Postfach: E-Mails erscheinen nicht

Wenn E-Mails im Postfach nicht angezeigt werden, führt dieser Leitfaden durch die häufigsten Ursachen: Anbieterverbindung/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 Eingaben erreichen nicht den Webhook-Endpunkt
• Nachrichten werden verarbeitet, sind aber nicht mit den richtigen Datensätzen verknüpft
• 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
• Keine neuen Threads/Nachrichten erscheinen

Szenario 2: Probleme mit Weiterleitung/Webhook

• Die Weiterleitungsadresse erhält E-Mails, aber nichts wird im Postfach angezeigt
• Der eingehende Anbieter veröffentlicht nicht an den Webhook
• Authentifizierung oder Konfiguration ist fehlerhaft

Szenario 3: Korrelationsprobleme

• E-Mails erscheinen im Postfach, sind aber nicht mit einer Person/Organisation verknüpft
• Thread ist nicht mit einem Ticket/Opportunity/Aufgabe verbunden
• Sie erwarten eine Aktivitätsgeschichte zu einem Datensatz, aber die Nachricht bleibt unzugeordnet

Szenario 4: Filter blenden die Nachrichten aus

• Falscher Ordner ausgewählt (Posteingang/Gesendet/Archiviert usw.)
• Sie befinden sich 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 erhält und an Piraja weiterleitet.

Wie die Postfacheingabe funktioniert

Damit eine E-Mail im Postfach angezeigt wird, gelangt sie typischerweise über einen dieser Wege:

1. Anbieter-Synchronisierung (Gmail/Outlook in Postfach verbunden)
2. Weitergeleitete Eingabe (ein E-Mail-Dienst empfängt die Nachricht und veröffentlicht sie an Pirajas Webhook)

Warum BCC allein fehlschlägt

Wenn Sie eine Adresse in BCC setzen:

• Die E-Mail wird an diese Adresse gesendet
• Wenn kein empfangendes Postfach/Route dahinter steht, wird die Nachricht niemals verarbeitet
• Piraja sieht die Nachricht niemals, 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:

1. E-Mails an die Weiterleitungsadresse empfängt
2. Die rohe E-Mail an Pirajas Webhook weiterleitet/veröffentlicht (einige Setups verwenden immer noch den Legacy-Kompatibilitätsendpunkt unter /api/integrations/email-logging/webhook, der an die aktuelle Postfacheingabe weiterleitet)

Wenn Sie Gmail/Outlook verwenden, verbinden Sie den Anbieter im Postfach und lassen Sie die Synchronisierung die Nachrichten direkt verarbeiten.

Ohne ein echtes Empfangs- + Weiterleitungssystem 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

1. Anbieter ist verbunden für Ihren Benutzer im Postfach
2. Synchronisierungsstatus zeigt als gesund an (keine Fehler)
3. Sie sehen den richtigen Ordner (Posteingang, Gesendet, Alle E-Mails, Archiv, Spam, Papierkorb oder benutzerdefiniert)
4. Sie haben keine Suchanfrage oder Filter, die Ergebnisse ausblenden
5. Für Gesendet: Lassen Sie Synchronisierungszeit zu — verbinden Sie Outlook erneut, wenn gesendete Nachrichten fehlen

Wenn es verbunden ist, aber immer noch leer

• Senden Sie eine neue Test-E-Mail und überprüfen Sie die Nachrichten-Ansicht in Alle E-Mails
• Trennen Sie den Anbieter und verbinden Sie ihn erneut, wenn die Synchronisierung festzustecken scheint
• Wenn nur einige Nachrichten fehlen, kann es sich um eine Verzögerung oder ein Problem auf der Anbieterseite handeln.

Weiterleitungs/Webhook-Eingabe: Was zu überprüfen ist

Wenn Sie anstelle der Anbieter-Synchronisierung Weiterleitung verwenden, muss Ihr empfangender E-Mail-Dienst eingehende Nachrichten an Piraja veröffentlichen.

Häufige Ursachen

