Guías de Configuración de Integraciones
Instrucciones paso a paso para conectar cada servicio de terceros a tu plataforma Engium. Incluye credenciales, enlaces, precios y solución de problemas.
Resumen de Integraciones
Engium se conecta con servicios de terceros para manejar llamadas telefónicas, mensajes de WhatsApp, correos electrónicos, pagos y reservas de calendario. Cada integración requiere credenciales del proveedor externo. A continuación encontrarás guías paso a paso para cada servicio compatible.
Llamadas de Voz
Twilio (internacional) o Exotel (India)
API en la Nube de Meta o Gupshup (India)
Correo Electrónico
SendGrid, AWS SES o Mailgun
Calendario
Sincronización bidireccional con Google Calendar
Chat Web
Widget integrado — no requiere configuración
Para empresas en India, recomendamos Exotel para llamadas de voz y Gupshup para WhatsApp — son 60–75% más baratos que los proveedores internacionales con mejor soporte local.
📞 Twilio — Llamadas de Voz
Twilio es la plataforma líder en comunicaciones en la nube. Úsalo para llamadas entrantes y salientes, menús IVR, grabación de llamadas y respuestas de voz con IA.
Requisitos Previos
- Una cuenta de Twilio (prueba gratuita con $15 de crédito)
- Una dirección de correo electrónico y número de teléfono verificados
- Un número de teléfono comprado con capacidad de Voz (~$1/mes)
Pasos de Configuración
Crear una cuenta de Twilio
Ve al sitio web de Twilio y regístrate para una prueba gratuita. Recibirás $15 en crédito gratuito para probar.
Verifica tu identidad
Twilio te pedirá que verifiques tu correo electrónico y número de teléfono. Completa ambas verificaciones para activar tu cuenta.
Encuentra tu Account SID y Auth Token
Después de iniciar sesión, ve al panel de la Consola de Twilio. Tu Account SID (comienza con 'AC') y Auth Token se muestran en la página principal. Haz clic en el ícono del ojo para revelar el Auth Token.
Compra un número de teléfono
Ve a Phone Numbers → Manage → Buy a Number. Busca un número en tu país, asegúrate de que tenga la capacidad de 'Voice' habilitada y cómpralo (~$1/mes).
Ingresa las credenciales en Engium
En Engium, ve a Integraciones → Voz → Twilio. Ingresa tu Account SID, Auth Token y dale un nombre a la integración (ej. 'Línea Principal'). Haz clic en 'Verificar Credenciales'.
Selecciona tu número de teléfono
Después de que la verificación sea exitosa, selecciona el número de teléfono que compraste del menú desplegable. Haz clic en 'Guardar' y tu canal de voz estará activo. Engium configura automáticamente el webhook.
Referencia de Credenciales
| Field | Where to find it |
|---|---|
| Account SID* | Consola de Twilio → Panel → Account SID (comienza con 'AC', 34 caracteres) |
| Auth Token* | Consola de Twilio → Panel → Auth Token (clic en ícono del ojo, 32 caracteres) |
| Phone Number* | Consola de Twilio → Phone Numbers → Manage → Active Numbers |
Precios
Precios de Twilio Pago por Uso (EE.UU.)
| Número de Teléfono | ~$1.00/month |
| Llamadas Entrantes | ~$0.0085/min |
| Llamadas Salientes | ~$0.013/min |
Enlaces Útiles
Twilio ofrece credenciales de prueba que simulan llamadas sin cargos. Encuéntralas en Consola → Configuración → Credenciales de Prueba. Perfecto para verificar tu configuración antes de ir a producción.
📞 Exotel — Voz y SMS (India)
Exotel es el proveedor líder de telefonía en la nube de India. Una sola integración con Exotel habilita llamadas de voz y SMS — y es 60–75% más barato que Twilio para números indios.
¿Por qué Exotel? Comparación de Precios
| Exotel | Twilio | |
|---|---|---|
| Llamadas de Voz (India) | ₹0.50/min | ₹1.25/min |
| SMS (India) | ₹0.15/msg | ₹0.55/msg |
| Ahorro | 60–75% más barato | |
Pasos de Configuración
Crear una cuenta de Exotel
Regístrate en el sitio web de Exotel. Es posible que se requiera verificación empresarial para cumplimiento de telecomunicaciones indias.
Completar verificación KYC
Sube tu documentación empresarial según se requiera. Es obligatorio para la regulación de telecomunicaciones de India. La aprobación generalmente toma 1–2 días hábiles.
Obtén tus credenciales de API
Inicia sesión en tu panel de Exotel. Ve a Configuración → API. Copia tu API Key, API Token y Account SID.
Obtén un número virtual
En tu panel de Exotel, navega a Numbers y compra o activa un número de teléfono virtual. Este será tu identificador de llamadas empresarial.
Ingresa las credenciales en Engium
En Engium, ve a Integraciones → Proveedores → Exotel. Ingresa tu API Key, API Token, Account SID y número de origen. Haz clic en 'Verificar y Conectar'. Engium habilita automáticamente los canales de Voz y SMS.
Referencia de Credenciales
| Field | Where to find it |
|---|---|
| API Key* | Panel de Exotel → Configuración → API → API Key |
| API Token* | Panel de Exotel → Configuración → API → API Token |
| Account SID* | Panel de Exotel → Configuración → API → Account SID |
| From Number | Tu número virtual de Exotel (solo dígitos, ej. 08047190000) |
Enlaces Útiles
Exotel requiere verificación KYC/empresarial para cumplimiento de telecomunicaciones indias. Planifica 1–2 días hábiles para la aprobación. Ten listos tu PAN empresarial, certificado GST y comprobante de domicilio.
💬 WhatsApp Business — API en la Nube de Meta
Conecta WhatsApp Business directamente a través de la API en la Nube de Meta para mensajería confiable y escalable. Esta es la ruta de integración oficial recomendada para empresas internacionales.
Requisitos Previos
- Una cuenta de Meta Business (business.facebook.com)
- Un número de teléfono NO registrado en WhatsApp — se convertirá en número Business
- Una página de Facebook para tu empresa (opcional pero recomendado)
- Un método de pago en tu cuenta de Meta Business
Pasos de Configuración
Crear una cuenta de Meta Business
Si no tienes una, ve a Meta Business Suite y crea una cuenta empresarial. Es gratis y toma pocos minutos.
Crear una App de Meta
Ve a Meta for Developers, haz clic en 'Crear App' y selecciona el tipo 'Business'. Agrega el producto WhatsApp a tu app.
Agrega y verifica tu número de teléfono
En la sección de WhatsApp de tu app, agrega un número de teléfono. Meta enviará un código de verificación por SMS o llamada. Importante: este número NO debe estar registrado en WhatsApp — elimínalo de WhatsApp primero si es necesario.
Crear un Usuario del Sistema y generar Token de Acceso
En Meta Business Suite → Configuración → Configuración del Negocio → Usuarios → Usuarios del Sistema: crea un Usuario del Sistema con rol 'Admin', luego haz clic en 'Generar Nuevo Token'. Selecciona la app de WhatsApp y otorga permisos whatsapp_business_management y whatsapp_business_messaging. Copia el token — no lo verás de nuevo.
Obtén tu Phone Number ID y Business Account ID
En Meta for Developers → tu app → WhatsApp → API Setup: encontrarás tanto tu Phone Number ID (numérico) como el WhatsApp Business Account ID.
Ingresa las credenciales en Engium
En Engium, ve a Integraciones → WhatsApp → API en la Nube de Meta. Ingresa tu Phone Number ID, Business Account ID y Access Token. Haz clic en 'Verificar y Conectar'.
Configurar webhook (automático)
Después de la verificación exitosa, Engium proporciona una URL de webhook. Cópiala y pégala en tu App de Meta → WhatsApp → Configuración → URL de Callback. Suscríbete a eventos de 'messages'. Engium recibirá todos los mensajes entrantes de WhatsApp.
Referencia de Credenciales
| Field | Where to find it |
|---|---|
| Phone Number ID* | Meta for Developers → App → WhatsApp → API Setup → Phone Number ID |
| Business Account ID* | Meta for Developers → App → WhatsApp → API Setup → Business Account ID |
| Access Token* | Meta Business Suite → Configuración → Usuarios del Sistema → Generar Token (usar token permanente de Usuario del Sistema, NO el token temporal de prueba) |
Precios
Precios de WhatsApp por Conversación
| Iniciado por Empresa (Marketing/Utilidad) | ~$0.04–0.06 |
| Iniciado por Usuario (Servicio) | ~$0.01–0.03 |
| Cuota gratuita | Primeras 1,000 conversaciones/mes gratis |
Usa un Token de Acceso permanente de Usuario del Sistema para producción. El token temporal de prueba de API Setup expira en 24 horas y romperá tu integración.
Los primeros mensajes a clientes deben usar Plantillas de Mensajes pre-aprobadas (apruébalas en WhatsApp Manager). Después de que un cliente responde, tienes una ventana de 24 horas para mensajes libres.
Enlaces Útiles
💬 Gupshup — WhatsApp para India
Gupshup es el mayor proveedor de API de WhatsApp Business en India. Es ~70% más barato que Twilio para mensajes de WhatsApp en India, con incorporación rápida y excelente soporte local.
¿Por qué Gupshup? Comparación de Precios
| Gupshup | Twilio | |
|---|---|---|
| Mensaje de WhatsApp (India) | ₹0.30/msg | ₹0.85/msg |
| Ahorro | ~70% más barato | |
Pasos de Configuración
Crear una cuenta de Gupshup
Regístrate en el portal de desarrolladores de Gupshup. Tendrás acceso al panel y sandbox para pruebas.
Crear una app de WhatsApp Business
En el panel de Gupshup, haz clic en 'Crear App' y selecciona 'WhatsApp'. Sigue las instrucciones para registrar tu número de WhatsApp Business y nombre para mostrar.
Obtén tus credenciales de API
Ve a tu Perfil → Claves API para encontrar tu API Token. Luego ve a tu App → Configuración → Información de la App para el App ID.
Ingresa las credenciales en Engium
En Engium, ve a Integraciones → WhatsApp → Gupshup. Ingresa tu API Token, número de teléfono de origen (en formato E.164 sin '+', ej. 919876543210) y opcionalmente el App ID. Haz clic en 'Verificar y Conectar'.
Copia la URL del webhook
Después de la verificación exitosa, Engium muestra una URL de webhook. Copia esta URL — la necesitarás en el siguiente paso.
Configurar webhook en Gupshup
Ve a tu panel de Gupshup → Configuración de la App → Webhooks. Pega la URL del webhook de Engium y habilita los webhooks 'message-event' y 'user-event'. Haz clic en Guardar.
Referencia de Credenciales
| Field | Where to find it |
|---|---|
| API Token* | Panel de Gupshup → Perfil → Claves API → API Token |
| Source Phone* | Tu número de WhatsApp registrado en formato E.164 sin '+' (ej. 919876543210) |
| App ID | Panel de Gupshup → App → Configuración → Info de App → App ID (opcional) |
Configuración del Webhook
Después de conectar Gupshup en Engium, debes configurar el webhook en tu panel de Gupshup:
- Inicia sesión en tu panel de Gupshup
- Ve a tu App de WhatsApp Business → Configuración → Webhooks
- Pega la URL del webhook proporcionada por Engium
- Habilita estos eventos: 'message-event' y 'user-event'
- Haz clic en Guardar — los mensajes fluirán a Engium automáticamente
Enlaces Útiles
Usa el entorno sandbox de Gupshup para probar tu integración antes de ir a producción. Envía un mensaje a su número sandbox y verifica que los mensajes aparezcan en Engium.
📧 Integración de Correo Electrónico
Conecta un proveedor de correo electrónico para habilitar respuestas de email con IA, seguimientos automáticos y correos de notificación. Engium soporta tres proveedores — elige el que mejor se adapte a tus necesidades.
Proveedores Soportados
| Proveedor | Mejor Para | Plan Gratuito | Panel |
|---|---|---|---|
| SendGrid | La mayoría de empresas — configuración fácil | 100 emails/day | app.sendgrid.com ↗ |
| AWS SES | Alto volumen — más barato a escala | 62,000/month (EC2) | AWS Console ↗ |
| Mailgun | Desarrolladores — APIs potentes | 100 emails/day (trial) | mailgun.com ↗ |
Configuración de SendGrid
Crear una cuenta de SendGrid
Regístrate en SendGrid (propiedad de Twilio). El plan gratuito incluye 100 emails/día.
Verificar identidad del remitente
Ve a Configuración → Autenticación de Remitente. Verifica una sola dirección de email o autentica todo tu dominio para mejor entregabilidad.
Crear una clave API
Ve a Configuración → Claves API → Crear Clave API. Selecciona 'Acceso Completo' o 'Acceso Restringido' con permiso de Envío de Correo. Copia la clave inmediatamente — no se mostrará de nuevo.
Ingresar en Engium
En Engium, ve a Integraciones → Email. Selecciona 'SendGrid', pega tu clave API, ingresa tu dirección de email verificada y guarda.
Configuración de AWS SES
Accede a AWS SES
Inicia sesión en la Consola de AWS y navega a Amazon SES. Si eres nuevo en AWS, crea una cuenta primero.
Verifica tu email/dominio
En SES, ve a Identidades → Crear Identidad. Verifica una dirección de email (rápido) o un dominio completo (agregar registros DNS). Comenzarás en modo Sandbox.
Crear credenciales SMTP o clave API
Ve a AWS IAM y crea una clave de acceso con permisos de SES. O usa SES → Configuración SMTP para generar credenciales SMTP. Copia el Access Key ID y Secret Access Key.
Ingresar en Engium
En Engium, ve a Integraciones → Email. Selecciona 'AWS SES', pega tu clave API, ingresa tu email verificado y guarda. Nota: solicita acceso de producción en SES para enviar a destinatarios no verificados.
Configuración de Mailgun
Crear una cuenta de Mailgun
Regístrate en Mailgun. La prueba incluye 100 emails/día durante el primer mes.
Agregar y verificar tu dominio
En Mailgun, ve a Dominios → Agregar Nuevo Dominio. Sigue las instrucciones de registros DNS para verificar tu dominio. Esto mejora significativamente la entregabilidad del email.
Obtén tu clave API
Ve a Configuración → Claves API. Copia tu clave API privada. Esta se usa para enviar emails a través de la API de Mailgun.
Ingresar en Engium
En Engium, ve a Integraciones → Email. Selecciona 'Mailgun', pega tu clave API privada, ingresa tu dirección de email verificada y guarda.
Referencia de Credenciales (Todos los Proveedores)
| Field | Where to find it |
|---|---|
| Proveedor* | Selecciona SendGrid, AWS SES o Mailgun del menú desplegable |
| API Key* | Panel del proveedor → Sección de Claves API (ver pasos individuales arriba) |
| Email de Origen* | Debe ser un email de remitente verificado en el panel de tu proveedor |
Prueba tu integración de email enviando un correo de prueba desde Engium después de la configuración. Revisa tu carpeta de spam si no llega — es posible que necesites configurar registros DNS SPF/DKIM para tu dominio.
📅 Google Calendar — Sincronización Bidireccional
Conecta Google Calendar para sincronización automática bidireccional de reservas. Cuando la IA agenda una cita, aparece en tu Google Calendar inmediatamente. Los eventos creados en Google Calendar bloquean el horario en Engium para prevenir reservas dobles.
Pasos de Configuración
Ir a Configuración de Calendario
En Engium, navega a Configuración → Calendario. Verás la opción de conectar Google Calendar.
Haz clic en 'Conectar Google Calendar'
Se abrirá una ventana de inicio de sesión de Google. Inicia sesión con la cuenta de Google que tiene el calendario que quieres sincronizar. Otorga a Engium permiso para leer y escribir eventos del calendario.
Selecciona tu calendario
Después de la autorización, selecciona qué Google Calendar sincronizar (puedes tener varios). Elige tu calendario principal de negocios.
Verifica que la sincronización funciona
Crea una reserva de prueba en Engium y verifica que aparezca en tu Google Calendar en pocos segundos. Luego crea un evento en Google Calendar y verifica que bloquee el horario en Engium.
Características
- Sincronización bidireccional — las reservas aparecen tanto en Engium como en Google Calendar
- Prevención de reservas dobles — los eventos de Google Calendar bloquean horarios en Engium
- Actualizaciones automáticas — reprogramaciones y cancelaciones se sincronizan en ambas direcciones
- Múltiples calendarios — conecta diferentes calendarios para diferentes miembros del equipo
Enlaces Útiles
Si no necesitas sincronización con Google Calendar, el calendario integrado de Engium funciona inmediatamente sin configuración. Siempre puedes conectar Google Calendar más tarde.
🌐 Widget de Chat Web
El widget de chat web de Engium está integrado y no requiere configuración de terceros. Solo habilítalo y pega un fragmento de código en tu sitio web. Los visitantes pueden chatear con tu asistente de IA directamente.
Pasos de Configuración
Habilitar Chat Web
En Engium, ve a Integraciones → Chat Web y actívalo. Personaliza la apariencia del widget: colores, mensaje de bienvenida, posición y avatar.
Copiar el código de inserción
Engium genera un fragmento de JavaScript. Cópialo y pégalo en el HTML de tu sitio web, justo antes de la etiqueta de cierre </body>. Funciona en cualquier plataforma web.
Probar en tu sitio web
Visita tu sitio web y busca la burbuja de chat en la esquina inferior derecha. Haz clic para iniciar una conversación de prueba con tu asistente de IA.
Características
- Respuestas de IA en tiempo real — los visitantes obtienen respuestas instantáneas
- Apariencia personalizable — adapta los colores y estilo a tu marca
- Compartir archivos — los clientes pueden enviar imágenes y documentos
- Responsivo móvil — funciona perfectamente en teléfonos y tablets
- Historial de conversaciones — todos los chats se guardan en tu panel de Engium
🔧 Solución de Problemas
Problemas comunes de integración y cómo resolverlos.
"La verificación de credenciales falló"
Verifica que copiaste el valor completo de la credencial sin espacios adicionales. Asegúrate de que la clave API/token no haya sido revocada o expirada. Para Twilio, el Account SID debe comenzar con 'AC'. Para Stripe, la Secret Key comienza con 'sk_live_' o 'sk_test_'.
"Los mensajes de WhatsApp no llegan"
Verifica la configuración del webhook en el panel de Meta/Gupshup — la URL debe coincidir exactamente con la proporcionada por Engium. Verifica que te suscribiste a eventos de 'messages'. También verifica que usaste un token permanente de Usuario del Sistema (no el token de prueba de 24 horas).
"Las llamadas no se conectan vía Twilio"
Asegúrate de que tu número Twilio tenga la capacidad de Voz habilitada. Verifica que tu cuenta tenga saldo suficiente (las cuentas de prueba solo pueden llamar a números verificados). Verifica que la URL del webhook sea accesible — revisa Consola de Twilio → Monitor → Logs para detalles del error.
"El KYC de Exotel está tardando demasiado"
El KYC de Exotel típicamente toma 1–2 días hábiles. Asegúrate de que todos los documentos (PAN, certificado GST, comprobante de domicilio) sean claros y legibles. Contacta al soporte de Exotel en support@exotel.com si tarda más de 3 días.
"Los emails van a spam"
Configura registros DNS SPF, DKIM y DMARC para tu dominio. Usa la función de autenticación de dominio de tu proveedor (SendGrid → Autenticación de Remitente, Mailgun → Verificación de Dominio). AWS SES: solicita acceso de producción para salir del modo sandbox.
"Google Calendar no se sincroniza"
Desconecta y reconecta el calendario en Configuración → Calendario. Asegúrate de seleccionar el calendario correcto durante la configuración. Verifica que la cuenta de Google tenga acceso a la API de Calendar habilitado. La sincronización puede tardar hasta 30 segundos para nuevos eventos.
"Los pagos de Stripe fallan"
Verifica que estás usando el tipo correcto de clave (en vivo vs prueba). Verifica que tu cuenta de Stripe esté completamente activada con la verificación empresarial completa. Para problemas de webhook, revisa Panel de Stripe → Developers → Webhooks → selecciona endpoint → ver intentos recientes y detalles del error.