> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryvo.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Números: importar tu número de Twilio

> Conecta un número telefónico de tu cuenta de Twilio, asígnalo a un agente y entiende qué llamadas cubre hoy.

Ryvo no vende números telefónicos: usas los de **tu propia cuenta de Twilio**. Twilio te cobra la telefonía (el minuto de línea) y Ryvo te cobra sólo los créditos del agente.

## Importar un número

<Frame caption="Números → (1) Importar número de Twilio.">
  <img src="https://mintcdn.com/ryvo-3dab4d1a/9EEXAZ5i3XN2oDZq/images/portal/numeros-anotado.png?fit=max&auto=format&n=9EEXAZ5i3XN2oDZq&q=85&s=49f127fe59364bc6dfb65408fc3a4f6f" alt="Pantalla de Números" width="1600" height="1000" data-path="images/portal/numeros-anotado.png" />
</Frame>

En **Números → Importar número de Twilio** llena los cuatro campos:

| Campo           | Dónde lo encuentras                      | Formato                                                         |
| --------------- | ---------------------------------------- | --------------------------------------------------------------- |
| **Número**      | Twilio Console → Phone Numbers           | E.164: `+5215512345678` (código de país + número, sin espacios) |
| **Etiqueta**    | Tú la inventas: «Ventas CDMX», «Soporte» | Hasta 80 caracteres                                             |
| **Account SID** | Twilio Console → Account Info            | Empieza con `AC`, 34 caracteres                                 |
| **Auth Token**  | Twilio Console → Account Info (Show)     | 32 caracteres                                                   |

Al guardar, Ryvo **prueba las credenciales contra Twilio**; si Twilio las rechaza verás «Twilio rechazó esas credenciales. Revisa el Account SID y el Auth Token». Las credenciales se guardan cifradas y no se vuelven a mostrar.

<Note>
  No hay límite de números por plan. El límite que sí aplica es el de [llamadas simultáneas](/guias/facturacion/uso-y-cuotas).
</Note>

## Asignar el número a un agente

En la tabla, cada número tiene un selector **Agente asignado**. Elige uno y el estado pasa a **Activo**; «Sin asignar» lo deja **Inactivo**. Un número atiende a un solo agente; un agente puede tener varios números.

## Entrante y saliente

| Tipo de llamada                | Estado hoy                                                                                                                                                                                                                    |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Saliente** (el agente marca) | Importar el número habilita este carril. Por ahora las llamadas del Constructor las dispara el equipo de Ryvo; el botón y la API para hacerlo tú mismo están en camino.                                                       |
| **Entrante** (te llaman)       | Requiere apuntar el webhook de voz del número en Twilio hacia Ryvo. Es una configuración por número que todavía no se hace desde el portal: escríbenos a [soporte@ryvo.so](mailto:soporte@ryvo.so) con el número y el agente. |

## Eliminar un número

**Acciones → Eliminar** pide que escribas el número para confirmar. Se quita de Ryvo (y de la plataforma de voz), pero **sigue existiendo en tu cuenta de Twilio**: si lo quieres de vuelta, lo importas otra vez.

## Errores frecuentes

| Mensaje                                                         | Qué hacer                                                               |
| --------------------------------------------------------------- | ----------------------------------------------------------------------- |
| «Usa formato E.164»                                             | Agrega el `+` y el código de país; quita espacios y guiones.            |
| «El Account SID de Twilio empieza con AC y tiene 34 caracteres» | Copiaste el SID de un subaccount o de una API key; usa el de la cuenta. |
| «Twilio rechazó esas credenciales»                              | El Auth Token cambió (Twilio permite rotarlo). Copia el vigente.        |
| «Agente no encontrado o aún no está configurado»                | Publica el agente antes de asignarle el número.                         |
| «Demasiados intentos. Espera un momento»                        | Límite de peticiones por minuto; reintenta en 60 s.                     |
