O assistente lê no Raynet quem está escrevendo para ele: o contato e a empresa, os casos de negócio, as propostas e pedidos e as atividades. Ele nunca grava nada no Raynet. 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
- Raynet no plano PROFESSIONAL ou superior – o plano START não tem chaves de API.
- Uma instância em app.raynet.cz (o servidor tcheco). Instâncias nos servidores eslovaco e internacionais do Raynet (
app.raynetcrm.sk,eu.raynetcrm.com,app.raynetcrm.com) não podem ser conectadas. - Um administrador do Raynet – só ele cria usuários e chaves de API.
- No draften, o proprietário ou um administrador da organização.
No Raynet
O Raynet não tem chave somente leitura: uma chave de API sempre tem os direitos do usuário ao qual ela pertence. Por isso, crie para o assistente um usuário separado com um perfil somente leitura. Não emita a chave para um administrador – um administrador vê e pode fazer tudo.
Usuário somente leitura
- No canto superior direito, clique no seu nome → Nastavení (Configurações).
- No menu à esquerda, abra Uživatelské účty (Contas de usuário) e adicione um usuário (Přidat uživatele (Adicionar usuário); na versão paga, primeiro Přidat další uživatelské účty e depois Přiřadit uživatele). Preencha:
- o nome, por exemplo
draften, - o e-mail de login – anote-o, o draften vai precisar dele,
- o perfil Jen ke čtení (Somente leitura).
Cada usuário é uma licença paga no Raynet.
- o nome, por exemplo
- Se quiser usar um usuário que já existe: Uživatelské účty → abra o perfil dele → Oprávnění uživatele (Permissões do usuário) → mude o perfil para Jen ke čtení e salve.
- Opcionalmente, limite quais registros o usuário vê: Nastavení → Bezpečnostní úrovně (Níveis de segurança) → Přidat úroveň (Adicionar nível), dê um nome ao nível e escolha o usuário.
Chave de API
- Nastavení → no menu à esquerda, na seção PRO VÝVOJÁŘE (Para desenvolvedores) → API klíče (Chaves de API).
- Clique em Nový API klíč (Nova chave de API). Na janela Vytvořit API klíč (Criar chave de API), preencha:
- Název klíče (Nome da chave) – por exemplo
draften, - Uživatel (Usuário) – o usuário somente leitura do passo anterior. A chave vai ler com as permissões dele.
- Název klíče (Nome da chave) – por exemplo
- Copie a chave imediatamente – depois de salva, o Raynet não a mostra de novo. Depois clique em Vytvořit API klíč.
Nome da instância
No canto superior direito, clique no seu nome → O aplikaci Raynet CRM (Sobre o Raynet CRM); lá está o nome da instância. Ele também é a parte do endereço depois de app.raynet.cz/ – no endereço https://app.raynet.cz/firma, é firma.
No draften
- Abra Organização → Integrações e, no cartão Integrações, preencha:
- Sistema – Raynet CRM,
- Nome – por exemplo
Raynet – vendas, - Nome da instância – do passo anterior,
- Usuário (e-mail) – o e-mail de login do usuário somente leitura,
- Segredo de acesso – a chave de API.
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 (…), conta …”. Quando o usuário não pode ler alguma coisa, o teste lista isso em “Não disponível com este token:”.
- 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,
- Casos de negócio e, abaixo deles, Valores,
- Propostas e pedidos,
- Atividades e, abaixo delas, Descrição e solução das atividades.
- 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 Raynet ou do draften:
| Na mensagem | O que significa | O que fazer |
|---|---|---|
the user name or the API key was refused (401) | o Raynet não aceitou o e-mail ou a chave | verificar se o e-mail é o e-mail de login do usuário ao qual a chave pertence e colar a chave de novo |
the user of the API key may not read this (403) | o usuário da chave não pode ler | verificar o perfil e o nível de segurança do usuário |
Raynet rate limit reached (429) | o limite diário de chamadas de API foi atingido | tentar mais tarde; o limite depende do plano do Raynet |
Raynet needs the instance name (letters, digits, dashes) | o nome da instância está faltando ou tem caracteres inválidos | copiar o nome da instância de O aplikaci Raynet CRM |
Raynet answered HTTP … | outra resposta do Raynet | verificar o nome da instância e tentar de novo |