Pular para o conteúdo
Contatos

Buscar contato por id

v1.0.0
GEThttps://api.growthaisystem.com/api/v1/contacts/{id}
  • ExigeAuthorization: Bearer gos_…— Chave de API (gos_…)· escoposcontacts.read

Além dos campos de sempre, traz firstHumanTouchAt/lastHumanTouchAt (issue #728): a primeira e a última vez que alguém do seu time — não automação, não o próprio contato — tocou este contato (mensagem, ligação, e-mail ou nota; mesmo actor:"user" de /interactions). Desde 30/10/2026, também humanTouchCount (quantos toques) e firstHumanTouchChannel (o canal do primeiro, do mesmo registro de firstHumanTouchAt). Datas e canal null (e contagem 0) = nunca houve toque humano identificado. Só aparecem aqui, nunca em GET /contacts (a agregação é cara demais pra rodar por linha numa lista).

Parâmetros de caminho

Entram no próprio endereço, no lugar das chaves.

  • idstringobrigatório
    • tamanho mín. 1

Respostas

6 respostas documentadas — o código, o que ele significa nesta rota e a forma do corpo.

200Deu certoapplication/json

O contato, com os campos de toque humano (primeiro e último, quantidade e canal do primeiro) que só esta rota calcula.

V1Contact

  • idstring
  • namestring
  • phonestring | null
  • emailstring | null
  • companystring | null
  • companyIdstring | null
  • rolestring | null
  • cpfstring | null
  • notesstring | null
  • tagsstring[]
  • statusstring
    • um de"active""archived""merged"
  • ownerUserIdstring | null
  • originstring
  • customFieldsobjeto livre
    • chave string
    • valor qualquer valor JSON
  • createdAtstring
  • updatedAtstring
  • urlstring
    • sourcestring | null
    • mediumstring | null
    • campaignstring | null
    • termstring | null
    • contentstring | null
  • firstHumanTouchAtstring | nullpode faltar
  • lastHumanTouchAtstring | nullpode faltar
  • humanTouchCountintegerpode faltar

    Quantos toques humanos este contato recebeu (cada mensagem, ligação, e-mail ou nota com actor: "user" em /interactions conta um). 0 = nenhum. Mesma fonte de firstHumanTouchAt/lastHumanTouchAt; só vem em GET /contacts/{id}.

    • mín. 0
  • firstHumanTouchChannelstring | nullpode faltar

    O canal do PRIMEIRO toque humano — o mesmo registro de firstHumanTouchAt, no vocabulário de channel de /interactions (whatsapp, instagram, facebook, call, email, note…). Dois toques no mesmo instante: vale o de menor id de /interactions. null = nunca houve toque humano.