La integración de WhatsApp Business permite enviar notificaciones automáticas (confirmaciones, recordatorios) y recibir mensajes de tus pacientes directamente desde la plataforma. Esta guía cubre todos los modos de conexión, la configuración paso a paso, y las herramientas disponibles.
1. Modos de Conexión
La plataforma soporta cuatro modos de integración con WhatsApp. El modo ideal depende de tu plan y necesidades:
| Modo | Descripción | Plan | Configuración |
|---|---|---|---|
Gestionado | Usás el número de WhatsApp de la plataforma. Sin configuración técnica. | Pro | Automática |
Meta Embedded | Conectás tu cuenta de Meta Business directamente con un flujo guiado (signup embebido). | Business | Guiada (3 pasos) |
Meta Propia (BYON) | Configuración manual con tus credenciales de la API de Meta (Phone Number ID, WABA ID, Access Token). | Business | Manual (5 pasos) |
2. Conexión Rápida: Meta Embedded Signup
El modo Embedded Signup es la forma más sencilla de conectar tu propio número de WhatsApp Business. El flujo guiado se realiza directamente desde la plataforma sin salir del navegador.
Si compartís pantalla con alguien que te está ayudando, hacé el paso vos, o abrí una ventana de incógnito para que Facebook te pida las credenciales.
Pasos
- Ingresá a Configuración → Integraciones → WhatsApp.
- Hacé clic en “Conectar con Facebook”. Se abrirá una ventana de Meta. Verificá que estés entrando con tu cuenta de Facebook.
- Seleccioná tu cuenta de Meta Business y el número de teléfono que querés vincular.
🇦🇷 Si tu número es de Argentina, asegurate de que incluya el 9 después del +54 (ej: +54 9 2324 404445). - Autorizá los permisos solicitados (
whatsapp_business_managementywhatsapp_business_messaging). - La plataforma recibirá automáticamente las credenciales y configurará el webhook. ¡Listo! Ya podés enviar mensajes.
3. Conexión Manual: BYON (Bring Your Own Number)
Si preferís configurar manualmente tu integración de Meta, podés usar el asistente de 5 pasos disponible en la sección de integraciones.
Paso 1 — Bienvenida
Se muestra información sobre los requisitos y lo que vas a necesitar tener a mano.
Paso 2 — Credenciales
Ingresá los siguientes datos de tu aplicación de Meta:
- Phone Number ID: El identificador de tu número de teléfono en la API de WhatsApp Cloud.
- WABA ID: El ID de tu cuenta de WhatsApp Business API.
- Access Token: Token permanente de tu aplicación de Meta con permisos de mensajería.
- Número de WhatsApp: Tu número completo con código de país (ej: +5491112345678).
Paso 3 — Configuración de Webhook
La plataforma te proporcionará una URL de webhook y un token de verificación que debés configurar en el panel de desarrolladores de Meta:
- Entrá a developers.facebook.com
- Navegá a tu app → WhatsApp → Configuración.
- En la sección Webhook, pegá la URL y el token que te dio la plataforma.
- Suscribite al campo messages.
Paso 4 — Test de Envío
Se enviará un mensaje de prueba al número configurado para verificar que todo funciona correctamente.
Paso 5 — Completado
Si el test fue exitoso, la integración queda activa. Podés empezar a enviar notificaciones y recibir mensajes.
4. Plantillas de Mensaje
Las plantillas son mensajes predefinidos que la plataforma envía automáticamente en momentos clave del flujo de turnos. Cada plantilla usa variables dinámicas que se reemplazan con los datos reales del turno.
Plantillas del Sistema
| Plantilla | Cuándo se Envía | Variables |
|---|---|---|
| Turno Creado | Al confirmar una nueva reserva de turno | patient_name, date, time, service, provider, location |
| Turno Confirmado | Cuando el profesional confirma un turno pendiente | patient_name, date, time, provider |
| Recordatorio 24h | Automático, 24 horas antes del turno | patient_name, date, time, provider |
| Recordatorio 2h | Automático, 2 horas antes del turno | patient_name, date, time |
| Oferta Lista Espera | Cuando se libera un turno y hay pacientes en espera | patient_name, date, time, service |
Personalización de Plantillas
Desde Configuración → WhatsApp → Plantillas podés:
- Editar el texto de cada plantilla manteniendo las variables entre llaves (ej:
{patient_name}). - Activar o desactivar plantillas individuales según tus necesidades.
- Previsualizar cómo se verá el mensaje con datos de ejemplo.
5. Perfil Empresarial de WhatsApp
Si usás tu propio número (BYON o Embedded), podés editar el perfil empresarial de tu WhatsApp Business directamente desde la plataforma.
Campos editables
- Descripción corta (Acerca de): Hasta 139 caracteres. Se muestra en la info del contacto.
- Descripción larga: Hasta 512 caracteres. Más detalle sobre tu negocio.
- Dirección: La dirección física de tu consultorio.
- Email: Dirección de contacto.
- Sitios web: Hasta 2 URLs.
- Categoría (Vertical): El rubro de tu negocio (Salud, Belleza, Educación, etc.).
- Foto de perfil: Se recomienda una imagen cuadrada de al menos 640×640 px.
6. Envío Manual de Recordatorios
Además de los recordatorios automáticos (24h y 2h), podés enviar recordatorios manuales en cualquier momento desde varias ubicaciones del dashboard:
- Vista Hoy (Inbox): Cada turno tiene un botón de “Notificar” con el ícono de campana.
- Calendario Semanal: Desde el popup de detalle del turno.
- Detalle del Turno: Botón dedicado para reenviar confirmación o recordatorio.
El envío manual usa la plantilla de recordatorio configurada y consume mensajes de tu cuota mensual.
7. Logs de Mensajes
Desde Configuración → WhatsApp → Logs (pestaña Historial) podés ver un registro completo de todos los mensajes enviados y recibidos.
Información disponible en cada log
- Dirección: Si fue un mensaje EnviadooRecibido.
- Estado: Enviado, Entregado, Leído o Error.
- Número de teléfono: Del paciente destinatario.
- Contenido: Vista previa del mensaje.
- Fecha y hora: Timestamp exacto del envío/recepción.
- Proveedor: Canal por el cual se envió el mensaje.
Los logs se pueden filtrar por rango de fechas, dirección y estado, y se muestran paginados para facilitar la consulta.
8. Límites por Plan
Cada plan tiene un límite mensual de mensajes de WhatsApp. Cuando alcanzás el límite, los mensajes se encolan hasta el próximo período.
| Plan | Mensajes / Mes | WhatsApp Propio (BYON) | Asistente IA |
|---|---|---|---|
| Free | 0 | ❌ No | ❌ No |
| Pro | 300 | ❌ No | ✅ Sí |
| Business | 1.000 | ✅ Sí | ✅ Sí |
Podés ver tu consumo actual en Configuración → Plan y Facturación, donde se muestra una barra de progreso con el porcentaje de mensajes utilizados.
9. Opt-Out y Privacidad
Los pacientes pueden dejar de recibir mensajes en cualquier momento escribiendo “STOP”, “BAJA” o “NO QUIERO RECIBIR MÁS MENSAJES”. El sistema registra automáticamente la preferencia y deja de enviar notificaciones a ese número.
Si el paciente quiere volver a recibir mensajes, puede escribir “ACTIVAR”, “SUSCRIBIR” o “REACTIVAR”. El sistema lo re-suscribe automáticamente.
10. Seguridad
La integración de WhatsApp implementa múltiples capas de seguridad para proteger tus credenciales y la información de tus pacientes:
- Cifrado AES-256-GCM: Los Access Tokens se almacenan encriptados en la base de datos. Se descifran solo en memoria al momento de usar la API.
- App Secret Proof (HMAC-SHA256): Cada llamada a la API de Meta incluye una prueba criptográfica de autenticidad.
- Verificación de Webhook: Los webhooks entrantes se validan con el token de verificación y la firma HMAC del payload.
- Deduplicación: Los mensajes entrantes se deducen por ID para evitar procesamiento duplicado.
- Redacción de PII: Los logs del sistema enmascaran números de teléfono y datos sensibles.
11. Preguntas Frecuentes
¿Puedo usar mi número personal?
No se recomienda. WhatsApp Business API requiere un número que no esté vinculado a WhatsApp personal ni WhatsApp Business App. Lo ideal es usar un número dedicado.
¿Qué pasa si se me acaban los mensajes del mes?
Los recordatorios automáticos se pausan hasta el próximo período de facturación. Los mensajes manuales mostrarán un aviso de que se alcanzó el límite. Podés actualizar tu plan para obtener más.
¿Puedo tener los dos modos activos? (gestionado + propio)
Sí, la plataforma soporta modo híbrido. Podés tener el número gestionado activo como respaldo mientras configurás tu número propio. Los envíos se priorizan por el proveedor que configurés como principal.
¿Cómo sé si mis mensajes se están entregando?
Revisá la sección de Logs de Mensajes donde podés ver el estado de cada mensaje (Enviado → Entregado → Leído). Si hay errores, se muestra el código y la razón del fallo.
¿Puedo cambiar el nombre que ven mis pacientes?
Si usás tu propio número, el nombre verificado solo puede cambiarse desde Meta Business Suite. El proceso requiere re-verificación y puede demorar hasta 3 días. Sin embargo, la “Descripción” y el “Acerca de” sí se pueden editar desde la plataforma.