Источники Chatter: подключение и настройка каналов

В документации мы постарались ответить на частые вопросы по работе TesLab, с которыми сталкиваются пользователи.
Если Вы не нашли ответ на свой вопрос, напишите нам.

Личный кабинет

Источники Chatter: подключение и настройка каналов

Источник Chatter объединяет обращения, которые приходят с сайта, из почтового ящика или мессенджера. Подключите нужный канал, назначьте операторов и проверьте, что сообщение доходит в TesLab, а ответ возвращается клиенту.

В этой статье

Подготовить канал и доступ

Откройте «Конфигурация» и выберите вкладку «Chatter». Для работы с источниками нужны действующее подключение Chatter и право на группу «Chatter». Если вкладки нет или сервис отказывает в доступе, обратитесь к администратору.

  • Для сайта подготовьте его адрес и договоритесь, кто разместит код виджета.
  • Для почты получите адрес ящика, параметры IMAP и SMTP у почтового администратора.
  • Для мессенджера подготовьте отдельного бота или канал и реквизиты доступа к нему.
  • Заранее добавьте нужных сотрудников в список операторов Chatter. Затем назначьте их источнику. Право настройки само по себе не делает сотрудника оператором.

Перед подключением мессенджера проверьте другие интеграции. Настройка бота или канала меняет доставку входящих событий. Не используйте один токен в нескольких обработчиках без согласованной схемы. Для внешнего обработчика нужен доступный адрес с корректным HTTPS. Требования конкретного провайдера проверяет ответственный за интеграцию.

Роботы системных уведомлений на вкладке «Email» настраиваются отдельно от источников Chatter.

Добавить источник нужного вида

  1. В блоке «Источники» нажмите «Добавить».
  2. В окне «Добавление источника» выберите значение поля «Источник» и заполните поля выбранного вида.
  3. Нажмите «Добавить» и дождитесь результата. Проверьте, что источник появился в списке.
  4. На его карточке нажмите кнопку с иконкой пользователей и назначьте операторов источника. Создание канала и назначение операторов выполняются отдельно.
Учебные источники Chatter и кнопки управления
1: добавить источник. 2: назначить операторов. 3: открыть настройки выбранного источника.
ИсточникЧто подготовить
Web-сайтНазвание источника, домен сайта и цвет виджета. При необходимости заполните заголовок, текст виджета и приветствие.
Telegram BotТокен авторизации бота. Название созданного источника берётся из имени бота.
VK MaxНазвание источника и токен авторизации бота.
WhatsApp GupshupНазвание источника, API Key и App ID. Имя приложения определяется по данным провайдера.
WhatsApp WhapiНазвание источника и токен авторизации подготовленного канала.
EmailНазвание источника и адрес ящика. IMAP и SMTP настраиваются после создания.
APIНазвание источника и URL webhook согласованной интеграции.
Добавление учебного источника для сайта
1: вид источника. 2: параметры выбранного канала. 3: подтверждение добавления.

Форма не создаёт внешний аккаунт, бот или почтовый ящик и не определяет тариф провайдера.

Если создание завершилось ошибкой, сначала обновите список. Источник мог уже появиться, даже если подключение к провайдеру не завершено. Откройте его настройки и проверьте подключение в этой карточке. Если результат неизвестен, проверьте список и внешнюю интеграцию до повторного добавления.

Настроить сайт и разместить код

  1. На карточке источника «Web-сайт» нажмите «Настройки».
  2. В блоке «Основные настройки» проверьте название сайта, домен, цвет, заголовок, текст виджета и приветствие.
  3. Настройте возможности: время ответа, сбор адреса электронной почты, сообщения после завершения разговора, продолжение переписки по почте, файлы, смайлы и завершение разговора посетителем.
  4. Нажмите «Сохранить» в конце блока «Основные настройки». Проверьте результат и при необходимости повторно откройте карточку.
  5. Если нужна форма перед диалогом, настройте её ниже и сохраните отдельно.
  6. Выберите положение виджета, тип кнопки и надпись. Нажмите «Копировать» в блоке «Код для вставки на сайт» и передайте код ответственному за сайт.
  7. После размещения откройте страницу сайта и проверьте виджет, заполнение формы и обмен сообщениями.
Возможности учебного виджета и код для сайта
1: возможности виджета. 2: положение и тип кнопки. 3: копирование кода для сайта.

Поле «Время ответа» задаёт информационную оценку для посетителя. Оно не назначает оператора и не запускает автоматический ответ в указанный срок.

