> ## 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.

# Conectar tu número de Twilio

> Integración nativa con Twilio: trae un número de tu propia cuenta, asígnalo a un agente y entiende qué cubre hoy el carril saliente y el entrante.

Ryvo **no vende números telefónicos**. Tu agente marca y contesta desde un número de **tu propia cuenta de Twilio**: tú eres el dueño de la línea, Twilio te cobra la telefonía y Ryvo te cobra sólo los créditos del agente.

La integración es **nativa**: guardas las credenciales de tu cuenta de Twilio una vez, Ryvo las verifica contra Twilio en ese momento y a partir de ahí opera el número por ti. No hay que instalar nada ni mantener un servidor en medio.

## Qué necesitas

1. Una **cuenta de Twilio** con saldo o método de pago. Una cuenta de prueba (*trial*) sólo puede llamar a números verificados en ella.
2. Un **número con capacidad de voz** comprado en esa cuenta.
3. Un **agente publicado** en Ryvo. Un agente en borrador no se puede asignar a un número.

<Note>
  Si tu número ya estaba conectado a Ryvo desde antes, no hace falta que hagas nada: sigue funcionando como hasta ahora. Esta guía es para los números que conectes tú.
</Note>

## Paso 1: elige el número en Twilio

<Steps>
  <Step title="Abre la consola de Twilio">
    En [console.twilio.com](https://console.twilio.com) ve a **Phone Numbers → Manage → Active numbers**.
  </Step>

  <Step title="Compra uno si aún no lo tienes">
    En **Buy a number**, filtra por país y marca la capacidad **Voice**. Un número sin voz sirve para SMS, pero no para tu agente.
  </Step>

  <Step title="Cópialo en formato E.164">
    Es el formato con el `+` y el código de país, sin espacios ni guiones: `+5215512345678`. Es como Twilio lo muestra.
  </Step>
</Steps>

## Paso 2: copia tus credenciales

En la pantalla principal de la consola, en **Account Info**, están los dos datos que Ryvo necesita:

| Dato            | Cómo se ve                                   | Dónde                         |
| --------------- | -------------------------------------------- | ----------------------------- |
| **Account SID** | Empieza con `AC`, 34 caracteres              | Twilio Console → Account Info |
| **Auth Token**  | 32 caracteres, oculto hasta que das **Show** | Twilio Console → Account Info |

<Warning>
  Usa el **Account SID de la cuenta**, no el de un *subaccount* ni el de una API key. Es el error más común al conectar, y Ryvo lo rechaza con un mensaje claro.
</Warning>

## Paso 3: conéctalo en Ryvo

<Frame caption="Números → 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 del portal de Ryvo" 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           | Qué va                                                            | Formato                         |
| --------------- | ----------------------------------------------------------------- | ------------------------------- |
| **Número**      | El que elegiste en el paso 1                                      | E.164: `+5215512345678`         |
| **Etiqueta**    | El nombre con el que lo vas a reconocer: «Ventas CDMX», «Soporte» | Hasta 80 caracteres             |
| **Account SID** | Del paso 2                                                        | Empieza con `AC`, 34 caracteres |
| **Auth Token**  | Del paso 2                                                        | 32 caracteres                   |

Al guardar, Ryvo **llama a Twilio con esas credenciales antes de guardar nada**. Si Twilio las rechaza, lo ves en el formulario en ese momento, no días después cuando el teléfono no suena.

### Qué pasa con tus credenciales

* Se guardan **cifradas** y no se vuelven a mostrar en ninguna pantalla.
* Se usan para que tu agente marque desde tu número; Ryvo no las usa para nada más.
* Si rotas el Auth Token en Twilio, vuelve a importar el número con el token nuevo.

<Note>
  No hay límite de números por plan. El límite que sí aplica es el de [llamadas simultáneas](/guides/billing/usage-and-quotas).
</Note>

## Paso 4: asígnalo a un agente

En la tabla, cada número tiene un selector **Agente asignado**:

* Elige un agente y el número pasa a **Activo**.
* «Sin asignar» lo deja **Inactivo**: sigue conectado, pero no atiende a nadie.

Un número atiende **a un solo agente**; un agente puede tener **varios números** (por ejemplo, uno por ciudad o por campaña).

## Llamadas salientes y entrantes

| Tipo de llamada                       | Estado hoy                                                                                                                                                                                                                   |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Saliente** (tu agente marca)        | Queda lista al conectar el número. Ryvo marca desde tu cuenta de Twilio con las credenciales que guardaste.                                                                                                                  |
| **Entrante** (te llaman a ese número) | Necesita apuntar el *webhook* de voz del número, dentro de Twilio, hacia Ryvo. Todavía **no se hace desde el portal**: escríbenos a [team@ryvo.so](mailto:team@ryvo.so) con el número y el agente, y lo dejamos configurado. |

<Note>
  Conectar el número **no cambia** la configuración que ya tenga en Twilio. Si ese número hoy entra a tu conmutador o a otro flujo, sigue haciéndolo hasta que alguien lo reapunte a propósito.
</Note>

## Qué te cobra cada quien

| Concepto                                    | Quién lo cobra                                               |
| ------------------------------------------- | ------------------------------------------------------------ |
| Renta mensual del número y minutos de línea | **Twilio**, en tu cuenta y con tu tarjeta                    |
| El agente: voz, modelo y transcripción      | **Ryvo**, en [créditos](/guides/billing/credits-and-charges) |

## Quitar un número

En **Acciones → Eliminar**, Ryvo te pide escribir el número completo para confirmar. Se quita de Ryvo, pero **sigue siendo tuyo en Twilio**: puedes volver a conectarlo cuando quieras, o dejarlo para otro uso.

## Errores frecuentes

| Mensaje                                                         | Qué significa y qué hacer                                                                             |
| --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| «Usa formato E.164»                                             | Falta el `+` o el código de país, o hay espacios y guiones. `+5215512345678`.                         |
| «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 **Account Info**.                      |
| «Twilio rechazó esas credenciales»                              | El Auth Token no corresponde a ese Account SID, o lo rotaste en Twilio. Copia el vigente y reintenta. |
| «Agente no encontrado o aún no está configurado»                | El agente está en borrador. Publícalo y vuelve a asignar.                                             |
| «Demasiados intentos. Espera un momento»                        | Límite de peticiones por minuto. Reintenta en 60 segundos.                                            |

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Puedo usar un número que no sea de Twilio?">
    Hoy la conexión que puedes hacer tú mismo es con Twilio. Si tu número está en otro proveedor, escríbenos a [team@ryvo.so](mailto:team@ryvo.so) y te decimos qué se puede hacer con él.
  </Accordion>

  <Accordion title="¿Ryvo puede ver o usar mi cuenta de Twilio para otra cosa?">
    No. Las credenciales se guardan cifradas y se usan únicamente para operar las llamadas de tus agentes desde tus números.
  </Accordion>

  <Accordion title="¿Qué pasa si elimino el número en Ryvo?">
    Deja de atender llamadas de tus agentes. El número **sigue existiendo en tu cuenta de Twilio** con toda su configuración.
  </Accordion>

  <Accordion title="¿Puedo tener el mismo número en dos agentes?">
    No. Un número atiende a un agente a la vez. Si quieres repartir tráfico, conecta un número por agente.
  </Accordion>

  <Accordion title="Mi cuenta de Twilio es de prueba, ¿sirve?">
    Sirve para probar, pero Twilio sólo deja llamar a números verificados dentro de esa cuenta y antepone un mensaje grabado. Para operar de verdad, activa la cuenta en Twilio.
  </Accordion>
</AccordionGroup>