Skip to content

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

  1. Accede a .
  2. Ve a Configuración del negocio > Verificación del negocio.
  3. Sube los documentos solicitados (registro mercantil, factura de servicios, etc.).
  4. Espera la aprobación de Meta (generalmente 1-5 días hábiles).

Paso 2: Crear la aplicación en Meta

  1. Ve a .
  2. Crea una nueva aplicación de tipo Business.
  3. Agrega el producto WhatsApp a tu aplicación.
  4. 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

  1. En Zelta Chat, ve a Ajustes > Canales > + Agregar canal.
  2. Selecciona WhatsApp.
  3. 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
  4. 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:

  1. Después de crear el canal, Zelta Chat mostrará una URL de webhook y un Token de verificación.
  2. En la consola de Meta para Desarrolladores, ve a WhatsApp > Configuración.
  3. En la sección Webhook, pega la URL y el token de verificación proporcionados.
  4. 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

  1. Ve a Ajustes > Canales > WhatsApp > Plantillas.
  2. Haz clic en + Nueva plantilla.
  3. 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}}.
VariableDescripció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

EstadoDescripción
PendienteLa plantilla fue enviada a Meta para revisión
AprobadaLista para usarse en conversaciones
RechazadaNo 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:

  1. Al crear la plantilla, selecciona Botones > Llamada a la acción.
  2. Configura el texto del botón y la URL de destino.
  3. 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

TipoEnviarRecibirNotas
TextoHasta 4,096 caracteres
ImágenesJPEG, PNG (hasta 5 MB)
VideoMP4 (hasta 16 MB)
DocumentosPDF, DOC, XLS, etc. (hasta 100 MB)
AudioMP3, OGG, AAC (hasta 16 MB)
UbicaciónCoordenadas con nombre del lugar
ContactosNoTarjetas de contacto vCard
StickersNoStickers recibidos se muestran como imagen

Estado de los mensajes

Zelta Chat muestra el estado de entrega de cada mensaje enviado:

IndicadorEstadoDescripción
RelojEnviandoEl mensaje está siendo procesado
Un checkEnviadoEl mensaje llegó al servidor de WhatsApp
Doble checkEntregadoEl mensaje llegó al dispositivo del cliente
Doble check azulLeídoEl cliente abrió y leyó el mensaje
Alerta rojaErrorEl mensaje no pudo ser enviado

Solución de problemas

ProblemaSolución
No se reciben mensajesVerifica la configuración del webhook y que la URL sea accesible
Error al enviar plantillasConfirma que la plantilla esté aprobada y los valores de variables sean correctos
Token expiradoGenera un nuevo token permanente en la consola de Meta
Número no verificadoCompleta 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.

Documentación oficial de Zelta