WhatsApp
WhatsApp es el canal de mensajería más utilizado en Latinoamérica y permite a tu equipo mantener conversaciones bidireccionales con clientes a través de la API oficial de WhatsApp Business (Cloud API).
Requisitos previos
Antes de comenzar
- Una cuenta de Meta Business verificada
- Un número de teléfono dedicado para WhatsApp Business (no puede estar registrado en la app personal de WhatsApp)
- Acceso a la plataforma de Meta para desarrolladores
Configuración de Cloud API
Paso 1: Verificar tu negocio en Meta
- Accede a .
- Ve a Configuración del negocio > Verificación del negocio.
- Sube los documentos solicitados (registro mercantil, factura de servicios, etc.).
- Espera la aprobación de Meta (generalmente 1-5 días hábiles).
Paso 2: Crear la aplicación en Meta
- Ve a .
- Crea una nueva aplicación de tipo Business.
- Agrega el producto WhatsApp a tu aplicación.
- Copia el ID de número de teléfono, el ID de cuenta de WhatsApp Business y el Token de acceso permanente.
Paso 3: Conectar en Zelta Chat
- En Zelta Chat, ve a Ajustes > Canales > + Agregar canal.
- Selecciona WhatsApp.
- Completa los campos:
- Nombre del canal: Un nombre descriptivo (ej: "WhatsApp Ventas")
- Número de teléfono: Tu número con código de país
- ID de número de teléfono: Obtenido de Meta
- ID de cuenta de negocio: ID de tu cuenta de WhatsApp Business
- Token de acceso: Token permanente de la API
- Haz clic en Crear canal.
Paso 4: Configurar el webhook
Registro automático del webhook
Zelta Chat puede registrar el webhook automáticamente sin necesidad de acceder a la consola de Meta para Desarrolladores. En la configuración del canal (Ajustes > Canales > [Tu canal de WhatsApp] > Configuración), encontrarás un botón para registrar el endpoint del webhook directamente en Meta. Este es el método recomendado por su simplicidad.
Si prefieres configurar el webhook manualmente o si el registro automático no está disponible, sigue estos pasos:
- Después de crear el canal, Zelta Chat mostrará una URL de webhook y un Token de verificación.
- En la consola de Meta para Desarrolladores, ve a WhatsApp > Configuración.
- En la sección Webhook, pega la URL y el token de verificación proporcionados.
- Suscríbete a los campos:
messages,message_template_status_update.
Importante
El webhook debe estar correctamente configurado para recibir mensajes. Si no recibes mensajes de prueba después de configurarlo, verifica que la URL sea accesible públicamente y que el token coincida.
Plantillas de mensaje
Las plantillas son mensajes pre-aprobados por Meta que puedes enviar fuera de la ventana de conversación de 24 horas.
Crear una plantilla
- Ve a Ajustes > Canales > WhatsApp > Plantillas.
- Haz clic en + Nueva plantilla.
- Completa los campos:
- Nombre: Identificador interno (solo letras minúsculas y guiones bajos)
- Categoría: Marketing, Utilidad o Autenticación
- Idioma: Selecciona el idioma de la plantilla
- Encabezado (opcional): Texto, imagen, video o documento
- Cuerpo: El contenido del mensaje con variables
- Pie (opcional): Texto breve al final del mensaje
- Botones (opcional): Llamada a la acción o respuesta rápida
Variables en plantillas
Usa llaves dobles para insertar variables dinámicas en el cuerpo del mensaje:
Hola {{1}}, tu pedido #{{2}} ha sido confirmado.
La entrega estimada es el {{3}}.| Variable | Descripción |
|---|---|
{{1}} | Se reemplaza con el primer valor proporcionado al enviar |
{{2}} | Se reemplaza con el segundo valor |
{{n}} | Variables numeradas secuencialmente |
Proceso de aprobación
| Estado | Descripción |
|---|---|
| Pendiente | La plantilla fue enviada a Meta para revisión |
| Aprobada | Lista para usarse en conversaciones |
| Rechazada | No cumple las políticas de Meta; revisa y reenvía |
Consejo
Las plantillas de categoría Utilidad (confirmaciones de pedido, actualizaciones de envío, encuestas de satisfacción) tienen mayor tasa de aprobación que las de Marketing.
Plantillas para encuestas CSAT Nuevo
Puedes utilizar plantillas de WhatsApp para enviar encuestas de satisfacción (CSAT) cuando una conversación se resuelve. Para configurar esta funcionalidad, consulta la guía de .
Botones de llamada a la acción (CTA) Nuevo
Las plantillas ahora soportan botones de llamada a la acción (call-to-action) que permiten incluir enlaces URL dinámicos. Esto es útil para dirigir al cliente a una página específica, como el seguimiento de un pedido o un enlace de pago.
Para crear una plantilla con botón CTA:
- Al crear la plantilla, selecciona Botones > Llamada a la acción.
- Configura el texto del botón y la URL de destino.
- Usa variables en la URL si necesitas personalizar el enlace por cliente.
Ventana de conversación de 24 horas
WhatsApp impone una ventana de 24 horas para mensajes de formato libre:
- Dentro de las 24 horas: Puedes enviar cualquier tipo de mensaje (texto, imágenes, documentos) sin restricciones después de que el cliente te escriba.
- Fuera de las 24 horas: Solo puedes enviar plantillas de mensaje aprobadas para reiniciar la conversación.
- Reinicio de ventana: Cada mensaje del cliente reinicia el contador de 24 horas.
Regla de las 24 horas
Si intentas enviar un mensaje de formato libre fuera de la ventana, Zelta Chat te solicitará seleccionar una plantilla aprobada. Esto es un requisito de Meta, no una limitación de la plataforma.
Tipos de contenido soportado
| Tipo | Enviar | Recibir | Notas |
|---|---|---|---|
| Texto | Sí | Sí | Hasta 4,096 caracteres |
| Imágenes | Sí | Sí | JPEG, PNG (hasta 5 MB) |
| Video | Sí | Sí | MP4 (hasta 16 MB) |
| Documentos | Sí | Sí | PDF, DOC, XLS, etc. (hasta 100 MB) |
| Audio | Sí | Sí | MP3, OGG, AAC (hasta 16 MB) |
| Ubicación | Sí | Sí | Coordenadas con nombre del lugar |
| Contactos | No | Sí | Tarjetas de contacto vCard |
| Stickers | No | Sí | Stickers recibidos se muestran como imagen |
Estado de los mensajes
Zelta Chat muestra el estado de entrega de cada mensaje enviado:
| Indicador | Estado | Descripción |
|---|---|---|
| Reloj | Enviando | El mensaje está siendo procesado |
| Un check | Enviado | El mensaje llegó al servidor de WhatsApp |
| Doble check | Entregado | El mensaje llegó al dispositivo del cliente |
| Doble check azul | Leído | El cliente abrió y leyó el mensaje |
| Alerta roja | Error | El mensaje no pudo ser enviado |
Solución de problemas
| Problema | Solución |
|---|---|
| No se reciben mensajes | Verifica la configuración del webhook y que la URL sea accesible |
| Error al enviar plantillas | Confirma que la plantilla esté aprobada y los valores de variables sean correctos |
| Token expirado | Genera un nuevo token permanente en la consola de Meta |
| Número no verificado | Completa el proceso de verificación de número en Meta Business |
Soporte
Si tienes problemas con la configuración de WhatsApp, contacta a nuestro equipo al +507 6927 9551 para asistencia personalizada.