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://api.axelo.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✅Alias amigable registrado en el dashboard, o el nombre exacto del template en Meta (snake_case). Axelo resuelve el alias automáticamente
language_codestring—Código de idioma. Si usas alias, se infiere del registro
paramsarray—Valores para {{1}}, {{2}}, etc. en orden

​
Alias de templates

Los templates con header media en Meta llevan un sufijo _hxXXXX... (hash del contenido) que es ilegible. Para usar nombres limpios en tu código, registra un alias en el dashboard:
Alias (wa_template_id)Nombre real en Meta (meta_name)
confirmaciontorneospro_confirmacion_hx97bb9c99ad7...
partidotorneospro_partido_v2_hxf2a40395f1d...
Después puedes llamar la API con "template_id": "confirmacion" y Axelo traduce al nombre real antes de enviar a Meta. Si el alias no existe en tu tenant, el template_id se manda tal cual.

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