В блоке «Форма перед стартом диалога» включите форму и нужные поля: имя, электронную почту или телефон. Для каждого поля отдельно задайте обязательность, метку и вариант ввода. Нажмите «Сохранить» именно в этом блоке. Не делайте обязательными сведения, без которых можно обработать обращение.

Поля учебной формы перед началом диалога Chatter
1: включение формы. 2: выбор полей и обязательности. 3: отдельное сохранение формы.

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

Если автоматическое копирование недоступно, выделите код и скопируйте его вручную.

Настроить почтовый источник

IMAP получает входящие письма, SMTP отправляет ответы. Название и приветствие находятся в отдельном блоке «Основные настройки».

  1. Откройте настройки источника «Email».
  2. В блоке «Настройки IMAP» заполните адрес сервера, порт, логин и пароль. Установите «SSL» по требованиям почтового сервера и нажмите «Сохранить IMAP».
  3. В блоке «Настройки SMTP» заполните адрес сервера, порт, домен, логин и пароль. Выберите шифрование, авторизацию и режим проверки сертификата, затем нажмите «Сохранить SMTP».
  4. Повторно откройте карточку и проверьте параметры. Отправьте письмо на подключённый ящик, ответьте из Chatter и убедитесь, что ответ получен отправителем.
Учебные настройки получения и отправки почты в Chatter
1: параметры получения по IMAP. 2: параметры отправки по SMTP. 3: сохранение IMAP. 4: сохранение SMTP.

Параметры подключения и способ шифрования получите у почтового администратора. Не отключайте проверку сертификата ради устранения любого отказа. Общий SMTP TesLab не заполняет настройки почтового источника Chatter автоматически.

После изменения IMAP или SMTP проверьте оба направления переписки. Надпись «подключен» в карточке не заменяет проверку получения письма и доставки ответа.

Передать параметры API и проверить подключение

В настройках API-канала показаны «Идентификатор входящего канала» и ключ «Проверка личности пользователя». Передавайте параметры ответственному за интеграцию и соблюдайте правила доступа вашей организации. Не публикуйте ключ HMAC, токены ботов и почтовые пароли на открытых страницах. Публичный токен виджета сайта имеет другое назначение и входит в код его размещения.

Флажок «Принудительная проверка личности пользователя» включайте после подготовки стороны интеграции: непроверяемые запросы будут отклоняться. В этой форме можно изменить название, приветствие и проверку личности. Реквизиты провайдера и URL webhook, заданные при создании, здесь не редактируются.

В карточках Telegram Bot, VK Max, WhatsApp Gupshup и WhatsApp Whapi есть блок «Подключение к провайдеру». Если источник создан, но доставка событий не настроилась, проверьте доступ к провайдеру и нажмите «Проверить подключение». Дождитесь результата, затем отправьте тестовое сообщение. Эта кнопка настраивает подключение существующего источника.

Учебные параметры API и повторная настройка подключения Chatter
1: параметры API-канала. 2: принудительная проверка личности. 3: повторная настройка подключения существующего источника.

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

Проверить получение и отправку сообщений

  1. Повторно откройте настройки источника и проверьте сохранённые параметры и назначенных операторов.
  2. Отправьте новое тестовое сообщение с подключённого сайта, почты или мессенджера.
  3. Попросите назначенного оператора открыть обращение в Chatter и ответить. Убедитесь, что клиент получил ответ в исходном канале.
  4. Если включены обязательные поля или вложения, проверьте их отдельно. Для сайта также проверьте положение виджета и надпись на кнопке.

Если входящее сообщение не появилось, проверьте назначение операторов и доставку событий от провайдера. Если сообщение видно в Chatter, но ответ не получен снаружи, проверьте исходящее подключение. Для почты отдельно проверьте SMTP.

После ошибки сохранения обновите карточку и проверьте фактические значения. При неизвестном результате создания сначала проверьте список источников. Правила меток и заготовок ответов описаны в статье «Метки и быстрые ответы Chatter».

Удалить ненужный источник

Удаление источника и связанных диалогов необратимо. Перед удалением согласуйте завершение работы канала и сохраните нужные сведения по правилам вашей организации.

  1. Откройте настройки нужного источника и проверьте его название.
  2. В блоке «Удаление источника» нажмите «Удалить источник».
  3. Подтвердите действие кнопкой «Удалить». Если источник ещё нужен, выберите отмену.
  4. После подтверждения проверьте, что источник исчез из списка. Если результат не подтверждён, обновите список перед следующим действием.

Удаление источника в TesLab и управление внешним ботом, ящиком или аккаунтом провайдера являются разными действиями. Состояние внешних подписок после удаления должен проверить ответственный за интеграцию.