Übersicht
Rufen Sie eine paginierte Kontaktliste ab. Nutzen Sie den Query-Parameter number zur Suche nach einer bestimmten Nummer. Ergebnisse sind auf den authentifizierten Benutzer beschränkt. Kombinieren Sie mit CRM-Sync-Jobs, um externe IDs mit Buzzbip-Kontakt-IDs für WhatsApp-Sendungen abzugleichen.
GET /api/contacts/
Rufen Sie diesen Endpunkt mit GET und gültigem Bearer-Token auf.
curl -X GET 'https://app.buzzbip.com/api/contacts/?currentPage=1&limit=20&number=' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json'Hinweise zur Nutzung
Paginierte Kontaktliste abrufen. number-Parameter für gezielte Suche. Paginierungsparameter beachten.
Nutzen Sie Paginierung und Filter, um die Antwortgröße zu reduzieren.
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?
Verwandte Seiten: api/contacts/create-contact api/whatsapp-messaging/send-whatsapp-message guides/sync-contacts-from-crm
