Módulo Voz

API de Voz

Gestiona llamadas entrantes y salientes, grabaciones y campañas de marcación automática desde tu sistema mediante la API de Voz de CIFRA 360.

Actualizado: Marzo 2026 Endpoint base: /v1/voice

Llamadas

El recurso calls permite iniciar llamadas salientes (click-to-call), consultar el estado de llamadas en curso y acceder al historial completo con sus grabaciones.

Iniciar una llamada saliente

POST /v1/voice/calls

JSON · Body

{
  "to": "+573001234567",
  "from_agent": "agent_id_xyz",
  "contact_id": "cnt_01HX2K9",
  "record": true,
  "campaign_id": null
}

Consultar estado de una llamada

GET /v1/voice/calls/{call_id}

JSON · Respuesta

{
  "id": "call_01HX9ABCDE",
  "status": "in_progress",
  "direction": "outbound",
  "duration_seconds": 127,
  "to": "+573001234567",
  "started_at": "2026-04-01T10:05:33Z",
  "recording_url": null
}

Suscríbete al webhook call.completed para recibir la URL de grabación automáticamente cuando finalice la llamada.

Grabaciones

Las grabaciones se almacenan cifradas en la infraestructura de CIFRA. Puedes acceder a ellas mediante URLs firmadas con expiración configurable.

GET /v1/voice/recordings

GET /v1/voice/recordings/{id}/url

La URL firmada tiene una duración predeterminada de 3600 segundos. Puedes configurarla con el parámetro expires_in (máximo 86400 segundos).

Campañas Outbound

Las campañas de marcación automática permiten lanzar llamadas masivas a listas de contactos con scripts predefinidos. Soportan marcación predictiva, progresiva y preview.

POST /v1/voice/campaigns

GET /v1/voice/campaigns/{id}/stats

PATCH /v1/voice/campaigns/{id}/status

API de Gestión CRM Siguiente: API de Chat