Lass einen Agenten WhatsApp-Nachrichten an deine Geschäftsnummer beantworten, auch mit Fotos und Dokumenten. Antworten gehen von derselben Nummer raus, und freigegebene Vorlagen erreichen alle, die in den letzten 24 Stunden nicht geschrieben haben.
- Modi
- Inbound, Outbound
- Einrichtung
- Dashboard oder connectors/*.yaml
- Dokumentation
- WhatsApp Docs
- Publisher
- Von connic
Setz einen Agenten auf deine Geschäftsnummer
Speichere eine Connection mit deiner Meta-App und wähle eine Telefonnummer. Sobald du eine eingehende Verbindung speicherst, leitet connic die Nachrichten dieser Nummer an den Agenten.
- Eine Connection pro Meta-App
- Die Connection enthält App ID, App Secret, Systemnutzer-Token und die ID des WhatsApp Business Accounts. Jede Verbindung darauf wählt eine Telefonnummer dieses Kontos.
- Webhook beim Speichern eingerichtet
- connic abonniert für die App das Konto und setzt die Callback-URL der Nummer. Andere Nummern behalten ihre Einstellungen, und beim Löschen der Verbindung entfernt connic die Callback-URL wieder.
- Eine eingehende Verbindung pro Nummer
- Eine Nummer schickt ihre Nachrichten an genau eine eingehende Verbindung. Ausgehende Verbindungen können von derselben Nummer senden.
Jede Nachricht geprüft und lesbar
WhatsApp signiert jede Zustellung mit deinem App Secret. connic prüft die Signatur und startet dann alle verknüpften Agenten mit Text, Absender und Datei.
- Geprüfte Zustellungen
- connic prüft X-Hub-Signature-256 mit dem App Secret. Stellt WhatsApp eine Nachricht erneut zu, landet sie im selben Run.
- Dateien aus der Nachricht
- Bilder, Audio, Video, Dokumente und Sticker kommen in files an, die Bildunterschrift als text. Dateien über 32 MB stehen in file_issues.
- Absender mit oder ohne Nummer
- from enthält die Telefonnummer, wenn die Person sie teilt. user_id kennzeichnet jeden Absender, und Antworten erreichen beide.
- Gesprächsverlauf
- conversation_id steht für eine Person an einer Nummer. Setze session.key auf input.conversation_id, dann teilen sich Folgenachrichten eine Session.
{
"message_id": "wamid.HBgNNDkxNzYxMjM0NTY3OBUCABIYFDNBRjQ2QkZBMEM2RDQ1NjE3MjAA",
"type": "text",
"text": "Has order ord_8812 shipped yet?",
"from": "+4917612345678",
"user_id": "US.13491208655302741918",
"name": "Jana",
"conversation_id": "whatsapp:9e0f77d9-2fd8-5a8e-8d47-59fbf5b8a091",
"raw": { ... }
}session:
key: input.conversation_id
ttl: 86400Innerhalb von 24 Stunden antworten oder eine Vorlage senden
Verknüpfe eine ausgehende Verbindung mit derselben Connection und Nummer. Sie sendet nach dem Run, wenn der Agent sie als Tool aufruft oder wenn Middleware sie aufruft.
- Reihenfolge der Empfänger
- Zuerst zählt ein ausdrückliches to, dann der Standardempfänger der Verbindung, dann die Person, die geschrieben hat.
- Antworten mit Text
- Bis zu 4.096 Zeichen, innerhalb von 24 Stunden nach der letzten Nachricht der Person.
- Freigegebene Vorlagen
- Außerhalb dieses Fensters sendest du template mit Name, Sprache und Parametern einer Vorlage, die Meta für dein Konto freigegeben hat.
- Zustellbestätigungen
- Die Ausgabe des Runs enthält die Nachrichten-ID von WhatsApp. Bestätigungen für gesendet, zugestellt, gelesen und fehlgeschlagen stehen in den Logs der eingehenden Verbindung auf derselben Nummer.
{
"text": "Yes, ord_8812 left our warehouse today and arrives on Friday."
}{
"to": "+4917612345678",
"template": {
"name": "appointment_reminder",
"language": "en_US",
"parameters": ["Jana", "10:30"]
}
}Beide Richtungen im Code festlegen
Lege die eingehende und die ausgehende Verbindung als YAML-Dateien in connectors/ an. Beide verweisen per Name auf die WhatsApp-Connection, die Dateien enthalten also keine Zugangsdaten, und jedes Deployment legt sie für seine Umgebung an oder aktualisiert sie.
type: whatsapp
mode: inbound
connection: support-whatsapp
config:
phone_number_id: "106540352242922"
agents:
- whatsapp-supporttype: whatsapp
mode: outbound
connection: support-whatsapp
config:
phone_number_id: "106540352242922"
agents:
- name: whatsapp-support
outbound: { usage: automatic, source: [support-whatsapp] }Wo WhatsApp passt
Wähle ein Szenario und sieh, was von WhatsApp ankommt und was der Agent zurückschickt.
Ein Kunde schickt ein Foto einer Fehlermeldung, und der Agent antwortet mit der Lösung.
{
"message_id": "wamid.HBgNNDkxNzYxMjM0NTY3OBUCABIYFDVBMjA0N0Q5RTQ2MEI3MUQ4NjAA",
"type": "image",
"text": "The coffee machine shows this error. What should I do?",
"from": "+4917612345678",
"user_id": "US.13491208655302741918",
"conversation_id": "whatsapp:4c2a9e1b-7f3d-5b8e-a6c4-0d2f8e1a3b5c",
"files": [
{
"name": "image-1184303612398871.jpg",
"mime_type": "image/jpeg",
"data": "<base64-bytes>",
"size": 182344
}
]
}{
"message_id": "wamid.HBgNNDkxNzYxMjM0NTY3OBUCABEYEjdCMjA5RjE0QzM2RDU4NEU2AA==",
"wa_id": "4917612345678"
}Ein Kunde fragt nach einer Bestellung, und der Agent schlägt sie nach und antwortet von deiner Nummer.
{
"message_id": "wamid.HBgNNDkxNzYxMjM0NTY3OBUCABIYFDNBRjQ2QkZBMEM2RDQ1NjE3MjAA",
"type": "text",
"text": "Has order ord_8812 shipped yet?",
"from": "+4917612345678",
"user_id": "US.13491208655302741918",
"conversation_id": "whatsapp:9e0f77d9-2fd8-5a8e-8d47-59fbf5b8a091"
}{
"message_id": "wamid.HBgNNDkxNzYxMjM0NTY3OBUCABEYEjFBM0Q1QzdFOUIyRjRBNkM4AA==",
"wa_id": "4917612345678"
}Ein täglicher Zeitplan startet den Agenten, und er schickt allen mit einem Termin am nächsten Tag eine freigegebene Vorlage.
{
"trigger": "cron",
"schedule": "0 7 * * *",
"triggered_at": "2026-10-14T07:00:00",
"prompt": "Remind every customer who has an appointment tomorrow."
}{
"to": "+4917612345678",
"template": {
"name": "appointment_reminder",
"language": "en_US",
"parameters": ["Jana", "10:30"]
}
}Ein Kunde tippt in der Erinnerung auf Verschieben, und der Agent schlägt freie Termine vor.
{
"message_id": "wamid.HBgNNDkxNzYxMjM0NTY3OBUCABIYFDhDMkU0QTZCOEQwRjJBNEM2RThBAA==",
"type": "button",
"text": "Reschedule",
"from": "+4917612345678",
"user_id": "US.13491208655302741918",
"conversation_id": "whatsapp:4c2a9e1b-7f3d-5b8e-a6c4-0d2f8e1a3b5c"
}{
"text": "No problem. Thursday 14:00 and Friday 9:30 are free. Which one suits you?"
}FAQ zu WhatsApp
Weitere Verbindungen
Apache Kafka
Agenten verarbeiten Kafka-Topics und veröffentlichen ihre Ergebnisse unter dem Key der Ausgangsnachricht wieder in Topics.
Inbound · Outbound
Cron-Scheduler
Ein Cron-Ausdruck legt fest, wann ein Agent ausgeführt wird. connic betreibt den Scheduler für tägliche Zusammenfassungen, stündliche Health-Checks und wöchentliche Audits.
Inbound
GitLab
Issues, Merge Requests und Kommentare in einem GitLab-Projekt lösen Agenten aus, auf gitlab.com oder deiner eigenen Instanz. Die Agenten antworten mit Kommentaren.
Inbound · Outbound
Linear
Neue und geänderte Issues und Kommentare in einem Linear-Team lösen Agenten aus. Die Agenten antworten im Kommentar-Thread oder legen neue Issues an.
Inbound · Outbound
Pipedrive
Neue, geänderte oder gelöschte Deals, Leads, Personen und Organisationen in Pipedrive lösen Agenten aus. Die Agenten halten ihr Ergebnis als Notiz am Datensatz fest.
Inbound · Outbound
WebSocket
Agenten streamen Tokens über eine bestehende Socket-Verbindung an den Browser. Chat-UIs behalten den Kontext über mehrere Nachrichten hinweg.
Sync