Поддержка в WeChat Mini Program

Когда покупатель нажимает кнопку «Связаться с поддержкой» в Mini Program, он попадает в чат поддержки WeChat, и на его сообщения отвечает AI; после перевода на оператора вы принимаете диалог в разделе «Диалоги» админ-панели, а ответы отправляются обратно покупателю в WeChat.

Шаг 1: Подключение на странице «Каналы» в админ-панели. Укажите AppID и AppSecret Mini Program (WeChat Official Accounts Platform → Разработка → Управление разработкой → Настройки разработки). Перед сохранением мы действительно выполняем обмен с WeChat для получения access_token; если данные заполнены неверно, сразу покажем причину. Для получения токена мы используем интерфейс stable_token, поэтому токен, который уже используется на вашем сервере, не станет недействительным.

Шаг 2: Настройка push-сообщений. WeChat Official Accounts Platform → Разработка → Управление разработкой → Настройки разработки → Push-сообщения. Включите их и заполните поля согласно данным на странице «Каналы»:

При отправке WeChat проверит адрес; после успешной проверки статус канала станет «Работает». Если в Mini Program включён белый список IP, добавьте в него IP-адрес сервера, указанный на странице канала.

Шаг 3: Разместите кнопку в Mini Program.

<button open-type="contact" session-from="{{userToken}}">联系客服</button>

В session-from укажите user_token, выданный вашим сервером (формат см. в Идентификация авторизованных покупателей). Тогда AI будет знать, какой это участник программы лояльности, и сможет проверить заказы; если не указать, покупатель будет считаться анонимным. Токен проверяется только один раз, когда покупатель входит в чат; рекомендуем задавать exp не менее 1 часа.

Примечания:

• В течение 48 часов после сообщения покупателя вы можете ему ответить (правило WeChat); после этого нужно дождаться нового сообщения от покупателя. Неотправленные ответы выделяются в «Диалогах» красным с указанием причины.
• Сейчас поддерживаются текстовые сообщения и карточки Mini Program; изображения и голосовые сообщения сохраняются в диалоге для оператора, а AI при ответе попросит покупателя описать запрос текстом.
• Если в канале указан «Путь к странице товара» (например, pages/goods/detail?id={id}), AI дополнительно отправляет рекомендованные товары в виде карточек Mini Program, а {id} заменяется на external_id товара. Карточка отправляется только для товара с изображением в формате JPG или PNG.
• Когда один и тот же покупатель впервые за 24 часа входит в чат поддержки, ему один раз отправляется приветственное сообщение; это можно отключить в канале. Текст берётся из приветствия в «Настройках бота».
• В сообщениях поддержки WeChat не поддерживается Markdown, поэтому AI отвечает обычным текстом.