JAICP

WeChat как входящий канал


WeChat — мессенджер для обмена текстовыми и голосовыми сообщениями, также поддерживает видео и голосовые VoIP звонки.

Для использования WeChat как входящего канала:

  1. Подключите тестовую учетную запись.
  2. Создайте канал.
  3. Протестируйте бота.

Подключение тестовой учетной записи

Обратите внимание, что WeChat позволяет одновременно подключать только одного бота к одной тестовой учетной записи. Для подключения других ботов создайте для каждого новую тестовую учетную запись.

Для подключения бота к каналу зарегистрируйтесь в WeChat, а также установите официальное приложение на смартфон.

Мы рассматриваем подключение бота на основе приложения для тестовой учетной записи интерфейса WeChat. Рекомендуем установить плагин или переключить язык, так как сайт доступен только на китайском языке.

  1. Нажмите на кнопку Авторизоваться, появится страница с QR-кодом.
  2. Зайдите в мобильное приложение WeChat и нажмите на кнопку Отсканируйте QR-код в мобильном приложении WeChat > Отсканировать QR-код.
  3. Отсканируйте QR-код с веб-страницы и нажмите на Согласиться в появившемся окне. Вы получили доступ к администрированию тестового аккаунта.
  4. Скопируйте значения: WeChat ID, appID и appsecret. Они понадобятся далее при создании канала.

параметры тестовой учетной записи WeChat


  1. В поле URL вводим адрес сервера, на который WeChat будет посылать нам запросы. Адрес сервера должен иметь вид:
https://{имя_хоста}/chatadapter/chatapi/webhook/{название_канала}/{WeChat_ID}
  1. В поле Token необходимо ввести Wechat ID для генерации подписи. Это поле должно совпадать с WeChat_ID, указанном в URL-адресе сервера, для прохождения проверки безопасности.
  2. Нажмите кнопку Submit и переходите к созданию канала.

Создание канала

Нажмите на панели управления Каналы > Входящие > Создать канал. В разделе Мессенджеры и соцсети выберите WeChat.

Заполните поля:

  • Название — укажите название для канала или оставьте по умолчанию.
  • Токен — укажите WeChat ID вашего бота, который вы получили ранее при создании тестового аккаунта.
  • AppID — укажите идентификатор приложения, который вы получили ранее при создании тестового аккаунта.
  • AppSecret — укажите токен доступа приложения, который вы получили ранее при создании тестового аккаунта.
  • Ветка — укажите ветку проекта, которую вы хотите развернуть в канал, по умолчанию master. Вы также можете выбрать Git-тег или ввести хеш конкретного коммита.
  • Оператор — выберите операторский канал или оставьте поле пустым.
  • Публикация — автоматически (после каждого сохранения внесенных в проект изменений) или вручную (с помощью кнопки Опубликовать в строке с описанием канала).

Публикацию или деплой сценария нужно выполнять перед запуском чат-бота. На этом этапе происходит сборка чат-бота, проверка синтаксиса сценариев и скриптов, а также проверка прохождения тестов.

Нажмите Создать. Дождитесь всплывающего окна с результатом деплоя.

Тестирование бота

Для того чтобы открыть окно диалога с ботом в WeChat:

  1. Зайдите в мобильное приложение WeChat и нажмите на кнопку Отсканируйте QR-код в мобильном приложении WeChat > Отсканировать QR-код.
  2. На странице администрирования тестового аккаунта найдите QR-код и отсканируйте его с помощью приложения.
  3. В приложении появится тестовый аккаунт. Нажмите Подписаться. Диалог с ботом будет открыт автоматически.
  4. Отправьте боту приветственную/активационную фразу, предусмотренную вашим сценарием. После этого должен начаться ваш диалог с ботом.

Для перехода к чату с ботом в мобильном приложении откройте Контакты > Офиц. уч. записи и найдите в списке чат вашего тестового аккаунта.