WhatsApp-Protokolle
Der Bereich WhatsApp-Protokolle bietet eine umfassende Aufzeichnung aller automatisierten Interaktionen, die vom WhatsApp Cloud API Chat & Marketing Modul verarbeitet werden. Dies umfasst Kampagnenzustellungen, Bot-ausgelöste Antworten und vorlagenbasierte Nachrichten. Verwenden Sie diesen Bereich, um Aktivitäten zu überwachen, Zustellprobleme zu beheben und eine vollständige Prüfspur Ihrer WhatsApp-Kommunikation zu führen.
Zugriff auf WhatsApp-Protokolle
Navigieren Sie zu WhatsApp-Modul > WhatsApp-Protokolle in der Perfex CRM-Seitenleiste. Die Protokolle werden in einer sortierbaren, durchsuchbaren Tabelle angezeigt, die alle automatisierten Nachrichtenaktivitäten zeigt.
Protokolltabellenspalten
Jeder Protokolleintrag enthält die folgenden Informationen:
| Spalte | Beschreibung |
|---|---|
| # | Eine eindeutige automatisch inkrementierte ID für jeden Protokolleintrag |
| Kategorie | Der Typ der automatisierten Interaktion — z. B. Marketingkampagne, Vorlagen-Bot |
| Name | Der Name der Kampagne, des Bots oder der Automatisierung, die den Protokolleintrag erzeugt hat |
| Vorlagenname | Die für die Interaktion verwendete WhatsApp-Nachrichtenvorlage |
| Antwortcode | Der von der WhatsApp Cloud API zurückgegebene HTTP-Antwortcode (z. B. 200 für Erfolg, 400 für fehlerhafte Anfrage) |
| Typ | Der Empfängertyp — z. B. Leads, Kunden, Kontakte |
| Erfasst am | Datum und Uhrzeit der Erfassung der Interaktion |
| Aktionen | Verfügbare Aktionen für jeden Eintrag: Details anzeigen oder Protokolleintrag Löschen |
Antwortcodes verstehen
Die Spalte Antwortcode hilft Ihnen, schnell zu erkennen, ob Nachrichten erfolgreich zugestellt wurden oder auf Fehler gestoßen sind.
| Antwortcode | Bedeutung | Erforderliche Maßnahme |
|---|---|---|
| 200 | Erfolg — Nachricht von der WhatsApp API akzeptiert | Keine Maßnahme erforderlich |
| 400 | Fehlerhafte Anfrage — ungültige Parameter oder Vorlagenproblem | Überprüfen Sie die Vorlage und Parameter |
| 401 | Nicht autorisiert — ungültiges oder abgelaufenes Access Token | Generieren Sie Ihr Access Token in den Meta Business-Einstellungen neu |
| 403 | Verboten — unzureichende Berechtigungen | Überprüfen Sie Ihre System-Benutzer-Berechtigungen |
| 404 | Nicht gefunden — ungültige Phone Number ID oder Endpunkt | Überprüfen Sie Ihre Phone Number ID in den Moduleinstellungen |
| 429 | Rate-Limit — zu viele gesendete Anfragen | Reduzieren Sie die Sendehäufigkeit; nach Abkühlung erneut versuchen |
| 500 | Interner Serverfehler — WhatsApp API-Problem | Später erneut versuchen; Meta-Statusseite prüfen, wenn das Problem bestehen bleibt |
Ein erfolgreicher Antwortcode (200) bestätigt, dass die WhatsApp Cloud API die Nachricht zur Zustellung akzeptiert hat. Dies garantiert nicht die endgültige Zustellung an das Gerät des Empfängers — die Zustellbestätigung erfolgt über Webhook-Statusaktualisierungen, die in der Chat-Oberfläche sichtbar sind.
Protokolle filtern
Verwenden Sie die integrierten Filter, um Protokolleinträge einzugrenzen und bestimmte Einträge schnell zu finden:
- Kategorie — nach Interaktionstyp filtern (Marketingkampagne, Vorlagen-Bot usw.)
- Antwortcode — nach Erfolg (
200) oder bestimmten Fehlercodes filtern - Typ — nach Empfängertyp filtern (Leads, Kunden, Kontakte)
- Datumsbereich — wählen Sie ein Start- und Enddatum, um Protokolle innerhalb eines bestimmten Zeitraums anzuzeigen
- Suche — Freitextsuche über Kampagnennamen, Vorlagennamen und andere Felder
Protokolldetails anzeigen
Klicken Sie auf die Aktion Anzeigen bei einem beliebigen Protokolleintrag, um die vollständigen Details der Interaktion zu sehen, einschließlich:
- Vollständiger an die WhatsApp API gesendeter Request-Payload
- Vollständiger API-Antwort-Body
- Telefonnummer und Kontaktreferenz des Empfängers
- Vorlagenparameter und verwendete Variablenwerte
- Zeitstempel mit Zeitzoneninformation
Diese Detailansicht ist unschätzbar wertvoll für die Fehlerbehebung bei fehlgeschlagenen Zustellungen oder die Prüfung bestimmter Nachrichteninhalte.
Protokolleinträge löschen
Um einzelne Protokolleinträge zu entfernen:
- Klicken Sie auf die Aktion Löschen in der Zielprotokollzeile.
- Bestätigen Sie das Löschen, wenn Sie dazu aufgefordert werden.
Für Massenlöschungen verwenden Sie die Kontrollkästchen-Auswahl, um mehrere Einträge auszuwählen, und klicken Sie auf Ausgewählte löschen.
Gelöschte Protokolleinträge können nicht wiederhergestellt werden. Wenn Sie Einträge für Compliance- oder Prüfungszwecke aufbewahren müssen, erwägen Sie den Export der Daten vor dem Löschen.
Best Practices
- Protokolle regelmäßig überprüfen — prüfen Sie auf fehlgeschlagene Zustellungen (Nicht-200-Antwortcodes) und beheben Sie Probleme umgehend, um die Kampagneneffektivität aufrechtzuerhalten
- Rate-Limits überwachen — wenn häufige
429-Antworten auftreten, reduzieren Sie Ihre Kampagnen-Senderate oder verteilen Sie Zustellungen über längere Zeitfenster - Tokens aktuell halten —
401-Fehler zeigen an, dass Ihr Access Token abgelaufen ist oder widerrufen wurde; aktualisieren Sie es sofort, um die Funktionalität wiederherzustellen - Vor der Bereinigung archivieren — bevor Sie alte Protokolle löschen, exportieren oder dokumentieren Sie alle Einträge, die für Compliance, Berichterstattung oder Streitbeilegung benötigt werden
- Filter für Prüfungen verwenden — wenn Sie eine bestimmte Kampagne oder einen Bot untersuchen, verwenden Sie die Kategorie- und Namensfilter, um die relevanten Protokolleinträge schnell zu isolieren
WhatsApp-Protokolle erfassen nur automatisierte Interaktionen (Kampagnen, Bots, Vorlagenversand). Manuelle Chat-Nachrichten zwischen Mitarbeitern und Kunden werden im Chat-Verlauf gespeichert und nicht in diesem Protokollbereich dupliziert.