• Die Weiterleitungsadresse erhält die E-Mail nicht (Routing/MX-Problem)
• Der Anbieter erhält E-Mails, veröffentlicht aber nicht an Piraja
• Authentifizierung oder Konfiguration ist fehlerhaft

Praktische Überprüfungsschritte

1. Senden Sie eine Test-E-Mail an die Weiterleitungsadresse
2. Überprüfen Sie, ob der Anbieter zeigt, dass die Nachricht empfangen wurde
3. Überprüfen Sie, ob der Anbieter einen erfolgreichen POST an Piraja zeigt
4. Aktualisieren Sie das Postfach und überprüfen Sie die Alle + Nachrichten-Ansicht

Hinweis: Einige Setups verwenden immer noch den Legacy-Kompatibilitätsendpunkt unter /api/integrations/email-logging/webhook, der an die aktuelle Postfacheingabe-Implementierung weiterleitet.

Korrelations- und „fehlende CRM-Datensätze“

Die Postfacheingabe und die CRM-Korrelation sind separate Schritte.

Wenn Sie die E-Mail im Postfach sehen können, aber nicht bei einem Kontakt (Person/Organisation)

• Überprüfen Sie, ob der Kontakt die richtige E-Mail-Adresse gespeichert hat
• Wenn die Nachricht an ein Alias oder eine Verteilerliste gesendet wurde, kann die Korrelation eine manuelle Verknüpfung erfordern

Wenn Sie erwarten, dass E-Mails unter Tickets/Opportunities/Aufgaben erscheinen

• Ein Thread muss mit diesem Arbeitsobjekt verknüpft sein
• Wenn es noch nicht verknüpft ist, sehen Sie die E-Mail möglicherweise im Postfach, aber nicht in den Arbeitsobjekt-Tabs

Tipp: Bestätigen Sie immer, dass die E-Mail in Postfach → Nachrichtenansicht → Alle Ordner vorhanden ist, bevor Sie es als Eingabeproblem behandeln.

Sichtbarkeit und Filter (es könnte bereits dort sein)

Bevor Sie annehmen, dass die Eingabe defekt ist, bestätigen Sie, dass die Nachricht nicht durch den UI-Zustand verborgen ist.

Dinge, die häufig Nachrichten verbergen

• Falscher Ordner ausgewählt (Posteingang vs. Gesendet vs. Archiviert)
• Sie sind in der Unterhaltungen-Ansicht, erwarten jedoch 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:

1. Postfach → Nachrichtenansicht
2. Alle Ordner
3. Suchanfrage löschen

Wenn Sie die Nachricht dort immer noch nicht finden können, fahren Sie mit den Überprüfungen zur Anbieter-Synchronisierung oder Weiterleitung fort.

Häufige Probleme

Problem: Anbieter ist verbunden, aber es kommen keine neuen E-Mails an

• Trennen/erneut verbinden von Gmail oder Outlook
• Senden Sie eine brandneue Testnachricht und überprüfen Sie erneut Nachrichten → Alle

Problem: Weiterleitung erhält E-Mails, aber das Postfach ist leer

• Bestätigen Sie, dass der Weiterleitungsanbieter erfolgreich an Piraja veröffentlicht
• Überprüfen Sie, ob der Anbieter die rohe E-Mail-Nutzlast nicht 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 Weiterleitungsweg von Ende zu Ende, bevor Sie sich darauf verlassen
• Halten Sie die E-Mail-Adressen der Kontakte auf dem neuesten Stand, um die Korrelation zu verbessern
• Verwenden Sie Nachrichten + Alle als Ihre „Basisansicht“ bei der Fehlersuche
• Vermeiden Sie es, kritische Workflows 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 erscheinen:

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 versucht haben
• Screenshots der Konfiguration

2. Kontaktieren Sie den Support

• E-Mail: support@piraja.io
• In-App: Verwenden Sie das Hilfe-Symbol (?) 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 versucht haben
• Konfigurationsscreenshots (maskieren Sie alle sensiblen Schlüssel/Tokens)

Verwandte Artikel

• Postfachmodul: Vollständiger Leitfaden zur E-Mail-Verwaltung
• Das Modulsystem verstehen

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