Para administradores
← Todos los temas

Raynet CRM: conexión

Un usuario de solo lectura, una clave API y el nombre de la instancia en Raynet, y la conexión en draften, paso a paso.

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.

Qué necesita

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.

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 mensajeQué significaQué hacer
the user name or the API key was refused (401)Raynet no aceptó el correo electrónico o la clavecomprobar 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 lecturacomprobar el rol y el nivel de seguridad del usuario
Raynet rate limit reached (429)se agotó el límite diario de llamadas a la APIintentarlo 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álidoscopiar el nombre de la instancia de O aplikaci Raynet CRM
Raynet answered HTTP …otra respuesta de Raynetcomprobar el nombre de la instancia y volver a intentarlo

Versión en texto