Documentación
API de Llamadas (voz).md

Actualizar llamada

PATCH /v2/update-call/{call_id}

Permite modificar los metadatos, configuración de almacenamiento y variables dinámicas de una llamada existente, ya sea que esté en curso o finalizada.

Parámetros de ruta

Campo Tipo Requerido Descripción
call_id string Sí ID de la llamada a actualizar. Ejemplo: call_a4441234567890777c4a4a123e6

Parámetros del cuerpo (todos opcionales)

Campo Tipo Descripción
metadata object Objeto libre para almacenar información adicional sobre la llamada. Tamaño máximo: 50 KB. Ejemplo: {"crm_id": "LEAD-9821", "notas": "Requiere seguimiento"}
data_storage_setting string Política de almacenamiento de datos para esta llamada. Valores: everything | everything_except_pii | basic_attributes_only. Nota: No se puede reducir a una política menos restrictiva que la actual.
override_dynamic_variables object Sobreescribe las variables dinámicas del agente durante la llamada activa. Envía null para eliminar las sobreescrituras existentes. Ejemplo: {"descuento_adicional": "15%"}
custom_attributes object Atributos personalizados para clasificación o análisis. Los valores pueden ser string, número o booleano. Ejemplo: {"segmento": "enterprise", "prioridad": 1}

Respuesta — 200 OK

Devuelve el objeto completo de la llamada actualizada, con el mismo esquema que Obtener llamada.

Ejemplos de solicitud

Agregar metadatos a una llamada finalizada

curl --request PATCH \
     --url https://calls.anunzi.net/v2/update-call/call_a4441234567890777c4a4a123e6 \
     --header 'Authorization: Bearer TU_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{
  "metadata": {
    "crm_id": "LEAD-9821",
    "resultado": "interesado",
    "agente_humano": "Carlos Méndez"
  }
}'

Modificar variable dinámica durante una llamada en curso

curl --request PATCH \
     --url https://calls.anunzi.net/v2/update-call/call_a4441234567890777c4a4a123e6 \
     --header 'Authorization: Bearer TU_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{
  "override_dynamic_variables": {
    "descuento_adicional": "20%",
    "plan_ofrecido": "Pro Anual"
  }
}'

Cambiar política de almacenamiento

curl --request PATCH \
     --url https://calls.anunzi.net/v2/update-call/call_a4441234567890777c4a4a123e6 \
     --header 'Authorization: Bearer TU_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{
  "data_storage_setting": "everything_except_pii"
}'

Políticas de almacenamiento

Valor Descripción
everything Se almacena todo: grabación, transcripción, análisis, PII.
everything_except_pii Se almacena todo excepto información personal identificable.
basic_attributes_only Solo se almacenan atributos básicos (duración, estado, timestamps). No se guarda grabación ni transcripción.

Códigos de estado

Código Descripción
200 Llamada actualizada correctamente.
400 Formato de solicitud inválido.
401 API Key ausente o inválida.
422 La llamada no existe bajo tu API Key.
500 Error interno del servidor.
Esc