ДескусДескус · Справочный центр

Мессенджеры, формы и приём по API

Подключённый мессенджер превращает сообщения клиентов в тикеты, а ответы операторов уходят обратно в тот же чат. Формы с сайта и «Приём по API» тоже создают тикеты. Каждый канал — отдельная карточка, а порядок подключения у всех одинаковый.

Где найти

Настройки → Каналы → Мессенджеры — формы сайта и «Приём по API» — в «Настройки → Каналы → Формы и API»

Что понадобится для каждого канала

Канал

Данные доступа

Что важно знать

Telegram

«Токен бота» от @BotFather.

Вебхук ставится автоматически.

ВКонтакте

«Токен сообщества», «ID сообщества», «Строка подтверждения».

После активации вставьте «Адрес» и «Секрет подписи» в настройки Callback API сообщества.

MAX

«Токен бота».

Бот появляется после подтверждения организации на платформе MAX для партнёров и модерации. Файлы из ответа клиент получает ссылкой на 30 дней.

Одноклассники

«Ключ доступа группы».

Подписи у вебхука нет. Перевыпуск ключа группы отключит другие интеграции этой группы.

WhatsApp (Green API)

«idInstance» и «apiTokenInstance» из кабинета Green API.

Неофициальный шлюз: WhatsApp может заблокировать номер за рассылки. Можно подключить без белого адреса — опросом, см. ниже. Под ответами бывает «Прочитано».

Viber

«Токен бота», «Имя отправителя».

Бот пишет только тем, кто написал ему первым. Под ответами бывает «Прочитано».

Авито

«client_id» и «client_secret» основного аккаунта, «ID продавца» — по желанию.

Картинки из ответа уходят картинками, другие файлы — ссылкой.

Формы: Tilda Publishing, HTML-форма, WordPress, 1С-Битрикс, Craftum, Flexbe, Creatium

Обычно ничего — у части форм есть необязательный «Секретный ключ».

Ответить в форму нельзя — отвечайте по почте или телефону из заявки.

Taplink

«Секретная фраза» из модуля Webhooks — по желанию, но с ней Дескус проверяет подпись каждой заявки.

Тикетом становится «Новая заявка», оплаты пропускаются. Ответить на страницу нельзя — отвечайте по почте или телефону из заявки.

Как подключить мессенджер или форму

  1. Откройте «Настройки → Каналы → Мессенджеры» или «Формы и API» и нажмите «Подключить» на карточке канала. Пошаговая подготовка в самом сервисе — на вкладке «Инструкция».

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

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

  4. Нажмите «Активировать». У большинства мессенджеров адрес для событий пропишется сам. Если на вкладке есть блок «Адрес для приёма», скопируйте «Адрес» и «Секрет подписи» в настройки сервиса — куда именно, написано в «Инструкции».

У форм без данных доступа заполнять нечего: сразу нажмите «Активировать» — появится адрес приёма, его вставляют в настройки формы на сайте. Куда именно в Tilda, WordPress, 1С-Битрикс и других конструкторах — в статье Сайт на Tilda, WordPress или 1С-Битрикс.

Что получится

У карточки появится метка «Подключено», а после первых сообщений — время «Последнего события». Сообщения из канала станут тикетами, а сам канал — источником на панели «Тикетов», см. Папки, категории и источники. Проверьте канал на живом сообщении — напишите себе как клиент.

Метки и фильтры

Метка

Что значит

«Подключено»

Канал работает: сообщения становятся тикетами.

«Ожидает включения»

Проверка прошла, осталось нажать «Активировать».

«Черновик»

Подключение начали, но не закончили.

«Ошибка»

Сервис вернул ошибку — её текст в плашке «Последняя ошибка» на странице канала.

«Отключено»

Приём выключен, данные доступа сохранены.

«Не подключено»

Канал ещё не подключали.

Фильтр «Требуют внимания» над карточками собирает каналы с ошибкой, черновики и проверенные, но не включённые подключения.

Раздел «Мессенджеры» с включённым фильтром «Требуют внимания»: карточка «MAX» с меткой «Ожидает включения» и карточка «Авито» с меткой «Ошибка», у каждой кнопка «Настроить»
Фильтр «Требуют внимания»: 1 — фильтр, 2 — MAX ждёт «Активировать», 3 — Авито с ошибкой

WhatsApp без белого адреса

