Konto und Integrationen

Ein externes System oder einen Assistenten verbinden

Erstelle mit Pro oder Agency einen Schlüssel mit eingeschränktem Zugriff, veröffentliche neue Inhalte oder verbinde einen Assistenten.

Bevor du beginnst

Ein Webhook empfängt Nachrichtenhinweise vom WhatsApp-Dienst. Die Servereinrichtung gehört zum Betreiber der Integration. Dashboard-Nutzer müssen keine Servereinstellungen ändern. MCP erlaubt Assistenten, Kontowerkzeuge anzufordern.

So gehst du vor

Öffne für eingehende Nachrichten Einstellungen und finde Webhook-URL.
Wähle Kopieren für die genaue Adresse der Bereitstellung deines Kontos.
Bitte den Betreiber, eingehende Ereignisse des gewünschten Geräts mit dieser Adresse einzurichten.
Plane nach bestätigter Bereitschaft einen eingehenden Test von einer eigenen Nummer.
Prüfe das erwartete Ergebnis, etwa passende automatische Antwort oder neuer Gruppenprotokolleintrag bei aktiviertem Protokoll.
Melde dich für Assistentenzugang über die von deinem MCP-Client geöffnete Autorisierungsansicht an.
Prüfe vor Zugriffsgenehmigung den Anwendungsnamen und das Konto.
Öffne für ausgehende Integrationen Einstellungen → Externe Integrationen. Erstelle einen benannten Schlüssel für ein verbundenes Konto und ausdrücklich ausgewählte Gruppen. Speichere den Schlüssel sofort; er wird nur einmal angezeigt. Kopiere die API-Basis-URL.
Beispiel: Konfiguriere Abacus.AI so, dass zu jedem der acht täglichen Veröffentlichungszeitpunkte in America/Sao_Paulo neue Inhalte entstehen. Übermittle jede Veröffentlichung mit einem neuen Idempotency-Key an drei zugelassene Gruppen. Verwende diesen Schlüssel nur erneut, um dieselbe Anfrage unverändert zu wiederholen.
Lasse scheduled_at weg, um die Anfrage sofort einzureihen, oder verwende einen absoluten Zeitstempel mit -03:00 oder Z (UTC), bis zu 30 Tage im Voraus. Die Verarbeitung prüft die Warteschlange jede Minute; scheduled_at ist der frühestmögliche Zeitpunkt, ohne Garantie einer sekundengenauen Zustellung.
Prüfe vor einem erneuten Versuch den Auftragsstatus und die Ergebnisse je Gruppe. Brich nur Sendungen ab, die noch nicht gestartet wurden. Widerrufe einen kompromittierten Schlüssel in Einstellungen und erstelle und speichere anschließend einen Ersatz; alte Aufträge werden mit einem neuen Schlüssel nicht fortgesetzt.

Ausgearbeitetes Beispiel

Anfragen mit Platzhaltern; ersetze die IDs und wähle vor dem Senden ein zukünftiges Datum. Diese Anfragen veröffentlichen echte Nachrichten. curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'

So prüfst du das Ergebnis

Die Annahme des Auftrags und angenommene Gruppenergebnisse bestätigen die Annahme durch das Gateway. Sie bestätigen weder die Zustellung noch das Lesen. Geplante Aufträge können blockiert werden, wenn sich Zugriff, Schlüssel, Konto oder Gruppenberechtigungen ändern.

Was du wissen solltest

Assistenten können bereitgestellte Einträge lesen und beauftragten Text senden. Lies vor einer Versandanfrage die Anleitung Assistentenwerkzeuge.
Nutze das Dashboard für Bearbeitungen, die MCP nicht anbietet.
Der API-Zugriff ist in den monatlichen und jährlichen Pro- und Agency-Abonnements enthalten. Starter erfordert einen Tarifwechsel. Schlüssel erlauben nur das ausgewählte Konto und die ausgewählten Gruppen; ein Austausch des WhatsApp-Kontos blockiert das Senden. Gib niemals Serverzugangsdaten weiter.
Texte unterstützen 4.096 Zeichen, Bildunterschriften 1.024. Lade JPEG-, PNG- oder WebP-Dateien mit bis zu 5 MiB über die Multipart-Felder payload und image hoch. Externe Bild-URLs werden nicht akzeptiert.
Ein neuer Auftrag gibt HTTP 202 zurück. Eine identische Wiederholung mit demselben Idempotency-Key liefert den ursprünglichen Auftrag mit HTTP 200; andere Inhalte mit demselben Schlüssel führen zu 409. Eine Zeitüberschreitung nach Beginn des Versands kann ein unbestätigtes Ergebnis hinterlassen; übermittle die Anfrage nicht automatisch mit einem anderen Schlüssel erneut.

Häufige Probleme

Was du siehst: Nach dem Test erscheint weder Antwort noch neuer Eintrag.
Was du tun kannst: Prüfe Verbindung und Regel oder Protokoll-Einstellung und bitte den Betreiber um Prüfung eingehender Ereignisse.
Erwartetes Ergebnis: Eine korrekt eingerichtete Funktion verarbeitet neue passende Ereignisse.

Was du siehst: Der Assistent kann nicht autorisieren oder zeigt ein anderes Konto.
Was du tun kannst: Kehre zur Anmeldung zurück und wähle das gewünschte Konto; melde wiederholte Autorisierungsfehler dem Betreiber.
Erwartetes Ergebnis: Autorisierungsansicht und Einträge gehören zum gewünschten Konto.

Weitere Hilfe

Nenne dem Betreiber Funktion und sichtbaren Fehler. Teile keine Serverzugangsdaten in Assistentengesprächen.

Funktion öffnen