Integration von WhatsApp-Registrierungsprüfungen in einen CRM-Workflow

Ein Schritt-für-Schritt-Leitfaden für einen CRM-Workflow zur WhatsApp-Prüfung: Wann der Check ausgelöst werden sollte, wie Nummern normalisiert werden, welche Eigenschaften und Tags gespeichert werden sollten und wie Follow-ups gesteuert werden.

Ein CRM-Workflow zur WhatsApp-Prüfung führt eine Registrierungsprüfung durch, sobald ein Kontakt erstellt oder dessen Telefonnummer geändert wird. Das Ergebnis sowie das Prüfdatum werden im Datensatz gespeichert, und das entsprechende Tag dient als Entscheidungsgrundlage für die Follow-up-Sequenz, in die der Kontakt aufgenommen werden kann. Der Check dient der Kanalplanung; der Status des opt-in entscheidet weiterhin darüber, ob der Kontakt kontaktiert werden darf. Durch diese Vorgehensweise hält das CRM ein aktuelles Signal zur Kontopräsenz vor, ohne die gesamte Datenbank jede Nacht erneut prüfen zu müssen.

Wo der Check im Kontaktlebenszyklus angesiedelt ist

Anbieterleitfäden zu diesem Thema zeigen meist ein Prüftool und ein CRM nebeneinander, lassen jedoch die Designfragen aus: Wann soll der Check ausgelöst werden, was soll gespeichert werden und wie ist mit Ergebnissen umzugehen, die nicht eindeutig bestimmt werden können? Beginnen Sie mit den Auslösern.

• Kontakt erstellt: Über ein Formular, einen Import oder durch einen Vertriebsmitarbeiter, der einen Lead anlegt.
• Telefonnummer geändert: Bei einem bestehenden Datensatz, da das alte Ergebnis nicht mehr gültig ist.
• Vor der Aufnahme: In eine WhatsApp-Sequenz, wenn das gespeicherte Ergebnis älter ist als das von Ihrem Team gewählte Zeitfenster für eine erneute Prüfung.

Vermeiden Sie geplante Prüfungen der gesamten Datenbank. Jeder abgeschlossene Check wird berechnet, unabhängig davon, ob die Nummer registriert ist oder nicht. Das wiederholte Prüfen unveränderter Datensätze verbraucht daher Guthaben, ohne einen Mehrwert zu bieten.

Schritt-für-Schritt-Design des CRM-Workflows zur WhatsApp-Prüfung

1. Nummer normalisieren. Konvertieren Sie den gespeicherten Telefonwert unter Verwendung des Länderfeldes des Datensatzes in das E.164-Format: Ländervorwahl, nationale Nummer, ohne führende Null. Datensätze, die nicht normalisiert werden können, erhalten anstelle eines Checks ein Tag für "Überprüfung erforderlich".
2. Deduplizieren. Wenn zwei Datensätze dieselbe normalisierte Nummer teilen, prüfen Sie diese nur einmal und schreiben das Ergebnis in beide Datensätze.
3. Echtzeit-Check aufrufen. Ein CRM-Automatisierungs- oder Middleware-Schritt sendet POST /api/v1/check mit dem X-API-Key Header, der E.164-Nummer und dem gewählten service_type für die WhatsApp-Registrierungsprüfung. Das Ergebnis wird in derselben Antwort zurückgegeben, sodass der Workflow ohne Polling fortgesetzt werden kann.
4. Importe in Gruppen verarbeiten. Für einen CSV-Import von einigen hundert Leads nimmt POST /api/v1/batch-check bis zu 100 Nummern pro Anfrage entgegen. Eine einmalige Bereinigung einer sehr großen historischen Basis eignet sich besser für eine Bulk-Datei-Aufgabe: hochladen, warten, Ergebnisdatei herunterladen und dann die Zeilen anhand der Telefonnummer zuordnen.
5. Zurückschreiben und taggen. Speichern Sie das Ergebnis und das Prüfdatum im Datensatz und lassen Sie dann die CRM-eigenen Workflow-Regeln Tags vergeben und den Kontakt aufnehmen.

Speichern Sie den API-Schlüssel in den Geheimnissen oder Integrationseinstellungen des CRM, niemals in einem Kontaktfeld oder einer freigegebenen Tabelle.

Zu speichernde Eigenschaften und Tags

Halten Sie das Schema klein und übersichtlich für Vertriebsmitarbeiter. Ein typischer Satz benutzerdefinierter Eigenschaften, definiert durch Ihr Team:

"Unbestimmt" ist wichtig. Ein Check, der nicht entschieden werden kann, gibt einen Business-Code ungleich Null zurück und sollte niemals als "Nicht registriert" gespeichert werden. Ebenso bedeutet ein "Nein" in der Eigenschaft für das Business-Konto nur, dass das Signal für ein Business-Konto fehlte; es beweist nicht, dass der Kontakt privat ist oder keiner Firma angehört.

