Configuración de Twilio (WhatsApp + Voz)

Objetivo

Guiar la configuración básica de Twilio para WhatsApp y Voice en Helios.

Requisitos

• Cuenta Twilio activa
• Acceso a Twilio Console

Datos que necesitas

• Account SID
• Auth Token
• Número WhatsApp (sandbox o productivo)
• Número telefónico (voice)

Paso 1: Crear cuenta y obtener credenciales

1. Entra a https://www.twilio.com/try-twilio
2. Completa el registro y verifica teléfono.
3. En el Dashboard copia:
   • Account SID (empieza con AC)
   • Auth Token (32 chars)

Paso 2: Guardar Twilio en Helios

1. Ve a /app/{tenant}/integrations.
2. En Twilio (Voice & WhatsApp) pega Account SID y Auth Token.
3. Pulsa Save Twilio Credentials.

Paso 3: WhatsApp (sandbox o producción)

Sandbox (pruebas)

1. En Twilio Console: Messaging -> Try it out -> Send a WhatsApp message.
2. Conecta tu número personal siguiendo el código del sandbox.
3. Copia el WhatsApp Sandbox Number.

Producción

1. En Twilio Console: Messaging -> Senders -> WhatsApp Senders.
2. Solicita acceso y completa verificación.
3. Una vez aprobado, usa tu número productivo.

Webhook de WhatsApp

Configura el webhook en Twilio:

• URL: https://TU_DOMINIO.com/api/whatsapp/webhook
• Method: POST

Paso 4: Voice (telefonía)

1. Compra o usa un número en Twilio -> Phone Numbers.
2. En la configuración del número:
   • Voice webhook URL: https://TU_DOMINIO.com/api/voice/webhook
   • Method: POST
   • (Opcional) Status callback: https://TU_DOMINIO.com/api/voice/status-callback

Paso 5: Conectar número en Helios

• WhatsApp: /app/{tenant}/whatsapp -> Connect New Number
• Voice: /app/{tenant}/voice-agents -> Create Voice Agent

Buenas prácticas

• Usa un número separado para pruebas y producción.
• Verifica que los webhooks respondan 200.
• Revisa logs si no llegan mensajes o llamadas.

Errores comunes

• Webhook no llega: URL incorrecta o sin HTTPS.
• Invalid signature: revisa Auth Token guardado.
• Número no aparece: revisa que este activo en Twilio.

Captura