Conecte una cuenta de Twilio y un número de teléfono

Conectar su cuenta de Twilio directamente a Versafy le permite reunir sus números de teléfono con capacidad de voz en una configuración de llamadas completa. Sus agentes de voz pueden responder llamadas entrantes, realizar llamadas salientes, utilizar el enrutamiento del operador y del horario comercial, recopilar mensajes de voz y mantener la actividad de las llamadas en conjunto en Versafy.

Esta es la configuración de Twilio recomendada cuando desea que Versafy administre el enrutamiento de voz activo del número. No requiere una troncal SIP externa.

Con una conexión directa de Twilio, puedes:

utilice números de Twilio que ya sean propiedad de su empresa;
asignar un número a cualquier elegible Flujo de llamadas entrantes, incluyendo flujos con operadores, horarios, anuncios y correo de voz;
habilitar un número para llamadas individuales de Voice Agent y Campañas, cuando esté disponible;
revisar llamadas en Llamadas y grabaciones.

Si necesita conservar su propio enrutamiento y troncal SIP de Twilio, siga Conecte un número Twilio a través de SIP. No complete ambos métodos para el mismo número.

Antes de comenzar

Prepare lo siguiente:

permiso para crear o administrar una cuenta de Twilio;
el nombre legal, la dirección y los documentos de identidad o comerciales solicitados para el país y el tipo de número elegidos;
un método de pago y saldo de Twilio suficiente para uso en producción;
permiso para administrar números de teléfono y flujos de llamadas entrantes en Versafy;
un activo Agente de voz si las llamadas serán atendidas por un agente;
un administrador de contraseñas para el token de autenticación de Twilio.

Utilice un proyecto o subcuenta de Twilio a lo largo de esta guía. Las credenciales ingresadas en Versafy deben pertenecer al mismo proyecto o subcuenta propietaria del número de teléfono.

Descripción general de la configuración

Completarás la conexión en este orden:

Cree y verifique una cuenta de Twilio.
Actualícelo para uso en producción.
Complete cualquier aprobación individual o comercial requerida.
Compre un número de teléfono con capacidad de voz.
Copie las credenciales de Twilio en vivo.
Conecte Twilio en Versafy.
Asigne el número a un flujo entrante y habilite las llamadas salientes cuando sea necesario.
Pruebe ambas direcciones de llamada.

1. Cree y verifique una cuenta de Twilio

Al crear su propia cuenta de Twilio, la propiedad de los números, los registros regulatorios, los pagos y el uso se mantienen bajo el control de su organización.

Abierto Registro de Twilio y cree una cuenta utilizando una dirección de correo electrónico controlada por su organización.
Verifique la dirección de correo electrónico.
Verifica un número de teléfono real al que puedas acceder.
Complete las preguntas sobre su proyecto o uso previsto.
Habilite la autenticación multifactor y almacene la información de recuperación de forma segura.
En Twilio Console, confirme qué proyecto o subcuenta está viendo antes de comprar un número.

Las cuentas de Twilio comienzan con restricciones de prueba. Una prueba es útil para las pruebas iniciales, pero limita los números de teléfono, los destinos y quién puede recibir llamadas. Revisión Guía actual de cuentas de prueba de Twilio .

2. Actualice la cuenta Twilio para producción.

La actualización elimina importantes restricciones de prueba y permite que la cuenta admita llamadas normales de los clientes.

En la consola de Twilio, seleccione Actualizar, o abrir Administrador → Facturación de cuenta → Actualizar cuenta.
Cree el perfil de cuenta solicitado.
Ingrese su dirección real e información de pago.
Agregue el saldo inicial solicitado.
Confirme que el proyecto muestre un estado pagado antes de confiar en él para las llamadas de los clientes.

Twilio cobra por separado el alquiler de números de teléfono y el uso de llamadas. Revise los precios mostrados para el país y el número elegido antes de comprar.

3. Completar la aprobación individual o empresarial cuando sea necesario.

Las reglas sobre números de teléfono difieren según el país y el tipo de número. Twilio puede exigir prueba de quién utilizará el número y dónde se encuentra esa persona u organización. Completar la aprobación correcta protege el número de una activación retrasada o una desconexión posterior.

Elija el tipo de usuario final correcto

Elija la opción que coincida con el usuario legal real del número:

Negocios — elija esta opción cuando una empresa u organización registrada utilice el número. Utilice el nombre legal de la organización y los documentos de registro y dirección correspondientes.
individuo — elija esta opción cuando una persona vaya a utilizar y poseer el número a título personal. Utilice los documentos de identidad legal y dirección de esa persona.

No seleccione un tipo sólo porque su lista de documentos parece más fácil. La identidad, la dirección, el uso previsto y los documentos de respaldo enviados deben describir al usuario del número real y coincidir entre sí.

