Настройка шаблонов для разных каналов

Вступление-утверждение

Организация службы поддержки в Telegram‑CRM предполагает работу с несколькими каналами входящих обращений: личные сообщения боту, топик‑группы, формы обратной связи на сайте, интегрированные через webhook. Каждый канал накладывает свои ограничения на формат и содержание ответа. Настройка шаблонов (canned responses) должна учитывать эти различия, иначе даже идеально составленный скрипт может не сработать или привести к некорректной передаче данных. В этом материале разберём типовые проблемы, возникающие при настройке шаблонов для разных каналов, и предложим пошаговые решения.

Проблема 1. Шаблон не отправляется в топик‑группу

Топик‑группы Telegram имеют особую структуру: каждое обращение создаётся как отдельная тема (топик). Шаблон ответа, настроенный для личных сообщений, может не сработать в топике, если в нём используются переменные, не поддерживаемые в контексте темы.

Причина: В шаблоне указана переменная `{user_id}` или `{username}`, которая не передаётся в топик‑группу, так как обращение приходит от имени группы, а не конкретного пользователя.

Решение:

1. Проверьте, какие переменные доступны в вашей CRM для топик‑групп. Обычно это `{ticket_id}`, `{topic_title}`, `{agent_name}`.
2. Замените переменные, связанные с личными данными пользователя, на общие идентификаторы обращения.
3. Если требуется указать имя клиента, используйте поле «Имя отправителя» из первого сообщения в теме — оно часто передаётся как `{sender_name}`.

Когда требуется специалист: Если после замены переменных шаблон всё равно не отправляется, возможно, проблема в настройках прав доступа бота к топик‑группе или в ограничениях API Telegram для работы с темами. В этом случае следует обратиться к администратору CRM или разработчику интеграции. Подробнее о лимитах API читайте в статье Ограничения API Telegram для автоматизации.

Проблема 2. Шаблон с HTML‑разметкой отображается некорректно

Telegram поддерживает ограниченный набор HTML‑тегов: `<b>`, `<i>`, `<a>`, `<code>`, `<pre>`. Если в шаблоне используется сложная вёрстка (таблицы, списки, вложенные теги), сообщение может не отправиться или отобразиться как обычный текст без форматирования.

Причина: CRM не экранирует некорректные теги перед отправкой, и Telegram Bot API возвращает ошибку `Bad Request: can't parse entities`.

Решение:

1. Используйте только разрешённые теги. Избегайте вложенности тегов (например, `<b><i>текст</i></b>` — допустимо, но `<b><a href="...">текст</a></b>` может вызвать ошибку).
2. Если шаблон содержит URL, оборачивайте их в тег `<a>` с атрибутом `href`.
3. Проверьте шаблон через тестовую отправку в режиме «без форматирования» — если сообщение уходит, проблема именно в разметке.

Когда требуется специалист: Если шаблон содержит обязательные элементы форматирования, которые не поддерживаются Telegram (например, таблицы с данными), потребуется доработка CRM: либо автоматическая конвертация в список, либо отправка ссылки на внешний ресурс. Это задача разработчика.

Проблема 3. Шаблон для webhook‑канала не подставляет данные из внешней системы

При интеграции через webhook данные могут приходить в нестандартном формате (JSON, XML). Шаблон, настроенный на стандартные поля Telegram‑CRM, не сможет извлечь нужные значения.

Причина: Поле `{custom_field}` не сопоставлено с ключом в JSON‑запросе от внешней системы.

Решение:

1. Откройте логи входящих webhook‑запросов в CRM и определите структуру данных. Например, если внешняя система присылает `{"order_id": "12345", "client_name": "Иван"}`, то в шаблоне нужно использовать переменную `{order_id}`, а не `{ticket_id}`.
2. Создайте кастомное поле в CRM (например, «Номер заказа») и привяжите его к соответствующему ключу в настройках webhook.
3. В шаблоне укажите `{Номер заказа}`. Убедитесь, что регистр переменной совпадает с названием поля.

