O assistente lê no HubSpot quem está escrevendo para ele: o contato e a empresa, os negócios e os chamados de suporte. Ele nunca grava nada no HubSpot. O que exatamente ele pode ler, você define para cada caixa de e-mail separadamente. Como as conexões funcionam no draften em geral é descrito na página Integrações.
Do que você vai precisar
- Uma conta do HubSpot com direitos de super admin (ou com a permissão Developer tools access) – só uma conta assim cria uma chave de API.
- No draften, o proprietário ou um administrador da organização.
O draften precisa de uma chave de API só com permissões de leitura. Hoje o HubSpot a emite como service key. Contas mais antigas também podem ter um token de private app da forma anterior (começa com pat-); ele continua funcionando, só que o HubSpot não permite mais criar novos private apps.
No HubSpot: service key
- Abra a lista de chaves: no menu principal, Development → Keys → Service keys (em algumas contas, Settings → Integrations → Service Keys).
- No canto superior direito, clique em Create service key e dê um nome à chave, por exemplo
draften. - Clique em Add new scope. No painel à direita, procure (campo Find a scope) e marque só estas permissões de leitura:
crm.objects.contacts.read– contatos,crm.objects.companies.read– empresas,crm.objects.owners.read– quem cuida do contato,crm.objects.deals.read– negócios,crm.objects.tickets.read– chamados.
Não adicione nada com
.write. A chave só pode receber as permissões que o criador dela tem. - Crie a chave. Na página dela, clique em Show e depois em Copy.
Mais tarde, a chave pode ser trocada (Rotate and expire now, ou Rotate and expire later – a antiga então ainda vale por 7 dias). Cole a nova chave no draften (veja abaixo).
No draften
- Abra Organização → Integrações e, no cartão Integrações, preencha:
- Sistema – HubSpot,
- Nome – por exemplo
HubSpot – vendas e suporte, - Segredo de acesso – a chave copiada.
Clique em Adicionar conexão. A chave é guardada criptografada e nunca mais é exibida.
- Na linha da conexão, abra o menu ⋯ → Testar a conexão. Em instantes aparece “Conexão em ordem (…)”. As permissões que faltam, o teste lista em “Não disponível com este token:”; quando a chave também tem permissões de gravação, ele avisa.
- Em Quais caixas de e-mail podem usar a conexão, clique em Conceder ao lado da caixa de e-mail, marque o que o assistente pode ler e clique em Salvar a permissão:
- Contato e empresa,
- Negócios e, abaixo deles, Valores dos negócios,
- Chamados de suporte e, abaixo deles, Detalhe do chamado e Notas internas do chamado.
- Depois, o editor do assistente adiciona, nas Configurações do assistente → Conhecimento, uma fonte do tipo sistema externo e escolhe o que o assistente de fato lê – veja Conectar um CRM e outros sistemas.
Quando você trocar a chave, cole a nova na conexão em Novo segredo de acesso e clique em Trocar; depois, Testar a conexão de novo.
Erros do teste de conexão
A mensagem do teste vem em inglês, direto do HubSpot ou do draften:
| Na mensagem | O que significa | O que fazer |
|---|---|---|
the access token was refused (401) | o HubSpot não aceitou a chave – um erro de digitação, ou a chave foi trocada ou apagada | colar uma chave válida |
… lacks a scope for this read (403) | falta à chave uma permissão de leitura | adicionar a permissão à chave no HubSpot |
HubSpot rate limit reached (429) | o limite de chamadas de API foi atingido | tentar mais tarde |
HubSpot answered HTTP … | outra resposta do HubSpot | tentar de novo; se persistir, trocar a chave |