Eliminar un contacto

Elimina de forma permanente un contacto del negocio autenticado, igual que Eliminar en la página de Contactos.

DELETE/contacts/:uuid

Autenticación

Este endpoint se autentica con tu API key enviada en la cabecera X-API-Key (formato ek_live_...). Puedes gestionar tus API keys desde la sección Dev Tools del panel.

No se puede deshacer. El contacto se elimina junto con sus conversaciones y mensajes, y se cancelan los seguimientos programados para él.

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción
`uuid`	String	Obligatorio	UUID del contacto a eliminar.

Ejemplo de solicitud

bash

curl -X DELETE "https://api.eclecticlabs.com/api/external/v2/contacts/eb2b914a-977e-4ab8-96e7-b886698b3eac" \
  -H "X-API-Key: ek_live_your_api_key_here"

Ejemplo de respuesta

json

{
  "success": true,
  "contact_id": "eb2b914a-977e-4ab8-96e7-b886698b3eac"
}

Notas

Si el contacto es un duplicado, prefiere POST /contacts/merge: conserva el historial y la persona sigue llegando al contacto que queda.
No se requiere cuerpo en la solicitud.
Posibles errores: 401 (API key inválida o ausente), 404 (contacto no encontrado en tu negocio), 500 (no se pudo eliminar el contacto).