Skip to main content

​
Requisitos

Para enviar por WhatsApp necesitas:
  1. Una cuenta de Meta Business con número verificado
  2. Templates aprobados por Meta (el proceso toma 24–48 h)
  3. Credenciales configuradas en el dashboard: phone_number_id y access_token

​
Cómo funciona

WhatsApp Business API solo permite enviar mensajes de template (HSM) hacia usuarios fuera de una ventana de conversación activa. Los templates deben ser aprobados por Meta antes de poder usarlos. Las variables del template se pasan en orden como params: 
Template Meta: "Hola {{1}}, tu cita es el {{2}}."
params:        ["María", "15 de abril"]

​
Enviar un mensaje

curl -X POST https://comms.panzo.mx/v1/send/whatsapp \
  -H "Content-Type: application/json" \
  -H "X-API-Key: TU_API_KEY" \
  -d '{
    "phone_number":  "521234567890",
    "template_id":   "confirmacion_cita",
    "language_code": "es",
    "params":        ["María", "15 de abril", "10:00 AM"]
  }'

​
Parámetros

CampoTipoRequeridoDescripción
phone_numberstring✅Número en formato internacional sin + (ej. 521234567890)
template_idstring✅Nombre del template en Meta (snake_case)
language_codestring—Código de idioma del template. Default: es
paramsarray—Valores para {{1}}, {{2}}, etc. en orden

​
Gestionar templates

​
Desde el portal de tenant (/app/me/wa-templates)

Los tenants pueden ver sus templates disponibles con el ejemplo de llamada a la API. Si el administrador habilitó credenciales propias (allow_custom=true) para el canal WhatsApp, el tenant también puede crear, editar y eliminar sus templates directamente.

​
Desde el panel admin (/app/tenants/:id/wa-templates)

El administrador puede gestionar templates de cualquier tenant. Registra cada template con:
  • El nombre del template (debe coincidir exactamente con el aprobado en Meta)
  • El código de idioma
  • El esquema de parámetros (para documentar qué va en cada posición)
El nombre del template en el campo template_id debe ser exactamente el mismo que aparece en el Meta Business Manager, incluyendo mayúsculas/minúsculas.

​
Webhook de entrada

Meta envía eventos (mensajes recibidos, confirmaciones de entrega) a: 
POST https://comms.panzo.mx/webhook/whatsapp
La plataforma verifica la firma X-Hub-Signature-256 automáticamente.