Обращения из Chatter: события сообщений и диалога
Сообщение в Chatter, поступившее обращение и основная диспетчерская заявка являются разными записями. Робот может уточнить данные жителя и передать обращение диспетчеру. Ответ сотрудника или представителя ОДС обрабатывается отдельным сценарием.
В этой статье
Что настроить заранее
- Подключите нужный источник сообщений к Chatter.
- Назначьте операторов и подходящего робота этому источнику.
- Выберите режим робота: работа с жителями либо смешанная обработка.
- Настройте получение событий
message_createdна штатный URL с ключом входа TesLab. - Проведите проверку на учебном источнике и условных контактах.
Доступность Chatter и возможность распознавания проверяются отдельно. Наличие диалога не подтверждает, что робот распознал сообщение или создал обращение.

Какие сообщения обрабатываются
Входящий сценарий работает с новым текстовым сообщением контакта: event=message_created, sender.type=contact. Пустой текст, внутренние заметки, сообщения операторов Chatter и agent_bot не запускают этот сценарий. Вложение без текста также не становится обращением автоматически.
Нужны корректные ID сообщения, контакта, источника и диалога. Нельзя подставить массив вместо текста или идентификатора. Неверный состав запроса отклоняется до создания записей.
Ответ оператора Chatter имеет sender.type=user. Это другое значение, чем роль сотрудника TesLab: сотрудник, написавший из мессенджера, приходит как контакт и определяется по подтверждённой связи.
Как определяется отправитель
| Отправитель | Результат |
|---|---|
| Подтверждённый работающий сотрудник | Ответ на доступную ему заявку может попасть в список «К закрытию». |
| Подтверждённый действующий представитель ОДС | Ответ на заявку его ОДС проходит отдельную проверку и передаётся диспетчеру. |
| Житель в соответствующем режиме или диалоге | Робот собирает данные о неисправности либо проверяет доступный статус. |
| Неопределённый отправитель | Запрашивается идентификация. Метка staff или ids сама по себе не подтверждает конкретного человека. |
Подтверждённая связь с сотрудником или ОДС учитывается раньше общего режима жителя. Для уволенного сотрудника обработка служебного ответа не выполняется. В групповом сообщении может потребоваться разрешение действительного автора.
Обращение жителя
Для регистрации нужны обслуживаемый адрес, подъезд, конкретный лифт и описание неисправности. Недостающие сведения робот уточняет. При смене дома прежний лифт не переносится в новое обращение. Выбранный лифт проверяется по текущим дому и подъезду.
Если сообщение относится сразу к нескольким лифтам, робот не выбирает один произвольно. Уточните конкретный лифт. При неоднозначном объекте или недоступном распознавании обращение не считается зарегистрированным.

1. Подтверждение связано с поступившим обращением. При наличии доступа нажатие на такое сообщение открывает раздел «Поступившие». Это ещё не подтверждение создания основной заявки и назначения механика.
Диспетчер проверяет поступившее обращение и принимает дальнейшее решение. Разные сообщения о новых неисправностях не блокируются только потому, что этот житель уже обращался в течение часа.
Статус основной заявки доступен через связь с обращением этого заявителя. Одного номера, адреса или совпадения контакта в другом источнике недостаточно для получения чужих сведений.
Ответ сотрудника и ОДС
- Сотрудник или представитель ОДС отвечает на исходное сообщение о заявке.
- TesLab получает действительный ID цитируемого сообщения и проверяет его в том же диалоге.
- Проверяется связь отправителя и доступ к открытой заявке.
- Подходящий текст заносится в список «К закрытию» для дальнейшей обработки диспетчером.
Номер в произвольном тексте или подставленная цитата не заменяют проверку. Сообщение без подтверждённой связи, ответа на исходное уведомление или доступа к заявке не создаёт запись к закрытию. Само сообщение не означает окончательной приёмки и закрытия основной заявки.
Отключение робота
Откройте диалог и карточку контакта. Флажок «Отключить робота» останавливает автоматическую обработку для этого контакта.

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-ответ подтверждает обработку входящего события. Наличие диалога, ответа робота, поступившего обращения и основной заявки проверяйте по отдельности.
Связанные материалы
- Talk-Me и Chatter: каналы приёма обращений.
- Операторы Chatter и доступ к источникам.
- Контакт Chatter и его связи с TesLab.
- Поступившие обращения: принять, связать или отклонить.
- Webhook-каналы мессенджеров Chatter.