Saltar al contenido principal

Proveedores de Mensajería

Configuración → Comunicaciones → Proveedores de Mensajería es donde conectas LeadHub a los canales de mensajería bidireccional. Una vez configurados, los clientes potenciales pueden ser contactados directamente desde su vista de detalle, y los mensajes entrantes de esos canales llegan a Conversaciones.

Canales compatibles:

CanalDirecciónProveedor
WhatsAppEnvío y RecepciónMeta Cloud API (WhatsApp Business)
SMSEnvío y RecepciónTwilio Programmable Messaging
TelegramEnvío y RecepciónTelegram Bot API
ViberEnvío y RecepciónViber Business Messages
Voz (Click-to-Call)Saliente + GrabaciónTwilio Programmable Voice

WhatsApp Business (Meta Cloud API)​

Requisitos previos​

  • Una Cuenta de Meta Business en business.facebook.com
  • Una Cuenta de WhatsApp Business con un número de teléfono aprobado
  • El número debe estar registrado en WhatsApp Cloud API (no en la app regular de WhatsApp)

Paso 1 — Crear una App de Meta​

  1. Ve a developers.facebook.com → Mis Apps → Crear App.
  2. Selecciona Business como tipo de app.
  3. Dale un nombre (p. ej., LeadHub Integration) y haz clic en Crear App.
  4. En Agregar Productos, busca WhatsApp y haz clic en Configurar.

Paso 2 — Obtener tus Credenciales​

  1. En el panel del producto WhatsApp, ve a Configuración de API.
  2. Anota:
    • Phone Number ID (numérico, p. ej., 106540352242922)
    • WhatsApp Business Account ID
  3. Ve a Usuarios del Sistema (en Configuración de Business) → crea un usuario del sistema → genera un Token de Acceso Permanente con permiso whatsapp_business_messaging.

Paso 3 — Configurar en LeadHub​

  1. Ve a Configuración → Comunicaciones → Proveedores de Mensajería.

  2. Expande la sección WhatsApp Business y completa:

    CampoValor
    HabilitadoActiva el interruptor
    Token de Acceso PermanenteDel Paso 2
    Phone Number IDDel Paso 2
    Número de Teléfono MostradoTu número de WhatsApp (p. ej., +1-415-555-0199)

  3. Haz clic en Guardar Configuración.

  4. La URL del Webhook Entrante aparece después de guardar.

Paso 4 — Registrar el Webhook en Meta​

  1. En el panel de la App de Meta, ve a WhatsApp → Configuración → Webhooks.
  2. Establece la URL de Devolución de Llamada con tu URL del Webhook Entrante del Paso 3.
  3. Establece el Token de Verificación con cualquier cadena (p. ej., leadhub_verify).
  4. Suscríbete al campo de webhook messages.

Pruébalo: Envía un mensaje a tu número de WhatsApp desde tu teléfono. Debería aparecer como una nueva Conversación en LeadHub.

SMS (Twilio Programmable Messaging)​

Paso 1 — Obtener Credenciales de Twilio​

  1. Inicia sesión en console.twilio.com.
  2. Desde el Panel, copia tu Account SID y Auth Token.
  3. En Números de Teléfono → Gestionar → Números activos, anota tu número de Twilio.

Paso 2 — Configurar en LeadHub​

  1. Ve a Configuración → Comunicaciones → Proveedores de Mensajería.

  2. Expande SMS (Twilio) y completa:

    CampoValor
    HabilitadoActiva el interruptor
    Account SIDAC... del panel de Twilio
    Auth TokenDel panel de Twilio
    Número RemitenteTu número de Twilio en formato E.164 (p. ej., +14155550199)

  3. Haz clic en Guardar Configuración.

  4. Copia la URL del Webhook Entrante que aparece después de guardar.

Paso 3 — Registrar el Webhook en Twilio​

  1. En Twilio, ve a Números de Teléfono → Gestionar → Números activos → haz clic en tu número.
  2. En Mensajería → Cuando llega un mensaje, establece la URL del webhook con tu URL del Webhook Entrante de LeadHub.
  3. Establece el método en HTTP POST y guarda.

