Om e-postmeddelanden inte visas i din e-postloggning förklarar denna guide varför BCC ensam inte fungerar, hur man konfigurerar e-postvidarebefordran, webhook-inställning, API-nyckelkonfiguration och problem med e-postkorrelation.
Problemformulering
Problemet
Du har ställt in e-postloggning, men e-postmeddelanden visas inte i Piraja CRM. Detta kan bero på:
- E-postmeddelanden som skickas med BCC visas inte
- Webhook tar inte emot e-postmeddelanden
- API-nyckelfel
- E-postmeddelanden korrelerar inte med kontakter
- Integration fungerar inte
Vanliga scenarier
Scenario 1: BCC fungerar inte
- Vidarebefordringsadress tillagd till BCC
- E-post skickad men visas inte i CRM
- Inga felmeddelanden, bara inga e-postmeddelanden
Scenario 2: Webhook-problem
- "Saknad API-nyckel"-fel
- "Ogiltig API-nyckel"-fel
- Webhook tar inte emot e-postmeddelanden
Scenario 3: Korrelationproblem
- E-postmeddelanden visas men är inte länkade till kontakter
- "Ingen korrelation hittades"-meddelanden
- Kan inte tilldela e-postmeddelanden till kontakter
Scenario 4: Integration inte aktiv
- Integration visas som inaktiv
- Kan inte aktivera integration
- Konfigurationsfel
Varför BCC ensam inte fungerar
Missuppfattningen
Många användare tror att det räcker att lägga till vidarebefordringsadressen till BCC för att automatiskt logga e-postmeddelanden. Så fungerar det inte.
Hur e-postloggning faktiskt fungerar
För att ett e-postmeddelande ska loggas måste det:
- Tas emot av en e-postserver på vidarebefordringsadressen
- Vidarebefordras till webhook-slutpunkten av den e-postservern
- Bearbetas av webhook med en giltig API-nyckel
Varför BCC ensam misslyckas
När du BCC:ar en adress:
- E-postmeddelandet skickas till den adressen
- Men om det inte finns någon e-postserver konfigurerad för att ta emot det, går e-postmeddelandet förlorat
- Webhook-slutpunkten anropas aldrig
- Ingen e-post visas i ditt CRM
Lösningen: E-postvidarebefordran
Du behöver ställa in en e-postvidarebefordringstjänst som:
- Tar emot e-postmeddelanden på din vidarebefordringsadress (t.ex.
log+xxx@yourdomain.com) - Vidarebefordrar dessa e-postmeddelanden till din webhook-URL:
https://yourdomain.com/api/integrations/email-logging/webhook?api_key=YOUR_API_KEY
Utan e-postvidarebefordran kommer BCC inte att fungera.
Ställa in e-postvidarebefordran
Alternativ 1: Använd en e-postleverantör (Rekommenderas)
SendGrid Inbound Parse:
- Registrera dig för SendGrid
- Gå till Inställningar → Inbound Parse
- Lägg till ett nytt värdnamn:
yourdomain.com - Ställ in POST-URL till:
https://yourdomain.com/api/integrations/email-logging/webhook?api_key=YOUR_API_KEY - Konfigurera DNS MX-poster för din domän
- Testa genom att skicka ett e-postmeddelande till
log+xxx@yourdomain.com
Mailgun Routes:
- Registrera dig för Mailgun
- Gå till Mottagning → Routes
- Skapa en rutt som vidarebefordrar till:
https://yourdomain.com/api/integrations/email-logging/webhook?api_key=YOUR_API_KEY - Konfigurera DNS MX-poster
- Testa vidarebefordringen
AWS SES:
- Ställ in AWS SES
- Konfigurera regler för e-postmottagning
- Lägg till en åtgärd för att vidarebefordra till din webhook-URL
- Konfigurera DNS MX-poster
- Verifiera att e-postmottagning fungerar
Alternativ 2: Använd Gmail/Outlook-vidarebefordran (Enklare men begränsad)
Gmail-vidarebefordran:
- Ställ in ett Gmail-konto för e-postloggning
- Gå till Inställningar → Vidarebefordran och POP/IMAP
- Lägg till vidarebefordringsadress:
log+xxx@yourdomain.com - Konfigurera vidarebefordringsregler
- Obs: Gmail-vidarebefordran har begränsningar och kanske inte fungerar för alla användningsfall
Outlook-vidarebefordran:
- Ställ in ett Outlook-konto
- Gå till Inställningar → Mail → Vidarebefordran
- Konfigurera vidarebefordran till din webhook-slutpunkt
- Obs: Outlook-vidarebefordran kan kräva ytterligare inställningar
Alternativ 3: Använd en dedikerad e-posttjänst
För produktion rekommenderar vi att använda en dedikerad e-postleverantör som SendGrid eller Mailgun för bättre tillförlitlighet och funktioner.
Webhook-konfiguration
Förstå webhooken
Webhooken är slutpunkten som tar emot vidarebefordrade e-postmeddelanden. Den måste vara:
- Tillgänglig: Offentligt tillgänglig via HTTPS
- Konfigurerad: Med korrekt API-nyckel
- Aktiv: Integration måste vara aktiv
Webhook-URL-format
Din webhook-URL ska se ut så här:
https://yourdomain.com/api/integrations/email-logging/webhook?api_key=YOUR_API_KEY
Hämta din API-nyckel
- Gå till Integrationer → E-postloggning
- Hitta din integration
- Kopiera API-nyckeln
- Använd den i din webhook-URL
Verifiera att webhooken fungerar
- Kontrollera integrationsstatus (bör vara "Aktiv")
- Testa webhook-slutpunkt manuellt
- Kontrollera serverloggar för webhook-förfrågningar
- Verifiera att API-nyckeln är korrekt
Vanliga webhook-problem
Problem: "Saknad API-nyckel"
- Orsak: API-nyckel inte i URL eller header
- Lösning: Lägg till
?api_key=YOUR_API_KEYtill webhook-URL
Problem: "Ogiltig API-nyckel"
- Orsak: Fel API-nyckel eller integration inaktiv
- Lösning: Verifiera API-nyckel och integrationsstatus
Problem: Webhook tar inte emot e-postmeddelanden
- Orsak: E-postvidarebefordran inte konfigurerad
- Lösning: Ställ in e-postvidarebefordringstjänst
API-nyckelproblem
Problem: "Saknad API-nyckel"-fel
Symptom:
- Webhook returnerar "Saknad API-nyckel"-fel
- E-postmeddelanden bearbetas inte
- Integration visar fel
Lösning 1: Lägg till API-nyckel till webhook-URL
Webhook-URL måste inkludera API-nyckeln:
- Hämta din API-nyckel från Integrationer → E-postloggning
- Lägg till den i din webhook-URL:
?api_key=YOUR_API_KEY - Uppdatera din e-postvidarebefordringstjänst med den nya URL:en
- Testa genom att skicka ett test-e-postmeddelande
Lösning 2: Använd header istället (om stöds)
Vissa e-posttjänster stöder API-nyckel i headers:
- Konfigurera din e-posttjänst för att skicka
x-api-keyheader - Ställ in header-värdet till din API-nyckel
- Webhook accepterar header istället för frågeparameter
- Testa konfigurationen
Problem: "Ogiltig API-nyckel"-fel
Symptom:
- Webhook returnerar "Ogiltig API-nyckel"-fel
- API-nyckel verkar korrekt men fungerar inte
- Integration visar autentiseringsfel
Lösning 1: Verifiera API-nyckel
- Gå till Integrationer → E-postloggning
- Kontrollera din integrations API-nyckel
- Kopiera den exakt (inga extra mellanslag)
- Uppdatera webhook-URL med korrekt nyckel
- Testa igen
Lösning 2: Kontrollera integrationsstatus
Om API-nyckel är ogiltig:
- Gå till Integrationer → E-postloggning
- Kontrollera om integration är "Aktiv"
- Om inaktiv, aktivera den
- Generera en ny API-nyckel om det behövs
- Uppdatera webhook-URL
Lösning 3: Regenerera API-nyckel
Om API-nyckel fortfarande inte fungerar:
- Gå till Integrationer → E-postloggning
- Hitta din integration
- Klicka på "Regenerera API-nyckel" eller "Koppla från och återanslut"
- Kopiera den nya API-nyckeln
- Uppdatera webhook-URL med ny nyckel
- Uppdatera e-postvidarebefordringstjänst
- Testa igen
E-postkorrelationsproblem
Problem: E-postmeddelanden länkas inte till kontakter
Symptom:
- E-postmeddelanden visas i e-postloggning
- Men inte länkade till någon kontakt
- "Ingen korrelation hittades"-meddelanden
- Kan inte se e-postmeddelanden i kontaktregister
Hur e-postkorrelation fungerar
E-postmeddelanden korreleras automatiskt med kontakter när:
- Mottagare-e-post (TO eller CC) matchar en individs e-post
- Mottagare-e-post matchar en organisations e-post
- Auto-korrelation är aktiverad i inställningar
Lösning 1: Aktivera auto-korrelation
- Gå till Integrationer → E-postloggning
- Hitta dina integrationsinställningar
- Aktivera "Auto-korrelation" om tillgängligt
- Spara inställningar
- Nya e-postmeddelanden bör auto-korrelera
Lösning 2: Tilldela e-postmeddelanden manuellt
Om auto-korrelation inte fungerar:
- Gå till Mailbox → Tilldela (eller e-postloggningssida)
- Hitta oallokerade e-postmeddelanden
- Klicka på ett e-postmeddelande
- Välj kontakten att tilldela det till
- Spara tilldelning
Lösning 3: Verifiera kontaktens e-postadresser
Om e-postmeddelanden inte korrelerar:
- Kontrollera att kontakter har e-postadresser
- Verifiera att e-postadresser är korrekta
- Kontrollera för stavfel i e-postadresser
- Se till att e-postformat matchar exakt
Lösning 4: Kontrollera e-postmottagare
Om korrelation fortfarande inte fungerar:
- Kontrollera e-postens TO och CC-fält
- Verifiera att mottagare-e-post matchar kontakt-e-post
- Kontrollera för e-postalias eller vidarebefordran
- Försök med manuell tilldelning om det behövs
Vanliga problem
Problem: "Saknad API-nyckel"-fel
Lösning: Se till att webhook-URL inkluderar api_key frågeparameter, eller att e-postvidarebefordringstjänsten skickar x-api-key header.
Problem: "Ogiltig API-nyckel"-fel
Lösning:
- Kontrollera att du använder rätt API-nyckel från din integration
- Verifiera att integrationen är aktiv (status = 'aktiv')
- Försök koppla från och återansluta för att generera en ny API-nyckel
Problem: E-postmeddelanden visas som dubbletter
Lösning: Detta är förväntat beteende - systemet förhindrar dubbletter av e-postmeddelanden med hjälp av Message-ID header. Om du testar, använd en annan e-post varje gång.
Problem: Ingen korrelation hittades
Lösning:
- Kontrollera att mottagare-e-post (TO/CC) matchar en individ eller organisation i ditt CRM
- Aktivera auto-korrelation i inställningar
- Tilldela e-postmeddelanden manuellt med
/mailbox/assignsidan
Problem: Integration inte aktiv
Lösning:
- Gå till Integrationer → E-postloggning
- Kontrollera integrationsstatus
- Aktivera om inaktiv
- Verifiera att konfigurationen är korrekt
Problem: Webhook tar inte emot e-postmeddelanden
Lösning:
- Verifiera att e-postvidarebefordran är konfigurerad
- Kontrollera att webhook-URL är korrekt
- Testa webhook-slutpunkt manuellt
- Kontrollera serverloggar för fel
Problem: E-postmeddelanden visas inte efter inställning
Lösning:
- Vänta några minuter (bearbetning kan vara försenad)
- Kontrollera integrationsstatus
- Verifiera att e-postvidarebefordran fungerar
- Testa genom att skicka ett nytt e-postmeddelande
- Kontrollera webhook-loggar
Förebyggande tips
Hur man undviker problem med e-postloggning
1. Ställ in e-postvidarebefordran korrekt
- Förlita dig inte enbart på BCC
- Använd en korrekt e-postvidarebefordringstjänst
- Testa vidarebefordran innan du förlitar dig på den
2. Håll API-nyckeln säker
- Dela inte API-nycklar
- Regenerera om den är komprometterad
- Använd API-nyckel i webhook-URL, inte i e-postinnehåll
3. Övervaka integrationsstatus
- Kontrollera att integrationen är aktiv regelbundet
- Övervaka för fel
- Åtgärda problem snabbt
4. Testa regelbundet
- Skicka test-e-postmeddelanden periodiskt
- Verifiera att e-postmeddelanden loggas
- Kontrollera att korrelation fungerar
5. Håll kontaktens e-postadresser uppdaterade
- Se till att kontakter har korrekta e-postadresser
- Uppdatera e-postadresser när de ändras
- Ta bort ogiltiga e-postadresser
6. Använd korrekt e-postformat
- Använd standard e-postformat
- Undvik specialtecken i e-postadresser
- Verifiera att e-postadresser är giltiga
7. Dokumentera din inställning
- Håll reda på vidarebefordringskonfiguration
- Dokumentera webhook-URL
- Notera eventuella specialinställningar
Fungerar fortfarande inte?
När du ska kontakta support
Om du har provat alla lösningar och e-postmeddelanden fortfarande inte visas:
1. Samla information Innan du kontaktar support:
- Integrationsstatus
- API-nyckel (maskerad för säkerhet)
- Webhook-URL (utan API-nyckel)
- Använd e-postvidarebefordringstjänst
- Felmeddelanden
- Steg du redan har provat
- Skärmdumpar av konfiguration
2. Kontakta support
- E-post: support@piraja.com (eller din support-e-post)
- I appen: Använd hjälpikonen (?) i gränssnittet
- Kunskapsbas: Sök efter relaterade artiklar
3. Vad supporten behöver
- Din kontoe-post
- Företagsnamn
- Integrationstyp (E-postloggning)
- E-postvidarebefordringstjänst
- Felmeddelanden
- Steg du har provat
- Konfigurationsskärmdumpar (utan API-nyckel)
Relaterade artiklar
Ytterligare resurser
- Integrationshjälp: Allmän felsökning av integrationer
- E-posttjänstdokumentation: SendGrid, Mailgun, AWS SES-guider
- Webhook-testning: Verktyg för att testa webhook-slutpunkter