Wenn E-Mails im Postfach nicht angezeigt werden, beschreibt dieser Leitfaden die häufigsten Ursachen: Anbieter-Verbindung/Synchronisierung, Weiterleitungs-/Webhook-Einrichtung und CRM-Zuordnung.
Problemstellung
Das Problem
Sie haben Postfach eingerichtet, aber E-Mails erscheinen nicht in Piraja CRM. Das könnte bedeuten:
- Anbieter-Synchronisierung ist nicht verbunden (Gmail/Outlook) oder läuft nicht
- Weitergeleitete Daten gelangen nicht zum Webhook-Endpunkt
- Nachrichten werden empfangen, aber nicht den richtigen Datensätzen zugeordnet
- Filter/Ansichtsmodus blenden die Nachrichten aus, die Sie erwarten
Häufige Szenarien
Szenario 1: Anbieter-Synchronisierung nicht verbunden
- Gmail/Outlook ist für Ihren Benutzer nicht verbunden
- Synchronisierung ist pausiert oder schlägt fehl
- Es erscheinen keine neuen Threads/Nachrichten
Szenario 2: Probleme mit Weiterleitung/Webhook
- Die Weiterleitungsadresse erhält E-Mails, aber nichts wird im Postfach angezeigt
- Der eingehende Anbieter sendet keine Daten an den Webhook
- Authentifizierung oder Konfiguration ist fehlerhaft
Szenario 3: Zuordnungsprobleme
- E-Mails erscheinen im Postfach, sind aber nicht mit einer Person/Organisation verknüpft
- Thread ist nicht mit einem Ticket/Gelegenheit/Aufgabe verbunden
- Sie erwarten eine Aktivitätsgeschichte zu einem Datensatz, aber die Nachricht bleibt nicht zugeordnet
Szenario 4: Filter blenden die Nachrichten aus
- Falscher Ordner ausgewählt (Posteingang/Gesendet/Archiviert usw.)
- Sie sind in einem anderen Ansichtsmodus (Unterhaltungen vs. Nachrichten)
- Ein Suchfilter ist aktiv
Warum BCC allein nicht funktioniert (Weiterleitung)
Das Missverständnis
Viele Benutzer denken, dass das einfache Hinzufügen einer Weiterleitungsadresse zu BCC E-Mails automatisch protokolliert. Dies funktioniert nur wenn die Weiterleitungsadresse ein echtes Postfach/Route ist, das die Nachricht empfängt und an Piraja weiterleitet.
Wie die Postfach-Datenaufnahme funktioniert
Damit eine E-Mail im Postfach angezeigt wird, kommt sie normalerweise über einen dieser Wege:
- Anbieter-Synchronisierung (Gmail/Outlook in Postfach verbunden)
- Weitergeleitete Datenaufnahme (ein E-Mail-Dienst empfängt die Nachricht und sendet sie an den Webhook von Piraja)
Warum BCC allein fehlschlägt
Wenn Sie eine Adresse in BCC setzen:
- Die E-Mail wird an diese Adresse gesendet
- Wenn es kein empfangendes Postfach/Route dahinter gibt, wird die Nachricht niemals aufgenommen
- Piraja sieht die Nachricht nie, sodass nichts im Postfach erscheinen kann
Die Lösung: Anbieter-Synchronisierung oder richtige Weiterleitung verwenden
Wenn Sie Weiterleitung verwenden, benötigen Sie einen E-Mail-Dienst/Anbieter, der:
- E-Mails an die Weiterleitungsadresse empfängt
- Die rohe E-Mail an den Webhook von Piraja weiterleitet/postet (einige Konfigurationen verwenden weiterhin den Legacy-Kompatibilitätsendpunkt unter /api/integrations/email-logging/webhook, der an die aktuelle Postfach-Datenaufnahme weiterleitet)
Wenn Sie Gmail/Outlook verwenden, verbinden Sie den Anbieter im Postfach und lassen Sie die Synchronisierung die Nachrichten direkt aufnehmen.
Ohne eine echte Empfangs- und Weiterleitungseinrichtung funktioniert BCC nicht.
Anbieter-Synchronisierung (Gmail/Outlook): Was zu überprüfen ist
Wenn Sie Gmail oder Outlook-Synchronisierung verwenden, sollten E-Mails ohne jegliche Weiterleitungs-/Webhook-Konfiguration im Postfach ankommen.
Was zu überprüfen ist
- Anbieter ist verbunden für Ihren Benutzer im Postfach
- Synchronisierungsstatus zeigt als gesund an (keine Fehler)
- Sie sehen den richtigen Ordner (Posteingang vs. Gesendet)
- Sie haben keine Suchanfrage oder Filter, die Ergebnisse ausblenden
Wenn es verbunden ist, aber immer noch leer
- Senden Sie eine neue Test-E-Mail und überprüfen Sie die Nachrichten-Ansicht in Alle
- Trennen Sie die Verbindung und verbinden Sie den Anbieter erneut, wenn die Synchronisierung festzustecken scheint
- Wenn nur einige Nachrichten fehlen, kann es sich um eine Verzögerung oder ein Umfangsproblem auf der Anbieterseite handeln
Weiterleitungs/Webhook-Datenaufnahme: Was zu überprüfen ist
Wenn Sie anstelle der Anbieter-Synchronisierung die Weiterleitung verwenden, muss Ihr empfangender E-Mail-Dienst eingehende Nachrichten an Piraja senden.
Häufige Ursachen
- Die Weiterleitungsadresse erhält die E-Mail nicht (Routing/MX-Problem)
- Der Anbieter erhält E-Mails, sendet aber keine POST-Anfrage an Piraja
- Authentifizierung oder Konfiguration ist fehlerhaft
Praktische Überprüfungsschritte
- Senden Sie eine Test-E-Mail an die Weiterleitungsadresse
- Überprüfen Sie, ob der Anbieter zeigt, dass die Nachricht empfangen wurde
- Überprüfen Sie, ob der Anbieter einen erfolgreichen POST an Piraja zeigt
- Aktualisieren Sie das Postfach und überprüfen Sie die Ansicht Alle + Nachrichten
Hinweis: Einige Konfigurationen verwenden weiterhin den Legacy-Kompatibilitätsendpunkt unter /api/integrations/email-logging/webhook, der an die aktuelle Implementierung der Postfach-Datenaufnahme weiterleitet.
Zuordnung und „fehlend aus CRM-Datensätzen“
Die Postfach-Datenaufnahme und die CRM-Zuordnung sind separate Schritte.
Wenn Sie die E-Mail im Postfach sehen können, aber nicht bei einem Kontakt (Person/Organisation)
- Überprüfen Sie, ob die E-Mail-Adresse des Kontakts korrekt gespeichert ist
- Wenn die Nachricht an ein Alias oder eine Verteilerliste gesendet wurde, kann die Zuordnung eine manuelle Verknüpfung erfordern
Wenn Sie erwarten, dass E-Mails unter Tickets/Gelegenheiten/Aufgaben erscheinen
- Ein Thread muss mit diesem Arbeitsgegenstand zugeordnet sein
- Wenn es noch nicht zugeordnet ist, sehen Sie die E-Mail möglicherweise immer noch im Postfach, aber nicht in den Registerkarten des Arbeitsgegenstands
Tipp: Bestätigen Sie immer, dass die E-Mail in Postfach → Nachrichtenansicht → Alle Ordner vorhanden ist, bevor Sie sie als ein Datenaufnahmeproblem behandeln.
Sichtbarkeit und Filter (es könnte bereits da sein)
Bevor Sie annehmen, dass die Datenaufnahme fehlerhaft ist, bestätigen Sie, dass die Nachricht nicht durch den UI-Zustand ausgeblendet wird.
Dinge, die häufig Nachrichten ausblenden
- Falscher Ordner ausgewählt (Posteingang vs. Gesendet vs. Archiviert)
- Sie sind in der Unterhaltungen-Ansicht, erwarten aber eine einzelne Nachrichtenzeile (versuchen Sie die Nachrichten-Ansicht)
- Eine Suchanfrage ist aktiv (löschen Sie sie)
- Sie sehen einen anderen Anbieter/Konto als erwartet
Beste Praxis
Überprüfen Sie immer:
- Postfach → Nachrichtenansicht
- Alle Ordner
- Suchanfrage löschen
Wenn Sie die Nachricht dort immer noch nicht finden können, fahren Sie mit den Überprüfungen der Anbieter-Synchronisierung oder Weiterleitung fort.
Häufige Probleme
Problem: Anbieter ist verbunden, aber es kommen keine neuen E-Mails an
- Trennen/verbinden Sie Gmail oder Outlook erneut
- Senden Sie eine brandneue Testnachricht und überprüfen Sie erneut Nachrichten → Alle
Problem: Weiterleitung empfängt E-Mails, aber das Postfach ist leer
- Bestätigen Sie, dass der Weiterleitungsanbieter erfolgreich an Piraja postet
- Überprüfen Sie, ob der Anbieter die rohe E-Mail-Nutzlast entfernt
Problem: E-Mails erscheinen, sind aber nicht mit den richtigen Datensätzen verknüpft
- Bestätigen Sie, dass die E-Mail-Adressen der Kontakte korrekt sind
- Verknüpfen Sie Teilnehmer/Entitäten, wenn Sie dazu im Postfach aufgefordert werden
Problem: „Ich kann es nicht finden“
- Wechseln Sie den Ansichtsmodus (Unterhaltungen ↔ Nachrichten)
- Überprüfen Sie die Ordner (Posteingang/Gesendet/Alle)
- Suchanfrage löschen und aktualisieren
Präventionstipps
So vermeiden Sie Überraschungen durch „fehlende E-Mails“
- Bevorzugen Sie Anbieter-Synchronisierung (Gmail/Outlook), wo immer möglich
- Wenn Sie Weiterleitung verwenden, testen Sie den Weiterleitungspfad von Ende zu Ende, bevor Sie sich darauf verlassen
- Halten Sie die E-Mail-Adressen der Kontakte aktuell, um die Zuordnung zu verbessern
- Verwenden Sie Nachrichten + Alle als Ihre „Basisansicht“, wenn Sie Fehlerbehebungen durchführen
- Vermeiden Sie es, kritische Arbeitsabläufe hinter einmaligen Filtern/Suchanfragen zu speichern
Immer noch nicht funktioniert?
Wann Sie den Support kontaktieren sollten
Wenn Sie alle Lösungen ausprobiert haben und E-Mails immer noch nicht angezeigt werden:
1. Informationen sammeln Bevor Sie den Support kontaktieren:
- Integrationsstatus
- API-Schlüssel (maskiert aus Sicherheitsgründen)
- Webhook-URL (ohne API-Schlüssel)
- Verwendeter E-Mail-Weiterleitungsdienst
- Fehlermeldungen
- Schritte, die Sie bereits ausprobiert haben
- Screenshots der Konfiguration
2. Kontaktieren Sie den Support
- E-Mail: support@piraja.io
- In-App: Verwenden Sie das Hilfesymbol (?) in der Benutzeroberfläche
- Wissensdatenbank: Suchen Sie nach verwandten Artikeln
3. Was der Support benötigt
- Ihre Kontaktemail
- Firmenname
- Integrationsart (Postfach)
- Anbieter (Gmail/Outlook/Weiterleitung)
- Fehlermeldungen
- Schritte, die Sie ausprobiert haben
- Konfigurations-Screenshots (maskieren Sie alle sensiblen Schlüssel/Tokens)
Verwandte Artikel
Zusätzliche Ressourcen
- Integrationshilfe: Allgemeine Fehlerbehebung bei Integrationen
- Dokumentation des E-Mail-Dienstes: SendGrid, Mailgun, AWS SES-Leitfäden
- Webhook-Tests: Tools zum Testen von Webhook-Endpunkten