Перейти к содержимому

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

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

Что такое сервисный аккаунт WeChat?

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

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

  • Клиент отправляет сообщение на ваш сервисный аккаунт.
  • Planfix автоматически создает карточку контакта и задачу для нового диалога.
  • Сотрудник отвечает, добавляя комментарий к задаче и выбирая клиента в уведомлениях о комментарии.
  • Клиент получает ответ в WeChat от аккаунта вашей компании.
  • После этого переписка может продолжаться с учетом ограничений WeChat (см. ниже).

Сотрудники ведут переписку в едином интерфейсе Planfix, а клиенты продолжают пользоваться WeChat.

Что нужно знать перед подключением

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

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

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

Для кого подойдет интеграция?

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

Что нужно для подключения интеграции

  • Права администратора в аккаунте Planfix.
  • Доступ к платформе разработчиков WeChat с правом управления нужным сервисным аккаунтом.
  • «AppID» и «AppSecret» сервисного аккаунта WeChat.
  • «Token» и «EncodingAESKey», которые нужно настроить при подключении (см. шаги ниже).
  • Шаблоны задач и контактов, которые Planfix будет использовать для создания задач по новым диалогам и карточек контактов.

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

AppID и AppSecret — это идентификатор и секретный ключ вашего сервисного аккаунта. Planfix использует их для подключения к WeChat:

  • Откройте платформу разработчиков WeChat и войдите через WeChat.
  • Нажмите «Перейти в консоль».
  • Перейдите в раздел «My Business» — «Service Account».
  • Откройте сервисный аккаунт, который хотите подключить.
  • Скопируйте «AppID» и «AppSecret» из сведений об аккаунте.

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

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

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

Важно: Сохраните интеграцию в Planfix до проверки URL в WeChat. В противном случае проверка WeChat завершится ошибкой.

Шаг 3. Настройте получение сообщений в WeChat

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

  • Откройте свой сервисный аккаунт на платформе разработчиков WeChat.
  • Перейдите в настройки домена и push-уведомлений.
  • Нажмите «Enable» рядом с пунктом «Push Notifications».
  • В поле «URL» вставьте «Request URL», скопированный из Planfix на шаге 2.
  • В поле «Token» введите тот же Token, который вы указали в Planfix.
  • В поле «EncodingAESKey» введите тот же ключ, который вы указали в Planfix (или сгенерируйте здесь случайный ключ и скопируйте его в Planfix).
  • Выберите «XML» в качестве формата данных.
  • Выберите «Secure Mode» в качестве режима шифрования.
  • Сохраните настройки.

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

Проверьте подключение

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

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

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

Проверьте следующее:

  • Интеграция была сохранена в Planfix до проверки URL в WeChat.
  • URL скопирован полностью и начинается с https://.
  • Значения Token в Planfix и WeChat совпадают, без лишних пробелов.
  • Значения EncodingAESKey в Planfix и WeChat совпадают.
  • В качестве формата данных выбран XML.
  • AppID и AppSecret принадлежат одному и тому же сервисному аккаунту.
  • AppSecret не был сброшен или заблокирован в WeChat.
  • Если в WeChat включен список разрешенных IP-адресов для API, убедитесь, что он не блокирует доступ из Planfix.

Ограничения

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

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

Перейти

Источник — https://planfix.com/ru/help/Интеграция_с_WeChat_Service_Account