Skip to main content
POST
Guía de Enviar plantilla · Tipos de plantilla Usa este payload cuando la plantilla aprobada en Meta contiene un botón FLOW. El flow_id ya forma parte de la plantilla aprobada y no se repite al enviar el mensaje.

Qué representa flow_token

flow_token es el identificador opaco de una instancia o sesión del Flow. No es una API key ni una credencial de autenticación. Permite correlacionar:
  • el envío de la plantilla;
  • las consultas intermedias al Data Endpoint;
  • la respuesta final;
  • el contacto, mensaje y contexto de negocio originales.
Si el Flow usa un Data Endpoint, cada envío necesita un valor único. Puedes proporcionar tu propio UUID u omitir flow_token para que la API genere uno. No uses valores secuenciales ni incluyas datos personales. Meta devuelve exactamente el valor enviado al Data Endpoint.
Cuando omites flow_token, Insurance Boosters genera un UUID antes de enviar la plantilla a Meta y registra automáticamente ese mismo valor con el Flow y el contexto del envío. Si envías la plantilla directamente a Meta, esta generación y asociación automáticas no ocurren.

Datos iniciales opcionales

Puedes agregar flow_action_data dentro de action para enviar datos iniciales definidos por la primera pantalla:
message_status: "accepted" confirma que Meta aceptó la solicitud; no confirma todavía la entrega al destinatario ni la finalización del Flow.

Errores frecuentes

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
to
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.

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[]
messages
object[]