Cuentas de prueba: Solo pueden enviar SMS a números verificados. Actualiza a una cuenta de pago para uso en producción.

Telegram​

Paso 1 — Crear un Bot de Telegram​

  1. Abre Telegram y envía un mensaje a @BotFather.
  2. Envía /newbot y sigue las instrucciones (nombre y nombre de usuario).
  3. BotFather te da un Token del Bot (formato: 123456:ABCdef...).
  4. Anota también el Nombre de Usuario del Bot (p. ej., @your_leadhub_bot).

Paso 2 — Configurar en LeadHub​

  1. Ve a Configuración → Comunicaciones → Proveedores de Mensajería.

  2. Expande Telegram y completa:

    CampoValor
    HabilitadoActiva el interruptor
    Token del BotDe BotFather
    Nombre de Usuario del Botp. ej., @your_leadhub_bot

  3. Haz clic en Guardar Configuración.

  4. Copia la URL del Webhook Entrante que aparece.

LeadHub registra automáticamente el webhook en Telegram usando la API del Bot de Telegram — no necesitas pegar la URL en Telegram manualmente.

Viber Business Messages​

⚠️ Viber Business Messages requiere una cuenta de servicio Viber aprobada (cuenta ISV/empresarial). Las cuentas personales regulares de Viber no pueden enviar mensajes empresariales.

Paso 1 — Obtener tu Auth Token de Viber​

  1. Contacta el programa de socios de Viber y obtén tu cuenta de servicio.
  2. Inicia sesión en el Portal de Socios de Viber y encuentra tu Auth Token.
  3. Anota el Nombre del Remitente (el nombre de tu marca, hasta 28 caracteres).

Paso 2 — Configurar en LeadHub​

  1. Ve a Configuración → Comunicaciones → Proveedores de Mensajería.
  2. Expande Viber y completa los campos con el Auth Token y el nombre del remitente.
  3. Haz clic en Guardar Configuración.
  4. Copia la URL del Webhook Entrante y regístrala en el panel de tu cuenta de servicio de Viber.

Voz / Click-to-Call (Twilio Voice)​

Twilio Voice permite llamadas con un solo clic directamente desde la página de detalle de un cliente potencial. Las llamadas se registran en el Historial de Llamadas y pueden grabarse y transcribirse automáticamente.

Requisito previo: SMS (Twilio) debe configurarse primero — Voice reutiliza el mismo Account SID y Auth Token.

Paso 1 — Configurar en LeadHub​

  1. Ve a Configuración → Comunicaciones → Proveedores de Mensajería.
  2. Expande Voz (Twilio Voice) y completa los campos requeridos, incluyendo el número de identificación de llamada y las opciones de grabación.
  3. Haz clic en Guardar Configuración.
  4. Aparecen tres URLs — URL TwiML, URL de Estado y URL de Grabación. Copia las tres.

Paso 2 — Registrar Webhooks en Twilio​

  1. En Twilio, ve a tu número de voz → sección Voz.
  2. Establece Cuando llega una llamada → Webhook → pega tu URL TwiML.
  3. Establece El estado de la llamada cambia → pega tu URL de Estado.
  4. En Grabaciones, establece el webhook con tu URL de Grabación.

Solución de Problemas​

ProblemaSolución
"Guarda la configuración primero para generar la URL del webhook entrante"Aún no has guardado — completa las credenciales y haz clic en Guardar primero
La verificación del webhook de WhatsApp fallaAsegúrate de que el Token de Verificación en Meta coincida con el que usaste durante la configuración
Los mensajes de Telegram no lleganLeadHub registra automáticamente el webhook — verifica que el Token del Bot sea correcto
La prueba de SMS fallaConfirma que el Auth Token sea correcto y que tu número de Twilio esté activo
Las llamadas de voz no conectanAsegúrate de que las URLs TwiML y de Estado estén registradas en Twilio
Los tokens aparecen enmascarados (••••••••••••)Esto es intencional — los secretos existentes se enmascaran por seguridad. Déjalos sin cambios para conservar el secreto almacenado.