Disparar una llamada saliente

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.

Si tu wallet está vacío, tu suscripción está vencida o el agente está pausado, esta petición devuelve 402 o 422 y la llamada no se dispara.

Para evitar duplicados en reintentos, manda el header Idempotency-Key.

POST /v1/calls

cURL

minimal

curl --request POST \
  --url https://api.ryvo.so/v1/calls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "agent_8801kpabc123",
  "to": "[phone]"
}
'

201

{
  "id": "call_conv_01abcdef",
  "agent_id": "agent_8801kpabc123",
  "to": "[phone]",
  "status": "initiated",
  "created_at": "2026-04-30T18:32:11.123Z"
}

Authorizations

Authorization · string · header · required

Autenticación con un token Bearer. El token se obtiene desde https://app.ryvo.so/developers y tiene el formato ryvo_live_<64 hex>.

Header: Authorization: Bearer ryvo_live_…

Headers

Idempotency-Key · string

Identificador único (1-255 caracteres ASCII imprimibles) para que reintentos del mismo request devuelvan la misma respuesta sin disparar una segunda llamada. Cache de 24 horas. Reusar la misma key con un body distinto devuelve 409 idempotency_conflict.

Maximum string length: 255

Example:

"lead-abc-2026-04-30-001"

Body

application/json

agent_id · string · required

ID del agente de ElevenLabs (lo ves en app.ryvo.so/agentes). Debe pertenecer a tu cuenta.

Example:

"agent_8801kpabc123"

to · string · required

Número destino en formato E.164.

Pattern: ^\+[1-9]\d{6,14}$

Example:

"[phone]"

metadata · object

Diccionario opcional de variables que se pasan al agente como dynamic_variables. Máximo 5KB. Las llaves deben tener ≤64 chars, y los valores deben ser string, número, booleano o null.

Show child attributes

Example:

{
  "lead_name": "Juan García",
  "deal_id": "OPP-2026-0042"
}

Response

201

application/json

Llamada disparada

id · string · required

ID único de la llamada (call_<conversation_id>).

Example:

"call_conv_01abcdef"

agent_id · string · required

Example:

"agent_8801kpabc123"

to · string · required

Example:

"[phone]"

status · enum<string> · required

Estado al disparar. Para saber cómo terminó la llamada, escucha los webhooks call.completed / call.failed.

Available options: initiated

created_at · string<date-time> · required

Example:

"2026-04-30T18:32:11.123Z"