Обращения из Chatter: события сообщений и диалога

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

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

Обращения из Chatter: события сообщений и диалога

Сообщение в Chatter, поступившее обращение и основная диспетчерская заявка являются разными записями. Робот может уточнить данные жителя и передать обращение диспетчеру. Ответ сотрудника или представителя ОДС обрабатывается отдельным сценарием.

Что настроить заранее

  1. Подключите нужный источник сообщений к Chatter.
  2. Назначьте операторов и подходящего робота этому источнику.
  3. Выберите режим робота: работа с жителями либо смешанная обработка.
  4. Настройте получение событий message_created на штатный URL с ключом входа TesLab.
  5. Проведите проверку на учебном источнике и условных контактах.

Доступность Chatter и возможность распознавания проверяются отдельно. Наличие диалога не подтверждает, что робот распознал сообщение или создал обращение.

У Chatter два разных входящих маршрута. Диалог и основная диспетчерская заявка имеют разные этапы.

Какие сообщения обрабатываются

Входящий сценарий работает с новым текстовым сообщением контакта: event=message_created, sender.type=contact. Пустой текст, внутренние заметки, сообщения операторов Chatter и agent_bot не запускают этот сценарий. Вложение без текста также не становится обращением автоматически.

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

Ответ оператора Chatter имеет sender.type=user. Это другое значение, чем роль сотрудника TesLab: сотрудник, написавший из мессенджера, приходит как контакт и определяется по подтверждённой связи.

Как определяется отправитель

ОтправительРезультат
Подтверждённый работающий сотрудникОтвет на доступную ему заявку может попасть в список «К закрытию».
Подтверждённый действующий представитель ОДСОтвет на заявку его ОДС проходит отдельную проверку и передаётся диспетчеру.
Житель в соответствующем режиме или диалогеРобот собирает данные о неисправности либо проверяет доступный статус.
Неопределённый отправительЗапрашивается идентификация. Метка staff или ids сама по себе не подтверждает конкретного человека.

Подтверждённая связь с сотрудником или ОДС учитывается раньше общего режима жителя. Для уволенного сотрудника обработка служебного ответа не выполняется. В групповом сообщении может потребоваться разрешение действительного автора.

Обращение жителя

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

Если сообщение относится сразу к нескольким лифтам, робот не выбирает один произвольно. Уточните конкретный лифт. При неоднозначном объекте или недоступном распознавании обращение не считается зарегистрированным.

Учебный диалог жителя: уточнение подъезда и подтверждение регистрации обращения

1. Подтверждение связано с поступившим обращением. При наличии доступа нажатие на такое сообщение открывает раздел «Поступившие». Это ещё не подтверждение создания основной заявки и назначения механика.

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

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

Ответ сотрудника и ОДС

  1. Сотрудник или представитель ОДС отвечает на исходное сообщение о заявке.
  2. TesLab получает действительный ID цитируемого сообщения и проверяет его в том же диалоге.
  3. Проверяется связь отправителя и доступ к открытой заявке.
  4. Подходящий текст заносится в список «К закрытию» для дальнейшей обработки диспетчером.

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

Отключение робота

Откройте диалог и карточку контакта. Флажок «Отключить робота» останавливает автоматическую обработку для этого контакта.

Карточка учебного контакта с флажком Отключить робота

1. Флажок отключения. После подтверждения изменения проверьте новое входящее сообщение: робот не должен отвечать или создавать записи. Для группового сообщения проверяется и фактически разрешённый контакт автора.

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

Пример события и повторы

Ниже сокращённый учебный пример структуры. Реальное событие формирует Chatter; используйте штатное подключение и ключ, не имитируйте рабочие сообщения вручную.

{
  "event": "message_created",
  "id": 901410,
  "content": "Учебная улица, дом 10, подъезд 2. Не работает левый лифт.",
  "private": false,
  "account": {"id": 901},
  "inbox": {"id": 902},
  "conversation": {"id": 903, "inbox_id": 902, "status": "open"},
  "sender": {"id": 904, "type": "contact", "custom_attributes": {}}
}

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

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

Как проверить результат

  • Для жителя: проверьте уточнения, подтверждение в переписке и запись в «Поступивших».
  • Для сотрудника и ОДС: проверьте ответ на исходное уведомление и запись в «К закрытию».
  • Для отключённого робота: новое сообщение должно остаться без автоматического ответа и новой записи.
  • После смены адреса: проверьте, что предложены лифты нового дома.
  • После сбоя отправки: проверьте уже созданную запись и результат повторной обработки.

HTTP-ответ подтверждает обработку входящего события. Наличие диалога, ответа робота, поступившего обращения и основной заявки проверяйте по отдельности.

Связанные материалы