Para administradores
← Todos os tópicos

Raynet CRM: conexão

Um usuário somente leitura, uma chave de API e o nome da instância no Raynet, e a conexão no draften, passo a passo.

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

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

  1. No canto superior direito, clique no seu nome → Nastavení (Configurações).
  2. 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.

  3. 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.
  4. 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

  1. Nastavení → no menu à esquerda, na seção PRO VÝVOJÁŘE (Para desenvolvedores) → API klíče (Chaves de API).
  2. 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.
  3. 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

  1. 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.

  2. 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:”.
  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 empresa,
    • Casos de negócio e, abaixo deles, Valores,
    • Propostas e pedidos,
    • Atividades e, abaixo delas, Descrição e solução das atividades.
  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 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 mensagemO que significaO que fazer
the user name or the API key was refused (401)o Raynet não aceitou o e-mail ou a chaveverificar 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 lerverificar 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 atingidotentar 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álidoscopiar o nome da instância de O aplikaci Raynet CRM
Raynet answered HTTP …outra resposta do Raynetverificar o nome da instância e tentar de novo

Versão em texto