Parte 1
WhatsApp Business (Meta)
Necesitas una cuenta de Meta Business Suite y un número de teléfono dedicado. El proceso tarda entre 30 y 60 minutos la primera vez.
Crear una App de Meta
Abre Meta for Developers (developers.facebook.com/apps) e inicia sesión con tu cuenta de Meta Business Suite.
- Click Crear app → tipo Empresa → Siguiente.
- Nombre sugerido:
MiNegocio Bot - Selecciona tu cuenta empresarial de Meta Business Suite.
- Click Crear app.
Agregar WhatsApp al producto
En el panel de tu app, busca el producto WhatsApp y click Configurar.
- Selecciona o crea una Cuenta de WhatsApp Business (WABA).
- Si no tienes una, usa la opción Crear una cuenta nueva (nombre de empresa, zona horaria, moneda).
Agregar y verificar tu número
En WhatsApp → Configuración → Números de teléfono, click Agregar número.
- Introduce el número con código de país, sin
+(ej:521XXXXXXXXXX). - Verifica por SMS o llamada.
- Una vez verificado, copia el Phone Number ID (15–16 dígitos) que aparece en la lista.
Crear un System User y generar el Access Token
Los tokens de usuario personal expiran cada 60 días. Un System User genera un token permanente ligado a la app.
- Ve a Meta Business Suite → Configuración → Usuarios del sistema → click Agregar.
- Nombre:
eivo-bot-system-user· Rol: Empleado. - Click Agregar activos:
— Apps → tu app → permisos:whatsapp_business_messaging,whatsapp_business_management
— Cuentas de WhatsApp Business → tu WABA → rol Administrador. - Click Generar token → selecciona tu app → mismos dos permisos → expiración Nunca.
- Copia el token de inmediato — Meta solo lo muestra una vez.
Obtener el App Secret
En el panel de tu app → Configuración → Básica.
- En el campo App secret, click Mostrar (pedirá tu contraseña de Meta).
- Copia el valor.
Entregar credenciales al equipo de EIVO
Con los pasos anteriores tienes todo lo necesario para WhatsApp:
| Dato | Dónde lo encontraste |
|---|---|
| Phone Number ID | Paso 03 — lista de números verificados |
| Access Token | Paso 04 — System User, sin expiración |
| App Secret | Paso 05 — Configuración básica de la app |
| Verify Token | El equipo de EIVO te lo proporciona |
Compártelos por un canal seguro (gestor de contraseñas compartido o mensaje cifrado).
Configurar el webhook en Meta
Una vez que el equipo de EIVO cargue tus credenciales, recibirás una URL de webhook y un Verify Token:
Para configurarlos en Meta:
- Panel de la app → WhatsApp → Configuración → Webhooks → click Editar.
- Pega la URL y el Verify Token → click Verificar y guardar.
- En Campos de webhook, suscríbete a
messages.
Crear la plantilla de recordatorio (opcional)
Si quieres recordatorios automáticos de cita por WhatsApp, necesitas una plantilla aprobada por Meta.
- WhatsApp → Administrador de plantillas → Crear plantilla.
- Categoría: Utility · Nombre:
confirmacion_cita· Idioma:Español (México). - Cuerpo sugerido:
Meta suele aprobar en 24–48 h. Comunica el nombre exacto de la plantilla al equipo de EIVO.
Parte 2 · Opcional
Google Calendar
Conecta tu Google Calendar para que las citas confirmadas se registren automáticamente y manden invitaciones por correo a tus pacientes. Si no lo configuras, las citas solo se guardan en la base de datos del bot.
Crear proyecto en Google Cloud Console
- Abre console.cloud.google.com e inicia sesión.
- Selector de proyecto → Nuevo proyecto → nómbralo
EIVO Bot. - Espera ~30 s a que se cree y selecciónalo.
Habilitar Google Calendar API
En el buscador de la consola busca "Google Calendar API" y click Habilitar.
Configurar la pantalla de consentimiento OAuth
- APIs y servicios → Pantalla de consentimiento de OAuth → tipo External → Crear.
- App name:
EIVO Bot· User support email y Developer contact: tu Gmail. - En Test users, agrega tu propio Gmail.
- Guarda y continúa en cada paso.
Crear OAuth Client ID
- APIs y servicios → Credentials → Crear credenciales → OAuth Client ID.
- Application type: Desktop app · Name:
EIVO Bot Desktop. - Click Crear — aparece un modal con
Client IDyClient Secret. - Cópialos y tenlos a la mano para el siguiente paso.
Obtener el Refresh Token
El equipo de EIVO corre un script contigo (o tú lo corres localmente) que abre tu navegador para autorizar el acceso:
El script pide el Client ID y Client Secret del paso anterior, abre tu navegador para que autorices con tu Gmail y al finalizar imprime los 4 valores que necesitas entregar al equipo de EIVO:
Entregar valores al equipo de EIVO
El equipo los cargará en tu cuenta desde el panel de administración. No necesitas acceso a Railway ni a ningún servidor.
| Valor | Cómo obtenerlo |
|---|---|
| OAuth Client ID | Paso 04 — Google Cloud Console |
| OAuth Client Secret | Paso 04 — Google Cloud Console |
| Refresh Token | Paso 05 — script bootstrap_google_oauth.py |
| Calendar ID | primary (tu calendario principal) o el ID específico |
Parte 3
Validar la integración
Una vez que el equipo de EIVO haya cargado tus credenciales, confirma que todo funciona antes de arrancar en producción.
Probar la conexión de WhatsApp
En el panel de super-admin → tu tenant → click Probar conexión WA. Debe mostrar el número verificado y el nombre registrado en Meta.
Probar Google Calendar
Click en Probar Google Calendar. Debe mostrar los próximos eventos del calendario (o "Sin eventos próximos" si está vacío).
Probar el flujo completo
- Envía un mensaje de WhatsApp a tu número de negocio (ej: "hola") — el bot debe responder.
- Intenta agendar una cita completa siguiendo el flujo conversacional.
- Si configuraste Google Calendar, verifica que el evento aparece en tu calendario.
Preguntas frecuentes
¿Tienes dudas?
¿Con qué frecuencia caduca el Access Token?
Si lo generaste como System User con expiración "Nunca", no caduca a menos que lo revoques manualmente o elimines el System User. Los tokens de usuario personal (no System User) sí caducan cada 60 días.
¿Qué pasa si cambio mi número de teléfono de negocio?
Notifica al equipo de EIVO; es necesario actualizar el Phone Number ID y re-verificar el número nuevo en Meta. El historial de conversaciones existente se conserva.
¿El bot tiene acceso a mis conversaciones pasadas de WhatsApp?
No. El bot solo ve los mensajes que los usuarios le envían a partir de la fecha de activación. No hay acceso al historial de WhatsApp previo.
¿Error 403: access_denied durante la autorización de Google?
Tu Gmail no está en la lista de Test Users del proyecto de Google Cloud. Vuelve al paso 03 de la parte Google Calendar → sección "Test users" → agrégalo.
¿Cómo revoco el acceso del bot a Google Calendar?
En myaccount.google.com/permissions, busca "EIVO Bot" y quita el acceso. Luego avisa al equipo de EIVO para eliminar las credenciales de tu cuenta. Las citas existentes en la base de datos se conservan.
¿Puede el bot manejar más de un número de WhatsApp?
No dentro de la misma cuenta. Si tienes sucursales con distintos números, el equipo de EIVO puede crear una cuenta independiente por sucursal, cada una con su propio bot y panel.