# Raynet CRM: conexão

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](/pt/admin/integrations).

## 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

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

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 |