Unir contactos

Une un contacto duplicado con otro, igual que Unir contactos en la página de Contactos. Úsalo cuando POST /contacts o GET /contacts muestren dos contactos para la misma persona.

POST/contacts/merge

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.

La unificación no se puede deshacer: el duplicado se elimina una vez que sus datos pasaron al contacto que se conserva.

Cuerpo de la solicitud

Parámetro	Tipo	Obligatorio	Descripción
`survivor_id`	String	Obligatorio	UUID del contacto que se conserva.
`loser_id`	String	Obligatorio	UUID del duplicado. Se unifica con el conservado y se elimina.
`field_choices`	Object	Opcional	Qué valor gana cuando ambos contactos tienen uno, por campo: un objeto que asigna a cada nombre de campo survivor o loser, p. ej. {"email": "loser"}. Acepta first_name, last_name, email y collected_data.<clave> para una clave dentro de collected_data (p. ej. collected_data.rut). Los campos no listados conservan el valor del contacto que se queda.

Ejemplo de solicitud

bash

curl -X POST "https://api.eclecticlabs.com/api/external/v2/contacts/merge" \
  -H "X-API-Key: ek_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "survivor_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "loser_id": "9c1e6d2a-0b7f-4c3d-8a52-7e1f0d4b9a11",
    "field_choices": { "email": "loser" }
  }'

Ejemplo de respuesta

json

{
  "success": true,
  "survivor_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Notas

Las conversaciones, mensajes e historial del duplicado pasan al contacto conservado. Este completa sus campos vacíos con los del duplicado, y las etiquetas y datos personalizados se combinan.
El email y el teléfono del duplicado quedan como alias del contacto conservado, así que los mensajes y llamadas a la API futuros que los traigan resuelven a ese contacto.
Posibles errores: 400 (validación, o una unificación no permitida: el mismo contacto dos veces, o un contacto de prueba con uno real), 401 (API key inválida o ausente), 404 (algún contacto no existe en tu negocio), 500 (error interno).