API-Dokumentation
Wir geben Ihnen eine API, und Sie bauen darauf auf. Beispiele in cURL, Node.js, PHP und Python. Die Beispiele hier verwenden Platzhalter (wc_live_…, conn_…); im Panel erscheinen sie mit Ihren echten Daten.
OpenAPI-Spezifikation
Die öffentliche API (/v1) in einer einzigen OpenAPI-3.1-Datei: Importieren Sie sie in Postman/Insomnia, erzeugen Sie einen Client in Ihrer Sprache oder geben Sie sie einem KI-Agenten, damit er die API nutzen kann, ohne HTML zu lesen.
Erste Schritte
Bevor Sie eine Zeile Code schreiben, sollten Sie wissen, was Meta von Ihnen verlangt — der Teil, der nicht von uns abhängt: eine eigene Nummer, ein Facebook-Konto mit Business-Portfolio, eine Karte in Ihrem Meta-Konto und — wenn Sie zuerst schreiben möchten — eine freigegebene Vorlage. Nichts davon kostet hier etwas, und zum Lesen müssen Sie sich nicht registrieren. Sechs kurze Schritte, in der Reihenfolge, in der sie wirklich passieren.
Sobald Sie ein Konto haben, zeigt Ihnen das Panel, welcher dieser sechs Schritte Ihnen noch fehlt, mit dem echten Status Ihrer Nummer. Jetzt starten.
- ① Bevor Sie verbinden — was Sie brauchen
- ② Während Sie verbinden
- ③ Die Formalitäten bei Meta, nach Dringlichkeit
- ④ Was eine Vorlage ist (und warum es sie gibt)
- ⑤ Zum Senden
- ⑥ Was Meta berechnet und was WAIA Connect berechnet
- ⑦ Migrating from another provider
Technische Dokumentation auf Englisch. Die ersten Schritte gibt es auf Deutsch; die API-Referenz (Endpunkte, Webhooks, Fehler) ist auf Englisch.
Grundlagen
- Authentication GET /v1/connections
- Send a text message POST /v1/messages
- Send media (image · document · audio · video) POST /v1/messages
- Receive messages by webhook
- Authenticate the webhook: static header vs signature
- Verify the signature
- Check a message's status GET /v1/messages/:id
- Mark a message as read (and show "typing…") POST /v1/messages/read
- Download inbound media GET /v1/media/:mediaId
- Receive the Coexistence conversation history GET /v1/connections/:id/history
Vollständig
- Send a template POST /v1/messages
- Send a template with a file in its header POST /v1/messages
- Templates with an image, a document and buttons POST /v1/messages
- Create templates with an image, document and buttons POST /v1/templates/media
- Carousel templates (cards with an image or video) POST /v1/templates
- Create, list and sync templates POST /v1/templates
- Connections and their health GET /v1/connections
- Email notices and the Notices inbox GET /v1/notices
- Hosted onboarding (your customer connects their number) POST /v1/onboarding-links
- Webhooks with the API (and the one born with the onboarding) POST /v1/webhooks
- Integrator journey: onboarding and webhooks 100 % by API GET /v1/onboarding-links/{id}
- Onboarding link intro page: full or minimal PATCH /v1/onboarding-links/{id}
- Automatic help on the signup screen PUT /v1/branding
- Your customers' sign-up cases and «Handled» GET /v1/onboarding-cases
- Templates proposed by your customer POST /v1/template-links
- Usage and limits GET /v1/usage
- Rate limits (per number, per account, per key) POST /v1/messages
- Catalog shopping carts
- Edited and deleted messages
- The 26 event types with their payload
- The full error catalog
- Idempotency, retries and delivery order
Anleitungen
- Ihr WhatsApp mit WAIA Connect verbinden (Coexistence), Schritt für Schritt
- WhatsApp in n8n: der komplette Kundenservice-Workflow, kostenlos
- Receive WhatsApp in Supabase with an Edge Function
- Connect WhatsApp to Google Sheets (Apps Script, no coding)
Sicherheit und Daten
Passt etwas nicht zusammen? Schreiben Sie uns Ihre Frage oder fragen Sie ein Angebot an.