Skip to main content
GET
Get a webhook endpoint

Autorizaciones

Authorization
string
header
requerido

A Bearer token. Create keys in the portal under Settings > API keys (https://app.ryvo.so/developers). The token has the form ryvo_live_<64 hex characters> and is shown once.

Header: Authorization: Bearer ryvo_live_...

Parámetros de ruta

id
string<uuid>
requerido

The webhook endpoint uuid.

Respuesta

The endpoint.

id
string<uuid>
requerido
Ejemplo:

"7f8e9d0c-1b2a-4c3d-8e4f-5a6b7c8d9e0f"

url
string<uri>
requerido
Ejemplo:

"https://crm.acme.example/hooks/ryvo"

events
enum<string>[]
requerido
Opciones disponibles:
conversation.started,
conversation.ended,
analysis.ready,
call.initiated,
call.completed,
call.failed
Ejemplo:
is_active
boolean
requerido
consecutive_failures
integer
requerido
Ejemplo:

0

auto_disabled_at
string<date-time> | null
requerido

Set when Ryvo switched the endpoint off after repeated exhausted deliveries.

auto_disabled_reason
string | null
requerido
previous_secret_expires_at
string<date-time> | null
requerido

After a rotation, until when the previous secret still signs.

created_at
string<date-time>
requerido
updated_at
string<date-time>
requerido