Follow-up-Regeln, die die Grenzen des Signals respektieren

Sobald die Ergebnisse gespeichert sind, können Workflow-Regeln danach verzweigen:

• Registriert und mit opt-in: Berechtigt für die WhatsApp-Sequenz, vorbehaltlich der eigenen Regeln Ihres Messaging-Anbieters.
• Registriert ohne opt-in: Verbleib in der E-Mail- oder Telefon-Akquise, bis eine Einwilligung vorliegt. Die WhatsApp Business Messaging Policy erfordert ein opt-in, bevor ein Unternehmen jemanden kontaktiert, und verlangt die Einhaltung von opt-out-Anfragen, einschließlich der Entfernung aus Kontaktlisten.
• Nicht registriert: Senden Sie Follow-ups per E-Mail, SMS oder Anruf anstelle einer WhatsApp-Vorlage.
• Unbestimmt: Zurückhalten für einen späteren erneuten Versuch und den Kontakt aus WhatsApp-spezifischen Schritten heraushalten, bis ein abgeschlossenes Ergebnis vorliegt.

Ein registriertes Ergebnis ist ein plattformspezifisches Signal zur Kontopräsenz zum Zeitpunkt der Prüfung. Nummern können neu vergeben werden, daher verhindert ein Zeitfenster für erneute Prüfungen (z. B. vor jeder neuen Kampagne), dass Tags veralten.

Betrieb der Integration

• Guthaben überwachen. Das Dashboard zeigt Guthaben, API-Schlüssel, Validierungshistorie und den Status von Bulk-Aufgaben; Integrationen können das Guthaben über GET /api/v1/balance vor einem großen Import abrufen.
• Nutzungsbeschränkungen beachten. Die API dokumentiert Kontrollen für Nebenläufigkeit und Timeouts pro Benutzer. Dimensionieren Sie parallele Worker entsprechend diesen Kontrollen und konsultieren Sie die aktuelle API-Dokumentation, anstatt eine feste Anfragerate anzunehmen.
• Fehler separat protokollieren. Netzwerkfehler und unbestimmte Prüfungen gehören in ein Fehlerprotokoll mit einer Zeitvorgabe für erneute Versuche, nicht in die Eigenschaft des Kontakts.
• Format konsistent halten. Metas Leitfaden zum Telefonnummernformat zeigt, dass Nummern ohne Pluszeichen und Ländervorwahl zum falschen Empfänger führen können. Daher sollte die für den Check verwendete normalisierte Nummer auch diejenige sein, die für den Versand genutzt wird.

FAQ

Wie können Teams vermeiden, für wiederholte Prüfungen desselben Kontakts zu bezahlen?

Lösen Sie den Check nur bei der Kontakterstellung, bei Änderungen der Telefonnummer oder bei der Aufnahme nach Ablauf des Zeitfensters für erneute Prüfungen aus und deduplizieren Sie normalisierte Nummern, bevor Sie die API aufrufen. Speichern Sie das Datum der letzten Prüfung, damit die Automatisierung Datensätze mit einem kürzlich abgeschlossenen Ergebnis überspringen kann.

Was sollte ein CRM speichern, wenn ein Check nicht entschieden werden kann?

Speichern Sie einen separaten Wert wie Unbestimmt, protokollieren Sie den Versuch und planen Sie einen erneuten Versuch ein. Ein unbestimmter Check ist kein abgeschlossenes "Nicht registriert"-Ergebnis und sollte den Kontakt daher nicht dauerhaft in ein Nicht-WhatsApp-Follow-up verschieben.

Welcher API-Aufruf eignet sich für einen CRM-Import von einigen hundert Leads?

Der synchrone Multi-Endpunkt, POST /api/v1/batch-check, akzeptiert bis zu 100 Nummern pro Anfrage und gibt Ergebnisse in derselben Antwort zurück, sodass einige hundert Leads in mehreren Anfragen verarbeitet werden können. Sehr große historische Bereinigungen passen besser zu einer Bulk-Datei-Aufgabe.

Kann das Ergebnis zum Business-Konto für B2B-Segmentierung verwendet werden?

Es kann ein Input sein. Wenn die WhatsApp-Business-Kontoprüfung ausgewählt ist, zeigt das Ergebnis, ob es sich um ein WhatsApp-Business-Konto handelt. Es identifiziert nur den Kontotyp und bestätigt weder ein registriertes Unternehmen noch die Erlaubnis zur Kontaktaufnahme.

Mehr erfahren

Wählen Sie die Produktinformationen, die zum nächsten Schritt in Ihrem Workflow passen.

• Produktdokumentation ansehen →
• Mit dem Team sprechen →