Telefonía: click-to-call y grabación (Twilio Voice)
Llama a contactos y leads con un clic y graba las llamadas usando la MISMA cuenta Twilio ya configurada para SMS/WhatsApp (modelo BYO).
La Telefonía usa la MISMA cuenta Twilio que ya configuraste para Mensajes (SMS/WhatsApp), con el modelo BYO ("trae tu propia cuenta"). Las llamadas se hacen y se cobran en tu cuenta Twilio: no hay costo, margen ni intermediación de nuestra parte. Solo necesitas un número Twilio habilitado para VOZ.
La funcionalidad es inerte: no ocurre nada hasta que la integración Twilio esté configurada, activada y con un número de voz completado.
Requisitos previos
- La integración Twilio (SMS/WhatsApp) ya configurada y activada, con la misma cuenta (Account SID + Auth Token).
- Un número Twilio habilitado para VOZ, en E.164, para usar como caller ID.
- Un teléfono del agente para recibir la pierna de la llamada (cada usuario puede indicar el propio al momento de llamar).
- En Sellio, ser administrador para completar el número de voz en la tarjeta de Twilio.
Cómo funciona el click-to-call (bridge)
No usamos teléfono en el navegador (WebRTC). El flujo es 100% por el servidor: cuando haces clic en "Llamar", Twilio llama PRIMERO a TU teléfono (el número del agente). Cuando contestas, Twilio conecta (hace el bridge) la llamada al número del CONTACTO y comienza a grabar. Al terminar, la duración y el enlace de la grabación se registran automáticamente.
Lo que necesitas configurar
- La integración Twilio ya configurada (Account SID + Auth Token), la misma de los Mensajes.
- Número de voz (caller ID): un número Twilio habilitado para VOZ, en E.164 (ej.: +15005550006). Es el identificador que aparece en la llamada.
- Teléfono del agente (opcional): un número predeterminado que suena primero. Cada usuario también puede indicar su propio teléfono al momento de llamar (queda memorizado en su navegador).
Cómo configurar
- Abre Configuración → Integraciones y localiza la tarjeta "Mensajes SMS/WhatsApp (Twilio)".
- Completa el "Número de voz (caller ID)" y, si quieres, el "Teléfono del agente (predeterminado)". Vuelve a indicar el Auth Token y haz clic en "Guardar credenciales".
- Las URLs de TwiML y de estado/grabación las apunta automáticamente el propio click-to-call; NO necesitas configurarlas en la Consola de Twilio.
- Asegúrate de que la integración Twilio esté "Activada".
Cómo hacer una llamada
- Abre un Contacto o Lead que tenga teléfono (campo Teléfono o Celular).
- En el recuadro "Telefonía (llamadas)", haz clic en "Llamar".
- Verifica el número del contacto, indica TU teléfono (agente), si aún no está memorizado, y haz clic en "Llamar ahora".
- Contesta cuando suene tu teléfono: Twilio te conecta con el contacto y graba la llamada.
- La llamada aparece en el historial con estado y, al concluir, la duración y el enlace "Escuchar grabación". La actividad también entra en la línea de tiempo del registro.
El CRM verifica la firma X-Twilio-Signature de los webhooks de estado y grabación usando tu Auth Token. La grabación queda alojada en tu cuenta Twilio; el enlace abre el audio (.mp3). Trata el Auth Token como secreto: se guarda cifrado y nunca se muestra de vuelta.
Cómo probar
- Abre un Contacto/Lead con teléfono y, en el recuadro "Telefonía (llamadas)", haz clic en "Llamar".
- Indica TU teléfono (agente) y haz clic en "Llamar ahora".
- Contesta cuando suene tu teléfono: Twilio te conecta con el contacto y comienza a grabar.
- Al colgar, confirma que la llamada aparece en el historial con la duración y el enlace "Escuchar grabación".
Solución de problemas
- El botón "Llamar" avisa que falta configuración: Twilio no está activado o el "Número de voz (caller ID)" no se completó. Complétalos en la tarjeta de Twilio.
- 401 / la llamada no inicia: Account SID/Auth Token incorrectos. Vuelve a indicar el Auth Token al guardar el número de voz.
- Mi teléfono no suena: verifica el número del agente en E.164 y si el número de voz Twilio puede originar llamadas hacia tu país (Geo Permissions en la Consola de Twilio).
- Sin grabación o sin duración al final: los webhooks de estado/grabación los apunta automáticamente el click-to-call; si fallan, verifica que el Auth Token sea correcto (la firma X-Twilio-Signature se verifica con él).
- No necesito configurar URLs en Twilio: correcto, las URLs de TwiML y de estado/grabación las define el propio flujo; no configures un webhook manual en el número para voz.