Инструкция по подключению Chat2Desk к платформе Chatme.ai

Chat2Desk — омниканальная платформа для общения с клиентами в текстовых каналах. Её можно использовать как канал для публикации вашего агента в качестве бота-оператора.

Подключение

1. Конфигурация бота на стороне Chat2Desk

Зайдите в аккаунт Chat2Desk и перейдите в раздел Настройки → API.

Нажмите Показать API-токен и введите пароль администратора.

Скопируйте полученный API-токен.

2. Конфигурация канала агента в платформе Chatme.ai

Создайте и настройте Канал Проекта с коннектором Chat2Desk.

Нажмите Add channel в настройках агента.

В открывшейся панели выберите Chat2Desk.

Откроется панель создания канала. При необходимости укажите название канала (плейсхолдер: New channel).

Введите webhook URL: https://api.chat2desk.com/v1 или https://api.chat2desk.kz/v1.

Вставьте API-токен из Chat2Desk в поле Chat2Desk token.

Для автоназначения чатов на конкретного оператора вставьте его ID в поле Chat2Desk operator ID.

Включите тумблер Receive service messages, чтобы получать сервисные сообщения канала.

Нажмите:

• CREATE — сохранить канал без активации.
• CREATE & ACTIVATE — сохранить и активировать канал.

✅ Канал будет сохранен и активирован, если:

• Агент обучен
• Токен уникален
• Доступен адрес Канала Проекта
• Удалось зарегистрировать вебхук

⚠️ Если одно или несколько условий не выполнены, канал сохранится, но не активируется.

Для отмены создания нажмите CANCEL.

Редактирование и удаление канала

Для редактирования нажмите на иконку канала на карточке агента.

Нажмите APPLY, чтобы применить изменения к активированному каналу.

✅ Изменения применятся, если выполнены условия:

• Агент обучен
• Токен уникален
• Доступен адрес канала
• Вебхук зарегистрирован

⚠️ В противном случае изменения будут сохранены, но канал не активирован.

Чтобы деактивировать канал проекта, нажмите DEACTIVATE. 

Чтобы применить изменения к деактивированному каналу, нажмите SAVE.

Нажмите:SAVE & ACTIVATE, чтобы применить изменения и активировать канал.

Для отмены нажмите CANCEL.

Для удаления канала нажмите DELETE.

Общение

Подключение бота как оператора в Chat2Desk

В Chat2Desk возможно настроить автоназначение чатов на конкретного оператора. При выключенном автоназначении чаты поступают в общую очередь.

Если необходимо, чтобы бот обрабатывал только чаты, назначенные на конкретного оператора, нужно подключить бота в качестве конкретного оператора и настроить назначение новых чатов на этого оператора.

В случае, если в настройках канала проекта не указан id оператора, бот будет принимать все сообщения из общей очереди, т.е. не распределенные на какого-либо конкретного оператора.

Чтобы настроить подключение бота в качестве оператора в Chat2Desk перейдите в Настройки → Операторы → Список.

Нажмите Создать оператора и заполните данные.

Авторизуйтесь как созданный оператор. Получите API-токен.

Через Postman выполните GET-запрос:

Метод: GET

URL: https://api.chat2desk.com/v1/operators/

Headers: Authorization: {API-токен из личного кабинета}

В ответ на запрос будет получен список с информацией о всех операторах следующего формата:

{"data": [{"id": "id оператора","email": "электронная почта","first_name": "имя","last_name": "фамилия","role": "роль","phone": "номер телефона","avatar": "аватар","last_visit": "время последнего логина в аккаунт","online": 1,"offline_type": null,"external_id": null,"opened_dialogs": "количество открытых диалогов","status_id": 0}],"meta": {"total": "количество операторов","limit": "лимит на количество операторов","offset": 0},"status": "success"}

В ответе найдите ID оператора и вставьте его в Chat2Desk operator ID настроек канала в Chatme.ai. Если ID оператора не указан, бот будет принимать все сообщения из общей очереди.

Переменные канала

Сообщения и функционал общения