Resumo
Este guia explica como configurar a ação Criar ou atualizar contato do HubSpot no Astra. Uma vez configurada, esta ação cria ou atualiza automaticamente os registros de contato no HubSpot com base nas conversas com os clientes, ajudando você a manter os dados do seu CRM precisos e atualizados.
Como a ação funciona
Quando esta ação é executada:
O Astra procura um Contato no HubSpot usando o e-mail do cliente
Se o contato existir, ele atualiza o registro com base na sua configuração
Se o contato não existir, ele pode criar um novo (dependendo das suas configurações)
Isso garante que os dados de contato permaneçam sincronizados sem esforço manual.
Instruções
Siga estas etapas para configurar a ação:
Etapa 1: Abra o modelo de criação ou atualização de contato do HubSpot
Faça login na sua conta Astra
Vá para a Biblioteca de ações
Selecione HubSpot — criar ou atualizar contato
Abra a etapa de Configuração
Etapa 2: Configure a intenção da ação
O que você faz
Insira um nome da ação e uma intenção claros
Clique em Editar intenção da ação a qualquer momento para atualizá-la
O que acontece
Uma intenção bem definida ajuda o agente a decidir quando acionar esta ação
Sincronização Offline
Mantenha isso DESLIGADO para executar a ação durante a conversa
Ligue-o ON para executar a ação após o término da conversa
Etapa 3: Selecione sua conta do HubSpot
O que você faz
Escolha uma conta HubSpot existente
Ou clique em Adicionar conta para conectar uma nova
O que acontece
Todos os dados criados ou atualizados por esta ação serão salvos na conta selecionada
Etapa 4: Configure a criação e as atualizações de contatos
Permitir criação e atualização de novos contatos
Quando LIGADO:
Cria um novo contato se não existir nenhum para o e-mail
Atualiza totalmente os contatos criados pelo Astra
Quando DESLIGADO:
Não cria novos contatos
Permitir atualização de campos existentes
Quando LIGADO:
Atualiza os campos mapeados para contatos já no HubSpot (mesmo que não tenham sido criados pelo Astra)
Quando DESLIGADO:
Não atualiza as propriedades de contato existentes
Aplica apenas atualizações de resumo como uma nota (se configurado)
Etapa 5: Mapear campos (HubSpot → Astra)
O mapeamento de campos define como os dados fluem do Astra para o HubSpot.
O que você faz
Para cada linha:
Selecione uma propriedade de contato do HubSpot (lado esquerdo)
Combine-a com um campo Astra (lado direito)
O que acontece
Quando a ação é executada, o Astra grava os dados mapeados nas propriedades de contato do HubSpot correspondentes
Campos obrigatórios
Você deve mapear o seguinte campo:
email
A ação não será executada sem ele.
Adicionando mais campos
Clique em Mapear campo para adicionar mapeamentos adicionais
Você pode mapear:
Propriedades padrão (e-mail, telefone, nome, etc.)
Propriedades personalizadas da sua conta do HubSpot
Observação: Apenas campos compatíveis e propriedades personalizadas editáveis (tipos semelhantes a texto) estão disponíveis para mapeamento.
Criando novos campos Astra
Você pode criar novos campos Astra durante o mapeamento.
Esses campos irão:
Estar disponível na configuração do agente
Aparecer como atributos de contato para seleção
Usando o campo de resumo
Se um resumo for fornecido:
O Astra cria ou atualiza uma nota no contato com o resumo da conversa
Se você também mapear uma propriedade do HubSpot para Resumo:
O mesmo resumo é gravado nessa propriedade de contato
Uma nota ainda é criada e vinculada ao contato
O que acontece quando a ação é executada
Aqui está o comportamento de ponta a ponta:
O Astra procura um Contato usando o e-mail mapeado
Se nenhum contato for encontrado:
Um novo contato é criado somente se permitido pelas suas configurações
Se um contato existir:
O contato é atualizado com base na sua configuração
Se as atualizações completas forem restritas:
Apenas a nota de resumo pode ser adicionada ou atualizada
Recurso adicional: Sincronização Offline
A Sincronização Offline permite que a ação seja executada após o término da conversa, em vez de durante a conversa.
Quando ativado
A ação é executada uma vez após a conclusão da conversa
Condições de término da conversa
Agente de texto: 10 minutos após a última mensagem
Agente de voz: Quando a chamada termina
Isso é útil quando você deseja capturar informações finalizadas em vez de atualizar os dados em tempo real.
O que fazer a seguir
Uma vez configurada, sua ação irá automaticamente:
Capturar detalhes do cliente nas conversas
Criar ou atualizar contatos no HubSpot
Manter seus dados de CRM atualizados sem esforço manual
Agora você pode usar esta ação como parte de seus fluxos de trabalho de automação no Astra.