Problemstilling
Problemet
Du har satt opp e-postlogging, men e-poster vises ikke i Piraja CRM. Dette kan være:
- E-poster sendt med BCC vises ikke
- Webhook mottar ikke e-poster
- API-nøkkelfeil
- E-poster korrelerer ikke med kontakter
- Integrasjon fungerer ikke
Vanlige scenarier
Scenario 1: BCC fungerer ikke
- Lagt til videresendingsadresse i BCC
- E-post sendt, men vises ikke i CRM
- Ingen feilmeldinger, bare ingen e-poster
Scenario 2: Webhook-problemer
- "Manglende API-nøkkel" feil
- "Ugyldig API-nøkkel" feil
- Webhook mottar ikke e-poster
Scenario 3: Korrelasjonsproblemer
- E-poster vises, men er ikke knyttet til kontakter
- "Ingen korrelasjon funnet" meldinger
- Kan ikke tilordne e-poster til kontakter
Scenario 4: Integrasjon ikke aktiv
- Integrasjon vises som inaktiv
- Kan ikke aktivere integrasjon
- Konfigurasjonsfeil
Hvorfor BCC alene ikke fungerer
Misforståelsen
Mange brukere tror at det å legge til videresendingsadressen i BCC automatisk vil logge e-poster. Dette er ikke hvordan det fungerer.
Hvordan e-postlogging faktisk fungerer
For at en e-post skal logges, må den:
- Mottaes av en e-postserver på videresendingsadressen
- Videresendes til webhook-endepunktet av den e-postserveren
- Behandles av webhook med en gyldig API-nøkkel
Hvorfor BCC alene mislykkes
Når du BCC-er en adresse:
- E-posten sendes til den adressen
- Men hvis det ikke er konfigurert en e-postserver for å motta den, går e-posten tapt
- Webhook-endepunktet blir aldri kalt
- Ingen e-post vises i CRM-en din
Løsningen: E-postvideresending
Du må sette opp en e-postvideresendingstjeneste som:
- Mottar e-poster på din videresendingsadresse (f.eks.
logg+xxx@dittdomene.com) - Videresender disse e-postene til din webhook-URL:
https://dittdomene.com/api/integrations/email-logging/webhook?api_key=DIN_API_NØKKEL
Uten e-postvideresending vil ikke BCC fungere.
Sette opp e-postvideresending
Alternativ 1: Bruk en e-posttjenesteleverandør (Anbefalt)
SendGrid Inbound Parse:
- Registrer deg for SendGrid
- Gå til Innstillinger → Inbound Parse
- Legg til et nytt vertsnavn:
dittdomene.com - Sett POST-URL til:
https://dittdomene.com/api/integrations/email-logging/webhook?api_key=DIN_API_NØKKEL - Konfigurer DNS MX-poster for ditt domene
- Test ved å sende en e-post til
logg+xxx@dittdomene.com
Mailgun Routes:
- Registrer deg for Mailgun
- Gå til Mottak → Ruter
- Opprett en rute som videresender til:
https://dittdomene.com/api/integrations/email-logging/webhook?api_key=DIN_API_NØKKEL - Konfigurer DNS MX-poster
- Test videresendingen
AWS SES:
- Sett opp AWS SES
- Konfigurer regler for e-postmottak
- Legg til en handling for å videresende til din webhook-URL
- Konfigurer DNS MX-poster
- Bekreft at e-postmottak fungerer
Alternativ 2: Bruk Gmail/Outlook-videresending (Enklere men begrenset)
Gmail-videresending:
- Sett opp en Gmail-konto for e-postlogging
- Gå til Innstillinger → Videresending og POP/IMAP
- Legg til videresendingsadresse:
logg+xxx@dittdomene.com - Konfigurer videresendingsregler
- Merk: Gmail-videresending har begrensninger og kan ikke fungere for alle brukstilfeller
Outlook-videresending:
- Sett opp en Outlook-konto
- Gå til Innstillinger → Mail → Videresending
- Konfigurer videresending til ditt webhook-endepunkt
- Merk: Outlook-videresending kan kreve ytterligere oppsett
Alternativ 3: Bruk en dedikert e-posttjeneste
For produksjonsbruk anbefaler vi å bruke en dedikert e-posttjenesteleverandør som SendGrid eller Mailgun for bedre pålitelighet og funksjoner.
Webhook-konfigurasjon
Forstå webhooken
Webhooken er endepunktet som mottar videresendte e-poster. Den må være:
- Tilgjengelig: Offentlig tilgjengelig via HTTPS
- Konfigurert: Med korrekt API-nøkkel
- Aktiv: Integrasjonen må være aktiv
Webhook-URL-format
Din webhook-URL bør se slik ut:
https://dittdomene.com/api/integrations/email-logging/webhook?api_key=DIN_API_NØKKEL
Få din API-nøkkel
- Gå til Integrasjoner → E-postlogging
- Finn din integrasjon
- Kopier API-nøkkelen
- Bruk den i din webhook-URL
Bekrefte at webhooken fungerer
- Sjekk integrasjonsstatus (bør være "Aktiv")
- Test webhook-endepunktet manuelt
- Sjekk serverlogger for webhook-forespørsler
- Bekreft at API-nøkkelen er korrekt
Vanlige webhook-problemer
Problem: "Manglende API-nøkkel"
- Årsak: API-nøkkel ikke i URL eller header
- Løsning: Legg til
?api_key=DIN_API_NØKKELtil webhook-URL
Problem: "Ugyldig API-nøkkel"
- Årsak: Feil API-nøkkel eller integrasjon inaktiv
- Løsning: Bekreft API-nøkkel og integrasjonsstatus
Problem: Webhook mottar ikke e-poster
- Årsak: E-postvideresending ikke konfigurert
- Løsning: Sett opp e-postvideresendingstjeneste
API-nøkkelproblemer
Problem: "Manglende API-nøkkel" feil
Symptomer:
- Webhook returnerer "Manglende API-nøkkel" feil
- E-poster behandles ikke
- Integrasjon viser feil
Løsning 1: Legg til API-nøkkel i Webhook-URL
Webhook-URL må inkludere API-nøkkelen:
- Få din API-nøkkel fra Integrasjoner → E-postlogging
- Legg den til din webhook-URL:
?api_key=DIN_API_NØKKEL - Oppdater din e-postvideresendingstjeneste med den nye URL-en
- Test ved å sende en test-e-post
Løsning 2: Bruk header i stedet (hvis støttet)
Noen e-posttjenester støtter API-nøkkel i headers:
- Konfigurer din e-posttjeneste til å sende
x-api-keyheader - Sett header-verdien til din API-nøkkel
- Webhook vil akseptere header i stedet for spørringsparameter
- Test konfigurasjonen
Problem: "Ugyldig API-nøkkel" feil
Symptomer:
- Webhook returnerer "Ugyldig API-nøkkel" feil
- API-nøkkel virker korrekt, men fungerer ikke
- Integrasjon viser autentiseringsfeil
Løsning 1: Bekreft API-nøkkel
- Gå til Integrasjoner → E-postlogging
- Sjekk din integrasjons API-nøkkel
- Kopier den nøyaktig (ingen ekstra mellomrom)
- Oppdater webhook-URL med korrekt nøkkel
- Test igjen
Løsning 2: Sjekk integrasjonsstatus
Hvis API-nøkkel er ugyldig:
- Gå til Integrasjoner → E-postlogging
- Sjekk om integrasjonen er "Aktiv"
- Hvis inaktiv, aktiver den
- Generer en ny API-nøkkel hvis nødvendig
- Oppdater webhook-URL
Løsning 3: Regenerer API-nøkkel
Hvis API-nøkkel fortsatt ikke fungerer:
- Gå til Integrasjoner → E-postlogging
- Finn din integrasjon
- Klikk "Regenerer API-nøkkel" eller "Koble fra og koble til igjen"
- Kopier den nye API-nøkkelen
- Oppdater webhook-URL med ny nøkkel
- Oppdater e-postvideresendingstjeneste
- Test igjen
E-postkorrelasjonsproblemer
Problem: E-poster knyttes ikke til kontakter
Symptomer:
- E-poster vises i e-postloggen
- Men er ikke knyttet til noen kontakt
- "Ingen korrelasjon funnet" meldinger
- Kan ikke se e-poster i kontaktoppføringer
Hvordan e-postkorrelasjon fungerer
E-poster korreleres automatisk med kontakter når:
- Mottakerens e-post (TO eller CC) samsvarer med en persons e-post
- Mottakerens e-post samsvarer med en organisasjons e-post
- Autokorrelasjon er aktivert i innstillinger
Løsning 1: Aktiver autokorrelasjon
- Gå til Integrasjoner → E-postlogging
- Finn dine integrasjonsinnstillinger
- Aktiver "Autokorrelasjon" hvis tilgjengelig
- Lagre innstillinger
- Nye e-poster bør autokorrelere
Løsning 2: Tilordne e-poster manuelt
Hvis autokorrelasjon ikke fungerer:
- Gå til Postkasse → Tilordne (eller e-postloggside)
- Finn ufordelte e-poster
- Klikk på en e-post
- Velg kontakten å tilordne den til
- Lagre tilordning
Løsning 3: Bekreft kontaktens e-postadresser
Hvis e-poster ikke korrelerer:
- Sjekk at kontakter har e-postadresser
- Bekreft at e-postadressene er korrekte
- Sjekk for skrivefeil i e-postadressene
- Sørg for at e-postformatet samsvarer nøyaktig
Løsning 4: Sjekk e-postmottakere
Hvis korrelasjon fortsatt ikke fungerer:
- Sjekk e-postens TO og CC-felt
- Bekreft at mottakerens e-poster samsvarer med kontaktens e-poster
- Sjekk for e-postaliaser eller videresending
- Prøv manuell tilordning hvis nødvendig
Vanlige problemer
Problem: "Manglende API-nøkkel" feil
Løsning: Sørg for at webhook-URL-en inkluderer api_key spørringsparameteren, eller at e-postvideresendingstjenesten sender x-api-key header.
Problem: "Ugyldig API-nøkkel" feil
Løsning:
- Sjekk at du bruker korrekt API-nøkkel fra din integrasjon
- Bekreft at integrasjonen er aktiv (status = 'aktiv')
- Prøv å koble fra og koble til igjen for å generere en ny API-nøkkel
Problem: E-poster vises som duplikater
Løsning: Dette er forventet oppførsel - systemet forhindrer dupliserte e-poster ved å bruke Message-ID header. Hvis du tester, bruk en annen e-post hver gang.
Problem: Ingen korrelasjon funnet
Løsning:
- Sjekk at mottakerens e-post (TO/CC) samsvarer med en person eller organisasjon i din CRM
- Aktiver autokorrelasjon i innstillinger
- Tilordne e-poster manuelt ved å bruke
/mailbox/assignsiden
Problem: Integrasjon ikke aktiv
Løsning:
- Gå til Integrasjoner → E-postlogging
- Sjekk integrasjonsstatus
- Aktiver hvis inaktiv
- Bekreft at konfigurasjonen er korrekt
Problem: Webhook mottar ikke e-poster
Løsning:
- Bekreft at e-postvideresending er konfigurert
- Sjekk at webhook-URL er korrekt
- Test webhook-endepunktet manuelt
- Sjekk serverlogger for feil
Problem: E-poster vises ikke etter oppsett
Løsning:
- Vent noen minutter (behandling kan være forsinket)
- Sjekk integrasjonsstatus
- Bekreft at e-postvideresending fungerer
- Test ved å sende en ny e-post
- Sjekk webhook-logger
Forebyggingstips
Hvordan unngå problemer med e-postlogging
1. Sett opp e-postvideresending riktig
- Ikke stol på BCC alene
- Bruk en skikkelig e-postvideresendingstjeneste
- Test videresending før du stoler på den
2. Hold API-nøkkelen sikker
- Ikke del API-nøkler
- Regenerer hvis kompromittert
- Bruk API-nøkkel i webhook-URL, ikke i e-postinnhold
3. Overvåk integrasjonsstatus
- Sjekk at integrasjonen er aktiv regelmessig
- Overvåk for feil
- Løs problemer raskt
4. Test regelmessig
- Send test-e-poster periodisk
- Bekreft at e-poster logges
- Sjekk at korrelasjon fungerer
5. Hold kontaktens e-postadresser oppdatert
- Sørg for at kontakter har korrekte e-postadresser
- Oppdater e-poster når de endres
- Fjern ugyldige e-postadresser
6. Bruk riktig e-postformat
- Bruk standard e-postformat
- Unngå spesialtegn i e-postadresser
- Bekreft at e-postadresser er gyldige
7. Dokumenter oppsettet ditt
- Hold oversikt over videresendingskonfigurasjon
- Dokumenter webhook-URL
- Noter eventuelle spesielle innstillinger
Fungerer fortsatt ikke?
Når du skal kontakte support
Hvis du har prøvd alle løsninger og e-poster fortsatt ikke vises:
1. Samle informasjon Før du kontakter support:
- Integrasjonsstatus
- API-nøkkel (maskert for sikkerhet)
- Webhook-URL (uten API-nøkkel)
- Brukt e-postvideresendingstjeneste
- Feilmeldinger
- Trinn du allerede har prøvd
- Skjermbilder av konfigurasjon
2. Kontakt support
- E-post: support@piraja.com (eller din support-e-post)
- I appen: Bruk hjelpeikonet (?) i grensesnittet
- Kunnskapsbase: Søk etter relaterte artikler
3. Hva support vil trenge
- Din konto-e-post
- Firmanavn
- Integrasjonstype (E-postlogging)
- E-postvideresendingstjeneste
- Feilmeldinger
- Trinn du har prøvd
- Konfigurasjonsskjermbilder (uten API-nøkkel)
Relaterte artikler
Ytterligere ressurser
- Integrasjonshjelp: Generell feilsøking av integrasjoner
- E-posttjenestedokumentasjon: SendGrid, Mailgun, AWS SES guider
- Webhook-testing: Verktøy for testing av webhook-endepunkter