Conecte un número Twilio a través de SIP

La conexión de un número de Twilio como número SIP externo le permite a su agente de voz Versafy responder llamadas a ese número y usarlo como número de persona que llama para llamadas salientes. Esto es útil cuando desea mantener el número y el enrutamiento de llamadas en su propia cuenta de Twilio mientras usa Versafy como un servicio telefónico de IA.

Para la conexión Twilio normal sin una troncal SIP externa, utilice Conecte una cuenta de Twilio y un número de teléfono. Admite flujos entrantes completos con operadores, horarios, anuncios y correo de voz.

Esta configuración admite:

llamadas entrantes desde el número de Twilio a un agente de voz Versafy;
llamadas salientes individuales de un agente de voz;
saliente Campañas, cuando esté disponible para su espacio de trabajo;
historial de llamadas en Llamadas y grabaciones.

Limitación del flujo entrante SIP externo: Un número SIP externo sólo se puede asignar a un número activo Solo IA Flujo de llamadas entrantes sin escalar a un humano. Si las personas que llaman necesitan enrutamiento del operador, sucursales en horario comercial, anuncios o correo de voz, utilice la conexión Twilio nativa de Versafy. Ver Flujos de llamadas entrantes.

Antes de comenzar

Prepare lo siguiente:

una cuenta de Twilio con permiso para comprar números y administrar Elastic SIP Trunks;
un proyecto o subcuenta de Twilio que será propietario tanto del número como del troncal;
permiso para administrar números de teléfono y flujos de llamadas entrantes en Versafy;
un activo Agente de voz para llamadas entrantes y salientes;
un administrador de contraseñas para el nombre de usuario y la contraseña del troncal SIP.

Las cuentas de prueba de Twilio restringen la propiedad de números de teléfono y los destinos salientes. Actualice la cuenta de Twilio antes del uso y revisión de producción Restricciones de la cuenta de prueba de Twilio .

Descripción general de la configuración

Completarás la conexión en este orden:

Compre un número con capacidad de voz en Twilio.
Cree una troncal SIP elástica de Twilio.
Configurar el maletero Terminación configuración para llamadas salientes.
Comience a importar el número en Versafy y copie su URI SIP entrante.
Agregue ese URI al troncal Originación configuración para llamadas entrantes.
Asocie el número de Twilio con el maletero.
Asigne el número SIP externo a un flujo de llamadas entrantes solo AI.
Pruebe llamadas entrantes y salientes.

1. Compre un número con capacidad de voz en Twilio

Comprar un número dedicado les brinda a los clientes un número público al que llamar y le brinda a su agente de voz un número de persona aprobado para llamadas salientes.

