Autorización para integraciones públicas

Cuando desarrollas una integración pública, con o sin un widget, lo primero que debes hacer es crear una integración. Luego de haber creado la integración, debes enviarla para moderación, para que, si es exitosa, se muestre en el Marketplace.

Tu integración puede ser autorizada en una cuenta de Kommo a través de un webhook o utilizando el botón en el sitio, dependiendo de si un widget está disponible o no.

🚧
El tiempo máximo para enviar un webhook desde nuestro lado es de 3 segundos. No verificamos el código de respuesta, y no es posible reenviar el webhook. Ten en cuenta que los clics virtuales en el botón de instalación no están permitidos en los widgets.

Integraciones públicas con widgets

Las integraciones públicas con widgets funcionan con Kommo a través de la API y el SDK web. Se muestran en el Marketplace y están disponibles para su instalación directamente allí.

Cuando se instala el widget a través de la interfaz de Kommo , el usuario recibirá un webhook en la URI de redirección especificada en los ajustes de la integración, con los parámetros GET: code, referer, y from_widget.

code: Representa el código de autorización.
referer: Indica la dirección de la cuenta del usuario.
from_widget: Especifica que la solicitud fue activada por la instalación del widget.

Integraciones públicas sin widgets

Las integraciones públicas sin widgets funcionan con Kommo solo a través de la API. Se muestran en el Marketplace, pero solo en formato de solo lectura.

Cuando el usuario hace clic en el ícono de la integración, verá una descripción de la integración, incluyendo cómo funciona y cómo instalarla. El usuario recibirá instrucciones para visitar un sitio web externo proporcionado por la integración y la instalación se gestionará a través del botón en el sitio. Al hacer clic en el botón, se abrirá una nueva página donde el usuario podrá seleccionar su cuenta y brindar consentimiento para autorizar la integración.

Luego de otorgar acceso, el usuario será redireccionado a la URI de redirección con los siguientes parámetros GET: code, referer, y state. Puedes intercambiar el código recibido por un token de acceso, y la integración aparecerá en la lista de integraciones instaladas.

Para pasar la moderación de estas integraciones, asegúrate de que la descripción especifique dónde los usuarios necesitan ir para completar la instalación.

¿Cómo verificar el mecanismo de autorización antes de pasar la moderación?

Si estás desarrollando una integración pública sin un widget, entonces antes de pasar la moderación, puedes utilizar el método del botón en el sitio pero de forma limitada. En la ventana generada para otorgar acceso, solo una cuenta estará disponible, la que se utilizó para crear la integración. Luego de seleccionar la cuenta, el mismo mecanismo de redirección del usuario funcionará como en la integración pública.

Si estás desarrollando una integración que tiene tanto un widget como una parte de backend que funciona con nuestra API, podrás obtener un webhook durante la instalación del widget.