# Ryvo API

> Documentación oficial de la API pública de Ryvo. Conecta tu CRM, herramientas internas o automatizaciones a tus agentes de voz IA.

## Docs

- [Disparar una llamada saliente](https://docs.ryvo.so/api-reference/calls/disparar-una-llamada-saliente.md): Inicia una llamada saliente desde uno de tus agentes hacia un número en formato E.164. La llamada se factura en tu wallet al terminar (no al disparar) usando la tarifa estándar de $0.29 USD/min prorrateado por segundo.
- [Autenticación](https://docs.ryvo.so/authentication.md): Bearer tokens con API keys que tú creas y revocas desde el portal.
- [Errores](https://docs.ryvo.so/errors.md): Códigos de error estables y cómo reaccionar a cada uno.
- [Idempotencia](https://docs.ryvo.so/idempotency.md): Cómo evitar disparar 2 llamadas si tu sistema reintenta la misma petición.
- [Empieza a construir con Ryvo](https://docs.ryvo.so/introduction.md): Todo lo que necesitas para integrar agentes de voz IA en tus apps. Desde tu primera petición hasta producción.
- [Quickstart](https://docs.ryvo.so/quickstart.md): Tu primera llamada disparada por API en menos de 5 minutos.
- [Rate Limits](https://docs.ryvo.so/rate-limits.md): Cuántas peticiones por minuto puedes hacer y cómo reaccionar al límite.
- [Webhooks](https://docs.ryvo.so/webhooks/overview.md): Recibe eventos firmados con HMAC cuando algo pasa en tus agentes.
- [Verificar firmas](https://docs.ryvo.so/webhooks/signature-verification.md): Valida con HMAC-SHA-256 que cada evento de webhook realmente viene de Ryvo.

## OpenAPI Specs

- [openapi](https://docs.ryvo.so/openapi.yaml)