Descripción

🚧
Por favor, ten en cuenta que no podrás ejecutar este paso descrito arriba directamente en la sección de Referencia de la API debido a limitaciones de la herramienta: no es posible calcular los encabezados requeridos y enviar una solicitud simultáneamente.

Para vincular un canal de chat a una cuenta, debes enviar una solicitud POST con el channel_id y el ID de la cuenta en el cuerpo de la solicitud.

Como respuesta, recibirás un scope_id único para este canal, que se utilizará más adelante para enviar mensajes. Una vez que el canal de chat esté vinculado a la cuenta de Kommo, podrás gestionar los mensajes y recibir webhooks sobre los mensajes enviados.

🚧
La conexión debe establecerse después de cada instalación de la integración en la cuenta, ya que el canal se desactiva automáticamente cuando se desactiva la integración.

El cuerpo de la solicitud se incluirá en la solicitud dos veces: una vez como su cuerpo y otra vez como el MD5 del cuerpo, que se incluirá en la firma.

📘
Debes escribir el cuerpo de tu solicitud de la misma manera en que lo hiciste al calcular los encabezados.

Encabezados y tipo de autorización

El proceso de autorización para la API de Chat es diferente al de otros métodos de la API de Kommo. A diferencia de otros métodos, la API de Chat no requiere un token de acceso para la autorización; en su lugar, necesitas incluir encabezados específicos en todas las solicitudes.

Requisitos generales para las solicitudes a la API de Chat

Todas las solicitudes a la API de Chat deben enviarse al dominio amojo.kommo.com e incluir los siguientes encabezados: Date, Content-Type, Content-MD5, X-Signature.
Los parámetros deben incluirse en el cuerpo de la solicitud en formato JSON.
La API de Chat tiene una tipificación estricta, por lo que asegúrate de que el tipo de argumento esperado coincida con la descripción del parámetro.

🚧
Es importante no utilizar una clave secreta en el frontend del widget. Cualquier solicitud que utilice la clave secreta debe realizarse únicamente desde la parte backend de tu aplicación.

Encabezado de tipo de datos cuando la solicitud es exitosa/en caso de un error

Content-Type: application/json.

Parámetros de respuesta

Parámetro	Tipo de dato	Descripción
account_id	string	ID de cuenta de la API de chats, es decir, cuenta `amojo_id`
scope_id	string	UUID, scope_id de la cuenta para tu canal
title	string	Nombre del bot
hook_api_version	string	La versión de la API de Chat
is_time_window_disabled	bool	Parámetro que indica si la ventana de tiempo de respuesta está deshabilitada

200200

400400