Centro de ayudaIntegraciones

Para: Administradores

Crea una clave API

Cree una clave de administración para la API del panel de administración o una clave de concentrador para la API del portal, limítela a sus direcciones IP y cópiela una sola vez.

En este artículo8 secciones

Una clave de APILlave Un token secreto, creado en la sección de Integración, que permite que tu propio software utilice la API del hub. permite que su propio software, como un sistema de gestión de casos, funcione en conjunto con su hub. Una clave de gestión utiliza la API del panel de administración, para gestionar los casos y las personas relacionadas con ellos. Una clave de hub, por su parte, utiliza la API del portal, para gestionar el trabajo que se realiza dentro de los casos. Entienda qué puede hacer la API.

  1. Abrir llaves

    Vaya a Integración › Teclas y seleccione NUEVO.

  2. Nómbralo

    Debajo de Descripción, indique qué será lo que se utilizará con él, como por ejemplo, el comando Case sync.

  3. Limitar dónde se utiliza

    Debajo de Fuente CIDR, ingrese la dirección IPv4 pública desde la cual su sistema realiza las llamadas, por ejemplo, 203.0.113.10. También puede escribir un rango de direcciones, como 203.0.113.0/24. Las llamadas provenientes de cualquier otro lugar serán rechazadas. El hub solo reconoce direcciones IPv4; por lo tanto, las direcciones IPv6 no son aceptadas.

    Si aún no conoces la dirección, deja el campo vacío. De esta manera, se puede indicar cualquier dirección. Después de que el sistema haga su primera llamada, Última IP utilizada mostrará esa dirección. Para más información, vea Restringir o revocar una clave API.

  4. Elige su tipo

    Debajo de Dominio, seleccione Manage para la API del panel de administración, o Hub para la API del portal. Esto no puede cambiarse posteriormente.

  5. Enciéndelo y añádelo

    Activo se inicia en ese punto. Deje activado este valor: una tecla inactiva no será aceptada en cada llamada. Elija Agregar clave. Se mostrará “Tecla agregada”.

  6. Copia la clave

    La ventana Llave secreta muestra la clave solo una vez. Elija el botón “Copiar”, Copiar al portapapeles, y guárdela en un lugar donde su desarrollador pueda acceder a ella de forma segura, como por ejemplo en un gestor de contraseñas. Luego, seleccione Hecho.

¿Qué sucede después?

Las funciones clave se envían de forma inmediata y no caducan. El desarrollador las envía junto con cada llamada que se realiza. Ver más información aquí. Se pueden autenticar las solicitudes de la API utilizando una clave.. Funciona como el centro de control de tu dispositivo. Asistente virtualAsistente virtual Un miembro del equipo automatizado que publica mensajes de bienvenida, registros de asistencia y actualizaciones de la empresa; sus publicaciones llevan una insignia de Asistente Virtual., Entonces, lo que publica parece ser información relacionada con la Asistente Virtual.

Último uso y Última IP utilizada muestran la fecha y la dirección de la última llamada realizada. Para desactivarla o eliminarla, vea Restringir o revocar una clave de API.

Si algo sale mal

  • Se ha alcanzado el límite máximo. Tu hub puede tener dos claves de cada tipo. Borra una de las claves que ya no utilices.
  • La fuente CIDR indica que “el bloque de direcciones es inválido”. Ejemplo: 203.0.113.10 o 203.0.113.0/24. Verifique la dirección: cuatro números entre 0 y 255, con puntos entre ellos. Para indicar un rango, se utiliza una barra roja seguida de un número hasta 32.
  • La fuente CIDR indica que “se debe utilizar una dirección IPv4 o un rango de direcciones IPv4, como por ejemplo 203.0.113.10. La API está accesible únicamente a través de IPv4”. Escribió una dirección IPv6. Utilice en cambio la dirección IPv4 de su sistema.
  • Perdiste la llave. No se puede mostrar de nuevo esa llave. Es necesario crear una nueva, mover tu sistema a ella, y luego eliminar la llave antigua. Si tu hub ya tiene dos llaves de ese tipo, primero elimina la llave antigua; tu sistema no podrá comunicarse con el hub hasta que tenga la nueva llave.

Artículos relacionados

Autenticar las solicitudes de API con una clave.Envía tu clave como token de portador a la API del panel de administración para obtener una clave de gestión o a la API del portal para obtener una clave central, y limita su uso a tus direcciones IP.IntegracionesRestringir o revocar una clave APILimite una clave a determinadas direcciones IP, desactívela o elimínela, y vea cuándo se utilizó por última vez.Integraciones · 2 minEntienda lo que la API puede hacerDescubre qué funciones pueden alcanzar una clave de administración y una clave de concentrador, por qué cada clave actúa como asistente virtual y dónde encontrar la lista técnica completa.Integraciones