Enviar plantilla - Insurance Boosters API

POST

{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

x-ib-api-key

string

header

required

API key emitida por Insurance Boosters.

Path Parameters

phoneNumberId

string

required

Identificador de tu línea de WhatsApp. Solicítalo con tu ejecutivo de cuenta.

Example:

"123456789012345"

Body

application/json

string

required

Teléfono del destinatario en formato E.164 (solo dígitos, sin +). Ejemplo México: 5215512345678.

name

string

required

Nombre exacto de la plantilla aprobada.

language

string

default:es

Código de idioma de la plantilla. Por defecto es.

Example:

"es"

components

(Encabezado (header) · object | Cuerpo (body) · object | Botón (button) · object)[]

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

inactiveBot

boolean

default:false

Si es true, desactiva respuestas automáticas para ese contacto tras el envío.

Response

Plantilla enviada correctamente.

messaging_product

enum<string>

Available options:

whatsapp

contacts

object[]

Show child attributes

messages

object[]

Show child attributes

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

​Endpoint

​Parámetro de ruta

​Body

​Ejemplo mínimo

​Elige el payload correcto

​Errores frecuentes

Authorizations

Path Parameters

Body

Response

Endpoint

Parámetro de ruta

Body

Ejemplo mínimo

Elige el payload correcto

Errores frecuentes