# Raynet CRM: conexión

El asistente lee en Raynet quién le escribe: el contacto y la empresa, los
casos comerciales, las ofertas y los pedidos y las actividades. Nunca escribe
en Raynet. Qué puede leer exactamente lo decide usted para cada buzón por
separado. Cómo funciona una conexión en draften en general lo describe la
página [Integraciones](/es/admin/integrations).

## Qué necesita

- Raynet con el plan **PROFESSIONAL** o superior: el plan START no tiene
  claves de API.
- Una instancia en **app.raynet.cz** (el servidor checo). Las instancias en
  los servidores eslovaco o internacionales de Raynet (`app.raynetcrm.sk`,
  `eu.raynetcrm.com`, `app.raynetcrm.com`) no se pueden conectar.
- Un **administrador de Raynet**: solo él puede crear el usuario y la clave de
  API.
- En draften, ser **propietario o administrador de la organización**.

## En Raynet

Raynet no tiene claves de solo lectura: una clave de API siempre tiene los
permisos del usuario al que pertenece. Por eso, cree para el asistente un
**usuario aparte con el rol de solo lectura**. No emita la clave a nombre de un
administrador: un administrador lo ve todo y lo puede hacer todo.

### Usuario de solo lectura

1. Arriba a la derecha, haga clic en su nombre → **Nastavení** (Configuración).
2. En el menú de la izquierda, abra **Uživatelské účty** (Cuentas de usuario)
   y añada un usuario con **Přidat uživatele** (Añadir usuario). En la versión
   de pago, primero **Přidat další uživatelské účty** (Añadir más cuentas de
   usuario) y luego **Přiřadit uživatele** (Asignar usuario). Rellene:
   - un nombre, por ejemplo `draften`,
   - el correo electrónico de inicio de sesión: anótelo, draften lo
     necesitará,
   - el rol **Jen ke čtení** (Solo lectura).

   Cada usuario es una licencia de pago en Raynet.
3. Si el usuario ya existe: **Uživatelské účty** → abra su perfil →
   **Oprávnění uživatele** (Permisos del usuario) → cambie el rol a **Jen ke
   čtení** y guarde.
4. Opcionalmente, limite qué registros ve el usuario: **Nastavení** →
   **Bezpečnostní úrovně** (Niveles de seguridad) → **Přidat úroveň** (Añadir
   nivel), póngale un nombre y elija el usuario.

### Clave de API

1. **Nastavení** → en el menú de la izquierda, en la sección **PRO
   VÝVOJÁŘE** (Para desarrolladores) → **API klíče** (Claves de API).
2. Haga clic en **Nový API klíč** (Nueva clave de API). En la ventana
   **Vytvořit API klíč** (Crear clave de API), rellene:
   - **Název klíče** (Nombre de la clave): por ejemplo `draften`,
   - **Uživatel** (Usuario): el usuario de solo lectura del paso anterior. La
     clave leerá con sus permisos.
3. **Copie la clave enseguida**: una vez guardada, Raynet no la vuelve a
   mostrar. Después haga clic en **Vytvořit API klíč**.

### Nombre de la instancia

Arriba a la derecha, haga clic en su nombre → **O aplikaci Raynet CRM**
(Acerca de Raynet CRM); allí está el **nombre de la instancia**. Es también la
parte de la dirección que sigue a `app.raynet.cz/`: en la dirección
`https://app.raynet.cz/empresa` es `empresa`.

## En draften

1. Abra Organización › **Integraciones** y, en la tarjeta **Integraciones**,
   rellene:
   - **Sistema**: **Raynet CRM**,
   - **Nombre**: por ejemplo `Raynet – ventas`,
   - **Nombre de la instancia**: el del paso anterior,
   - **Usuario (correo electrónico)**: el correo electrónico de inicio de
     sesión del usuario de solo lectura,
   - **Secreto de acceso**: la clave de API.

   Haga clic en **Añadir conexión**. La clave se guarda cifrada y no se vuelve
   a mostrar.
2. En la fila de la conexión, abra el menú **⋯** → **Probar la conexión**. Al
   cabo de un momento aparece «Conexión correcta (…), cuenta …». Si el usuario
   no puede leer algo, la prueba lo indica bajo «No disponible con este
   token:».
3. En la parte **Qué buzones pueden usar la conexión**, haga clic en
   **Conceder** junto al buzón, marque lo que puede leer el asistente y haga
   clic en **Guardar el permiso**:
   - **Contacto y empresa**,
   - **Casos comerciales** y, debajo, **Importes**,
   - **Ofertas y pedidos**,
   - **Actividades** y, debajo, **Descripción y solución de las actividades**.
4. Después, el editor del asistente añade en la Configuración del asistente ›
   **Base de conocimiento** una fuente del tipo **sistema externo** y elige lo
   que el asistente lee realmente: consulte
   [Conectar un CRM y otros sistemas](/es/connecting-a-crm).

Si sustituye la clave, pegue la nueva en la conexión, en **Nuevo secreto de
acceso**, y haga clic en **Sustituir**; después, vuelva a hacer clic en
**Probar la conexión**.

## Errores de la prueba de conexión

El mensaje de la prueba está en inglés y viene directamente de Raynet o de
draften:

| En el mensaje | Qué significa | Qué hacer |
|---|---|---|
| `the user name or the API key was refused (401)` | Raynet no aceptó el correo electrónico o la clave | comprobar que el correo electrónico es el de inicio de sesión del usuario al que pertenece la clave y volver a pegar la clave |
| `the user of the API key may not read this (403)` | el usuario de la clave no tiene permiso de lectura | comprobar el rol y el nivel de seguridad del usuario |
| `Raynet rate limit reached (429)` | se agotó el límite diario de llamadas a la API | intentarlo más tarde; Raynet fija el límite según el plan |
| `Raynet needs the instance name (letters, digits, dashes)` | falta el nombre de la instancia o tiene caracteres no válidos | copiar el nombre de la instancia de **O aplikaci Raynet CRM** |
| `Raynet answered HTTP …` | otra respuesta de Raynet | comprobar el nombre de la instancia y volver a intentarlo |