Skip to main content
Cuando un número de tu cuenta de Twilio queda conectado a un agente, ese agente contesta todas las llamadas al número y puede marcar desde él. No hay nada más que configurar en Twilio: Ryvo apunta el número a tu agente por ti.
Esta guía es para los agentes hechos en el Constructor. Si todavía no tienes un número en Ryvo, empieza por Conecta tu número de Twilio.

Lo que necesitas

  1. Un número de Twilio importado en Números.
  2. Un agente publicado. Las llamadas usan siempre la versión publicada, nunca el borrador que estás editando.
  3. Un método de pago guardado y créditos en tu cuenta. Las llamadas se cobran como cualquier otra conversación del agente.

Conecta el número al agente

1

Abre el agente en el Constructor

Desde Agentes, abre el agente y entra a la pestaña Canales.
2

Elige el número

En la tarjeta Voz, elige uno de tus números libres en Elige un número y pulsa Conectar número.
3

Listo

La tarjeta pasa a Conectado y dice en qué número contesta. También lo puedes hacer desde Números, con el selector Asignar agente de cada fila.
La tarjeta Voz de Twilio marcada como conectada, con Soltar número e Iniciar llamada

La tarjeta Voz en la pestaña Canales del Constructor, con un número conectado.

Qué cambia Ryvo en tu cuenta de Twilio

Al conectar el número, Ryvo configura su webhook de voz en Twilio para que las llamadas entrantes lleguen a tu agente, y guarda la configuración anterior. Si sueltas el número (Soltar número) o lo borras de Ryvo, se restaura la configuración anterior. Ryvo no toca nada más de tu cuenta.
Si el número mandaba las llamadas a un conmutador u otro flujo, eso deja de pasar en cuanto lo conectas a un agente. Usa un número dedicado, o suéltalo para volver al ruteo anterior.

Llamadas entrantes

Quien marque al número habla con tu agente. El agente saluda primero con su primer mensaje y la conversación sigue sus instrucciones, su conocimiento y sus tools, igual que en la prueba del Constructor. Si el agente no puede atender, quien llama oye un mensaje corto en el idioma del agente y la llamada termina. Pasa cuando:
  • el agente está pausado o no tiene versión publicada;
  • la cuenta no tiene créditos o no tiene método de pago;
  • la cuenta llegó a su tope de llamadas simultáneas.
Quien llama nunca oye el motivo. Tú lo ves en Logs.

Llamadas salientes

Desde el Constructor

En la misma tarjeta Voz, escribe el número a marcar en Número de Destino (formato E.164, por ejemplo +5215512345678) y pulsa Iniciar llamada. El agente marca desde su número conectado con su versión publicada.
El campo Número de Destino y el botón Iniciar llamada

Número de Destino e Iniciar llamada.

El botón queda apagado, con el motivo al lado, mientras el agente no tenga número o no esté publicado.

Desde la API

POST /v1/calls acepta el id de un agente del Constructor. La llamada sale del número conectado a ese agente, o del que mandes en from si también está conectado a él.
La respuesta trae "runtime": "engine" y el id de la llamada. El detalle completo, en la referencia de la API.

Llamadas que nadie contesta

Si del otro lado no contestan, está ocupado o la llamada falla, Twilio le avisa a Ryvo al momento y la llamada se cierra en segundos. No se cobra y no ocupa la capacidad de tu cuenta.

Dónde ves tus llamadas

Cada llamada aparece en Llamadas con su número, su dirección (entrante o saliente), duración, transcripción y costo. En la API, GET /v1/calls las devuelve con channel: "phone" y direction.

Quién te cobra qué

Errores comunes