API-Referenz

Buzzbip — Vorlage senden v2 API

POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send mit to, country_code, body_params, buttons, header_media_id und otp_code.

Ü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"]
  }'

Parameter	Type	Required	Description
`TEMPLATE_ID`	`integer`	Required	Template id (path). Must be APPROVED before sending.
`to`	`string`	Required	Recipient phone, digits only, no +, no spaces, no dashes. Example: "21696816277"
`country_code`	`string`	Required	ISO 3166-1 alpha-2 country code. Examples: TN, SA, FR, US, MA, DZ
`body_params`	`string[]`	Optional	Values for {{1}} {{2}} {{3}} body placeholders in order. Count must match placeholder count. Omit when template has no body placeholders.
`buttons`	`array`	Optional	Per-recipient button overrides. Each item: index (zero-based), sub_type (url or copy_code), value (replacement string).
`header_media_id`	`integer`	Optional	media_id from POST /api/v2/whatsapp/media. Overrides template header media for this send (IMAGE, VIDEO, DOCUMENT). User-scoped.
`document_filename`	`string`	Optional	Filename shown in WhatsApp for DOCUMENT headers. Ignored for IMAGE and VIDEO.
`otp_code`	`string`	Optional	AUTHENTICATION templates only. API inserts code into body and Copy Code button. Cannot combine with body_params or buttons.

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?

Was this helpful?

API-Referenz

Buzzbip — Vorlage senden v2 API

POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send mit to, country_code, body_params, buttons, header_media_id und otp_code.

Übersicht

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"]
  }'

Parameter	Type	Required	Description
`TEMPLATE_ID`	`integer`	Required	Template id (path). Must be APPROVED before sending.
`to`	`string`	Required	Recipient phone, digits only, no +, no spaces, no dashes. Example: "21696816277"
`country_code`	`string`	Required	ISO 3166-1 alpha-2 country code. Examples: TN, SA, FR, US, MA, DZ
`body_params`	`string[]`	Optional	Values for {{1}} {{2}} {{3}} body placeholders in order. Count must match placeholder count. Omit when template has no body placeholders.
`buttons`	`array`	Optional	Per-recipient button overrides. Each item: index (zero-based), sub_type (url or copy_code), value (replacement string).
`header_media_id`	`integer`	Optional	media_id from POST /api/v2/whatsapp/media. Overrides template header media for this send (IMAGE, VIDEO, DOCUMENT). User-scoped.
`document_filename`	`string`	Optional	Filename shown in WhatsApp for DOCUMENT headers. Ignored for IMAGE and VIDEO.
`otp_code`	`string`	Optional	AUTHENTICATION templates only. API inserts code into body and Copy Code button. Cannot combine with body_params or buttons.

Hinweise zur Nutzung

Tipp: v2-Endpunkte haben keinen abschließenden Slash. Verwenden Sie /api/v2/whatsapp/templates/{id}/send nicht /api/v2/whatsapp/templates/{id}/send/

Integrationshinweise

Sicherheit

Wie geht es weiter?

Was this helpful?

Buzzbip — Vorlage senden v2 API

Übersicht

POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send

Hinweise zur Nutzung

Integrationshinweise

Sicherheit

Wie geht es weiter?

Need help with your integration?

Buzzbip — Vorlage senden v2 API

Übersicht

POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send

Hinweise zur Nutzung

Integrationshinweise

Sicherheit

Wie geht es weiter?

Need help with your integration?