Inicie sesión en el Consola Twilio y seleccione el proyecto o subcuenta que desea utilizar.
Abierto Productos y servicios → Números y remitentes → Números de teléfono.
Seleccionar Configurar un nuevo número de teléfono.
Elija el país y el tipo de número, luego solicite el Voz capacidad en los filtros de búsqueda.
Seleccione un número, revise los cargos recurrentes y de uso de Twilio y complete la compra.
Complete cualquier identidad, dirección o registro regulatorio que Twilio solicite para ese país y tipo de número.
Copie el número comprado en formato internacional E.164, incluido + y el código del país (por ejemplo, +12025550123.

La interfaz de Twilio puede variar según la cuenta. Ver Guía de configuración de números de teléfono actuales de Twilio si las etiquetas en su consola difieren.

2. Cree una troncal SIP elástica

La troncal es la conexión bidireccional entre Twilio y Versafy. Un lado envía las llamadas entrantes a su agente de voz; el otro permite que Voice Agent realice llamadas a través de su cuenta de Twilio.

En la consola de Twilio, abra Productos y servicios → Trunking SIP elástico → Administrar → Trunks.
Seleccionar Crear nuevo tronco.
Introduzca un reconocible Nombre descriptivo, como Versafy Sales Line.
Guarda el baúl.

Mantenga el baúl abierto en una pestaña del navegador y Versafy abierto en otra. Twilio Guía de Trunking SIP elástica explica las secciones y la terminología actuales de la Consola.

3. Configure la terminación de Twilio para llamadas salientes

La terminación permite que Versafy envíe una llamada a Twilio, que luego la conecta con el número de destino del cliente.

Abre el nuevo baúl Terminación sección.
Crea un único URI SIP de terminación, como versafy-sales.pstn.twilio.com.
Copie el nombre de host completo. Lo ingresarás en Versafy más tarde sin sip: o un puerto.
en Autenticación, crear un Lista de credenciales.
Agregue un nuevo nombre de usuario SIP y una contraseña única y segura a la lista.
Asocie esa lista de credenciales con esta troncal y guarde la configuración de terminación.

Utilice el nombre de usuario y la contraseña de la lista de credenciales SIP en Versafy, no el SID de su cuenta Twilio, el token de autenticación ni la contraseña de la consola. Twilio requiere un URI de terminación más al menos un método de autenticación antes de que la troncal pueda realizar llamadas salientes.

Si llamará a destinos internacionales, habilite solo los países que su empresa necesita según los permisos geográficos de Voz de Twilio. Ver Guía de permisos geográficos de Twilio .

4. Importe el número a Versafy

La importación hace que el número propiedad de Twilio esté disponible para Versafy sin conectar la cuenta Twilio completa.

Navegación: Abierto Teléfono → Números de teléfono, seleccione el Números pestaña, luego seleccione Agregar número externo (a través de SIP).

Introduzca un claro Etiqueta, como Twilio Sales.
Ingrese lo comprado Número de teléfono en formato E.164, incluyendo + y el código del país.
Expandir Configuración entrante.
bajo Enrutamiento entrante/URI de origen, copia el completo URI SIP. Mantenlo sin cambios; lo pegará en Twilio en la siguiente sección.
mantener Cifrado de medios establecer en Permitido para la conexión inicial.
Deje sin cambios los filtros de números entrantes opcionales, los filtros de direcciones de origen, la lista de dominios, las asignaciones de encabezados y los campos de autenticación, a menos que su administrador de telefonía tenga una política específica para ellos.
Expandir Configuración saliente e ingresa:
- Dirección: el nombre de host de terminación de Twilio, como versafy-sales.pstn.twilio.com. no incluir sip: o un puerto.
- Transporte: TCP (recomendado).
- Cifrado de medios: Discapacitado.
- Nombre de usuario de troncal SIP: el nombre de usuario de la lista de credenciales de Twilio.
- Contraseña de troncal SIP: la contraseña de la misma lista de credenciales de Twilio.
Deje vacíos los encabezados y códecs salientes opcionales para la configuración inicial.
Seleccionar Importar.

No habilitar Twilio Canalización segura para esta configuración TCP. Secure Trunking requiere que TLS y la configuración de medios cifrados coincidan en ambos lados y rechazará una conexión que utilice la configuración anterior.

5. Configure Twilio Origination para llamadas entrantes

Origination le dice a Twilio dónde enviar una llamada cuando un cliente marca su número comprado.

Regrese al baúl en Twilio Console y abra Originación.
Seleccionar Agregar nuevo URI de origen.
Introduzca un Nombre descriptivo, como Versafy inbound.
Pegue el URI SIP completo copiado de Versafy. Incluye el número de teléfono, host, puerto y transport=tcp configuración.
Mantener la URI Habilitado.
Para un único URI, mantenga los valores de prioridad y peso predeterminados de Twilio.
Guarde la configuración de origen.

No reemplace el número dentro del URI, elimine transport=tcp, cambie el esquema a sips:o pegue aquí el nombre de host de terminación de Twilio. Twilio documenta el comportamiento del URI de origen en su Guía de configuración de Trunking SIP elástico .

6. Asociar el número de Twilio con el troncal.

Al asociar el número se activa la troncal como ruta de voz entrante del número.

Cambio de ruta: Asociar el número con esta troncal reemplaza su configuración de voz entrante anterior en Twilio. Confirme que el número no esté atendiendo a otra aplicación de producción antes de continuar.

Abre el maletero Números sección.
Seleccionar Asociar un número con esta troncal.
Elija el número que compró y confirme la asociación.
Verifique que el número aparezca en la lista de Números de la línea troncal.

Si Twilio, en cambio, abre la página de configuración del número, elija Enlace troncal SIP para llamadas de voz entrantes, seleccione esta línea troncal y guárdela.

7. Asigne un flujo de llamadas entrantes solo de IA

El flujo entrante elige qué agente de voz responde a este número.

En Versafy, abra Teléfono → Números de teléfono → Flujos de llamadas entrantes.
Cree un flujo usando el Solo IA plantilla.
Seleccione el número SIP externo importado y el agente de voz que debe responder.
Revisar, crear y activar el flujo.
Regresar a la Números y confirme que el número muestra Flujo de llamadas entrantes adjunto y el nombre del flujo previsto.

Si creó el flujo antes de importar el número, busque el número en Números, elige Conéctese a un flujo de llamadas entrantesy seleccione un flujo solo AI activo.

8. Pruebe ambas direcciones de llamada

Probar ambas direcciones confirma que las asignaciones de número, troncal, autenticación y Versafy funcionan juntas.

Probar llamadas entrantes

Llame al número de Twilio desde un teléfono fuera de la cuenta de Twilio.
Confirme que el agente de voz esperado responda con el mensaje de apertura correcto.
Haga una pregunta de prueba normal y luego finalice la llamada.
Abierto Teléfono → Registros de llamadas y grabaciones y confirma que aparece la llamada.

Probar llamadas salientes

Abierto Teléfono → Agentes de voz.
Busque el agente activo y seleccione hacer una llamada.
Seleccione el número de Twilio importado como número de la persona que llama.
Ingrese un destino de prueba en formato E.164 y confirme la llamada.
Responde la llamada y verifica el audio bidireccional.
comprobar Llamadas y grabaciones antes de repetir un intento fallido o poco claro.

También puedes revisar Trunking SIP elástico → Registros en Twilio. Twilio proporciona comprobaciones de maletero adicionales en Pruebe su troncal SIP elástica .

Solución de problemas

El número SIP externo no aparece para llamadas salientes

Confirme que la importación se completó, el número muestra Saliente habilitado bajo Teléfono → Números de teléfono → Númerosy el agente de voz está activo. Abierto Editar en el número externo y verifique la dirección saliente y las credenciales.

Las llamadas salientes fallan con un error de autenticación

Confirme que la lista de credenciales esté adjunta al mismo troncal de Twilio y que el Versafy Nombre de usuario de troncal SIP y Contraseña de troncal SIP coincide exactamente con él. No utilice las credenciales de la cuenta de Twilio.

Las llamadas salientes fallan antes de sonar

Comprueba que:

Dirección contiene sólo el nombre de host de terminación de Twilio;
el destino incluye + y su código de país;
Twilio permite llamadas a ese país de destino;
una cuenta de prueba llama a un destino verificado por Twilio;
el número de Twilio sigue siendo propiedad del mismo proyecto o subcuenta que el tronco.

Las llamadas entrantes no llegan a Versafy

Confirme que el número de Twilio esté asociado con la troncal correcta, que el URI de origen esté habilitado y coincida exactamente con el valor copiado de Versafy, y que el número externo esté asignado a un flujo activo solo AI.

No hay flujo disponible para el número SIP externo

Sólo activo Solo IA Los flujos sin escalamiento a un ser humano son elegibles. Cree o active ese tipo de flujo, o utilice la conexión nativa de Twilio si necesita un recorrido de llamada más complejo.

La llamada se conecta pero falta el audio o es unidireccional

Confirme que Twilio Secure Trunking esté deshabilitado para esta configuración y que la configuración de cifrado de medios Versafy coincida con esta guía. Si restringiste Direcciones IP de origen permitidas, incluya todos los rangos de señalización actuales de Twilio en lugar de solo una región; revisión Lista de direcciones IP actuales de SIP Trunking de Twilio .

Si Twilio informa un error de medios no compatibles, edite el número SIP externo y agregue PCMU/8000 o PCMA/8000 bajo Códecs habilitados. Twilio guía de solución de problemas del maletero enumera los códecs que acepta.

Necesitas cambiar el número de teléfono importado.

Puede editar su etiqueta y configuración SIP, pero no el número E.164 en sí. Desconéctelo de cualquier flujo, elimine el número SIP externo de Versafy e importe nuevamente el número correcto. Eliminarlo de Versafy no libera el número de su cuenta Twilio.