Eliminar vía de contacto

DELETE /api/v1/contacts/{id}/contact-sources

Este endpoint permite eliminar una vía de contacto específica (como un número de teléfono o correo electrónico) de un contacto existente.

Para identificar la vía de contacto que se desea eliminar, es necesario proporcionar tanto su type como su source en el cuerpo de la solicitud.

Al eliminar una vía de contacto existente, se registra un evento en el historial del contacto para mantener un registro de auditoría.

ℹ 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).

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción
id	Integer	✅ Sí	Identificador único del contacto al que pertenece la vía a eliminar.

Cuerpo de la solicitud

Atributo	Tipo	Obligatorio	Descripción
type	String	✅ Sí	Tipo de la vía de contacto a eliminar. Valores permitidos: CELL_PHONE, EMAIL, PHONE.
source	String	✅ Sí	El valor exacto de la vía de contacto a eliminar (ej: +51987654321 o juan@example.com).

⚠️ Importante: Formato del source

Para eliminar una vía de contacto de tipo CELL_PHONE o PHONE, debe enviar el valor del source en su formato normalizado, tal como lo devuelve la API en otros endpoints.

Por ejemplo, si un contacto tiene el número 987654321, la plataforma lo almacena como +51987654321. Es este último valor el que debe utilizar para la eliminación.

Ejemplo de solicitud

DELETE  /api/v1/contacts/66/contact-sources

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

{
  "type": "CELL_PHONE",
  "source": "+51987654321"
}

Respuesta

Respuesta base 200 OK

Se devuelve cuando la vía de contacto se elimina correctamente o si no existía previamente.

{
    "message": "Vía de contacto eliminada exitósamente.",
    "data": null
}

Definición de atributos

Campo	Tipo	Descripción
message	String	Mensaje de éxito de la operación.
data	null	No se devuelve ningún dato.

Errores específicos del endpoint

Además de los errores generales, este endpoint puede devolver los siguientes errores específicos de validación y lógica de negocio:

Código HTTP	Ejemplo	Causa Común
404	{ "message": "Vía de contacto no encontrada" }	El `type` o `source` proporcionado en la URL no corresponde a ninguna vía de contacto existente.
404	{ "message": "Contacto no encontrado" }	El id proporcionado en la URL no corresponde a ningún contacto existente.

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.