Resumen
Envíe una plantilla v2 aprobada por Meta a un número de teléfono. A diferencia del envío v1 (contact_id), el envío v2 acepta to y country_code, body_params opcionales para marcadores {{N}}, botones URL dinámicos o COPY_CODE, medios de encabezado por destinatario y otp_code para plantillas AUTHENTICATION. Endpoint: POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send — sin barra final.
POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send
Autentíquese con Authorization: Bearer <token>. Envíe un cuerpo JSON con to, country_code y los campos opcionales siguientes.
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"]
}'Notas de uso
⚠️ Nota: el recuento de body_params debe coincidir exactamente con los marcadores {{N}} del cuerpo de la plantilla. Si no, HTTP 400. ⚠️ Nota: otp_code no puede combinarse con body_params o buttons. Úselo solo con plantillas AUTHENTICATION.
Consejo: los endpoints v2 no usan barra final. Use /api/v2/whatsapp/templates/{id}/send no /api/v2/whatsapp/templates/{id}/send/
Notas de integración
Al integrar este endpoint de Buzzbip, use https://app.buzzbip.com como host de producción. Obtenga JWT de POST /api/login_check y envíe Authorization: Bearer en cada solicitud. Confirme que User.hasApiAccess está habilitado en el admin de Buzzbip. Las rutas WhatsApp v2 no usan barra final. Implemente reintentos con backoff ante límites de tasa. Guarde credenciales en el servidor y reautentíquese antes del vencimiento JWT (3600 s).
Seguridad
Buenas prácticas: credenciales solo en servidor, TLS obligatorio, monitorear fallos de autenticación. Separe cuentas staging y producción. Documente plantillas y automatizaciones. Redacte números y contenido en registros compartidos.
¿Qué sigue?
Páginas relacionadas: api/v2/whatsapp-media api/v2/whatsapp-templates guides/whatsapp-v2-use-cases guides/whatsapp-common-gotchas