Ответы на опрос Telegram: как обновлять данные в CRM
Правила для собственной интеграции: отделить статистику от ответа человека, сохранить соответствие вариантов и корректно обработать отзыв голоса.
Чтобы сохранить ответ человека из опроса Telegram в CRM, нужен неанонимный опрос, отправленный самим ботом, и обработчик poll_answer. Событие poll описывает состояние опроса и само по себе не даёт соответствие «человек - выбранный вариант». Перед записью проверьте происхождение опроса, наличие пользователя и разрешённую связь с карточкой. Повторный выбор должен заменять прежний ответ; пустой набор означает отзыв голоса.
Это проект правил для собственной интеграции Telegram Bot API с CRM. Он подходит владельцу сервиса, который согласует обработку заявок с разработчиком. Для внедрения нужны доступ к коду, хранилищу событий и тестовому окружению. Здесь нет утверждения о встроенной функции 24go.site, готовой настройке без разработки или проверенной работе с настоящим ботом. Проверка документации выполнена 12 ноября 2026 года; проверочный протокол ниже предложен для вашего стенда.
Сначала решите, нужен ли ответ конкретного человека
Для общей оценки интереса достаточно статистики. Если команда спрашивает, какое время встречи удобнее группе, результат может остаться агрегированным: вариант и число голосов. Персональная запись в CRM нужна только при понятной задаче, известной связи с обращением и допустимой обработке данных. Не пытайтесь восстановить личность участника анонимного опроса по времени голоса или по соседним сообщениям.
Перед персональным опросом объясните участникам, кто будет видеть ответы и для чего они попадут в систему обработки обращений. Не называйте такой сбор анонимным. Сам технический идентификатор Telegram не заменяет правовое основание обработки, разрешение на маркетинговые сообщения или подтверждение полномочий представителя компании. Ответ «интересно» не равен заказу, согласию на рассылку или полномочию менять сделку.
Например, вы предлагаете участнику уже начатого обращения выбрать тему консультации. Храните выбор как ответ на конкретный вопрос. Запуск последующих действий - создание задачи менеджеру, изменение стадии, отправка сообщения - должен иметь отдельные условия. Это позволяет исправить выбор без повторной продажи или повторного создания карточки.
Какие события Telegram действительно передаёт
В описании Update различаются poll и poll_answer. Для poll_answer документация ограничивает получение новых голосов опросами, отправленными самим ботом, и неанонимными опросами. Опрос, который сотрудник вручную создал в группе, нельзя заранее считать источником персональных ответов для вашего бота.
Объект PollAnswer содержит poll_id и выбранные варианты. Поле user необязательное: оно описывает пользователя, изменившего ответ, если голосующий не анонимен. Вместо него может присутствовать voter_chat, описывающий чат, от имени которого изменён ответ. Такой чат нельзя автоматически превращать в контакт человека. Сохраните тип участника отдельно и направьте событие на разбор, если ваша схема поддерживает только людей.
| Полученные данные | Допустимое решение интеграции |
|---|---|
Только агрегированный poll |
Обновить статистику опроса, не назначать голоса контактам |
Известный poll_id, есть user, связь с обращением подтверждена |
Проверить варианты и обновить ответ этого участника |
Есть voter_chat, личного пользователя нет |
Не записывать ответ в персональную карточку |
poll_id отсутствует в вашем реестре |
Отложить событие, проверить происхождение и регистрацию опроса |
| Выбранных вариантов нет | Зафиксировать отзыв голоса после проверки участника и опроса |
Если события вообще не доходят, сначала проверьте подписку на типы обновлений. Проверка allowed_updates и маршрутизации - отдельная задача. Она не делает анонимный опрос персональным и не исправляет отсутствующий реестр опросов.
Регистрируйте вопрос до обработки ответа
Создайте внутренний реестр опросов. После успешного sendPoll сохраните возвращённый Message и связанный poll.id: именно успешный ответ даёт данные отправленного опроса. В реестре нужны идентификатор вашего бота или подключения, пространство клиента, poll_id, назначение вопроса, версия схемы, связь с обращением и карта вариантов. Не используйте текст вопроса как уникальный ключ.
До отправки можно создать локальную запись намерения. До получения успешного результата она ещё не является подтверждённым Telegram-опросом. Если результат отправки неизвестен, не создавайте новый опрос автоматически в бесконечном повторе: сначала разберите неопределённый исход. Ранний ответ, пришедший до завершения регистрации, можно сохранить в отложенной очереди и обработать после появления проверенного соответствия.
В sendPoll анонимность по умолчанию включена. Для персонального сценария задайте is_anonymous: false явно. Определите и другие условия: обычный опрос или викторина, один или несколько вариантов, разрешено ли менять ответ, добавлять варианты и перемешивать их. Добавление вариантов не поддерживается для анонимных опросов и викторин. В обычном опросе изменение выбранных ответов по умолчанию разрешено; в викторине значение по умолчанию другое. Не полагайтесь на настройки из старого примера библиотеки.
Реестр должен сохранять фактическую конфигурацию, а не только желаемую. Если вы намеревались запретить добавление вариантов, но не проверили параметры и возвращённое состояние, обработчик всё равно обязан отвергать неизвестное соответствие. Для первого внедрения проще ограничить изменение состава вариантов и заранее определить все значения CRM. Это выбранная политика приложения, не универсальное ограничение Telegram.
Как не перепутать номер и смысл варианта
option_ids содержит номера вариантов с нуля. Номер относится к конкретному опросу; он не означает универсальное значение CRM. В одном вопросе нулевой вариант может означать «интеграция», в другом - «отчётность». Поэтому запись вида «если 0, ставим горячий интерес» без реестра вопроса опасна даже при неизменном составе вариантов.
Актуальная документация также описывает option_persistent_ids в ответе и persistent_id у PollOption. Эти идентификаторы сохраняются при добавлении и удалении вариантов. Если ваш сценарий допускает изменение состава, сопоставляйте смысл с постоянным идентификатором и версией карты, а не с текущей позицией или отображаемой подписью. Убедитесь, что используемая библиотека передаёт эти поля, а не отбрасывает их при разборе.
Для старой интеграции, доступной только по позиционным номерам, возможен ограниченный режим: фиксированный состав вариантов, сохранённая исходная карта и запрет неизвестных изменений. Нельзя объявлять этот режим поддержкой изменяемых опросов. Если состояние карты потеряно или обнаружен неизвестный постоянный ID, сохраните событие для проверки и не угадывайте значение по похожему тексту.
Пример внутренней карты можно описать без секретов: опрос demo-poll, постоянный вариант demo-integration соответствует полю «интерес: интеграция», demo-reporting - «интерес: отчётность». Это условные обозначения для обсуждения схемы, не настоящие идентификаторы Telegram и не образец сетевого запроса. Карта должна возникнуть из фактически полученных данных вашего опроса.
Храните текущее состояние и историю раздельно
Для персонального ответа используйте ключ, включающий пространство клиента, бот или подключение, poll_id и типизированного участника. Для пользователя это user.id; для чата нужна отдельная ветка, если она вообще разрешена. Имя и username можно показывать оператору, но не использовать как единственную связь с карточкой. Известный Telegram ID ещё не доказывает принадлежность к конкретной сделке: связь должна быть установлена вашим разрешённым процессом.
Новое принятое событие содержит актуальный набор выбранных ответов. Заменяйте этим набором прежнее состояние участника. Не прибавляйте каждый полученный вариант к бесконечному списку интересов. В опросе с несколькими ответами участник может убрать часть выбора; накопительное объединение оставит в CRM уже отозванное предпочтение.
Пустые option_ids и option_persistent_ids допускаются при отзыве голоса. В вашей модели это отдельное состояние «ответ отозван», а не ошибка JSON и не новый интерес с пустой подписью. Удалять всю карточку человека из-за отзыва нельзя. Снимите только результат этого вопроса, а зависимые автоматические действия пересмотрите по отдельной политике. Уже выполненное человеком действие не всегда можно или нужно автоматически отменять.
История событий полезна для расследования: что пришло, что прошло проверки, какая версия карты применялась, какое состояние получилось. Храните минимально необходимые данные и ограничивайте доступ и срок хранения. Не выгружайте реальные ответы и идентификаторы участников в общедоступные журналы, демонстрационные файлы или поисковую аналитику.
Повторы и порядок не должны возвращать старый ответ
Сначала надёжно сохраните входящее событие, затем применяйте его к проекции ответа - текущей записи для CRM. Повторная доставка одного update_id в пределах того же бота не должна заново создавать задачу. Основы этого разделения рассмотрены в статье о повторных webhook и второй заявке. Здесь дополнительно нужен контроль версии именно ответа участника.
Очередь с параллельными работниками может завершить старое изменение позже нового. Задайте обработку по одному ключу ответа либо используйте атомарную проверку версии в хранилище. Не сравнивайте только время завершения HTTP-запросов к CRM. Дата получения события и дата записи оператору не являются надёжным порядком действий пользователя.
Telegram описывает update_id как средство восстановления порядка обновлений; после недели без новых обновлений следующий идентификатор может быть выбран случайно. Поэтому не копируйте правило «больше число - новее навсегда» в бессрочное состояние. Для первого внедрения удобнее сохранять последовательность приёма и явно учитывать разрывы эпох доставки. При потере контекста порядка заблокируйте автоматическое продвижение ответа и проведите сверку. Это консервативная политика приложения, а не обещанная API процедура восстановления истории голосов.
Если запрос изменения CRM завершился таймаутом, результат записи может быть неизвестен. Прежде чем повторять действие с побочным эффектом, прочитайте доступное состояние или используйте поддерживаемый вашей CRM ключ идемпотентности. Не обещайте ровно однократную обработку только потому, что входящий webhook получил успешный HTTP-код.
Проверочный протокол для тестового окружения
Этот протокол не требует настоящих клиентских данных. Подготовьте синтетического участника, отдельное обращение и карту тестового опроса. Для каждой строки фиксируйте входное событие, прежнее состояние, версию карты, решение обработчика, итоговую запись и число побочных действий. Следующие результаты - критерии приёмки, а не отчёт уже проведённого сетевого теста.
- Передайте известный ответ с одним вариантом. Ожидайте один результат вопроса у разрешённого участника и отсутствие новой карточки, если карточка уже связана.
- Повторите то же событие с тем же
update_id. Ответ и число созданных задач не должны измениться. - Передайте следующий ответ с другим выбором. Прежний вариант должен исчезнуть из текущего ответа этого вопроса; история изменения остаётся доступной согласно политике хранения.
- Для множественного выбора сначала передайте два варианта, затем один. В текущем состоянии должен остаться только последний набор.
- Передайте отзыв с пустыми массивами. Ожидайте состояние «отозван», сохранённую карточку и отсутствие новой отправки клиенту.
- Передайте неизвестный опрос, неизвестный вариант и событие с
voter_chatбезuser. Каждый случай должен попасть в свою ветку отказа или разбора, без персональной записи по догадке. - Смоделируйте задержку старого задания после нового, перезапуск работника и неизвестный результат записи CRM. Старый выбор не должен незаметно стать текущим; неопределённый результат остаётся видимым оператору.
- Если разрешены изменения состава вариантов, удалите вариант и добавьте другой на стенде. Проверьте сохранность смысла по постоянным ID. Если библиотека теряет эти поля, такой режим не допускается к эксплуатации.
Отдельно проведите разрешённый интеграционный тест со своим ботом: он проверяет то, чего синтетические события не доказывают, - фактическую конфигурацию опроса, получение нужных полей библиотекой и поведение вашей CRM. Не отправляйте экспериментальные опросы реальным клиентам без согласованного сценария.
Когда персональную автоматизацию лучше остановить
Оставьте агрегированную статистику или ручной разбор, если опрос анонимный, создан не вашим ботом, не зарегистрирован, потеряна карта вариантов или нет проверенной связи участника с обращением. То же относится к событиям с неизвестным порядком и неоднозначной записи CRM. Очередь разбора должна показывать причину и ответственного, чтобы блокировка не превращалась в тихую потерю обращения.
При запуске выберите один вопрос и ограниченный тестовый поток. Сначала согласуйте допустимые ответы, правила отзыва и действия менеджера, затем проверьте протокол. Расширяйте автоматизацию только после проверки конечного состояния и отказов. Оценивать сервисы на 24go.site следует по реально подтверждённым возможностям; наличие этой инструкции не означает, что описанный обработчик уже доступен в продукте.
Источники
- Telegram Bot API: Update - условия получения
pollиpoll_answer, свойстваupdate_id. - Telegram Bot API: PollAnswer - участник, выбранные варианты, отзыв.
- Telegram Bot API: PollOption - постоянный идентификатор варианта.
- Telegram Bot API: Poll - состояние и параметры опроса.
- Telegram Bot API: sendPoll - отправка опроса и значения параметров по умолчанию.