# FLOWii: conexión

El asistente lee en FLOWii quién le escribe: el contacto y el socio
comercial, los casos comerciales, los pedidos y los eventos y las tareas.
Nunca escribe en FLOWii. 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

- FLOWii con una **licencia de pago**: la licencia FREE no tiene API.
- Un **administrador de FLOWii**: solo él puede configurar los derechos de
  acceso de un usuario.
- En draften, ser **propietario o administrador de la organización**.

## En FLOWii

FLOWii inicia sesión en la API con **el correo electrónico y la contraseña de
un usuario**, más una clave de API. Así que draften necesita la contraseña de
un usuario: por eso, cree para el asistente un **usuario aparte con los
permisos más restringidos posibles**, no la cuenta de una persona.

### Usuario con los permisos más restringidos

1. Abra **Firma** (Empresa) → **Uživatelé** (Usuarios) → **Nový uživatel**
   (Nuevo usuario). Rellene el nombre, los apellidos y el correo electrónico de
   inicio de sesión: anótelo, draften lo necesitará.
2. Abra el nuevo usuario → pestaña **Přístupová práva** (Derechos de acceso).
   En los módulos que debe leer el asistente, elija **Prohlížení**
   (Visualización); en todos los demás, **Zakázaný** (Prohibido):
   - **Partneři** (Socios): el contacto y el socio comercial,
   - **Obchodní případy** (Casos comerciales),
   - **Zakázky** (Pedidos),
   - **Události** (Eventos) y **Úlohy** (Tareas).
3. El usuario debe estar activo y tener una contraseña. Lo activa el
   administrador; la contraseña la establece el propio usuario en su primer
   inicio de sesión. Cada usuario es una licencia de pago en FLOWii.

Puede guardar los mismos permisos como perfil y reutilizarlo: la rueda dentada
del menú superior → **Nastavení** (Configuración) → **Přístupová práva** →
**Profily** (Perfiles) → **Nový profil** (Nuevo perfil); después lo elige en
el campo **Profil** (Perfil) del usuario.

### Clave de API

La rueda dentada del menú superior → **Nastavení** → **Rozšíření**
(Extensiones) → **API** → **FLOWii REST API**. Aparece la **API klíč** (clave
de API): cópiela.

### ID de la empresa

Solo si el inicio de sesión del usuario da acceso a varias empresas. No hace
falta buscar el ID: la prueba de conexión en draften muestra las empresas con
sus ID.

## En draften

1. Abra Organización › **Integraciones** y, en la tarjeta **Integraciones**,
   rellene:
   - **Sistema**: **FLOWii**,
   - **Nombre**: por ejemplo `FLOWii – ventas`,
   - **Correo electrónico de inicio de sesión del usuario**: el correo
     electrónico del usuario del paso anterior,
   - **ID de empresa (opcional)**: vacío si el usuario solo ve una empresa,
   - **La contraseña del usuario** y **Clave de API**.

   Haga clic en **Añadir conexión**. La contraseña y la clave se guardan
   cifradas y no se vuelven 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 …» con el nombre
   de la empresa. Si el usuario ve varias empresas, la prueba escribe «El
   inicio de sesión da acceso a estas empresas; escriba el ID de la correcta
   en “ID de empresa”»; complete el ID y repita la prueba. Los módulos que el
   usuario no puede leer, la prueba los indica bajo «No disponible con este
   token:» (los nombres de los módulos están en eslovaco, tal como los
   devuelve FLOWii).
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 socio comercial**,
   - **Casos comerciales** y, debajo, **Ingresos previstos**,
   - **Pedidos**,
   - **Eventos y tareas** y, debajo, **Notas de los eventos**.
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 cambia la contraseña del usuario**, la conexión deja de funcionar. Pegue
la nueva contraseña en la conexión, en los campos bajo **Nuevo secreto de
acceso** (la contraseña y la clave de API), 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 FLOWii o de
draften:

| En el mensaje | Qué significa | Qué hacer |
|---|---|---|
| `the login, the password or the API key was refused` | FLOWii no aceptó el correo electrónico, la contraseña o la clave de API | comprobar los tres datos; el usuario debe estar activo y la licencia debe ser de pago |
| `the login reaches N companies - set the company's id on the connection` | el usuario ve varias empresas | completar el **ID de empresa** según lo que muestra la prueba |
| `the login does not reach company …` | el usuario no ve el ID de empresa indicado | corregir el ID o dar al usuario acceso a esa empresa |
| `the login reaches no company` | el usuario no ve ninguna empresa | asignar el usuario a una empresa |
| `the user of the login may not read this (403)` | el usuario no tiene permiso para leer un módulo | configurar **Prohlížení** en los módulos necesarios |
| `FLOWii rate limit reached (429)` | se agotó el límite diario de llamadas a la API | intentarlo más tarde |