Colgar llamada

POST /api/v1/calls/hangup

Este endpoint permite colgar/cortar la llamada generada a través del uso del endpoint Generar llamada.

Para lo cual se requiere el identificador de acción para realizar el proceso de colgado.

ℹ Recuerda que:

La URL base para todas las solicitudes es: https://tu-dominio.c3.pe

Importante: reemplaza tu-dominio por el nombre de dominio específico que te haya proporcionado C3.

Solicitud

Cabeceras

Encabezado	Tipo	Obligatorio	Descripción
Authorization	String	✅ Sí	Token de autenticación (Bearer Token).

Cuerpo de la solicitud (Body)

Atributo	Tipo	Obligatorio	Descripción
actionid	String	✅ Sí	Identificador de la acción Originate generada en el previo endpoint.

Ejemplo de solicitud

POST /api/v1/calls/hangup

El cuerpo de la solicitud debe enviarse en formato JSON e incluir los siguientes campos:

{
    "actionid": "api_kdfdkjds4545454bkk4j35",
}

Respuesta

Respuesta Exitosa 200

{
    "message": "La solicitud se completó con éxito!",
	"data": {
        "actionid": "api_kdfdkjds4545454bkk4j35"
    }
}

Definición de atributos

Campo	Tipo	Descripción
message	String	Mensaje de respuesta del servidor.
data	Object	Objeto que contiene información básica de la generación de llamada.
data.actionid	String	Se obtiene el mismo identificador de acción enviado en la solicitud.

Errores generales

Código HTTP	Tipo	Causa común
401	Unauthorized	El token de acceso no fue proporcionado en el encabezado Authorization, es inválido o ha sido revocado. Verifique que el token sea correcto y esté activo.
422	Unprocessable Entity	La solicitud fue entendida, pero contiene errores semánticos que impiden su procesamiento. Esto puede deberse a: 1. Parámetros faltantes o inválidos (ej, from_date no es una fecha válida); 2. Recurso inexistente (wa_number no registrado en el sistema); 3. Violación de reglas de negocio (el rango de fechas excede el límite permitido).
500	Server Error	Error interno del servidor. Intenta nuevamente más tarde o contacta soporte técnico.