Pular para o conteúdo principal
GET
Buscar contato por ID

Autorizações

Authorization
string
header
obrigatório

Token JWT de autenticação

Cabeçalhos

x-company-id
string

Identificador da empresa-alvo. Obrigatório apenas para API Keys globais (type=global). Ignorado para API Keys de empresa e usuários humanos.

Parâmetros de caminho

id
string
obrigatório

ID do contato

Resposta

Contato encontrado com sucesso

name
string
obrigatório

Nome do contato

company
any
obrigatório

Empresa do contato

_id
string

ID do contato

id
string

ID do contato (mesmo valor de _id)

country_code
string

Código do país do número. Ausente junto com o telefone quando o contato só tem identificador do WhatsApp.

email
string

E-mail do contato

last_activity_at
any

Data da última atividade do contato

phone_number
string

Número de telefone do contato. Ausente quando o contato só tem identificador do WhatsApp.

linkedin_identifier
string

Identificador do perfil do LinkedIn

job_title
string

Cargo do contato

seniority
string

Nível de senioridade do contato

department
string

Departamento do contato

country
string

País do contato

region
string

Estado ou região do contato

city
string

Cidade do contato

experience
string

Experiência profissional do contato

skills
string

Habilidades do contato

additional_attributes
object

Valores dos campos personalizados do contato, por slug. Gravado via additional_attributes, o valor vem no envelope { id, value, type, updatedAt }. Gravado via custom_fields (PUT), vem cru: o option_id (select), a lista de option_id (multi_select) ou o texto (text).

business
string | null

ID do Business ao qual o contato pertence

notes
object[]

Notas registradas no contato

marketing_opt_out
object

Opt-out de marketing por meio de comunicação (whatsapp, email, linkedin). Ausente ou vazio quando o contato não pediu para sair de nenhum meio.

do_not_contact
object | null

Estado "Não abordar": objeto enquanto bloqueado, null depois do desbloqueio, ausente em quem nunca foi marcado. Bloqueia todo envio automático, em todos os canais.

whatsapp_user_id
string

Identificador do contato no WhatsApp (BSUID), atribuído pela Meta. String opaca.

whatsapp_username
string

@username do contato no WhatsApp, como a Meta envia

whatsapp_parent_user_id
string

parent_user_id do contato no WhatsApp, como a Meta envia

createdAt
any

Data de criação do contato

updatedAt
any

Data de atualização do contato