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

Материал из Planfix

Интеграция с WeChat Service Account позволяет получать сообщения клиентов из WeChat прямо в ПланФиксе и обрабатывать их как обычные обращения.

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

Таким образом, ваши сотрудники работают в едином интерфейсе ПланФикса, а клиент общается в привычном ему 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:

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

Перейти