# FLOWii: conexão

O assistente lê no FLOWii quem está escrevendo para ele: o contato e o
parceiro, os casos de negócio, os pedidos e os eventos e tarefas. Ele nunca
grava nada no FLOWii. 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](/pt/admin/integrations).

## Do que você vai precisar

- FLOWii com uma **licença paga** – a licença FREE não tem API.
- Um **administrador do FLOWii** – só ele define os direitos de acesso de um
  usuário.
- No draften, o **proprietário ou um administrador da organização**.

## No FLOWii

Pela API, o FLOWii entra com o **e-mail e a senha de um usuário** e, além
disso, com uma chave de API. Portanto, o draften precisa da senha do usuário –
por isso, crie para o assistente um **usuário separado com as permissões mais
restritas possíveis**, e não a conta de uma pessoa.

### Usuário com as permissões mais restritas

1. Abra **Firma** (Empresa) → **Uživatelé** (Usuários) → **Nový uživatel**
   (Novo usuário). Preencha o nome, o sobrenome e o e-mail de login – anote-o,
   o draften vai precisar dele.
2. Abra o novo usuário → aba **Přístupová práva** (Direitos de acesso). Nos
   módulos que o assistente deve ler, escolha **Prohlížení** (Visualização);
   em todos os outros, **Zakázaný** (Proibido):
   - **Partneři** (Parceiros) – contato e parceiro,
   - **Obchodní případy** (Casos de negócio),
   - **Zakázky** (Pedidos),
   - **Události** (Eventos) e **Úlohy** (Tarefas).
3. O usuário precisa estar ativo e ter uma senha definida. Quem o ativa é o
   administrador; a senha, o usuário define no primeiro login. Cada usuário é
   uma licença paga no FLOWii.

Você pode salvar as mesmas permissões como um perfil e reutilizá-lo: a
engrenagem no menu superior → **Nastavení** (Configurações) → **Přístupová
práva** → **Profily** (Perfis) → **Nový profil** (Novo perfil); depois, no
usuário, você o escolhe no campo **Profil**.

### Chave de API

A engrenagem no menu superior → **Nastavení** → **Rozšíření** (Extensões) →
**API** → **FLOWii REST API**. Aparece a **API klíč** (chave de API) –
copie-a.

### ID da empresa

Só quando o login do usuário alcança várias empresas. Você não precisa
procurar o ID: o teste de conexão no draften lista as empresas com os IDs
delas.

## No draften

1. Abra Organização → **Integrações** e, no cartão **Integrações**, preencha:
   - **Sistema** – **FLOWii**,
   - **Nome** – por exemplo `FLOWii – vendas`,
   - **E-mail de login do usuário** – o e-mail do usuário do passo anterior,
   - **ID da empresa (opcional)** – vazio se o usuário só vê uma empresa,
   - **A senha do usuário** e **Chave de API**.

   Clique em **Adicionar conexão**. A senha e a chave são guardadas
   criptografadas e nunca mais são exibidas.
2. Na linha da conexão, abra o menu **⋯** → **Testar a conexão**. Em instantes
   aparece “Conexão em ordem (…), conta …” com o nome da empresa. Quando o
   usuário alcança várias empresas, o teste escreve “O login alcança estas
   empresas – coloque o ID da correta em “ID da empresa””; preencha o ID e
   repita o teste. Os módulos que o usuário não pode ler, o teste lista em
   “Não disponível com este token:” (os nomes dos módulos vêm em eslovaco, como
   o FLOWii os retorna).
3. 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 parceiro**,
   - **Casos de negócio** e, abaixo deles, **Receita prevista**,
   - **Pedidos**,
   - **Eventos e tarefas** e, abaixo deles, **Notas dos eventos**.
4. 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](/pt/connecting-a-crm).

**Quando a senha do usuário mudar**, a conexão para de funcionar. Cole a nova
senha na conexão, nos campos em **Novo segredo de acesso** (a senha e a chave
de API), 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 FLOWii ou do draften:

| Na mensagem | O que significa | O que fazer |
|---|---|---|
| `the login, the password or the API key was refused` | o FLOWii não aceitou o e-mail, a senha ou a chave de API | verificar os três dados; o usuário precisa estar ativo e a licença precisa ser paga |
| `the login reaches N companies - set the company's id on the connection` | o usuário alcança várias empresas | preencher o **ID da empresa** conforme a lista do teste |
| `the login does not reach company …` | o usuário não alcança o ID de empresa informado | corrigir o ID ou dar ao usuário acesso à empresa |
| `the login reaches no company` | o usuário não alcança nenhuma empresa | atribuir o usuário a uma empresa |
| `the user of the login may not read this (403)` | o usuário não pode ler um módulo | definir **Prohlížení** nos módulos necessários |
| `FLOWii rate limit reached (429)` | o limite diário de chamadas de API foi atingido | tentar mais tarde |