Nó: Criar/atualizar contato no HubSpot (em breve)

Em breve: o nó vai sincronizar contatos com o HubSpot por email nas automações de quadro ou workflows. Enquanto isso, use o nó HTTP com n8n, Make ou Zapier.

Jul 11, 2026

Veja este passo no vídeo · Contatos e variáveis

Em breve. A integração com o HubSpot já está construída, mas ainda não pode ser conectada no Omnifox; em Configurações → Integrações o cartão dela aparece como «Em breve», então hoje este nó sempre termina na saída de erro. Este artigo descreve como vai funcionar. Enquanto isso, você pode enviar o contato ao n8n, Make ou Zapier com o nó HTTP (a partir do plano Impulsa) e deixar essa ferramenta criá-lo ou atualizá-lo no HubSpot.

Quando a integração estiver disponível, o nó Criar/atualizar contato no HubSpot vai sincronizar um contato com sua conta HubSpot conectada, usando o email como chave: se já existir um contato com esse email ele será atualizado, senão será criado. Ele aparece tanto na automação de Quadros (Projetos) quanto em Workflows.

Quando usar

  • Quando um cartão de Projetos passa para "Concluído"/"Ganho" e você quer refletir o cliente no HubSpot.
  • Quando um negócio do CRM é fechado e você precisa manter seu HubSpot externo sincronizado.
  • Como etapa de uma campanha omnichannel que também alimenta o HubSpot para marketing.

Requisitos

  • Ter uma integração do HubSpot conectada e ativa no workspace (Configurações → Integrações; hoje o cartão dela aparece como «Em breve»). Sem integração ativa, o nó falha de forma suave (saída de erro) e não interrompe o workflow.
  • Um email válido do contato — é o único campo obrigatório e a chave do upsert.

Configuração

  • Email (obrigatório): chave de busca/criação.
  • Nome (firstname), Sobrenome (lastname), Telefone (phone), Empresa (company): opcionais, enviados apenas se preenchidos.

O formulário no editor

O nó já tem o seu formulário no inspetor: Email (obrigatório: sem ele o fluxo não pode ser salvo ativo), Nome, Sobrenome, Telefone e Empresa, todos com variáveis. Você pode deixá-lo configurado; vai funcionar quando a integração puder ser conectada.

Exemplo

Automação de quadro "Vendas": quando um cartão é movido para o grupo "Ganho" → nó Criar/atualizar contato no HubSpot com email={{$deal.contact.email}}, firstname={{$deal.contact.first_name}}, company={{$deal.company.name}}.

Dicas

  • O upsert é feito por email: dois contatos com o mesmo email no HubSpot são tratados como o mesmo registro.
  • O nó atualiza a data da última sincronização da integração sempre que roda com sucesso.

Solução de problemas

  • "Nenhuma integração do HubSpot conectada": enquanto a integração estiver em Em breve, o nó sempre retorna este erro. Quando estiver disponível, conecte o HubSpot em Configurações → Integrações.
  • "Falta o email do contato": o campo email chegou vazio; verifique a variável usada.
  • Erro "HubSpot search/upsert failed": geralmente é um problema de permissões (scopes) do app conectado no HubSpot; reconecte a integração.
Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp