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.