Albato и ApiX-Drive

В Albato, ApiX-Drive и похожих сервисах связки собирают без программирования: «новый тикет в Дескусе → сделка в CRM», «заявка в таблице → обращение в Дескус». Готовые модули Дескуса в каталогах готовятся; пока подключите Дескус через универсальные блоки — вебхук и HTTP-запрос.

Событие Дескуса запускает связку

1. В конструкторе выберите запуск от входящего вебхука и скопируйте его адрес.

2. В Дескусе: «Настройки → Компания → API и приложения → Вебхуки» → «Добавить вебхук», вставьте адрес, отметьте события.

3. Нажмите «Проверить адрес» в меню подписки — конструктор получит событие ping, по нему он узнает поля.

4. Создайте в Дескусе тестовый тикет — конструктор получит настоящее событие с полями тикета и клиента (формат).

Связка делает действие в Дескусе

1. Выпустите ключ API для конструктора с нужными правами (ключи).

2. Добавьте в связку HTTP-запрос: метод и адрес из справочника, например POST https://app.deskus.ru/api/v1/tickets.

3. Заголовки: Authorization: Bearer <ключ> и Content-Type: application/json.

4. Тело — JSON с полями из предыдущих шагов: message, client.email (поля обращения).

Для разработчиков коннекторов

• Подключение клиента — OAuth 2.0: кнопка «Подключить Дескус», согласие, токены. Для установки в чужие компании — проверка Дескусом.

• Проверка подключения — GET /me.

• Триггеры — REST hooks: при включении связки POST /webhooks на ваш адрес, при выключении — DELETE /webhooks/{id}.

• Действия — методы справочника; поля описаны в спецификации OpenAPI.

• Пишите на info@deskus.ru — поможем с модулем и добавим ссылку на него сюда (поддержка).