WeChat как входящий канал
WeChat — мессенджер для обмена текстовыми и голосовыми сообщениями, также поддерживает видео и голосовые VoIP звонки.
Для использования WeChat как входящего канала:
Подключение тестовой учетной записи
предупреждение
Обратите внимание, что WeChat позволяет одновременно подключать только одного бота к одной тестовой учетной записи. Для подключения других ботов создайте для каждого новую тестовую учетную запись.
Для подключения бота к каналу зарегистрируйтесь в WeChat, а также установите официальное приложение на смартфон.
Мы рассматриваем подключение бота на основе приложения для тестовой учетной записи интерфейса WeChat. Рекомендуем установить плагин или переключить язык, так как сайт доступен только на китайском языке.
- Нажмите на кнопку Авторизоваться, появится страница с QR-кодом.
- Зайдите в мобильное приложение WeChat и нажмите на кнопку → Отсканировать QR-код.
- Отсканируйте QR-код с веб-страницы и нажмите на Согласиться в появившемся окне. Вы получили доступ к администрированию тестового аккаунта.
- Скопируйте значения:
WeChat ID
,appID
иappsecret
. Они понадобятся далее при создании канала.
- В поле URL вводим адрес сервера, на который WeChat будет посылать нам запросы. Адрес сервера должен иметь вид:
https://{имя_хоста}/chatadapter/chatapi/webhook/{название_канала}/{WeChat_ID}
- В поле Token необходимо ввести
Wechat ID
для генерации подписи. Это поле должно совпадать сWeChat_ID
, указанном в URL-адресе сервера, для прохождения проверки безопасности. - Нажмите кнопку Submit и переходите к созданию канала.
Создание канала
Нажмите на панели управления Каналы → Входящие → Подключить канал. В разделе Мессенджеры и соцсети выберите WeChat.
Заполните поля:
- Название — укажите название для канала или оставьте по умолчанию.
- Токен — укажите WeChat ID вашего бота, который вы получили ранее при создании тестового аккаунта.
- AppID — укажите идентификатор приложения, который вы получили ранее при создании тестового аккаунта.
- AppSecret — укажите токен доступа приложения, который вы получили ранее при создании тестового аккаунта.
- Ветка — укажите ветку проекта, которую вы хотите развернуть в канал, по умолчанию
master
. Вы также можете выбрать Git-тег или ввести хеш конкретного коммита. - Оператор — выберите операторский канал или оставьте поле пустым.
- Публикация — автоматически (после каждого сохранения внесенных в проект изменений) или вручную (с помощью кнопки Опубликовать в строке с описанием канала).
предупреждение
Публикацию сценария нужно выполнять перед запуском бота.
На этом этапе происходит сборка бота, проверка синтаксиса сценариев и скриптов, а также проверка прохождения тестов.
Нажмите Создать. Дождитесь всплывающего окна с результатом публикации.
Тестирование бота
Для того чтобы открыть окно диалога с ботом в WeChat:
- Зайдите в мобильное приложение WeChat и нажмите на кнопку → Отсканировать QR-код.
- На странице администрирования тестового аккаунта найдите QR-код и отсканируйте его с помощью приложения.
- В приложении появится тестовый аккаунт. Нажмите Подписаться. Диалог с ботом будет открыт автоматически.
- Отправьте боту приветственную/активационную фразу, предусмотренную вашим сценарием. После этого должен начаться ваш диалог с ботом.
подсказка
Для перехода к чату с ботом в мобильном приложении откройте Контакты → Офиц. уч. записи и найдите в списке чат вашего тестового аккаунта.