Enviando Mensajes de WhatsApp por API de WhatChimp — Mensajes de Texto vs Plantilla
El error más común de API explicado: cuándo usar mensajes de texto vs mensajes de plantilla, cómo funciona la ventana de 24 horas y cómo enviar mensajes de plantilla con variables.
Updated 5 February 2026
La API de WhatChimp te permite enviar dos tipos de mensajes de WhatsApp: mensajes de texto (mensajes de sesión) y mensajes de plantilla. Usar el tipo incorrecto es la razón más común por la que fallan los mensajes API — esta guía explica la diferencia.
El Error #1: Enviar Notificaciones como Mensajes de Texto
La mayoría de los desarrolladores comienzan con el endpoint Send Message, lo hacen funcionar en pruebas y luego intentan usarlo para enviar notificaciones o seguimientos. Esto fallará.
WhatsApp impone una ventana de sesión de 24 horas. Solo puedes enviar mensajes de texto dentro de las 24 horas del último mensaje del cliente. Después de eso, la API devuelve un error.
Si quieres enviar notificaciones, recordatorios, actualizaciones de pedidos u OTPs — debes usar un mensaje de plantilla.
Mensajes de Texto vs Mensajes de Plantilla
| Mensaje de Texto (Sesión) | Mensaje de Plantilla | |
|---|---|---|
| ¿Cuándo puedes enviarlo? | Solo dentro de 24 horas del último mensaje del cliente | En cualquier momento — sin restricción de tiempo |
| Contenido | Cualquier texto que quieras | Debe usar una plantilla pre-aprobada |
| Caso de uso | Responder consultas de clientes | Notificaciones, recordatorios, actualizaciones, OTPs |
| ¿Se necesita aprobación? | No | Sí — las plantillas deben ser aprobadas por Meta |
| API endpoint | POST /api/v1/whatsapp/send | POST /api/v1/whatsapp/send (mismo endpoint, parámetros diferentes) |
| Costo | Parte de conversación iniciada por el cliente | Conversación iniciada por el negocio (nivel de precios diferente) |
Guía Rápida de Decisión
¿Necesitas enviar un mensaje?
│
├── ¿El cliente está chateando contigo actualmente (dentro de 24 horas)?
│ ├── SÍ → Usa Mensaje de Texto (mensaje de sesión)
│ └── NO → Usa Mensaje de Plantilla
│
├── ¿Estás enviando una notificación, recordatorio o actualización?
│ └── Siempre usa Mensaje de Plantilla
│
├── ¿Estás enviando un OTP o código de verificación?
│ └── Usa Mensaje de Plantilla (tipo Authentication)
│
└── ¿No estás seguro?
└── Usa Mensaje de Plantilla (siempre funciona)Guías Detalladas
Video: https://www.youtube.com/watch?v=czd3S5cBHvY
Cada tipo de mensaje tiene su propia guía detallada con referencia completa de API, ejemplos de código y capturas de pantalla:
- Enviar Mensajes de Texto de 24 Horas por API de WhatChimp — Cómo funciona la ventana de sesión, parámetros API, ejemplos curl y manejo de errores
- Enviar Mensajes de Plantilla por API de WhatChimp — Cómo crear plantillas, usar el Template Message Generator, enviar con variables y solucionar errores
Artículos Relacionados
- Comenzando con la Developer API de WhatChimp — Configuración de API, autenticación y inicio rápido
- Creando una Message Template de WhatsApp en WhatChimp — Guía paso a paso de creación de plantillas
- WhatChimp Messaging API — Referencia completa de messaging API (todos los endpoints)