Обычно Green API сам присылает сообщения на адрес Дескуса. Если до сервера Дескуса извне не достучаться — он в закрытой сети или без белого IP, — Дескус может сам забирать сообщения из очереди Green API.

  1. Откройте «Настройки → Каналы → Мессенджеры» → «WhatsApp (Green API)», вкладка «Подключение».

  2. В блоке «Приём сообщений» включите «Получать сообщения опросом (без белого адреса)».

  3. Если канал уже работает, режим сменится сразу. Если нет — сохраните данные доступа, нажмите «Проверить» и «Активировать»: адрес вебхука в Green API в этом режиме не прописывается.

  • Дескус забирает сообщения и отметки о прочтении раз в минуту — новые сообщения приходят с задержкой до минуты. Ответы операторов уходят клиенту сразу, как обычно.

  • Если опрос три раза подряд не прошёл — например, телефон отвязался от инстанса или закончилась оплата Green API, — у канала появится метка «Ошибка» с причиной, а администраторам придёт письмо «Канал перестал работать». Когда опрос снова пройдёт, метка вернётся к «Подключено».

  • Чтобы вернуться к вебхуку, выключите переключатель — адрес Дескуса снова пропишется в Green API.

Приём по API

«Приём по API» — для обращений из своей системы: личного кабинета, приложения, CRM. Откройте «Настройки → Каналы → Формы и API» → «Приём по API» и нажмите «Активировать» — появятся «Адрес» и «Секрет подписи».

  • Ваша система отправляет обращение POST-запросом на «Адрес». Подпись — HMAC-SHA256 от тела запроса на секрете, в заголовке X-Deskus-Signature. Готовый пример — в блоке «Пример запроса».

  • Сообщения с одним externalChatId попадают в один тикет, как переписка. Событие с уже присланным externalMessageId не создаст дубль.

  • Запрос без externalChatId или с телом не в формате JSON получит ответ 422 с причиной в поле error, а в «Журнале» — строку «Запрос не принят». Тикет не создаётся: исправьте запрос и отправьте его заново.

  • Если указан «Адрес для ответов», ответ оператора придёт на него POST-запросом с той же подписью. Пустое поле — ответы наружу не уходят.

Страница «Приём по API» в «Формах и API»: блок «Подключение» с полем «Адрес для ответов», блоком «Адрес для приёма» с полями «Адрес» и «Секрет подписи», кнопками «Сохранить», «Проверить», «Активировать»; ниже блок «Пример запроса» с командой curl и заголовком X-Deskus-Signature
«Приём по API»: 1 — куда отправлять ответы, 2 — адрес и секрет подписи, 3 — готовый пример запроса

Журнал событий

На вкладке «Журнал» — входящие события и ответы за 30 дней: статус, число попыток и ссылка «→ новый тикет T-…». Фильтр «Только ошибки» оставит то, что не прошло. Правый клик по строке — «Подробности события», «Скопировать ID события» и «Повторить обработку» для события с ошибкой.

  • Если Дескус был недоступен, мессенджер дошлёт накопившиеся сообщения позже — они станут тикетами, повторы отсеются сами.

  • Сообщение без ID, которое пришло больше чем через двое суток после отправки, тикетом само не становится: в «Журнале» оно с ошибкой. Если это новое обращение, а не повтор, нажмите «Повторить обработку».

  • Запрос, который не удалось разобрать, тоже остаётся в «Журнале» со статусом «Отклонено» и причиной.

  • Через 30 дней текст событий из журнала удаляется — тикеты и переписка в них остаются. Повторить обработку такого события уже нельзя.

Вкладка «Журнал» подключения Telegram: таблица событий «Когда», «Направление», «Событие», «Статус», «Подробности»; у строки со статусом «Ошибка» и «попыток: 8» открыто меню «Подробности события», «Скопировать ID события», «Повторить обработку»
Журнал Telegram: 1 — событие с ошибкой, 2 — его меню по правому клику

Полезно знать

Формы — канал в одну сторону

Заявка с формы на сайте становится тикетом, но ответить в форму нельзя. Отвечайте по почте или телефону, которые клиент оставил в заявке. У «Приёма по API» ответ уходит на ваш «Адрес для ответов».

  • Каждый мессенджер подключается к компании один раз: один бот Telegram, одно сообщество ВКонтакте.

  • Viber и WhatsApp сообщают, что ответ прочитан или так и не дошёл, — под ответом в тикете появится «Прочитано» или «Не доставлено» с причиной. Остальные мессенджеры такого не присылают: там ответ остаётся «Доставлено». Подробнее — Ответить клиенту.

  • Удалить подключение нельзя — только «Отключить». Новые сообщения перестанут становиться тикетами, а данные доступа сохранятся: включить снова можно в один клик.

  • Если мессенджер перестал работать, администраторам компании придёт письмо «Канал перестал работать», а когда заработает — «Канал снова работает».

  • Что клиент получит после закрытия тикета в мессенджере, настраивается в «Показателях и оценках» — см. Опрос клиентов и показатели.

  • Не получается подключить — внизу вкладки «Инструкция» есть адрес поддержки Дескуса info@deskus.ru.

  • Смотреть подключения может сотрудник с правом «Интеграции → Просмотр», подключать и отключать — с правом «Интеграции → Изменение».

Не нашли ответ? Напишите нам
Поддержка ответит в рабочее время.
Вы сотрудник «Дескус»?Изменить статью в Дескусе