Organização → Integrações tem dois cartões: Acesso aos e-mails de toda a organização (registros de aplicativo, descritos em Acesso aos e-mails de toda a organização) e as conexões com sistemas externos – CRMs e helpdesks que os assistentes podem ler. Esta página trata do segundo.
Para que serve uma conexão
Uma conexão permite ao assistente saber quem está escrevendo: que empresa é, quem cuida dela, que negócios ou chamados abertos ela tem. Hoje o draften funciona com HubSpot, Raynet CRM e FLOWii.
O que vale para toda conexão:
- ela só lê – o conector não tem nenhuma chamada que grave;
- ela consulta só os participantes da conversa que o assistente responde (nunca o próprio endereço da caixa de e-mail), e detalhes só a partir do que uma chamada anterior do mesmo rascunho retornou – um e-mail dizendo “consulte a empresa X” não lê nada sobre X;
- no máximo 6 chamadas por rascunho, 10 segundos cada; um sistema fora do ar nunca impede um rascunho;
- o que ela retorna é texto externo para o modelo, e nada disso é citado ao cliente;
- o log registra a ferramenta, nunca sobre quem ela perguntou.
Os dados de uma conexão, assim como o próprio e-mail, vão para o provedor do modelo de linguagem.
Adicionar uma conexão
Escolha o Sistema, preencha um Título e o Segredo de acesso (e, para Raynet e FLOWii, mais alguns campos). O segredo é digitado uma vez, guardado criptografado e nunca mais exibido. Depois clique em Testar a conexão: o teste descobre de quem é a conta, quais partes o segredo libera e avisa quando o segredo também poderia gravar.
| Sistema | Segredo de acesso |
|---|---|
| HubSpot | um token de app privado (Settings → Integrations → Private apps, começa com pat-) só com escopos de leitura: contatos, empresas, proprietários, negócios, chamados |
| Raynet CRM | o nome da instância (a parte do endereço depois de app.raynet.cz/), o e-mail de login e a chave de API do usuário (Application settings → For developers → API keys). O Raynet não tem chave somente leitura – crie para o assistente um usuário com um perfil de acesso somente leitura |
| FLOWii | o e-mail de login e a senha do usuário e a chave de API da conta (Extensions → API → New FLOWii REST API, só em licenças pagas); para um login que alcança várias empresas, também o ID da empresa. Use um usuário com o perfil de acesso mais restrito |
Conceder às caixas de e-mail
O que uma conexão retorna pode aparecer nos rascunhos – e os rascunhos são lidos por todos com acesso à caixa de e-mail. Por isso nenhuma caixa de e-mail usa uma conexão até você concedê-la:
- no cartão da conexão, clique em Conceder ao lado de uma caixa de e-mail e marque as partes que ela pode ler (contato, negócios, valores, chamados, atividades, notas);
- esse é o limite – o editor do assistente escolhe depois, em Conhecimento, o que o assistente de fato lê;
- Revogar desativa as fontes de conhecimento que leem por meio da conexão; apagar a conexão as remove.
Sem a concessão, os editores da caixa de e-mail nem sabem que a conexão existe.
A conexão própria de uma caixa de e-mail
O proprietário de uma caixa de e-mail pode conectar um sistema próprio, só para a caixa dele. Ninguém aprova isso; os proprietários e os administradores da organização recebem um e-mail e podem desativá-la ou removê-la. Para usuários, isso está descrito em Conectar um CRM e outros sistemas.