Principal APIs Como importar contatos via HubSpot

Como importar contatos via HubSpot

Última atualização em May 21, 2026

Quando usar

  • Você quer criar ou atualizar contatos no Cloud Chat automaticamente quando algo acontece no HubSpot
  • Sua base de contatos é mantida no HubSpot e você quer mantê-la sincronizada com o Cloud Chat
  • Você está montando workflows que precisam disparar com contatos atualizados no helpdesk

Pré-requisitos

Sobre este tutorial

Usando o endpoint de importação do Cloud Chat, é possível criar ou atualizar contatos via webhooks integrados ao HubSpot.

Para a referência completa do endpoint (campos aceitos, comportamento de upsert e limitações), veja Como importar um contato individual via API.

Endpoint usado

O webhook do HubSpot deve apontar para:

POST https://{{CLOUDCHAT_DOMAIN}}/api/v1/accounts/{{ACCOUNT_ID}}/contacts/external_import

Passo a passo

Etapa 1 — Criar o Workflow

  1. Na sidebar principal do HubSpot, passe o mouse sobre Automações e clique em Fluxos de trabalho

  1. Clique em Criar fluxo de trabalho e selecione Do zero

  1. Selecione Baseado em Contato e clique em Próximo

Etapa 2 — Configurar a requisição do Webhook

  1. Adicione uma ação clicando em +

  1. No painel esquerdo, clique em Operações de dados e selecione Envie um webhook

  1. Escolha POST

  1. Preencha a URL e a chave de API

A chave de API deve ser configurada em Gerenciar Segredos do HubSpot.

Etapa 3 — Configurar campos do contato

Preencha os campos do contato para o disparo: name, phone_number, email, identifier (identificador único) e quaisquer atributos customizados disponíveis.

Pelo menos um entre phone_number, email e identifier é obrigatório para a criação do contato.

Se o contato já existir na sua base, ele é atualizado com os campos enviados. Caso contrário, um novo contato é adicionado.

Observações