[Hubspot] Guia passo a passo da integração

Este guia passo a passo o ajudará a integrar a Claudia com o HubSpot por meio da interface do Hub da Cloud Humans.

1. Entando na telinha do Hub da Cloud Humans

• Acesse a página de Integrações e escolha o HubSpot.

• No campo "Webhook", aperte em "Gerar Webhook" para configurar dentro do HubSpot.

2. Criar um aplicativo privado no HubSpot

• Acesse o menu "Configurações" do HubSpot.

• Selecione "Aplicativos privados".

• Clique em "Criar um aplicativo privado".

• Preencha o campo "Nome", por exemplo, "CloudHumans | Connector".

• Na seção "Escopos", adicione os escopos necessários para a integração:

  • conversations.read

  • conversations.write

  • forms

  • oauth

  • tickets

  • settings.users.read

  • settings.users.teams.read

• Na seção "Webhooks", copie a URL do webhook do Hub da Cloud Humans e cole no local indicado.

• Clique no botão "Criar assinatura":

  • No menu suspenso "Qual tipo de objeto?", selecione "Conversa"

  • Em "Monitorar quais eventos", selecione "Nova mensagem" e "Alteração de propridade"

  • Em "Quais propriedades?", selecione "assignedTo"

  • Clique em "Assinar" para salvar as configurações

• Clique em "Continuar".

• Copie o token de acesso gerado.

3. Voltando no Hub da Cloud Humans

• Cole o token de acesso gerado no campo "Token"

• Irá carregar na tabela Grupos do HubSpot, as existentes no HubSpot

• Em "Transbordar conversas para", escolha se as coversas vão:

  • Para uma equipe, pode pegar o id na tabela Equipes, e adicionar no campo "Id N2"

  • Para um agente especifico, nesse caso, no HubSpot vá em Configurações > Usuários e equipes, procure pelo agente, abra o perfil e na URL pegue o número que vem depois de "user/" e cole no campo "Identificador N2"

• Em "MFA", precisamos colocar a chave da autenticação de dois fatores

  • No seu gerenciador de senhas, clique para editar o acesso, em Chave do Autenticador, e copie a chave.

    • Se ela estiver em formato de URL copie o código que estará no lugar do X: otpauth://totp/HubSpot:projeto%40cloudhumans.com?secret=XXXXXXXXXXXXXX&issuer=HubSpot

    • Se estiver separadinho assim: XXXX XXX XXX, retire os espaços

• No campo "Senha", coloque a senha que usa para logar na conta do HubSpot

• Clique em "Salvar", e a integração estará pronta

Observações:

• Certifique-se de que o usuário do HubSpot esteja na caixa de entrada que irá atuar.

• Podem ser criadas automações para criação de ticket e etc normalmente, levando em conta que ela támbém é um agente.

• Importante não colocar a Claudia na equipe que serão enviadas as conversas de N2, pois pode acontecer um loop e prejudicar a experiencia do cliente.