Cree un paquete regulatorio si Twilio lo requiere

No todos los números requieren la misma aprobación. comprobar Requisitos de número y país de Twilio para el país, tipo de número y tipo de usuario final que planea utilizar.

Cuando se requiere un paquete regulatorio:

En la consola de Twilio, abra Números de teléfono → Cumplimiento normativo → Paquetes.
Seleccionar Crear un paquete regulatorio.
Elija el país y el tipo del número de teléfono.
elegir Negocios o individuo como usuario final.
Ingrese la información de identidad y dirección solicitada exactamente como aparece en los documentos.
Cargue cada documento de respaldo solicitado.
Revise la información de uso previsto y envíe el paquete para su revisión.
Espere hasta que Twilio marque el paquete como aprobado antes de asignarlo a un número.

Twilio también puede requerir una dirección aprobada. Después de comprar el número, abre su Información regulatoria sección y asignar el paquete aprobado y la dirección cuando se solicite. Un paquete aprobado no es suficiente si no se ha asignado al número de teléfono correspondiente.

Las revisiones suelen tardar varios días hábiles y pueden tardar más en algunas regiones. No programe un lanzamiento de producción hasta que el número en sí muestre un estado conforme o utilizable. Ver Twilio Tutorial de cumplimiento normativo de la consola .

4. Compre un número Twilio con capacidad de voz

El número comprado es lo que marcan los clientes y lo que los destinatarios pueden ver en las llamadas salientes admitidas.

En la consola de Twilio, abra Productos y servicios → Números y remitentes → Números de teléfono.
Seleccionar Configurar un nuevo número de teléfono. En algunos diseños de consola, utilice Números de teléfono → Administrar → Comprar un número.
Elija el país y el tipo de número.
Requerir el Voz capacidad en los filtros de búsqueda.
Revise las capacidades del número, los requisitos de activación, el precio recurrente y las condiciones de uso.
Selecciona el número y completa la compra.
Asigne un paquete regulatorio aprobado y una dirección si Twilio los solicita.
Abierto Números de teléfono → Administrar → Números activos y confirme que el número esté activo en el proyecto o subcuenta deseado.

No es necesario crear una troncal SIP elástica ni configurar manualmente un webhook de voz entrante para esta conexión. Versafy configura el enrutamiento de voz activo cuando asigna el número a un flujo de llamadas entrantes.

Ver Twilio guía actual de compra de números si las etiquetas de su Consola difieren.

5. Copie las credenciales de Twilio en vivo.

Versafy utiliza las credenciales para verificar la cuenta, mostrar sus números de teléfono y administrar el enrutamiento de voz que apruebe.

Abra el panel de la consola de Twilio.
encontrar Información de cuenta o abrir el Banco de trabajo panel.
Copia el ID de cuenta. El SID de una cuenta real normalmente comienza con AC.
Revelar y copiar el Token de autenticación.
Confirme una vez más que estas credenciales pertenecen al proyecto o subcuenta propietaria del número de teléfono.

Utilice el SID de cuenta real y el token de autenticación, no credenciales de prueba, una clave API, una contraseña SIP o credenciales de una subcuenta diferente. Twilio Guía del banco de trabajo muestra dónde aparecen los valores en la consola actual.

Trate el token de autenticación como una contraseña. No lo incluya en documentación, mensajes de chat, capturas de pantalla, correos electrónicos o tickets de soporte. Si puede haber quedado expuesto, gírelo en Twilio y actualice inmediatamente la conexión en Versafy.

6. Conecte Twilio en Versafy

Al conectar la cuenta, todos los números elegibles propiedad de ese proyecto o subcuenta de Twilio son visibles en Versafy.

Navegación: Abierto Teléfono → Números de teléfono.

Encuentra el Conecta Twilio cuando estés listo pancarta.
Seleccionar Conecta Twilio.
Pega el ID de cuenta.
Pega el Token de autenticación.
Seleccionar Guardar.
Confirma que la página muestra Twilio conectado y, cuando esté disponible, el nombre correcto de la cuenta de Twilio.
Seleccione el Números pestaña.
Si el nuevo número aún no es visible, seleccione Actualizar una vez.

Versafy admite una cuenta Twilio conectada directamente por espacio de trabajo. La conexión de credenciales de reemplazo cambia esa conexión; no agrega una segunda cuenta de Twilio.

7. Configurar el uso entrante y saliente

Las llamadas entrantes y salientes se habilitan por separado, por lo que cada número se utiliza únicamente para la experiencia del cliente que desea.

Asignar el número a un flujo entrante

Una asignación entrante determina lo que sucede cuando un cliente llama al número; por ejemplo, responder con un agente de voz, llamar a los operadores durante el horario comercial o grabar el correo de voz fuera del horario laboral.

