Übersicht
Senden Sie eine von Meta genehmigte v2-Vorlage an eine Telefonnummer. Anders als v1-Send (contact_id) akzeptiert v2-Send to und country_code, optionale body_params für {{N}}-Platzhalter, dynamische URL- oder COPY_CODE-Buttons, Header-Medien pro Empfänger und otp_code für AUTHENTICATION-Vorlagen. Endpunkt: POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send — ohne abschließenden Slash.
POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send
Authentifizieren Sie mit Authorization: Bearer <token>. Senden Sie einen JSON-Body mit to, country_code und optionalen Feldern unten.
curl --request POST \
'https://app.buzzbip.com/api/v2/whatsapp/templates/1289/send' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_JWT' \
--data '{
"to": "21696816277",
"country_code": "TN",
"body_params": ["Sam", "ORD-2026-00041"]
}'Hinweise zur Nutzung
⚠️ Hinweis: Die Anzahl von body_params muss exakt der Anzahl der {{N}}-Platzhalter im Vorlagentext entsprechen. Sonst HTTP 400. ⚠️ Hinweis: otp_code darf nicht mit body_params oder buttons kombiniert werden. Nur für AUTHENTICATION-Vorlagen.
Tipp: v2-Endpunkte haben keinen abschließenden Slash. Verwenden Sie /api/v2/whatsapp/templates/{id}/send nicht /api/v2/whatsapp/templates/{id}/send/
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. v2-WhatsApp-Routen haben keinen abschließenden Slash. 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/v2/whatsapp-media api/v2/whatsapp-templates guides/whatsapp-v2-use-cases guides/whatsapp-common-gotchas