Когда требуется специалист: Если внешняя система присылает данные в формате, который не поддерживается текущей версией CRM (например, вложенные объекты JSON), потребуется написание скрипта‑преобразователя или middleware. Это работа интегратора.

Проблема 4. Один и тот же шаблон выглядит по‑разному на разных устройствах

Telegram на десктопе и мобильных устройствах по‑разному обрабатывает переносы строк, длинные ссылки и эмодзи. Шаблон, который идеально выглядит в веб‑версии, может «съехать» на смартфоне.

Причина: Разная ширина экрана и поддержка Unicode‑символов.

Решение:

1. Ограничьте длину строки в шаблоне 50–60 символами. Используйте принудительные переносы строк через `\n`.
2. Избегайте длинных URL без сокращения — используйте сервисы сокращения ссылок или тег `<a>` с коротким текстом.
3. Проверьте шаблон на мобильном устройстве перед массовым использованием. Особое внимание уделите эмодзи: некоторые символы могут отображаться как квадраты на старых версиях Telegram.

Когда требуется специалист: Если проблема носит массовый характер и затрагивает все шаблоны, возможно, требуется адаптация CSS‑стилей в вашей CRM (если она поддерживает кастомизацию интерфейса). Это задача frontend‑разработчика.

Проблема 5. Шаблон не применяется при автоматическом распределении обращений

В Telegram‑CRM часто настраиваются триггеры автоматизации: при создании обращения из определённого канала отправляется приветственный шаблон. Если шаблон не срабатывает, причина может быть в неверной настройке триггера.

Причина: Триггер привязан к каналу «Личные сообщения», а обращение пришло через топик‑группу.

Решение:

1. Проверьте в настройках триггера поле «Канал». Убедитесь, что выбран нужный источник (например, «Топик‑группа» или «Webhook»).
2. Если триггер должен срабатывать для всех каналов, выберите опцию «Любой канал».
3. Убедитесь, что шаблон не содержит переменных, отсутствующих в контексте выбранного канала (см. проблему 1).

Когда требуется специалист: Если триггер настроен верно, но шаблон всё равно не отправляется, возможно, проблема в очередности выполнения правил или в конфликте с другими триггерами. В этом случае потребуется анализ логов автоматизации администратором CRM. О том, как настроить распределение обращений между агентами, читайте в статье Распределение обращений между агентами в Telegram.

Проблема 6. Шаблон содержит персональные данные, которые не должны отображаться в общем чате

В топик‑группах все участники видят сообщения в рамках своей темы. Если шаблон подставляет номер телефона или email клиента, это может нарушить политику конфиденциальности.

Причина: Шаблон использует переменную `{phone}` или `{email}`, которая доступна в CRM, но не предназначена для публичного отображения.

Решение:

1. Создайте отдельный шаблон для внутреннего использования (например, для заметок агента) и отдельный — для клиента.
2. В шаблоне для клиента используйте только обезличенные переменные: `{ticket_id}`, `{order_status}`.
3. Если необходимо передать контактные данные, отправляйте их в личное сообщение через бота, а не в топик.

Когда требуется специалист: Если CRM не поддерживает разделение шаблонов по видимости (внутренние/внешние), потребуется доработка системы. Это задача разработчика.

Заключение-резюме

Настройка шаблонов для разных каналов в Telegram‑CRM — задача, требующая учёта технических ограничений каждого канала и особенностей форматирования сообщений. Основные проблемы связаны с несовместимостью переменных, ошибками HTML‑разметки и неправильной привязкой триггеров. Большинство из них решается проверкой настроек и адаптацией шаблонов под конкретный канал. Если проблема носит системный характер (например, не поддерживается нужный формат данных), без участия разработчика или администратора CRM не обойтись. Рекомендуется вести журнал тестовых отправок для каждого канала и регулярно обновлять шаблоны при изменении API Telegram или структуры входящих данных. Общие принципы автоматизации ответов описаны в статье Шаблоны и автоматизация ответов в Telegram‑CRM.