Einführung
Halten Sie Buzzbip-Kontakte mit Ihrem CRM abgestimmt, damit Kampagnen die richtigen IDs ansprechen. Führen Sie Sync-Jobs serverseitig nach Zeitplan oder Webhook aus. Suchen Sie nach Nummer vor dem Erstellen, um Duplikate zu vermeiden.
Schritte
Folgen Sie diesen Schritten, um die Integration abzuschließen.
- Kontakte aus CRM exportieren oder paginieren.
- Felder auf firstname, lastname und number mappen.
- Upsert via POST /api/contacts/ (Duplikate nach Policy).
- Mit GET /api/contacts/?number= für id abgleichen.
- contact_id in WhatsApp- und SMS-Sends nutzen.
Einzelheiten
Buzzbip-Kontakte mit CRM synchron halten für korrektes Targeting. Sync serverseitig mit Duplikat-Handling und Retry.
curl -X POST 'https://app.buzzbip.com/api/contacts/' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json' \
-d '{"firstname": "Jane", "lastname": "Doe", "number": "21690123456"}'Vor Produktiv-Syncs oder -Sendungen in Staging testen.
Integrationshinweise
Bei der Integration dieses Buzzbip-Endpunkts https://app.buzzbip.com als Produktionshost verwenden. JWT über POST /api/login_check holen und Authorization: Bearer mitsenden. User.hasApiAccess im Buzzbip-Admin muss aktiv sein. JSend-Antworten (status, message, data) auswerten. Für E-Commerce-Plugins zusätzlich x-api-key, x-platform-type und x-base-uri senden. Abschließende Slashes bei POST /api/contacts/ und POST /api/whatsapp/ beachten. Bei Ratenlimits Backoff-Retries implementieren. Zugangsdaten serverseitig speichern und vor JWT-Ablauf (3600 s) neu authentifizieren.
Sicherheit
Sicherheit: Zugangsdaten nur serverseitig, TLS Pflicht, fehlgeschlagene Auth überwachen. Staging- und Produktionskonten trennen. Vorlagen und Automationen dokumentieren. Nummern und Inhalte in geteilten Logs schwärzen.
Wie geht es weiter?
Weiter lernen: api/contacts/list-contacts api/contacts/create-contact guides/send-whatsapp-message
