Saltar al contenido principal
GET
Obtener contacto por UUID

Autorizaciones

Authorization
string
header
requerido

API token emitido desde Settings → API Token del dashboard 1TO1 AI. Enviar en header Authorization: Bearer sk_1to1_...

Parámetros de ruta

slug
string
requerido

Slug del business, case-insensitive. Debe coincidir con el business del token.

Ejemplo:

"acme"

uuid
string<uuid>
requerido

UUID del contacto

Respuesta

OK

uuid
string<uuid>
requerido
first_name
string | null
requerido
middle_name
string | null
requerido
last_name
string | null
requerido
second_last_name
string | null
requerido
full_name
string | null
requerido
Ejemplo:

"Mariana López"

whatsapp_id
string | null
requerido

Teléfono del contacto (wa_id sin +). Identificador legacy; coexiste con whatsapp_user_id.

Ejemplo:

"525511223344"

whatsapp_user_id
string | null
requerido

Identificador forward-compatible del contacto. Devuelve el BSUID real cuando el contacto lo tiene; mientras Meta no migre, hace fallback al wa_id (whatsapp_id) para que siempre haya un valor resoluble. Si el contacto aún no tiene BSUID, este campo trae el teléfono: para resolver una conversación reenvíalo como phone, no como whatsapp_user_id (el resolver solo acepta BSUIDs reales y daría 404). Recomendado para nuevos clientes.

Ejemplo:

"MX.2658176374597251"

whatsapp_username
string | null
requerido

Username público de WhatsApp del contacto (sin @). Best-effort: es el último username observado por la plataforma y el usuario puede cambiarlo — útil para display y como identificador de resolución secundario (username en ConversationRef), nunca como clave estable (esa es uuid).

Ejemplo:

"mariana.lopez"

acquisition_source
string
requerido
Ejemplo:

"whatsapp"

is_tester
boolean
requerido

Contacto creado desde el módulo tester del dashboard (datos ficticios). El listado devuelve reales y tester mezclados; filtrar por este campo si el cliente solo necesita uno de los dos. Para solo-tester existe /tester/contacts.

Ejemplo:

false

created_at
string<date-time>
requerido
updated_at
string<date-time>
requerido