Pular para o conteúdo
Contatos

Atualizar contato

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

Campo ausente = não mexe; null explícito limpa. Campo fora da lista é recusado com validation_error (nunca ignorado em silêncio) — etiquetas têm rota própria, POST /contacts/{id}/tags.

Parâmetros de caminho

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

  • idstringobrigatório
    • tamanho mín. 1

Corpo da requisição

application/jsonobrigatório
  • namestringopcional
    • tamanho 1–200
  • phonestring | nullopcional
    • tamanho máx. 20
  • emailstring (email) | nullopcional
    • tamanho máx. 200
    • regex "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\…
  • companystring | nullopcional
    • tamanho máx. 200
  • companyIdstring | nullopcional
    • tamanho máx. 80
  • cpfstring | nullopcional
    • tamanho máx. 20
  • rolestring | nullopcional
    • tamanho máx. 120
  • notesstring | nullopcional
    • tamanho máx. 10000
  • customFieldsobjeto livreopcional
    • chave string
    • valor qualquer valor JSON

Respostas

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

200Deu certoapplication/json

O contato já com os campos alterados — a resposta é lida DEPOIS da Ação, então reflete o estado final.

V1ContactEscrito

  • 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.

  • idempotency_replaybooleanpode faltar

    Só presente (e sempre true) quando a Idempotency-Key repetiu uma escrita anterior.