Интеграция с WeChat Service Account

Материал из Planfix

Интеграция позволяет обрабатывать обращения клиентов, которые пишут на официальную страницу вашей компании в WeChat.

Что такое WeChat Service Account

WeChat Service Account — это официальная страница компании в WeChat. Клиенты находят её, подписываются и пишут туда так же, как написали бы в чат на сайте. Интеграция не позволяет переписываться с клиентами из личного аккаунта WeChat. Общение всегда идёт от имени компании и только через Service Account.

Как это работает

  • Клиент пишет в ваш Service Account.
  • В системе автоматически создаётся карточка контакта и задача общения.
  • Сотрудник отвечает комментарием в задаче и указывает клиента в уведомлениях к комментарию.
  • Ответ приходит клиенту в WeChat от имени компании.
  • Дальше переписка идёт свободно, в рамках ограничений WeChat (см. ниже).

Сотрудники работают в едином интерфейсе системы, а клиент остаётся в привычном ему WeChat.

Что важно знать до подключения

WeChat сильно ограничивает общение компании с пользователями:

  • Первым написать клиенту нельзя. Диалог всегда начинает клиент. Он должен сам написать на вашу страницу.
  • Не более 5 ответов на каждое входящее сообщение клиента.
  • Окно ответа — 48 часов с момента последнего сообщения клиента. Позже ответ не дойдёт.
  • Файлы, кроме изображений, отправляются ссылками. Картинки уходят как картинки, остальные вложения клиент получит в виде ссылки на файл.

Если лимит сообщений или 48-часовое окно исчерпаны, ваш ответ до клиента не дойдёт.

Кому подходит

  • Поддержка клиентов, которые обращаются через официальную страницу компании в WeChat.
  • Консультации и вопросы по товарам и услугам.
  • Обработка входящих обращений наравне с другими каналами в общей воронке.

Для подключения интеграции вам понадобится

  • Права администратора аккаунта ПланФикса.
  • Доступ к WeChat Developer Platform с правами управления нужным Service Account.
  • "AppID" и "AppSecret" вашего WeChat Service Account.
  • "Token" и "EncodingAESKey" — их вы задаёте сами при настройке (см. шаги ниже).
  • Шаблоны задачи и контакта, по которым ПланФикс будет создавать обращения и карточки клиентов.

Шаг 1. Получите AppID и AppSecret в WeChat

AppID и AppSecret — это идентификатор и секретный ключ вашего Service Account. По ним ПланФикс подключается к WeChat:

  • Откройте WeChat Developer Platform и авторизуйтесь через WeChat.
  • Нажмите "Перейти в консоль".
  • Перейдите в "Мой бизнес" — "Сервисный аккаунт".
  • Откройте нужный Service Account.
  • В карточке аккаунта скопируйте "AppID" и "AppSecret".

Важно: WeChat не хранит и не показывает старый AppSecret. Если вы его потеряли, ключ придётся сбросить. После сброса старый AppSecret перестаёт работать, поэтому сразу же обновите его в ПланФиксе и во всех других системах, где он используется.

Шаг 2. Создайте подключение в ПланФиксе

  • В ПланФиксе откройте Управление аккаунтом — Интеграции — Мессенджеры — WeChat.
  • Нажмите "Добавить аккаунт".
  • Скопируйте значение поля "Адрес для принятия запросов" — это адрес (webhook), на который WeChat будет присылать сообщения и события. Он понадобится на шаге 3.
  • Заполните остальные поля:
    • Название — произвольное имя подключения (например, «WeChat — поддержка»).
    • AppId — AppID из WeChat.
    • AppSecret — AppSecret из WeChat.
    • Token — придумайте строку из латинских букв и цифр (до 32 символов). Точно такую же нужно будет указать в WeChat на шаге 3.
    • EncodingAESKey — ключ шифрования сообщений. Введите свой или сгенерируйте его в WeChat на шаге 3 и вставьте сюда. Значение в ПланФиксе и WeChat должно совпадать.
  • Сохраните интеграцию.

Важно: сохраните интеграцию в ПланФиксе до того, как будете проверять адрес (URL) в WeChat. Иначе проверка на стороне WeChat не пройдёт.

Шаг 3. Настройте приём сообщений в WeChat

Теперь нужно указать в WeChat, куда присылать сообщения:

  • В WeChat Developer Platform откройте ваш Service Account.
  • Перейдите в настройки домена и push-уведомлений.
  • Рядом с Push-уведомлениями нажмите "Включить".
  • В поле "URL" вставьте "Адрес для принятия запросов", скопированный из ПланФикса на шаге 2.
  • В поле "Token" укажите тот же Token, что и в ПланФиксе.
  • В поле "EncodingAESKey" вставьте тот же ключ, что и в ПланФиксе (или сгенерируйте его здесь кнопкой случайной генерации и скопируйте в ПланФикс).
  • В качестве формата данных выберите "XML".
  • Для режима шифрования выберите "безопасный режим" (Secure mode).
  • Сохраните настройки.

При сохранении WeChat отправит на адрес ПланФикса проверочный запрос. ПланФикс проверит подпись по Token и вернёт подтверждение. Если проверка прошла успешно, WeChat начнёт присылать сообщения и события в ПланФикс.

Проверка подключения

Чтобы убедиться, что всё работает:

  • Напишите сообщение в подключённый Service Account от имени обычного пользователя WeChat.
  • В ПланФиксе должна появиться новая задача общения.
  • В задаче должен быть создан или найден контакт клиента.
  • Добавьте комментарий в задачу и укажите клиента в уведомлениях к комментарию.
  • Клиент должен получить ваш ответ в WeChat.

Если подключение не работает

Проверьте по списку:

  • Интеграция в ПланФиксе сохранена до проверки URL в WeChat.
  • Адрес (URL) скопирован полностью и начинается с https://.
  • Token в ПланФиксе и WeChat совпадает, без лишних пробелов.
  • EncodingAESKey в ПланФиксе и WeChat совпадает.
  • В качестве формата данных выбран XML.
  • AppID и AppSecret относятся к одному и тому же Service Account.
  • AppSecret не был сброшен или заморожен в WeChat.
  • Если в WeChat включён список разрешённых IP (IP whitelist) для API — проверьте, что доступ ПланФикса не заблокирован.

Ограничения

При работе с интеграцией действуют следующие правила WeChat:

  • Написать пользователю первым нельзя — диалог начинает только клиент.
  • Общение возможно только от имени Service Account компании, личные аккаунты WeChat не поддерживаются.
  • После каждого входящего сообщения клиента можно отправить не более 5 ответных сообщений.
  • Ответить клиенту можно только в течение 48 часов после его последнего сообщения.
  • Изображения отправляются как изображения, остальные файлы — ссылкой на файл.
  • Поддерживаются только сообщения в формате XML.
  • Для отправки сообщений из системы используются правила WeChat Customer Service Messages.

Перейти