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.

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.

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: