Obtener un contacto

Recupera el perfil de un contacto, sus etiquetas, usuario asignado y campos personalizados.

GET/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.

Parámetros de ruta

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

Parámetros de consulta

Parámetro	Tipo	Obligatorio	Descripción
`include_field_types`	Boolean	Opcional	Si es true, la respuesta incluye customFieldsMetadata con el tipo (y opciones) de cada campo personalizado.

Ejemplo de solicitud

bash

curl -X GET "https://eclectic-api-537143970188.us-central1.run.app/api/external/v2/contacts/eb2b914a-977e-4ab8-96e7-b886698b3eac" \
  -H "X-API-Key: ek_live_your_api_key_here"

Ejemplo de respuesta

json

{
  "contact": [
    {
      "uuid": "eb2b914a-977e-4ab8-96e7-b886698b3eac",
      "name": "John Doe",
      "phoneNumber": "+56912345678",
      "avatarUrl": null,
      "createdAt": "2024-09-23T20:09:10Z",
      "source": "whatsapp",
      "closedAt": null,
      "href": "https://dash.try-eclectic.com/contacts/eb2b914a977e4ab896e7b886698b3eac",
      "conversationHref": "https://dash.try-eclectic.com/chat/f3670b13446b412796238b1cd78899f9",
      "tags": ["vip"],
      "assignedUser": "agent@example.com",
      "customFields": {
        "rut": "12345678-9"
      }
    }
  ]
}

Notas

El contacto debe pertenecer al negocio autenticado por la API key.
Errores posibles: 401 (API key inválida o ausente), 404 (contacto no encontrado).