Nó: Criar/atualizar contato no HubSpot

O nó Criar/atualizar contato no HubSpot sincroniza um contato com sua conta HubSpot conectada, usando o email como chave: se já existir um contato com esse email ele é atualizado, senão é criado. Está disponível 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). 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.

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": 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.