Abierto Teléfono → Números de teléfono → Flujos de llamadas entrantes.
Crea y activa el recorrido de llamada que necesitas. Ver Flujos de llamadas entrantes.
Regresar a la Números pestaña.
Encuentra el número de Twilio.
bajo Conéctese a un flujo de llamadas entrantes, seleccione el flujo activo.
Espere hasta que aparezca el número Flujo de llamadas entrantes adjunto y el nombre del flujo previsto.

Propiedad del enrutamiento de voz: Mientras se adjunta un flujo entrante, Versafy controla la voz, el respaldo y el enrutamiento del estado de la llamada del número en Twilio. Desconectar el número borra esa ruta. Si el número pertenecía anteriormente a otra aplicación, registre su configuración anterior antes de adjuntarlo.

A diferencia de un número SIP externo, un número Twilio conectado directamente puede utilizar flujos estándar con operadores, horarios, anuncios, rutas de escalamiento y correo de voz, sujeto a los permisos y el plan de su espacio de trabajo.

Habilitar llamadas salientes

La habilitación saliente hace que el número sea seleccionable como número de llamada para llamadas de Voice Agent y campañas elegibles.

Encuentra el número debajo Teléfono → Números de teléfono → Números.
Seleccionar Habilitar llamadas salientes.
Espere hasta que se muestre la fila Saliente habilitado.
Si planea realizar llamadas internacionales, revise los permisos geográficos de Voz de Twilio y habilite solo los países que su organización necesita.

8. Pruebe ambas direcciones de llamada

Las pruebas confirman que la cuenta, el número, el flujo y el agente de voz de Twilio están conectados correctamente antes de que los clientes dependan de ellos.

Probar llamadas entrantes

Llame al número de Twilio desde un teléfono independiente.
Confirme que comience el saludo correcto o el primer paso del flujo.
Pruebe cada ruta importante, incluido el operador, el horario, la derivación y las ramas del correo de voz, cuando se utilicen.
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 conectado como número de la persona que llama.
Introduzca el destino en formato internacional E.164, incluido + y el código del país.
Responda la llamada y verifique el audio bidireccional y el número de la persona que llama.
comprobar Llamadas y grabaciones antes de volver a intentar un intento fallido o poco claro.

Administrar o eliminar la conexión

Abierto Teléfono → Números de teléfono, luego seleccione Twilio conectado en el encabezado de la página para ver su configuración.

uso Rotar o reemplazar credenciales después de cambiar el token de autenticación o mover intencionalmente el espacio de trabajo a otra cuenta de Twilio.
uso Eliminar integración solo cuando tenga la intención de desconectar Twilio del espacio de trabajo.

Al eliminar la integración también se eliminan las configuraciones del número de teléfono Versafy, los flujos de llamadas entrantes y los grupos de operadores asociados. Los agentes de voz ya no recibirán llamadas hasta que se vuelva a configurar la telefonía. Quitar la conexión Versafy no libera el número de teléfono de su cuenta Twilio.

Solución de problemas

Versafy rechaza las credenciales

Confirme que el SID de la cuenta comience con AC, el token de autenticación es el token activo actual y ambos valores provienen del mismo proyecto o subcuenta de Twilio. Cópielos nuevamente sin espacios iniciales ni finales.

El número de Twilio no aparece en Versafy

Confirme que el número esté activo en el proyecto o subcuenta conectado y que sea compatible con Voice. bajo Teléfono → Números de teléfono → Números, seleccione Actualizar una vez. Si sigue ausente, abrir Twilio conectado y confirme la cuenta mostrada antes de reemplazar las credenciales.

Twilio no te dejará comprar ni activar el número

Revise el país, el tipo de número, el tipo de usuario final, el saldo de la cuenta y los requisitos reglamentarios. Confirme que el paquete y la dirección correctos estén aprobados y asignados al número. Utilice el soporte de Twilio para una revisión regulatoria rechazada o inusualmente retrasada.

Las llamadas entrantes no siguen la ruta prevista

Confirme que el flujo está activo y que la fila numérica muestra Flujo de llamadas entrantes adjunto con el nombre de flujo correcto. Si la configuración numérica de Twilio se editó después de la asignación, vuelva a conectar el flujo en Versafy y vuelva a realizar la prueba.

El número no está disponible para llamadas salientes.

Confirme que admite voz y muestra Saliente habilitado. Verifique el estado del agente de voz, el formato de destino, el saldo de Twilio, las restricciones de prueba y los permisos geográficos.

Una llamada de prueba llega solo a algunos destinos

Las cuentas de prueba de Twilio restringen las llamadas a destinatarios verificados e imponen límites de uso y de otros países. Actualice la cuenta para producción y revise las restricciones de prueba actuales de Twilio antes de solucionar problemas de configuración de Versafy.