🟢 Documentación: WhatsApp
WhatsApp Business. Qué es, cómo funciona y cómo se usa — explicado paso a paso.
🟢 Definición — Módulo WhatsApp
El módulo WhatsApp usa WhatsApp Business para conversar con clientes por WhatsApp desde los números de la empresa. Incluye bandeja de conversaciones, envío de texto y multimedia, plantillas aprobadas y bots de flujo con menús interactivos y opt-in.
🗺️ Diagrama
Puede enviar WhatsApp desde el Portal, el API y la App Softphone; y recibir las respuestas del cliente por webhook. Todo pasa por UCaaS y el Proveedor de WhatsApp.
Recibir: el cliente escribe → el proveedor envía un webhook a UCaaS → aparece en la bandeja, la App Softphone y el historial; si el número tiene un bot activo, responde. Esa respuesta abre la ventana de 24 h.
📘 Explicación (paso a paso)
- El número debe estar registrado en WhatsApp Business (WABA) y verificado con el proveedor de WhatsApp.
- Para iniciar una conversación (fuera de 24 h) use una plantilla aprobada; dentro de la ventana puede enviar texto y multimedia libres.
- Las respuestas del cliente llegan por webhook a la bandeja y quedan registradas.
- Opcional: un bot de flujo atiende con menús interactivos, valida el opt-in por número y hace traspaso a un asesor.
- Por API: puede enviar WhatsApp por programación desde el API de TelHarbor:
POST /v1/whatsapp/send. Vea la Documentación del API. - App Softphone: también puede enviar y recibir WhatsApp desde la app TelHarbor UCaaS Desktop, con su bandeja de conversaciones integrada.
Importante: las plantillas las aprueba el proveedor de WhatsApp y tienen categoría (Utilidad / Marketing / Autenticación). Las notificaciones automáticas (ej. buzón de voz) usan plantillas de Utilidad.
🎬 Video: recorrido por el módulo WhatsApp
Unos tres minutos: cómo entrar con seguridad (contraseña y código de verificación), enviar con texto libre o con plantilla, la regla de las 24 horas, llamar por WhatsApp, la bandeja, responder desde el hilo y ver archivos. Tiene narración: active el sonido.
Datos de ejemplo con nombres, números y archivos ficticios. Debajo, la misma página explicada punto por punto.
📤 Enviar un WhatsApp con texto libre
Arriba a la izquierda el formulario de envío; a la derecha, el estado del módulo.
Datos de ejemplo: usuario, empresa, números, mensajes y archivos ficticios (los teléfonos usan rangos que no se pueden asignar). Toque la imagen para verla en tamaño completo.
- 1Origen
El número de WhatsApp de su empresa desde el que sale el mensaje.
- 2Modo de envío
Texto libre para escribir lo que quiera, o Template para usar una plantilla aprobada.
- 3Destino
El número del cliente, con su código de país.
- 4Mensaje
El texto que va a recibir el cliente.
- 5Enviar WhatsApp
Lo envía y lo deja registrado en la bandeja con su estado. Refrescar bandeja vuelve a leer la lista.
- 6Llamar por WhatsApp
Llama al cliente por WhatsApp y la llamada suena en la extensión escrita en Ext. agente. WhatsApp puede pedirle permiso al cliente la primera vez.
- 7Resumen
Recibidos, en cola, enviados, fallidos, hilos abiertos y archivos multimedia.
Importante: WhatsApp solo permite texto libre dentro de las 24 horas siguientes al último mensaje del cliente. Fuera de esa ventana, o para escribirle primero, hay que usar una plantilla aprobada.
📋 Enviar con una plantilla
Al elegir Template en el modo de envío aparecen la plantilla, el idioma y sus variables.
Datos de ejemplo: usuario, empresa, números, mensajes y archivos ficticios (los teléfonos usan rangos que no se pueden asignar). Toque la imagen para verla en tamaño completo.
- 1Modo Template
Obligatorio para escribirle primero a un cliente o fuera de las 24 horas.
- 2Plantilla
Las plantillas aprobadas de su número, con su nombre.
- 3Idioma
El idioma en que se aprobó la plantilla (por ejemplo
es). - 4Guía de la plantilla
Muestra el mensaje exacto que va a recibir el cliente y qué va en cada espacio
{{1}},{{2}}…, con un ejemplo de cada uno. - 5Variables
Un valor por línea, en el mismo orden de la guía.
- 6Enviar WhatsApp
Envía la plantilla ya completa.
📥 La bandeja de WhatsApp
Debajo del formulario, todo lo que entró y salió, con sus filtros.
Datos de ejemplo: usuario, empresa, números, mensajes y archivos ficticios (los teléfonos usan rangos que no se pueden asignar). Toque la imagen para verla en tamaño completo.
- 1Cuántos hay
El total de mensajes con los filtros aplicados.
- 2Filtros
Dirección, estado, y un buscador por número o texto. Filtrar aplica lo elegido.
- 3Las columnas
Fecha, dirección, origen, destino, mensaje, estado, usuario que lo envió y multimedia.
- 4Estado
queued en cola, sent enviado, delivered entregado, read leído, received entrante y failed fallido.
- 5Multimedia
Indica si el mensaje trae una imagen, un documento, un audio o un video.
- 6Acciones
Ver hilo abre la conversación completa y Responder le escribe de una vez.
💬 El hilo y la respuesta
La conversación completa con un contacto, sin salir de la página.
Datos de ejemplo: usuario, empresa, números, mensajes y archivos ficticios (los teléfonos usan rangos que no se pueden asignar). Toque la imagen para verla en tamaño completo.
- 1Con quién
El contacto y el mensaje desde el que abrió el hilo.
- 2Mensajes entrantes
Lo que escribió el cliente, con fecha y estado.
- 3Mensajes salientes
Lo que respondió su empresa, con fecha y estado.
- 4Adjuntos
Los archivos que vinieron en la conversación, con Vista previa y Descargar.
- 5Responder
Escriba aquí: sale del mismo número de la conversación.
- 6Enviar respuesta
La manda y la agrega al hilo. Recargar hilo trae lo que haya llegado mientras escribía.
Importante: WhatsApp solo permite texto libre dentro de las 24 horas siguientes al último mensaje del cliente. Fuera de esa ventana, o para escribirle primero, hay que usar una plantilla aprobada.
🖼️ Ver los archivos sin descargarlos
Al tocar Vista previa en un adjunto, el archivo se abre dentro del mismo hilo.
Datos de ejemplo: usuario, empresa, números, mensajes y archivos ficticios (los teléfonos usan rangos que no se pueden asignar). Toque la imagen para verla en tamaño completo.
- 1Responder
El cuadro de respuesta sigue a mano mientras mira el archivo.
- 2Vista previa multimedia
Aquí se abren imágenes, PDF, audios y videos.
- 3El archivo
El contenido del archivo que mandó el cliente, por ejemplo un comprobante de pago.