Pular para o conteúdo

Identidade do contato

Em toda conversa, o Agente já recebe o contato vinculado àquela conversa. Esses dados vêm dos cadastros da plataforma. Não há tipo Identificação do contato em Builder → Ferramentas.

Use esses valores nas Table Tools, na HTTP Request Tool ou na Message Sending Tool.


O Agente vê:

  • contact_id — ID estável do contato na plataforma
  • external_user_id — ID do cadastro do contato neste canal
  • sender_identifier — identificador do canal; pode ser diferente do telefone
  • sender_name — nome cadastrado do contato
  • sender_phone — telefone cadastrado, com código do país e apenas dígitos

Dados ausentes voltam vazios. Identificadores LID do WhatsApp, Instagram e Telegram não são tratados como telefone: use sender_phone só quando o número estiver cadastrado.

O Agente usa esses dados internamente e só os mostra na conversa quando o contato pede.


Nas Instruções do Agente, descreva quando usar o contato da conversa — por exemplo, antes de gravar um lead, chamar uma API ou enviar uma mensagem para o número da conversa. Peça para usar os valores cadastrados, sem inventar identificador nem tratar o identificador do canal como telefone.

Teste no chat interno antes de publicar o canal.