# Integrações

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](/pt/admin/organisation-mail-access)) 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](/pt/connecting-a-crm).