Neste artigo, você vai aprender a criar ou atualizar contatos no Cloud Chat automaticamente via webhooks do HubSpot.
Utilizando nosso endpoint de importação, é possível criar ou atualizar seus contatos no Cloud Chat através de webhooks integrados ao Hubspot.
Endpoint utilizado
O webhook do HubSpot deve apontar para:
POST https://{{CLOUDCHAT_DOMAIN}}/api/v1/accounts/{{ACCOUNT_ID}}/contacts/external_import
Para detalhes completos sobre este endpoint (campos aceitos, comportamento de upsert e limitações), veja o artigo API: Import de Contato.
Exemplo de configuração de webhook utilizando workflows no Hubspot
Para criar um webhook de importação de contato em um workflow do Hubspot, siga as etapas abaixo.
Etapa 1: Criando o workflow
Na sidebar principal do Hubspot, passe o mouse sobre o símbolo de automações e em seguida clique em Fluxos de trabalho para ser redirecionado à dashboard de workflows:
Ao adentrar a dashboard, clique em Criar fluxo de trabalho e em seguida selecione a opção Do zero:
Na seleção da configuração do tipo do workflow, selecione Baseado em Contato e clique em Próximo:
Etapa 2: Configurando a requisição do webhook
Com a configuração inicial do workflow concluída, temos agora que construir o payload a ser enviado no webhook.
Para iniciar a configuração do webhook, clique no botão de adicionar ação (+):
No painel esquerdo, clique em Operações de dados e em seguida selecione Envie um webhook:
No seletor de método, escolha a opção POST:
Em seguida, preencha as informações de url do webhook e a chave de api:
Observação: A chave de api deve ser configurada em gerenciar segredos.
Por fim, preencha os campos de informação do contato para efetuar o disparo: name (Nome), phone_number (Telefone), email, identifier (Identificador único do contato), bem como quaisquer outros atributos customizados disponíveis:
Observação: Pelo menos um entre os campos phone_number, email e identifier é obrigatório para a criação do contato.
Se o contato existir em sua base, ele será atualizado com os campos enviados acima. Caso contrário, um novo contato será adicionado.