Plantillas
Enviar plantilla
Envía un mensaje de WhatsApp con una plantilla aprobada.
POST
/
whatsapp
/
{phoneNumberId}
/
template
curl --request POST \
--url https://api.insuranceboosters.com/api/v1/whatsapp/{phoneNumberId}/template \
--header 'Content-Type: application/json' \
--header 'x-ib-api-key: <api-key>' \
--data '
{
"to": "",
"name": ""
}
'{
"messaging_product": "whatsapp",
"contacts": [
{
"input": "<string>",
"wa_id": "<string>"
}
],
"messages": [
{
"id": "<string>"
}
]
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Envía una plantilla aprobada desde una de tus líneas de WhatsApp.
Endpoint
POST /whatsapp/{phoneNumberId}/template
Parámetro de ruta
| Parámetro | Descripción |
|---|---|
phoneNumberId | Identificador de la línea emisora. Solicítalo con tu ejecutivo de cuenta. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
to | string | Sí | Teléfono destino en E.164, solo dígitos y sin +. |
name | string | Sí | Nombre exacto de la plantilla aprobada. |
language | string | No | Idioma exacto de la plantilla. Default: es. |
components | array | No | Variables de header, body y button. Usa [] si no hay variables. |
inactiveBot | boolean | No | Desactiva respuestas automáticas para el contacto después del envío. |
Ejemplo mínimo
curl -X POST "https://api.insuranceboosters.com/api/v1/whatsapp/{phoneNumberId}/template" \
-H "Content-Type: application/json" \
-H "x-ib-api-key: TU_API_KEY" \
-d '{
"to": "<numero-e164>",
"name": "<nombre-plantilla>",
"language": "es",
"components": []
}'
Obtén
name, language, parameter_format y components con Listar plantillas antes de enviar.Elige el payload correcto
Usa las guías de Ejemplos cuando la plantilla incluya:- variables posicionales como
{{1}}; - variables con nombre como
{{nombre}}; - imagen, video o PDF en el header;
- botones dinámicos.
Errores frecuentes
| HTTP | Qué significa | Qué hacer |
|---|---|---|
400 | Falta un campo o el payload no coincide con la plantilla. | Compara el body con la estructura listada. |
401 | API key inválida o faltante. | Verifica x-ib-api-key. |
403 | La línea no pertenece a tu cuenta. | Confirma phoneNumberId. |
404 | La plantilla o la línea no existe. | Confirma name, language y phoneNumberId. |
Authorizations
API key emitida por Insurance Boosters.
Path Parameters
Identificador de tu línea de WhatsApp. Solicítalo con tu ejecutivo de cuenta.
Example:
"123456789012345"
Body
application/json
Teléfono del destinatario en formato E.164 (solo dígitos, sin +). Ejemplo México: 5215512345678.
Nombre exacto de la plantilla aprobada.
Código de idioma de la plantilla. Por defecto es.
Example:
"es"
Componentes dinámicos (header, body, button). Omitir o enviar [] si la plantilla no tiene variables.
- Encabezado (header)
- Cuerpo (body)
- Botón (button)
Show child attributes
Show child attributes
Si es true, desactiva respuestas automáticas para ese contacto tras el envío.
Was this page helpful?
curl --request POST \
--url https://api.insuranceboosters.com/api/v1/whatsapp/{phoneNumberId}/template \
--header 'Content-Type: application/json' \
--header 'x-ib-api-key: <api-key>' \
--data '
{
"to": "",
"name": ""
}
'{
"messaging_product": "whatsapp",
"contacts": [
{
"input": "<string>",
"wa_id": "<string>"
}
],
"messages": [
{
"id": "<string>"
}
]
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}