Основные сведения

Каждое письмо состоит из двух частей: заголовков и тела. Тело — это текст, который видит получатель. Заголовки — служебные строки вида Название: значение перед телом письма. Их читают почтовые серверы и клиенты: по ним письмо доставляют, проверяют подлинность отправителя, собирают в цепочку переписки и решают, можно ли на него автоматически ответить.

Формат заголовков задаёт RFC 5322 (раздел 2.2 — общий синтаксис, раздел 3.6 — стандартные заголовки). Так выглядят заголовки уведомления Swarmica:

From: support@example.com
To: client@example.org
Subject: #1024: Не работает вход в личный кабинет
Date: Fri, 30 Oct 2026 12:00:00 +0300
Message-ID: <...@example.com>
Content-Type: multipart/alternative; boundary="..."
Auto-Submitted: auto-generated
X-Auto-Response-Suppress: All

Кроме стандартных заголовков, в письмо можно добавить собственные (RFC 5322, раздел 3.6.8). Раньше их принято было начинать с X-, но RFC 6648 рекомендует для новых заголовков обходиться без этой приставки. Общепринятые заголовки регистрируются в реестре IANA по RFC 3864.

Собственные заголовки помогают:

  • защититься от петли автоответов между Swarmica и другими почтовыми роботами — подробнее в статье Автоответы и заголовки Auto-Submitted и X-Auto-Response-Suppress;
  • пометить письма для правил почтового сервера или почтового клиента получателя, например чтобы раскладывать уведомления по папкам;
  • настроить обмен письмами с другой системой поддержки или другим экземпляром Swarmica, чтобы принимающая сторона отличала ваши письма от остальной почты.

Где настроить заголовки

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

  1. Откройте Настройки - Настройки почтовых шаблонов и выберите уведомление. Подробнее о разделе — в статье Настройки почтовых шаблонов.
  2. В блоке Настройки найдите поле Заголовки.
  3. Укажите заголовки JSON-объектом: ключ — название заголовка, значение — строка.
  4. Нажмите Сохранить.
{
  "Auto-Submitted": "auto-generated",
  "X-Auto-Response-Suppress": "All",
  "X-Partner": "acme"
}

Что важно знать:

  • Поле хранит весь набор заголовков уведомления. Многие уведомления уже содержат заголовки по умолчанию: если удалить их из JSON, они пропадут из писем. Чтобы добавить свой заголовок, допишите его к существующим.
  • Заголовки начинают действовать сразу после сохранения, для всех получателей уведомления. Пункт Применить настройки в меню дополнительных действий для них не нужен: он переносит на пользователей только роли и настройку По умолчанию.
  • Пункт Восстановить настройки в том же меню возвращает заголовки по умолчанию вместе с ролями и настройкой По умолчанию.
  • Чтобы отправлять уведомление без дополнительных заголовков, укажите пустой объект {}.
  • Значение подставляется в письмо как есть: переменные шаблона {{ ... }} в заголовках не обрабатываются.

Требования к заголовкам

  • Название состоит из печатных символов ASCII (коды 33–126) без двоеточия и пробела — так требует RFC 5322, раздел 3.6.8. Кириллица в названии недопустима.
  • Значение — строка в одну строку, без переводов строки. Так Swarmica защищает письмо от подстановки лишних заголовков через значение.
  • Для значений лучше использовать только латиницу, цифры и знаки препинания: символы не из ASCII при отправке кодируются по RFC 2047, и не все получатели читают их одинаково.

Если требование нарушено, Swarmica не сохранит настройки и покажет ошибку.

Заголовки, которые нельзя указать

Некоторые заголовки Swarmica, почтовая библиотека или почтовые серверы по пути письма проставляют сами. Поэтому указать их в поле Заголовки нельзя. Проверка не зависит от регистра: message-id тоже не пройдёт.

ЗаголовокКто и зачем его проставляетСтандарт
SubjectSwarmica, из темы в шаблоне уведомленияRFC 5322, раздел 3.6.5
FromSwarmica, адрес email-канала, через который уходит письмоRFC 5322, раздел 3.6.2
DateSwarmica, время отправкиRFC 5322, раздел 3.6.1
Message-IDSwarmica, уникальный идентификатор письма. В уведомлениях ticket_created_* и ticket_comment_* он содержит подписанный номер заявки: по нему Swarmica находит заявку, к которой относится вернувшийся отчёт о недоставкеRFC 5322, раздел 3.6.4
In-Reply-ToSwarmica, чтобы уведомление попало в ту же цепочку, что и письма получателя в заявкеRFC 5322, раздел 3.6.4
ReferencesЦепочка переписки. Одно постоянное значение склеило бы в одну цепочку все письма уведомленияRFC 5322, раздел 3.6.4
Content-TypeПочтовая библиотека: тип содержимого, HTML- и текстовая версии письма, вложенияRFC 2045, раздел 5; RFC 2046
DKIM-SignatureПочтовый сервер отправителя, цифровая подпись письмаRFC 6376
Authentication-ResultsСервер получателя, результаты проверок SPF, DKIM и DMARCRFC 8601
ReceivedКаждый почтовый сервер на пути письмаRFC 5321, раздел 4.4; RFC 5322, раздел 3.6.7
Received-SPFСервер получателя, результат проверки SPFRFC 7208, раздел 9.1
Delivered-ToСервер получателя, адрес ящика, в который доставлено письмоRFC 9228
Return-PathСервер получателя, из адреса отправителя в конверте письма (MAIL FROM). На этот адрес приходят отчёты о недоставке. Заголовок в письме его не меняет: сервер получателя всё равно запишет адрес из конвертаRFC 5321, раздел 4.4; RFC 5322, раздел 3.6.7

В уведомлениях, связанных с заявкой, Swarmica сама проставляет заголовок Thread-Index, по которому Outlook собирает цепочку переписки. Его можно указать в поле Заголовки, но в таких уведомлениях значение будет заменено.

Ссылки

  • RFC 5322 — Internet Message Format: формат письма и стандартные заголовки
  • RFC 5321 — Simple Mail Transfer Protocol: конверт письма и заголовки трассировки
  • RFC 6648 — Deprecating the "X-" Prefix and Similar Constructs in Application Protocols
  • RFC 3864 — Registration Procedures for Message Header Fields
  • RFC 2045, RFC 2046 — MIME: тип содержимого письма
  • RFC 2047 — MIME: символы не из ASCII в заголовках
  • RFC 6376 — DomainKeys Identified Mail (DKIM) Signatures
  • RFC 7208 — Sender Policy Framework (SPF)
  • RFC 8601 — Message Header Field for Indicating Message Authentication Status
  • RFC 9228 — Delivered-To Email Header Field
  • RFC 3834 — Recommendations for Automatic Responses to Electronic Mail: заголовок Auto-Submitted
Обновлена: 31 окт. 2026 г.

Основные сведения

Когда два почтовых робота отвечают друг другу, возникает петля, которую называют «битвой роботов». Например, Swarmica отправляет сотруднику уведомление о новом комментарии, почтовый сервер сотрудника отвечает автоответом «Нет на месте», автоответ попадает в email-канал и становится комментарием, а комментарий порождает новое уведомление. Без защиты такая переписка не заканчивается и засоряет заявки и почтовые ящики.

Чтобы этого не происходило, отправитель помечает автоматические письма служебными заголовками: «письмо отправил робот, отвечать на него автоматически не нужно». Начиная с версии 6.2.0 Swarmica по умолчанию добавляет такие заголовки в свои уведомления. Как посмотреть и изменить заголовки уведомления, рассказано в статье Почтовые заголовки в уведомлениях Swarmica.

Какие бывают автоматические письма

ТипПримерСтандарт
Автоматически сформированное письмоуведомление о новой заявке, отчёт, напоминаниеRFC 3834
Автоответ«Нет на месте», «Ваше письмо получено», ответ по правилу почтового клиентаRFC 3834
Отчёт о доставке или недоставке (DSN, bounce)«Письмо не доставлено: адрес не существует»RFC 3461, RFC 3464
Уведомление о прочтении (MDN)«Ваше письмо прочитано»RFC 8098

Отчёты о недоставке почтовые серверы отправляют с пустым адресом отправителя в конверте (MAIL FROM:<>, RFC 5321, раздел 4.5.5), поэтому у таких писем заголовок Return-Path: <>. Ответить на пустой адрес нельзя, и петля обрывается. RFC 3834 рекомендует отправлять так же и автоответы.

Заголовок Auto-Submitted

Auto-Submitted описан в RFC 3834, раздел 5. Это стандартный заголовок, его понимает большинство почтовых серверов и систем поддержки.

ЗначениеСмысл
noписьмо написал человек. То же самое, что отсутствие заголовка
auto-generatedписьмо сформировано автоматически, но не в ответ на другое письмо: уведомления, отчёты, рассылки по расписанию
auto-repliedавтоматический ответ на конкретное входящее письмо: автоответ «Нет на месте», сообщение «Заявка не создана»
auto-notifiedуведомление фильтра Sieve о пришедшем письме (RFC 5436)

Главное правило RFC 3834: на письмо, у которого Auto-Submitted имеет любое значение, кроме no, автоматически не отвечают. Автоответчик «Нет на месте» такое письмо пропустит, а система поддержки, которая соблюдает стандарт, не создаст из него заявку.

Заголовок X-Auto-Response-Suppress

X-Auto-Response-Suppress — заголовок Microsoft, в RFC его нет. Его учитывают Microsoft Exchange и Outlook, описание — в спецификации [MS-OXCMAIL] (свойство PidTagAutoResponseSuppress).

В отличие от Auto-Submitted, этот заголовок не говорит, кто написал письмо. Он просит получателя не присылать определённые виды автоматических ответов. Значения перечисляются через запятую:

ЗначениеЧто подавляет
DRотчёты об успешной доставке (delivery receipt)
NDRотчёты о недоставке (non-delivery report)
RNуведомления о прочтении (read notification)
NRNуведомления об удалении письма без прочтения (non-read notification)
OOFавтоответ «Нет на месте» (out of office)
AutoReplyпрочие автоответы, например ответ по правилу Outlook
Allвсё перечисленное

Разные почтовые системы смотрят на разные заголовки, поэтому Swarmica ставит оба: Auto-Submitted для серверов, которые следуют RFC 3834, и X-Auto-Response-Suppress для Exchange и Outlook.

Заголовки в уведомлениях Swarmica по умолчанию

УведомленияAuto-SubmittedX-Auto-Response-Suppress
Ответы в заявке, запрос оценки CSAT, письма об учётной записи, изменения в статье——
Моя заявка созданаauto-generated—
Копии собственных сообщений, упоминания, любая новая заявкаauto-generatedOOF, AutoReply, DR, RN, NRN
Заявка не созданаauto-repliedAll
Все остальные уведомленияauto-generatedAll
Полный список уведомлений

Без служебных заголовков

Эти письма уходят как обычная почта. В основном это письма с текстом, который написал человек, или письма, которые ждут от получателя действия: ответа, перехода по ссылке, ввода кода.

  • ticket_comment_public_external — Любой ответ добавлен в мою заявку
  • ticket_comment_public_internal — Публичный ответ добавлен
  • ticket_requester_csat — Запрос оценки CSAT
  • user_account_invited — Пользователь приглашен
  • user_account_created — Учетная запись создана
  • user_registration — Запрошена регистрация
  • user_password_change — Запрошен сброс пароля
  • user_identity_email_verification — Код подтверждения доступа к почте
  • user_identity_bot_verification — Код подтверждения доступа к почте при регистрации через мессенджер
  • user_2fa_email_verification — Код подтверждения для 2FA
  • user_2fa_disable_verification — Код для отключения 2FA
  • user_article_changed — Изменения в статье

Auto-Submitted: auto-generated

  • ticket_created_external — Моя заявка создана

Письмо о регистрации обращения уходит клиенту автоматически, поэтому помечено auto-generated, и автоответчик клиента не должен на него отвечать. Подавление автоответов для Exchange в этом письме не включено.

Auto-Submitted: auto-generated и X-Auto-Response-Suppress: OOF, AutoReply, DR, RN, NRN

  • ticket_created_internal_all — Любая новая заявка создана
  • ticket_comment_public_internal_own — Добавлен мой публичный комментарий
  • ticket_comment_public_external_own — Мой ответ добавлен
  • ticket_chatmessage_public_my — Мое сообщение в чате
  • ticket_user_mention — Меня упомянули в заявке
  • ticket_group_mention — Мою группу упомянули в заявке

Подавляются автоответы, отчёты о доставке и уведомления о прочтении. Отчёты о недоставке (NDR) не подавляются: если письмо не дошло, отправитель об этом узнает.

Auto-Submitted: auto-replied и X-Auto-Response-Suppress: All

  • ticket_email_error — Заявка не создана

Это ответ на конкретное входящее письмо, которое Swarmica не смогла принять, поэтому значение auto-replied, а не auto-generated.

Auto-Submitted: auto-generated и X-Auto-Response-Suppress: All

Все остальные уведомления: о назначении заявок, внутренних комментариях, смене статусов, KCS и оценках качества, CSAT для сотрудников, выгрузках и массовых действиях.

Список уведомлений
  • employee_agent_ticket_assigned, ticket_created_internal, ticket_comment_internal, ticket_comment_internal_own
  • ticket_issue_status_changed, employee_agent_ticket_reopened, employee_agent_ticket_resolved
  • ticket_chatmessage_public_others, ticket_chatmessage_public_transcript
  • employee_agent_csat, employee_manager_csat
  • employee_evaluator_assigned, employee_evaluator_unassigned, employee_agent_unapproved_articles, employee_agent_approved_articles
  • employee_agent_aqi, employee_agent_aqi_evaluator_comment, employee_evaluator_aqi_agent_comment, employee_agent_open_aqi
  • employee_agent_lai, employee_agent_lai_evaluator_comment, employee_evaluator_lai_agent_comment, employee_agent_open_lai
  • employee_agent_qa, employee_agent_qa_evaluator_comment, employee_evaluator_qa_agent_comment, employee_agent_open_qa
  • employee_agent_achievement, employee_agent_article_flagged, employee_agent_article_unflagged
  • employee_agent_links_required, employee_manager_links_required, admin_treenode_completed
  • filter_export_completed, report_export_completed, ticket_export_completed, metric_aggregate_completed
  • ticket_bulk_update, article_bulk_update, ticket_bulk_merge

Как Swarmica обрабатывает входящие автоматические письма

Защита работает и в обратную сторону. В настройках email-канала есть два переключателя, оба включены по умолчанию:

  • Игнорировать автоответы. Письма, у которых Auto-Submitted имеет любое значение, кроме no, и письма с X-Spam-Flag: YES не создают заявок и комментариев. X-Auto-Response-Suppress во входящих письмах не учитывается: это просьба к получателю, а не признак автоответа, и она встречается в обычных письмах.
  • Игнорировать возвраты писем. Отчёты о недоставке отбрасываются. Отчётом Swarmica считает письмо типа multipart/report с report-type=delivery-status (RFC 3464, RFC 6522) или письмо с пустым Return-Path либо от MAILER-DAEMON.

Если выключить Игнорировать возвраты писем, отчёт о недоставке уведомления о создании заявки или о комментарии добавится в эту заявку внутренним комментарием, а заявку в статусе «Ожидает ответа клиента», «Ожидание» или «Решение предоставлено» переоткроет. Swarmica находит заявку по номеру, который записан в Message-ID вернувшегося письма. Номер заявки есть в Message-ID только у уведомлений ticket_created_* и ticket_comment_*, поэтому отчёты о недоставке остальных уведомлений, например CSAT-уведомлений менеджерам, в заявки не попадают.

Кроме того, Swarmica не принимает письма, отправленные с адресов её собственных email-каналов.

Интеграция с другой системой по почте

Если другая система поддержки или другой экземпляр Swarmica должны создавать заявки из уведомлений вашей Swarmica, учтите: система, которая соблюдает RFC 3834, отбросит письмо с Auto-Submitted: auto-generated. Swarmica с включённым переключателем Игнорировать автоответы поступит так же.

Варианты:

  • убрать Auto-Submitted из заголовков нужного уведомления на отправляющей стороне;
  • выключить Игнорировать автоответы в email-канале принимающей стороны.

Оба варианта ослабляют защиту от петли между двумя системами, поэтому меняйте настройку только у тех уведомлений и каналов, которые участвуют в интеграции. Чтобы отличать письма партнёра от остальной почты, добавьте в уведомление собственный заголовок, например X-Partner: acme, и настройте по нему правила почтового сервера.

Ссылки

  • RFC 3834 — Recommendations for Automatic Responses to Electronic Mail: заголовок Auto-Submitted и правила для автоответчиков
  • RFC 5436 — Sieve Notification Mechanism: mailto: значение auto-notified
  • RFC 5321 — Simple Mail Transfer Protocol: пустой адрес отправителя, раздел 4.5.5
  • RFC 3461 — SMTP Service Extension for Delivery Status Notifications
  • RFC 3464 — An Extensible Message Format for Delivery Status Notifications
  • RFC 6522 — The Multipart/Report Media Type for the Reporting of Mail System Administrative Messages
  • RFC 8098 — Message Disposition Notification: уведомления о прочтении
  • [MS-OXCMAIL] — спецификация Microsoft, где описан X-Auto-Response-Suppress
Обновлена: 1 нояб. 2026 г.

Стоимость Swarmica зависит от количества сотрудников поддержки, выбранного тарифа, типа установки и дополнительных услуг. В этой статье разберём, что входит в каждый тариф и какой вариант подойдёт именно Вам.

Коротко о расчёте стоимости

  • Лицензируются сотрудники поддержки с ролями Администратор, Менеджер и Агент.
  • Пользователи с правами только на чтение не ограничены на всех тарифах.
  • Тарифы на странице указаны для установки на Вашем сервере.
  • При выборе облачной установки стоимость увеличивается на 25%, минимальное количество пользователей для облака — 10.
  • Миграция, обучение и отдельные проектные работы могут рассчитываться дополнительно.

Посмотреть актуальные тарифы Swarmica

Какой тариф подходит именно Вам?

Базовый — для омниканальной обработки обращений

Выберите тариф Базовый, если Вам нужно принимать и обрабатывать обращения из разных каналов и получать техническую поддержку со стороны Swarmica.

  • Email, Telegram, WhatsApp, VK, веб-чат, Max и личный кабинет.
  • Работа с тикетами и чатами.
  • Телефония Mango и Beeline.
  • Управление знаниями по KCS.
  • Базовые возможности автоматизации и аналитики.

Если Вам нужны сложные SLA и OLA, многоступенчатая маршрутизация, связь с разработкой или API-интеграции, сразу рассмотрите тариф Про.

Подробнее о возможностях helpdesk

Про — основной тариф для зрелой технической поддержки

Тариф Про подойдёт Вам, если поддержка работает по SLA и OLA, взаимодействует с разработкой и должна быть связана с другими корпоративными системами.

  • SLA и OLA.
  • Автоматизация, автоназначение и маршрутизация заявок.
  • Интеграции с Jira, YouTrack, Yandex Tracker и GitLab.
  • Интеграции по API.
  • SSO.
  • Исходящие тикеты.
  • Управление активами и трудозатратами.
  • KCS и база знаний.

Для большинства средних технических поддержек «Про» является основным рабочим тарифом: он закрывает стандартные операционные сценарии без необходимости сразу подключать расширенные возможности «Премиума».

Автоматизация поддержки · Интеграции Swarmica · KCS и база знаний

Премиум — для максимальной эффективности поддержки

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

  • ИИ для агентов и клиентов.
  • ИИ и KCS для создания и проверки статей базы знаний.
  • Модуль контроля качества сервиса.
  • Конструктор отчётов.
  • Исходящие вебхуки для сложных интеграций.
  • Скрипты и плагины.
  • Подключение внешних источников для поиска.
  • Премиальная техническая поддержка.

ИИ в Swarmica · Конструктор отчётов

Почему Swarmica может стоить дороже простого helpdesk?

Вы платите не только за приём заявок. Swarmica объединяет в одном рабочем контуре каналы поддержки, тикеты, SLA и OLA, маршрутизацию, автоматизацию, базу знаний, интеграции, аналитику и развитие процессов поддержки.

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

Сравнение с самописным helpdesk · Калькулятор экономии

Что может оплачиваться дополнительно?

  • Миграция со старого helpdesk.
  • Обучение сотрудников.
  • Нестандартные проектные работы.
  • Облачная установка.
  • Потребление ИИ сверх включённого лимита.
  • Интеграции, для которых нет доступного API или документации на стороне внешней системы.

Подробнее о миграции на Swarmica

Как подобрать тариф

  1. Определите количество сотрудников, которые будут работать с заявками.
  2. Перечислите необходимые каналы и системы для интеграции.
  3. Проверьте, нужны ли Вам SLA, OLA, маршрутизация и связь с разработкой.
  4. Определите, нужны ли ИИ, QA, расширенная аналитика и вебхуки.

Если Вам нужна только омниканальная обработка обращений — рассмотрите «Базовый». Если Ваша поддержка работает по SLA и OLA, взаимодействует с разработкой и использует интеграции — основным вариантом для Вас будет «Про». Если Вы хотите максимально повысить эффективность поддержки с помощью ИИ, QA и расширенной аналитики — рассмотрите «Премиум».

Сравнить тарифы или обсудить Ваш сценарий с экспертом.

Обновлена: 26 окт. 2026 г.

Вопрос

Как определять компанию клиента при работе через групповые Telegram-чаты?

Ответ

Если поддержка организована через большое количество клиентских групп, рекомендуется единый Telegram-бот с определением компании через профиль пользователя в Swarmica.

Telegram передаёт технический идентификатор группы — chat ID. Человекочитаемое название группы нельзя использовать в Swarmica как надёжный источник автоматического определения компании. Само название, например «Компания — поддержка», не обеспечивает такую привязку.

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

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

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

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

Обновлена: 20 окт. 2026 г.

Вопрос

Можно ли использовать для Telegram-канала в Swarmica другие типы прокси, кроме SOCKS5?

Например, можно ли использовать VLESS или другой способ подключения, если SOCKS5-прокси работает нестабильно или блокируется?

Ответ

Непосредственно в настройках Telegram-канала Swarmica поддерживается SOCKS5-прокси.

Его можно указать в поле Прокси URL, например:

socks5://user:password@host:port

Другие типы прокси или протоколы, например VLESS, напрямую в этом поле не поддерживаются.

При этом использование SOCKS5 в настройках Swarmica — не единственный способ обеспечить серверу доступ к Telegram.

Если в вашей инфраструктуре нужен более устойчивый способ подключения, маршрутизацию трафика Telegram можно организовать на сетевом уровне. Например, на сервере или на отдельном сетевом шлюзе можно поднять Xray/VLESS, WireGuard или другое подходящее решение и направить через него трафик к Telegram.

В такой схеме:

Swarmica → обычное подключение к Telegram → системная маршрутизация → туннель/шлюз → Telegram

Для Swarmica это выглядит как обычный доступ к Telegram API. Каким способом этот трафик выходит во внешнюю сеть, определяется уже сетевой конфигурацией сервера.

Например, в некоторых инсталляциях используется связка Xray/VLESS и TUN-интерфейса, через который маршрутизируется только необходимый исходящий трафик.

При таком варианте указывать SOCKS5-прокси в настройках Telegram-канала Swarmica не требуется, если доступ к Telegram уже обеспечивается на уровне операционной системы.

Важно. Настройка VPN, Xray/VLESS, TUN-интерфейсов и системной маршрутизации не является настройкой Swarmica и зависит от инфраструктуры клиента.

Ошибка в маршрутизации может привести к потере сетевого доступа к серверу. Поэтому перед изменением маршрутов рекомендуется иметь доступ к консоли сервера, гипервизору, IPMI/iLO или другому каналу управления, который не зависит от SSH-соединения.

По запросу техническая поддержка Swarmica может предоставить пример настройки Xray/VLESS через TUN как отправную точку для настройки маршрутизации в вашей инфраструктуре.

Обновлена: 23 окт. 2026 г.

Симптомы

При настройке канала веб-виджет и выставлении типа авторизации anonymous возникает ошибка.

Anonymous authentication is not supported for the widget channel.

Решение

  1. Нужно в файле /root/swarmica/.env в переменную AUTH_PROVIDERS через запятую дописать anonymous
  2. Перезапустить Swarmica
docker compose down && docker compose up -d

Причина

В .env в переменной AUTH_PROVIDERS отсутствует значение anonymous по соображениям безопасности. Возможность анонимной инициализации чатов повышает вероятность DDOS атаки через множественную инициализацию пустых чатов.

Обновлена: 17 окт. 2026 г.

Вопрос

Где посмотреть логи интеграции с Billmanager?

Ответ

  • /usr/local/mgr5/var/swarmica.log лог с запросами из Billmanager в Swarmica
  • /usr/local/mgr5/var/swarmica_webhook.log лог с запросами от Swarmica к Billmanager
  • Также можно смотреть события синхронизации в celery логе c помощью команды:
docker logs swarmica-celeryworker-1
Обновлена: 26 окт. 2026 г.

Симптомы

Можно ли добавить телеграм-бота для работы в группах?

Решение

Да. Для этого вам нужно:

  1. Создать телеграм бота с возможностью добавления в группу.
  2. В Настройки - Каналы - Телеграм создать новый канал и добавить этого бота туда
  3. В настройках канала вам нужно выбрать режим работы бота

Все сообщения - бот будет реагировать на любое сообщение в телеграм и создавать новый тикет или добавлять ответ в существующий.

Только при упоминании - бот будет реагировать только при его прямом упоминании через @, и создавать новый тикет или добавлять ответ в существующий.

При добавлении бота в группу мы рекомендуем также выбрать режи "Всегда один тикет" для более органичной коммуникации.

Обновлена: 17 окт. 2026 г.

Вопрос

Как у вас сейчас обстоят дела с работой телеграмма? Используется ли какой-то прокси сервер для поддержания стабильной работы бота?

Ответ

Мы поставляем коробочное решение. Сетевая конфигурация (в том числе и возможность подключения API Телеграмм) находится под управлением клиента. Соответственно в зависимости от выбранного ЦОДа, настроек корпоративной сети, маршрутизаций и роутов могут быть использованы конфигурации в которых API Телеграмм может быть доступен.

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

Обновлена: 17 окт. 2026 г.

Для подключения мессенджера MAX в качестве канала, необходимо получить токены для бота на платформе для разработчиков.

Инструкции по регистрации на платформе MAX

Настройка Swarmica

Вам понадобится обновиться до версии v5.8.0 или новее, чтобы подключить MAX к вашему инстансу Swarmica.

После создания бота на платформе MAX, создайте канал в разделе Настройки > Основные настройки > Каналы > MAX и укажите полученный токен:

После включения бота, перезагрузите контейнер MAX (или обратитесь в поддержку Swarmica, если у вас SaaS версия):

sudo su -
cd /root/swarmica
docker compose up -d --scale max=0
docker compose up -d --scale max=1

Подключение MAX на существующих инсталляциях

  1. Убедитесь, что в файле /root/swarmica/.env в переменной FEATURES указан max:
    FEATURES=max,telegram,vk,whatsapp_green,automations,...
    
  2. Убедитесь, что в файле /root/swarmica/docker-compose.yml есть сервис max:
      max:
       <<: *django
       ports: []
       command: /start-max
       labels:
          - "traefik.enable=false"
    
  3. Перезагрузите приложение с образами MAX:
    sudo su -
    cd /root/swarmica
    docker compose pull
    docker compose down
    docker compose up -d
    
Обновлена: 16 окт. 2026 г.

Симптомы

«А можно сделать так, чтобы команда /start не добавляла тикет, а тикет создавался уже нормальным сообщением?»

«Очень неудобно иногда по 5 задач с темой старт неудобно смотреть список. Тратится время высококвалифицированных сотрудников, чтобы исправить тему.»

Решение

Установите обновление v6.2.x или новее - в нем тема тикета автоматически создается с названием чата из Телеграм

Альтернативное решение

Если вы хотите изменить заголовок тикета по своему собственному шаблону, тогда создайте автоматизацию:

  1. Требуется версия Swarmica не ниже v5.3.0
  2. Создаем макрос в разделе Настройки > Автоматизация и маршрутизация > Макросы для Заявок
  3. В ID объекта указываем: {{ event.ticket.id }}
  4. В payload указываем такой JSON:
{
  "subject": "Новая заявка от {{ event.ticket.requester.name }} в канале {{ event.ticket.source.name }}"
}
  1. Сохраняем макрос
  2. Идем в Настройки > Автоматизация и маршрутизация > Действия по событию и создаем новый триггер:
    1. Событие TicketEvent
    2. Действие Макрос (выбрать макрос, созданный ранее)
  3. В условия добавляем следующее:
    Тип события = Ticket created
    Заявка:Тема = /start
    Заявка: Исходный канал: Тип канала = telegram

Меняем статус действия на "Включен".

Обновлена: 31 окт. 2026 г.

Симптомы

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

Решение

Это известное поведение возникает когда клиент перенаправляет сразу несколько медиа файлов + текст.

  1. Если создался пустой тикет, то проверить другие заявки от этого пользователя. С большой вероятностью найдется заявка, созданная практически одновременно, и содержащая переписку.
  2. Объединить пустые заявки в ту, что содержит переписку, и продолжать общаться с клиентом как обычно.

Причина

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

Обновлена: 15 окт. 2026 г.

Симптомы

При использовании Телеграм или WhatsApp каналов нужно включить сбор оценки удовлетворенности (CSAT) при закрытии тикетов/чатов. Как это сделать?

Решение

Включить можно в настройках канала - Запрашивать оценку:

Обновлена: 18 окт. 2026 г.

Симптомы

Какие есть параметры инициализации виджета и в какой последовательности они применяются?

Решение

Встраиваемые виджеты в Swarmica могут быть настроены в соответствии с требуемым пользовательским опытом в том приложении, куда виджет встраивается.

Порядок применения

Настройки для параметров применяются по следующей логике:

  • Настройки пользователя, которые он/она задали в своем профиле Swarmica (например, язык)
  • Параметры, переданные в URL встраивания (см. пример ниже, значения в src после знака ?)
  • Настройки, заданные администратором Swarmica в настройках соответствующего канала
  • Настройки по умолчанию

Пример кода встраивания виджета:

<!-- start embedded Swarmica widget script -->
  <iframe src="https://your.swarmica.domain/widgets/index.html?id=atTpw53B55dob5xu&locale=ru&auth_provider=email&button_color=%23933c44&telegram_link=http%3A%2F%2Ft.me%2Flink&max_link=https%3A%2F%2Fmax.ru%2Flink&helpcenter_url=https%3A%2F%2Fdomain.tld%2Fhelp" id="123qwe" style="position: fixed; right: 12px; bottom: 12px; width: 56px; height: 56px; overflow: hidden; "
    allowTransparency="true"
    frameborder="0"
    allowTransparency="true" frameborder="0"></iframe>
  <script src="https://your.swarmica.domain/widgets/render.js"></script>
  <script>
    const iframe = document.getElementById("123qwe")
    iframe.onload = () => {
      renderWidget("123qwe")
    }
  </script>
  <!-- end embedded Swarmica widget scripts -->

Доступные параметры

ПараметрЗначение по умолчаниюВозможные значения
locale - язык интерфейсаenen, ru
auth_provider - провайдер авторизации по умолчаниюemailemail - авторизация по email + password, code - авторизация по otp коду, для такого варианта необходимо еще передавать параметр otpdata, anonymous - без авторизации
otpdata - данные для OTP-авторизациине установленоСтрока с данными для входа по одноразовому коду. Обязателен при auth_provider=code. Передаётся в URL встраивания; содержит OTP-код.
button_color - цвет кнопки открытия виджета#93BEE6HEX код цвета. В url добавляется в виде %93BEE6 (button_color=%93BEE6)
telegram_link - ссылка на канал в Telegramне установленоссылка на телеграм, если не установлено - выбор опции Телеграм не отображается в виджете. Ожидается полный URL с https://
max_link - ссылка на канал в Maxне установленоссылка на Max, если не установлено - выбор опции Max не отображается в виджете. Ожидается полный URL с https://
helpcenter_url - ссылка на базу знанийне установленоссылка на базу знаний. Ожидается полный URL с https://
open - открывать или нет виджет сразуfalsetrue - открывать виджет сразу, false - отображать только кнопку
fullscreen - разворачивать виджет на весь экран без возможности свернутьfalsetrue - разворачивать на весь экран, false - показывать сворачиваемым окошком
page - стартовая страница виджетане установленоchats - список чатов, last_chat - последний открытый чат, new_chat - новый чат. Если не установлено, то первая страница - это выбор приложения внутри виджета
allow_logout - показывать кнопку выхода из учетной записи или нет (появилось в версии v5.7.1)falsetrue - показывать кнопку и позволять выходить из учетной записи, false - не показывать кнопку выхода (при этом выход из учетной записи доступен программно)
logout_on_init - производить выход из учетной записи при инициализации виджета, появилось в версии v5.9.2falsetrue - выполнять выход из текущей учётной записи при инициализации виджета. Полезно, если в рамках одной сессии приложения виджет используется для авторизации разных пользователей через otpdata.
false - не выполнять автоматический выход при инициализации.
Обновлена: 16 окт. 2026 г.

Симптомы

При проверке состояния Telegram канала отображается сообщение:

Ошибка: Missing permissions: ['can_read_all_group_messages']

Ошибка: Missing permissions: ['can_join_groups', 'can_read_all_group_messages']

Решение

Выключите настройку "Приватные группы"

  1. Владелец бота должен зайти в https://t.me/botfather
  2. Выбрать целевого бота (это также можно через приложение Botfather)
  3. Зайти в настройки Bot settings > Group privacy
  4. Выключить настройку Group privacy (Turn off) и Включить Allow Groups

Обновлена: 26 окт. 2026 г.

Симптомы

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

Решение

  1. Перейдите в конструктор ботов BotFather
  2. Запустите команду /my bots , выберите необходимое название бота, далее — Bot Settings и затем — Menu Button.
  3. Кликнуть Configure menu button.
  4. Отправить боту URL, на который пользователь перейдёт после нажатия кнопки. Например https://support.swarmica.com/help
  5. Ввести название кнопки, чтобы заменить стандартное название «База Знаний».
Обновлена: 15 окт. 2026 г.

Симптомы

Не все письма от Swarmica доходят по почтового ящика на Yandex.

В папке Входящие и Спам писем нет.

Если ввести заголовок в поиске (например, по номеру тикета), то письма показываются.

Решение

На некоторых ящиках Yandex включено подтверждение рассылок и почта от Swarmica определяется как рассылка. Необходимо добавить адрес Swarmica в подтвержденные подписки:

  1. Зайдите в веб-интерфейс почты Yandex
  2. Нажмите на XX неразобранных рассылок:
  3. Найдите адрес Swarmica и поставьте галочку напротив:
  4. Нажмите Получать
Обновлена: 17 окт. 2026 г.

Симптомы

Настроен почтовый канал support@company.com, при добавлении внутреннего комментария почта отправляется от support@company.com, а не support+internal@company.com.

Почта управляется Google (GSuite / Google Workspace / Gmail).

В заголовках почтового сообщения видно следующее:

From: Support <support@company.com>
X-Google-Original-From: Support <support+internal@company.com>
Subject: Test delivery
To: recepient@other-company.com
Reply-To: Support <support+internal@company.com>

Решение

Необходимо настроить дополнительный адрес на стороне аккаунта Google Mail

  1. Войдите в почтовое приложение под учетной записью канала support@company.com
  2. Нажмите иконку
  3. Нажмите Все настройки > Аккаунты и Импорт
  4. Пролистайте до раздела Отправлять письма как и нажмите Добавить другой адрес почты
  5. Добавьте адрес с суффиксом +internal перед @, то есть, для нашего примера это будет support+internal@company.com
  6. Уберите галочку Использовать как псевдоним и нажмите Далее

Причина

Начиная с 2025 года, Google поменял механизм работы с алиасами вида "+alias" и теперь по умолчанию подменяет такие алиасы на изначальный адрес, сохраняя изначальное поле From в заголовок X-Google-Original-From

Обновлена: 21 окт. 2026 г.

Симптомы

  1. Почтовый адрес для email-канала обслуживается office365.com (Exchange Online)
  2. При настройке получения входящей почты через IMAP ошибка: LOGIN failed.

Решение

Вы можете подключить сбор входящей почты через SMTP трансфер вместо IMAP

Причина

Microsoft убрал возможность авторизации через Basic Auth в Exchange Online:

https://learn.microsoft.com/en-us/answers/questions/1130148/outlook-imap-login-failed-using-python

Обновлена: 15 окт. 2026 г.

Симптомы

  1. Настроено SMTP перенаправление почты с адреса вида support@company.tld -> support@support.company.tld, где company.tld - это почтовый сервер (может быть Gmail, VK, Яндекс или локальный), а support.company.tld - это Swarmica
  2. Почта не доходит до тикета
  3. Если заглянуть в почтовый ящик , support@company.tld то письма там есть
  4. В почте отправителя баунсы
    Delivery Status Notification (Delay)
    454 4.7.1 : Relay access denied
  5. В логах постфикса на сервере ошибки вида:
    Oct 02 19:04:42 support postfix/smtpd[147]: NOQUEUE: reject: RCPT from unknown[79.137.243.76]: 454 4.7.1 <support@support.swarmica.com>: Relay access denied; from=<msudyin@swarmica.com> to=<support@support.swarmica.com> proto=ESMTP helo=<fallback20.i.mail.ru>

Решение

Добавить IP адреса почтового провайдера (например IP Адреса Gmail ) в переменную SMTP_NETWORKS и перезагрузить postfix:

vim .env
grep SMTP_NETWORKS .env
SMTP_NETWORKS=35.190.247.0/24,64.233.160.0/19,66.102.0.0/20,66.249.80.0/20,72.14.192.0/18,74.125.0.0/16,108.177.8.0/21,173.194.0.0/16,209.85.128.0/17,216.58.192.0/19,216.239.32.0/19,2001:4860:4000::/36,2404:6800:4000::/36,2607:f8b0:4000::/36,2800:3f0:4000::/36,2a00:1450:4000::/36,2c0f:fb50:4000::/36,172.217.0.0/19,172.217.32.0/20,172.217.128.0/19,172.217.160.0/20,172.217.192.0/19,172.253.56.0/21,172.253.112.0/20,108.177.96.0/19,35.191.0.0/16,130.211.0.0/22
docker-compose up -d

ВНИМАНИЕ! ЭТА КОМАНДА ПЕРЕЗАПУСТИТ ВСЕ ПРИЛОЖЕНИЯ - БУДЕТ ДАУНТАЙМ

Причина

Входящая почта обрабатывается postfix, который по умолчанию не разрешает соединение с внешних IP адресов

Для других провайдеров

Такая ошибка может быть и для других провайдеров. Например, для VK Workspace нужно настроить вот такие SMTP_NETWORKS:

79.137.243.0/24,94.100.180.215/32,94.100.180.216/32,217.69.139.215/32,217.69.139.216/32

В общем случае нужно смотреть в SPF запись домена, с которого настроено перенаправление, и добавлять эти сервера

Обновлена: 14 окт. 2026 г.

Необходимые условия

  • Для веб-виджета необходим минимальный тариф Про
  • Включенная фича Чаты (chats)
  • Сервер с Swarmica должен быть доступен извне по доменному имени и протоколу HTTPS

Создание канала

Для того, чтобы различать веб-приложения (сайты), куда встроен виджет и иметь возможность выполнять разные настройки для разных приложений, следует создавать отдельные каналы типа "Виджет" в Swarmica.

Для создания канала Виджета, зайдите в Настройки > Каналы > Виджеты:

Нажмите Создать и введите название, например "Виджет на основном сайте" - это название будет отображаться в списках заявок, экспортах данных и т.д.

Выберите тип авторизации:

  • Аноним - не будет требовать никакой авторизации.
  • OTP код - используется, если вы интегрируете виджет в свое приложение и хотите пробрасывать авторизацию из него.
  • Email - пускает только тех пользователей, которые зарегистрированы в Swarmica.

Переключите бегунок Включен и нажмите Сохранить.

Теперь виджет готов к встраиванию.

Встраивание виджета

Чтобы встроить виджет в приложение, добавьте код, отображаемый в правой панели в HTML код сайта или приложения, куда вы хотите встроить виджет. Для того, чтобы скорость загрузки приложения была оптимальна, разместите код ближе к закрывающему тегу </body>

Пример кода встраивания:

<!-- start embedded Swarmica Chat script -->
<iframe src="https://tool.swarmica.com/widgets/index.html?id=tHf5NcVly6D7ztm-" id="tHf5NcVly6D7ztm-" style="position: fixed; right: 12px; bottom: 12px; width: 56px; height: 56px; overflow: hidden; "
  allowTransparency="true"
  frameborder="0"
  allowTransparency="true" frameborder="0"></iframe>
<script src="https://tool.swarmica.com/widgets/render.js"></script>
<script>
  const iframe = document.getElementById("tHf5NcVly6D7ztm-")
  iframe.onload = () => {
    renderWidget("tHf5NcVly6D7ztm-")
  }
</script>
<!-- end embedded Swarmica Chat scripts -->

Также, можно указать параметр локализации виджета, для этого нужно передать параметр locale=ru или locale=en:

<iframe src="https://tool.swarmica.com/widgets/index.html?id=tHf5NcVly6D7ztm-&locale=ru" ...

Персонализация и стилизация

Изменение поведения виджета возможно с помощью дополнительных параметров инициализации виджета.

Стилизация виджета возможна через CSS тему бренда.

Обновлена: 15 окт. 2026 г.

В этой статье мы расскажем о том, как настроить SMTP relay в Swarmica для отправки исходящей почты со всех email-каналов.

Настройки SMTP relay

Чтобы внести в систему настройки SMTP relay, перейдите в раздел Настройки и далее на блок SMTP relay.

Откроется страница с настройками. Ниже показываем пример заполненных настроек.

Сверху вниз внесите следующие данные:

  1. Адрес вашего сервера.
  2. Порт для исходящей почты вашего сервера.
  3. Имя пользователя, через которого будет проходить исходящая почта.
  4. Пароль пользователя.
  5. Шифрование: нет, SSL или TLS.
  6. Активируйте переключатель Включен, если все настройки внесены, и сервер готов к работе.
  7. Активируйте настройку Использовать системный SMTP сервер в ваших email-каналах (раздел Настройки - Каналы - Email).

Проверка SMTP relay

После того, как все пункты будут выполнены, для проверки корректности настроек нажмите .

Если настройки выполнены верно, под кнопкой проверки появится такое уведомление зелёного цвета:

Если же настройки некорректны, уведомление будет красного цвета:

Кроме того, вы можете воспользоваться дополнительной опцией проверки справа от полей настроек - отправка тестового письма:

После заполнения данных и нажатия в этом блоке так же появится уведомление об успешной или неуспешной отправке:

Обновлена: 15 окт. 2026 г.

ВАЖНО! Для корректного обмена данными с сервером Mango, Swarmica должна быть доступна по доменному имени по HTTPS из внешней сети Интернет.

Что дает подключение?

  1. По входящему звонку создается пользователь 7ХХХХХХХХХХ@PHONE
  2. От этого пользователя создается тикет
  3. После окончания разговора в тикет добавляется запись звонка

Инструкция по подключению

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

Настройка подключения

В Mango в боковом меню откройте раздел Интеграции и выберите API-коннектор:

Подключение может быть платным. Обратитесь по этому вопросу в поддержку Mango.

Откроется такая страница:

В соседней вкладке браузера откройте Swarmica и перейдите в раздел Настройки - Каналы. Выберите Mango Office. Нажмите "Создать" справа вверху.

Введите название - любое произвольное название вашего канала. Затем переключитесь на вкладку Mango "API коннектор", которую вы открыли в предыдущем шаге, скопируйте и вставьте из неё в Swarmica следующие данные.

Ключ API в Swarmica - Уникальный код вашей АТС в Mango.

Ключ подписи в Swarmica - Ключ для создания подписи в Mango.

Для копирования воспользуйтесь специальными кнопками в правой части каждого из полей.

Нажмите в Swarmica "Сохранить" - вы окажетесь на странице настроек канала Mango.

Пропишите в поле URL содержимое поля со страницы Mango Адрес API виртуальной АТС:

Активируйте канал бегунком Включен и нажмите Сохранить:

Теперь нужно сгенерировать и прописать адрес внешней системы и прописать его в поле ниже на этой же странице Mango. Он имеет такой формат: https://your_swarmica_url/webhooks/mangooffice/XXXXX

Скопируйте этот url в поле Адрес внешней системы в Mango

Замените в нём следующее содержимое.

your_swarmica_url - ваш уникальный url, с которым вы входите в Swarmica.

XXXXX - набор символов, которым заканчивается URL на странице настроек Mango в Swarmica, указан на картинке:

На странице Mango API коннектор обязательно активируйте следующие настройки.

  1. Предоставлять возможность генерации и использования ссылок.
  2. Отправка данных о лиде из Контакт Центра.
  3. Не проверять сертификат.
  4. Не пробрасывать идентификатор SIP_Call_ID из внешней системы.
  5. Не отправлять события о статистике диалогов робота.
  6. Не отправлять информацию о событиях в Адресной книге на указанный адрес внешней системы.
  7. Не отправлять события о завершении процесса распознавания тематик.
  8. Не отправлять события Манго Диалоги.
Обновлена: 14 окт. 2026 г.

При помощи этой статьи вы сможете подключить ваше ВК-сообщество к Swarmica и переписываться в личных сообщениях сообществу от имени сообщества. Можно подключить сразу несколько ваших сообществ.

После завершения и сохранения всех настроек на стороне Swarmica обратитесь в службу поддержки Swarmica, чтобы запустить работу канала на стороне системы!

Настройка на стороне VK

Условия

  1. Необходимы права "Руководитель сообщества" для выполнения настройки.
  2. В вашем ВК-аккаунте должна быть включена двухфакторная аутентификация. Включить её можно по этой ссылке.

Настройки

Все шаги инструкции нужно выполнять только в указанной последовательности! Если поменять местами пункты, интеграция не заработает!

  1. На странице сообщества нажмите в боковом меню справа "Управление".
  2. Включите режим Long Poll API в разделе Настройки > Работа с API > Long Poll API:
  3. Подключите все типы событий, связанных с разделом Сообщения:
  4. Только после этого создайте API ключ и скопируйте его - он будет нужен для настройки канала в Swarmica:
  5. Найдите и скопируйте ID сообщества в разделе Настройки > Общая информация:
    ВНИМАНИЕ! Нужны только цифры, префикс club или group не нужен.

Настройка на стороне Swarmica

  1. Перейдите в вашем аккаунте Swarmica в раздел Настройки - Каналы и выберите "ВК (Вконтакте)".
  2. Справа вверху открывшейся страницы нажмите
  3. Введите название вашего канала и сохраните:
  4. Откроется такое окно:
  5. Введите токен - API ключ, созданный в ВК на этапе 3 настроек в предыдущем разделе. В сообществе ВК он находится в разделе Управление > Настройки > Работа с API.
  6. Введите номер сообщества из п.5 настроек в предыдущем разделе. В сообществе ВК он находится в разделе Управление > Настройки > Общая информация.
  7. Выберите, что будет создаваться при поступлении сообщения из ВК: заявки или чаты. О различии между этими функциями подробно написано в этой статье.
  8. Передвиньте бегунок "Включен" чтобы активировать канал.
  9. Нажмите
    Пример заполненных настроек:
  10. После завершения и сохранения всех настроек обратитесь в службу поддержки Swarmica, чтобы запустить работу канала на стороне системы!
Обновлена: 15 окт. 2026 г.

Омниканальность - система обработки обращений из разных внешних источников: telegram, WhatsApp, VK и виджет на сайте. Омниканальность может работать в 4 разных режимах. В этой статье мы расскажем об этих режимах.

1. Медленный режим

В медленном режиме могут работать Email, telegram, VK и WhatsApp. Тогда сообщения из этих мессенджеров попадают в раздел Заявки, который по умолчанию не требует быстрого ответа. Медленный режим делится на два подрежима.

1а. Однопоточный. Один мессенджер инициирует одну заявку, и вся переписка по нему ведётся в этой заявке.

1б. Многопоточный. Бот предлагает в мессенджере выбрать по номеру заявку, в которую клиент будет писать. Клиент видит это примерно так:

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

Если учётная запись клиента привязана к email, он может в рамках одной заявки писать и в мессенджер, и в email, переключаясь между каналами.

2. Быстрый (чатный) режим

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

2а. Сингл чат. В этом режиме один чат относится к одному тикету, и вся переписка в нём будет происходить в рамках одного тикета.

2б. Мультичат. В этом режиме к одному тикету могут присоединяться несколько чатов. Этот режим подойдёт, если у вас есть несколько линий поддержки, и первая линия определяет, относится чат к новому тикету или к существующему, и дополняет существующий тикет новым входящим чатом.

Настройка режимов

Некоторые каналы работают только в быстром или только в медленном режиме, а некоторые каналы можно настраивать. Ниже представим список каналов и их возможные режимы.

Email - всегда медленный режим.

WhatsApp- режим определяется в настройках канала (Настройки - Каналы - WhatsApp).

  • Заявки - медленный режим.
  • Чаты - быстрый режим.

Telegram- режим определяется в настройках канала (Настройки - Каналы - Telegram).

  • Заявки - медленный режим.
  • Чаты - быстрый режим.

VK - режим определяется в настройках канала (Настройки - Каналы - ВК (Вконтакте)).

  • Заявки - медленный режим.
  • Чаты - быстрый режим.

Виджет - всегда быстрый режим.

Подрежим (однопоточный, многопоточный, сингл чат, мультичат) определяется обычно на стадии внедрения Swarmica - обратитесь в службу поддержки для его выбора.

Обновлена: 15 окт. 2026 г.

Симптомы

Чаты из Telegram бота создают в системе тикеты, а не чаты.

Решение

  1. Зайдите в Настройки - Каналы - Telegram.
  2. Выберите Создавать - Чаты:

Причина

В настройках Telegram выбрано создавать Заявки.

Обновлена: 15 окт. 2026 г.

Симптомы

Есть Whatsapp аккаунт. Как правильно сделать пользователя админа?

Решение

  1. Зайдите в аккаунт клиента в
    Клиенты > Пользователи > Номер_телефона@WHATSAPP

  2. Выставить роль
    Администратор Клиента

  3. Задайте пароль:

После этого клиент может логиниться с:

Логин: Номер_телефона@WHATSAPP
Пароль: Тот что задали ему выше

Обновлена: 14 окт. 2026 г.

Подключение почты Yahoo! Mail через IMAP

После подключения в Swarmica попадут все письма в статусе "Не прочитано" в формате заявок. Если их более 100, это может вызвать перегрузку системы!


1. Перейдите в Swarmica в раздел Настройки - Каналы, нажмите Email.

2. Справа вверху нажмите

3. Откроется окно для заполнения основных данных:

Название - произвольное название вашего почтового канала.

Получатель - адрес email, на который вы получаете почту.

Отправитель - адрес, с которого вы будете отвечать на письма.

Входящий и исходящий адреса могут различаться в том случае, если, например, у вас несколько почтовых адресов, но вы отправляете ответы на все письма со всех ящиков только с одного адреса.

После заполнения основных данных нажмите "Сохранить"

4. Откроется страница настроек почты.

Заполнение настроек в Swarmica

Настройки входящей почты

  1. Название - произвольное название вашего почтового канала.
  2. Имя отправителя - отображаемое у получателей имя отправителя. Например, "Служба поддержки" и название вашей компании.
  3. Получатель: адрес email, на который вы получаете почту.
  4. Сервер получения: imap.mail.yahoo.com.
  5. Порт сервера IMAP: 993.
  6. Шифрование: SSL.
  7. Пользователь - в большинстве случаев равен вашему почтовому адресу.
  8. Пароль - необходим пароль для приложения. О том, как его получить, расскажем ниже.
  9. Папка - название папки в вашей почте на сервере IMAP, если вы хотите получать в Swarmica не всю входящую почту, а только из определённой папки.
  10. "Проверить подключение" - обязательно нажмите после того, как впишете настройки выше, чтобы убедиться в том, что настройки прописаны корректно. Если увидите ошибку, перепроверьте введённые данные.

Настройки исходящей почты

Можно настроить отправку с почтового ящика Yahoo! Mail, и можно отправлять почту с собственного сервера SMTP Relay. Для отправки по SMTP Relay включите бегунок "Использовать системный SMTP сервер":

О настройках SMTP Relay можно прочитать здесь.

Ниже расскажем о заполнении настроек отправки через Yahoo! Mail.

  1. Отправитель - адрес, с которого вы будете отвечать на письма.
  2. Сервер отправления: smtp.mail.yahoo.com.
  3. Порт сервера SMTP: 465.
  4. Шифрование: SSL.
  5. Пользователь - в большинстве случаев равен вашему почтовому адресу.
  6. Пароль - необходим пароль для приложения. О том, как его получить, расскажем ниже.
  7. Таймаут - искусственный промежуток времени в секундах между отправляемыми письмами, чтобы не отправлять много писем в один и тот же момент и понизить вероятность подозрения в спаме.
  8. "Проверить подключение" - обязательно нажмите после того, как впишете настройки выше, чтобы убедиться в том, что настройки прописаны корректно. Если увидите ошибку, перепроверьте введённые данные.

Остальные настройки

  1. Разрешить создание заявок - включите для передачи заявок в Swarmica.
  2. Сохранять цитирование - сохранить переписку при пересылке. С отключенной опцией пересылка будет содержать только сопроводительный текст. С включенной опцией - всю переписку.
  3. Разрешить новых пользователей в CC - позволить ставить в копию email-заявки любые адреса. Настройка включается для защиты от спамеров, использующих опцию создания заявки для рассылки спама при помощи функции поля для копии письма.
  4. Тот же домен в СС - разрешает ставить в копию письма адреса, принадлежащие только домену из электронного адреса создателя заявки. Это облегченный вариант защиты от спамеров, описанных в предыдущем пункте. Он разрешит добавлять в копию коллег из компании клиента, но запретит добавить чужие адреса.
  5. Использовать по умолчанию - включите, чтобы ответы всегда отправлялись с указанного адреса отправки.
  6. Включен - позволяет активировать почтовый канал в Swarmica.

После завершения и проверки настроек не забудьте их сохранить.

Получение пароля для приложения в Yahoo! Mail

1. Зайдите в ваш аккаунт Yahoo! Mail. Нажмите на имя вашего аккаунта вверху справа и выберите "Данные учётной записи".

2. Перейдите на вкладку "Безопасность", пролистните ниже и нажмите "Создать пароль для приложения".

3. Введите название вашего приложения - Swarmica.

4. Скопируйте получившийся пароль.

5. Перейдите в Swarmica в раздел настроек вашей почты и вставьте скопированный пароль в оба поля с паролями:

Проверьте оба подключения. При возникновении ошибок перепроверьте прописанные настройки.

Нажмите "Сохранить". Почта подключена.

Обновлена: 16 окт. 2026 г.

Подключение почты Mail.ru через IMAP

После подключения в Swarmica попадут все письма в статусе "Не прочитано" в формате заявок. Если их более 100, это может вызвать перегрузку системы!


1. Перейдите в Swarmica в раздел Настройки - Каналы, нажмите Email.

2. Справа вверху нажмите

3. Откроется окно для заполнения основных данных:

Название - произвольное название вашего почтового канала.

Получатель - адрес email, на который вы получаете почту.

Отправитель - адрес, с которого вы будете отвечать на письма.

Входящий и исходящий адреса могут различаться в том случае, если, например, у вас несколько почтовых адресов, но вы отправляете ответы на все письма со всех ящиков только с одного адреса.

После заполнения основных данных нажмите "Сохранить"

4. Откроется страница настроек почты.

Заполнение настроек в Swarmica

Настройки входящей почты

  1. Название - произвольное название вашего почтового канала.
  2. Имя отправителя - отображаемое у получателей имя отправителя. Например, "Служба поддержки" и название вашей компании.
  3. Получатель: адрес email, на который вы получаете почту.
  4. Сервер получения: imap.mail.ru.
  5. Порт сервера IMAP: 993.
  6. Шифрование: SSL.
  7. Пользователь - в большинстве случаев равен вашему почтовому адресу.
  8. Пароль - необходим пароль для приложения. О том, как его получить, расскажем ниже.
  9. Папка - название папки в вашей почте на сервере IMAP, если вы хотите получать в Swarmica не всю входящую почту, а только из определённой папки.
  10. Проверить подключение - обязательно нажмите после того, как впишете настройки выше, чтобы убедиться в том, что настройки прописаны корректно. Если увидите ошибку, перепроверьте введённые данные.

Настройки исходящей почты

Можно настроить отправку с почтового ящика Mail.ru, и можно отправлять почту с собственного сервера SMTP Relay. Для отправки по SMTP Relay включите бегунок "Использовать системный SMTP сервер":

О настройках SMTP Relay можно прочитать здесь.

Ниже расскажем о заполнении настроек отправки через Mail.ru.

  1. Отправитель - адрес, с которого вы будете отвечать на письма.
  2. Сервер отправления: smtp.mail.ru.
  3. Порт сервера SMTP: 465.
  4. Шифрование: SSL.
  5. Пользователь - в большинстве случаев равен вашему почтовому адресу.
  6. Пароль - необходим пароль для приложения. О том, как его получить, расскажем ниже.
  7. Таймаут - искусственный промежуток времени в секундах между отправляемыми письмами, чтобы не отправлять много писем в один и тот же момент и понизить вероятность подозрения в спаме.
  8. "Проверить подключение" - обязательно нажмите после того, как впишете настройки выше, чтобы убедиться в том, что настройки прописаны корректно. Если увидите ошибку, перепроверьте введённые данные.

Остальные настройки

  1. Разрешить создание заявок - включите для передачи заявок в Swarmica.
  2. Сохранять цитирование - сохранить переписку при пересылке. С отключенной опцией пересылка будет содержать только сопроводительный текст. С включенной опцией - всю переписку.
  3. Разрешить новых пользователей в CC - позволить ставить в копию email-заявки любые адреса. Настройка включается для защиты от спамеров, использующих опцию создания заявки для рассылки спама при помощи функции поля для копии письма.
  4. Тот же домен в СС - разрешает ставить в копию письма адреса, принадлежащие только домену из электронного адреса создателя заявки. Это облегченный вариант защиты от спамеров, описанных в предыдущем пункте. Он разрешит добавлять в копию коллег из компании клиента, но запретит добавить чужие адреса.
  5. Использовать по умолчанию - включите, чтобы ответы всегда отправлялись с указанного адреса отправки.
  6. Включен - позволяет активировать почтовый канал в Swarmica.

После завершения и проверки настроек не забудьте их сохранить.

Активация IMAP-протокола на стороне почты и получение пароля для приложения

1. Перейдите в вашу почту Mail.ru и нажмите "Настройки" внизу слева:

2. Выберите "Все настройки":

3. Выберите пункт Безопасность - Внешние сервисы:

4. На открывшейся странице включите "Доступ к Почте по IMAP, POP и SMTP", если он не включен.

5. Вернитесь в раздел "Безопасность" и выберите Пароли для внешних приложений:

6. Нажмите "Создать":

Придумайте название пароля, например, Swarmica, нажмите "Продолжить".

7. На открывшейся странице выберите "Полный доступ к почте":

8. Введите пароль от вашего аккаунта, пройдите проверку "Я не робот". Откроется окно с паролем для внешнего приложения. Нажмите "Скопировать":

9. Перейдите в Swarmica в раздел настроек вашей почты и вставьте скопированный пароль в оба поля с паролями:

Проверьте оба подключения. При возникновении ошибок перепроверьте прописанные настройки.

Нажмите "Сохранить". Почта подключена.

Обновлена: 17 окт. 2026 г.

Подключение почты Gmail через IMAP

После подключения в Swarmica попадут все письма в статусе "Не прочитано" в формате заявок. Если их более 100, это может вызвать перегрузку системы!


1. Перейдите в Swarmica в раздел Настройки - Каналы, нажмите Email.

2. Справа вверху нажмите

3. Откроется окно для заполнения основных данных:

Название - произвольное название вашего почтового канала.

Получатель - адрес email, на который вы получаете почту.

Отправитель - адрес, с которого вы будете отвечать на письма.

Входящий и исходящий адреса могут различаться в том случае, если, например, у вас несколько почтовых адресов, но вы отправляете ответы на все письма со всех ящиков только с одного адреса.

После заполнения основных данных нажмите "Сохранить"

4. Откроется страница настроек почты.

Заполнение настроек в Swarmica

Настройки входящей почты

  1. Название - произвольное название вашего почтового канала.
  2. Имя отправителя - отображаемое у получателей имя отправителя. Например, "Служба поддержки" и название вашей компании.
  3. Получатель: адрес email, на который вы получаете почту.
  4. Сервер получения: imap.gmail.com.
  5. Порт сервера IMAP: 993.
  6. Шифрование: SSL.
  7. Пользователь - в большинстве случаев равен вашему почтовому адресу.
  8. Пароль - необходим пароль для приложения. О том, как его получить, расскажем ниже.
  9. Папка - название папки в вашей почте на сервере IMAP, если вы хотите получать в Swarmica не всю входящую почту, а только из определённой папки.
  10. "Проверить подключение" - обязательно нажмите после того, как впишете настройки выше, чтобы убедиться в том, что настройки прописаны корректно. Если увидите ошибку, перепроверьте введённые данные.

Настройки исходящей почты

Можно настроить отправку с почтового ящика Gmail, и можно отправлять почту с собственного сервера SMTP Relay. Для отправки по SMTP Relay включите бегунок "Использовать системный SMTP сервер":

О настройках SMTP Relay можно прочитать здесь.

Ниже расскажем о заполнении настроек отправки через Gmail.

  1. Отправитель - адрес, с которого вы будете отвечать на письма.
  2. Сервер отправления: smtp.gmail.com.
  3. Порт сервера SMTP: 465.
  4. Шифрование: SSL.
  5. Пользователь - в большинстве случаев равен вашему почтовому адресу.
  6. Пароль - необходим пароль для приложения. О том, как его получить, расскажем ниже.
  7. Таймаут - искусственный промежуток времени в секундах между отправляемыми письмами, чтобы не отправлять много писем в один и тот же момент и понизить вероятность подозрения в спаме.
  8. "Проверить подключение" - обязательно нажмите после того, как впишете настройки выше, чтобы убедиться в том, что настройки прописаны корректно. Если увидите ошибку, перепроверьте введённые данные.

Остальные настройки

  1. Разрешить создание заявок - включите для передачи заявок в Swarmica.
  2. Сохранять цитирование - сохранить переписку при пересылке. С отключенной опцией пересылка будет содержать только сопроводительный текст. С включенной опцией - всю переписку.
  3. Разрешить новых пользователей в CC - позволить ставить в копию email-заявки любые адреса. Настройка включается для защиты от спамеров, использующих опцию создания заявки для рассылки спама при помощи функции поля для копии письма.
  4. Тот же домен в СС - разрешает ставить в копию письма адреса, принадлежащие только домену из электронного адреса создателя заявки. Это облегченный вариант защиты от спамеров, описанных в предыдущем пункте. Он разрешит добавлять в копию коллег из компании клиента, но запретит добавить чужие адреса.
  5. Использовать по умолчанию - включите, чтобы ответы всегда отправлялись с указанного адреса отправки.
  6. Включен - позволяет активировать почтовый канал в Swarmica.

После завершения и проверки настроек не забудьте их сохранить.

Настройки на стороне Gmail

1. Перейдите в вашу почту Gmail и затем в настройки по шестерёнке вверху справа. Выберите "Все настройки".

2. Выберите вверху вкладку "Пересылка и POP/IMAP". В блоке "Доступ по протоколу IMAP" убедитесь, что галочка "Включить IMAP" установлена.

При необходимости сохраните изменения внизу страницы.

3. Нажмите на аватарку справа вверху в вашем аккаунте Google и выберите "Управление аккаунтом Google".

В боковом меню выберите раздел "Безопасность" и затем пункт "Двухэтапная аутентификация". Для подключения почты к Swarmica она обязательно должна быть подключена.

Если у вас, как на картинке, двухэтапная аутентификация отключена, нажмите на этот пункт и включите её. Потребуется указать какой-либо дополнительный канал для подтверждения доступа - SMS, звонок, приложение от Google и т. п.

Если вы используйте Google Workspace, убедитесь, что у пользователей есть разрешение на включение двухэтапной аутентификации. Сделать это можно в разделе Консоль администратора - Безопасность - Обзор - Двухэтапная аутентификация. Чекбокс «Разрешить пользователям включать двухэтапную аутентификацию» должен быть активен.



4. Перейдите по ссылке https://myaccount.google.com/apppasswords для создания пароля приложения. Введите название пароля приложения - например, Swarmica, и нажмите "Создать".

Скопируйте пароль на открывшейся странице, и затем нажмите "Готово":

5. Перейдите в Swarmica в раздел настроек вашей почты и вставьте скопированный пароль в оба поля с паролями:

Проверьте оба подключения. При возникновении ошибок перепроверьте прописанные настройки.

Нажмите "Сохранить". Почта подключена.

Обновлена: 16 окт. 2026 г.

Подключение Yandex-почты через IMAP

После подключения в Swarmica попадут все письма в статусе "Не прочитано" в формате заявок. Если их более 100, это может вызвать перегрузку системы!


1. Перейдите в Swarmica в раздел Настройки - Каналы, нажмите Email.

2. Справа вверху нажмите

3. Откроется окно для заполнения основных данных:

Название - произвольное название вашего почтового канала.

Получатель - адрес email, на который вы получаете почту.

Отправитель - адрес, с которого вы будете отвечать на письма.

Входящий и исходящий адреса могут различаться в том случае, если, например, у вас несколько почтовых адресов, но вы отправляете ответы на все письма со всех ящиков только с одного адреса.

После заполнения основных данных нажмите "Сохранить"

4. Откроется страница настроек почты.

Заполнение настроек в Swarmica

Настройки входящей почты

  1. Название - произвольное название вашего почтового канала.
  2. Имя отправителя - отображаемое у получателей имя отправителя. Например, "Служба поддержки" и название вашей компании.
  3. Получатель: адрес email, на который вы получаете почту.
  4. Сервер получения: imap.yandex.ru.
  5. Порт сервера IMAP: 993.
  6. Шифрование: SSL.
  7. Пользователь - в большинстве случаев равен вашему почтовому адресу.
  8. Пароль - необходим пароль для приложения. О том, как его получить, расскажем ниже.
  9. Папка - название папки в вашей почте на сервере IMAP, если вы хотите получать в Swarmica не всю входящую почту, а только из определённой папки.
  10. "Проверить подключение" - обязательно нажмите после того, как впишете настройки выше, чтобы убедиться в том, что настройки прописаны корректно. Если увидите ошибку, перепроверьте введённые данные.

Настройки исходящей почты

Можно настроить отправку с почтового ящика Yandex, и можно отправлять почту с собственного сервера SMTP Relay. Для отправки по SMTP Relay включите бегунок "Использовать системный SMTP сервер":

О настройках SMTP Relay можно прочитать здесь.

Ниже расскажем о заполнении настроек отправки через Yandex.

  1. Отправитель - адрес, с которого вы будете отвечать на письма.
  2. Сервер отправления: smtp.yandex.ru.
  3. Порт сервера SMTP: 465.
  4. Шифрование: SSL.
  5. Пользователь - в большинстве случаев равен вашему почтовому адресу.
  6. Пароль - необходим пароль для приложения. О том, как его получить, расскажем ниже.
  7. Таймаут - искусственный промежуток времени в секундах между отправляемыми письмами, чтобы не отправлять много писем в один и тот же момент и понизить вероятность подозрения в спаме.
  8. "Проверить подключение" - обязательно нажмите после того, как впишете настройки выше, чтобы убедиться в том, что настройки прописаны корректно. Если увидите ошибку, перепроверьте введённые данные.

Остальные настройки

  1. Разрешить создание заявок - включите для передачи заявок в Swarmica.
  2. Сохранять цитирование - сохранить переписку при пересылке. С отключенной опцией пересылка будет содержать только сопроводительный текст. С включенной опцией - всю переписку.
  3. Разрешить новых пользователей в CC - позволить ставить в копию email-заявки любые адреса. Настройка включается для защиты от спамеров, использующих опцию создания заявки для рассылки спама при помощи функции поля для копии письма.
  4. Тот же домен в СС - разрешает ставить в копию письма адреса, принадлежащие только домену из электронного адреса создателя заявки. Это облегченный вариант защиты от спамеров, описанных в предыдущем пункте. Он разрешит добавлять в копию коллег из компании клиента, но запретит добавить чужие адреса.
  5. Использовать по умолчанию - включите, чтобы ответы всегда отправлялись с указанного адреса отправки.
  6. Включен - позволяет активировать почтовый канал в Swarmica.

После завершения и проверки настроек не забудьте их сохранить.

Активация IMAP-протокола на стороне почты и получение пароля для приложения

1. Перейдите в вашу Yandex почту, нажмите на шестерёнку вверху справа и выберите "Все настройки":

2. На открывшейся странице в боковом меню выберите "Почтовые программы", и затем отметьте галочками:

  • С сервера imap.yandex.ru по протоколу IMAP
  • Пароли приложений и OAuth-токены

3. В боковом меню перейдите в раздел "Безопасность" и выберите "Пароли приложений":

4. На открывшейся странице выберите "Почта":

5. Придумайте имя пароля, например, "Swarmica":

6. Нажмите на кнопку копирования справа от пароля, чтобы скопировать его:

7. Перейдите в Swarmica в раздел настроек вашей почты и вставьте скопированный пароль в два поля "Пароль" на стороне настроек входящей и исходящей почты:

Проверьте оба подключения. При возникновении ошибок перепроверьте прописанные настройки.

Нажмите "Сохранить". Почта подключена.

Обновлена: 15 окт. 2026 г.

Симптомы

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

В логах ошибка

ERROR 2024-11-16 14:01:57,491 dispatcher 7 139681445026688 Failed to fetch updates - TelegramConflictError: Telegram server says - Conflict: can't use getUpdates method while webhook is active; use deleteWebhook to delete the webhook first
WARNING 2024-11-16 14:01:57,498 dispatcher 7 139681445026688 Sleep for 4.893700 seconds and try again... (tryings = 13, bot id = 6804714376)

Решение

Удалить вебхук, открыв ссылку в браузере:

https://api.telegram.org/botAPITOKEN/setWebhook?url=

Замените слово APITOKEN на ваш токен вида 1111111111:AAAAAAAAAAAAAAbbbbbbbbbbCCCCCCCCCCC

Обновлена: 10 нояб. 2026 г.

Установка и обновление

Для настройки интеграции на стороне Billmanager 6 Hosting & Cloud потребуется сотрудник с полными правами администратора в биллинге и с доступом до консоли сервера по SSH.


Для установки модуля Swarmica скачайте и распакуйте архив на сервер с установленным Billmanager 6 Hosting & Cloud:

wget https://support.swarmica.com/attachments/L/I/LI3IZ0MMJ84Mku4K_a/swarmica_billmanager.v1.3.10.zip
unzip swarmica_billmanager.v1.3.10.zip

Затем выполните команду install.sh:

chmod +x install.sh
./install.sh

Изменения применятся после перезагрузки биллинга (скрипт установки предложит это сделать автоматически).

Альтернативно, можно скачать и установить пакет для одной из поддерживаемых OC:

DEB: https://support.swarmica.com/attachments/e/Z/eZ0Rgk0pw7OiDxUS_a/swarmica-billmanager-1.v1.3.10_amd64.deb

RPM: https://support.swarmica.com/attachments/R/r/RroG_UyR7n6h9r9l_a/swarmica-billmanager-v1.3.10-302.x86_64.rpm

При первоначальной установке настройте интеграцию в веб-интерфейсе.

Настройка на стороне Swarmica

На сервере

  1. Добавьте в в /root/swarmica/.env в FEATURES следующий флаг: billmanager
  2. Выполните команду
docker compose down && docker compose up -d

В интерфейсе

1. В разделе Настройки > Каналы > Billmanager создайте новый канал:

Название - произвольное название канала для приёма заявок.

URL биллинга - ваш уникальный URL для использования Billmanager 6 Hosting & Cloud.

Секретный ключ – это произвольная последовательность символов, которая будет отвечать за авторизацию Swarmica на строне Billmanager 6 Hosting & Cloud. Его можно сгенерировать автоматически. В случае изменения секретного ключа, впоследствии, не забудьте его обновить так же и на стороне Billmanager.

Чтобы сгенерировать ключ, перейдите в настройки созданного канала, нажав на него, а затем на значок в конце строки Секретный ключ:

Активируйте бегунок Включен для активации интеграции.

Скопируйте секретный ключ и UID канала из адресной строки браузера - эти данные понадобятся для настроек на стороне Billmanager:

2. В разделе Настройки > API и интеграции создайте новый API ключ и скопируйте его код - он так же понадобится для настроек на стороне Billmanager.

Настройки на стороне Billmanager 6 Hosting & Cloud

В разделе Интеграция > Swarmica в боковом меню заполните форму:

URL - ваш уникальный url для входа в Swarmica вместе с протоколом (http:// или https://).

API токен - код, полученный на стороне Swarmica в разделе API и интеграции.

UID канала Billmanager в Swarmica - UID из адресной строки на странице Настройки > Каналы > Billmanager:

Секретный ключ - ключ, который вы сгенерировали в настройках канала Billmanager на стороне Swarmica.

ID пользователя биллинга - ID привилегированного пользователя, от имени которого будут добавляться служебные комментарии. Требуется роль Администратор..

MySQL TLS соединение - если у вас отдельно стоящий MySQL сервер для Billmanager, который требует TLS для подключения - измените этот параметр на одно из значений false, true, preferred, skip-verify в зависимости от настроек сервера MySQL.

Для включения интеграции отметьте галочкой Синхронизация со Swarmica включена.

Создание и синхронизация внутренних пользователей

Чтобы правильно создать агентские роли с соответствующими правами, нужно:

  1. Создать пользователя с ролью сотрудник на стороне Billmanager
  2. Выдать ему соответствующие права на обработку тикетов
  3. Пользователь будет синхронизирован со Swarmica - проверить и выдать уже нужную роль (Менеджер или Агент) в Swarmica
Обновлена: 24 окт. 2026 г.

Симптомы

Как подключить канал Whatsapp если у нас Swarmica установлена на нашем оборудовании через installer?

Как подключить канал Whatsapp для коробочной (on-premise) установки?

Лицензия и тариф

Для подключения канала Whatsapp через Green API необходима лицензия Swarmica тарифа Про или выше, а так же инстанс тарифа Business в Green API.

Решение

1. Зайдите в папку на сервере, где установлена Swarmica (по умолчанию /root/swarmica):

cd /root/swarmica

2. Отредактируйте файл docker-compose.yml так, чтобы он содержал следующую секцию В КОНЦЕ раздела services:


  whatsapp_green:
    <<: *django
    ports: []
    command: /start-whatsapp-green
    labels:
      - "traefik.enable=false"

ВАЖНО! Секция должна быть отделена пустыми строками сверху и снизу, а так же иметь необходимые отступы (2 пробела перед whatsapp_green: и далее как в примере выше.

3. Перезапустите приложение:

docker compose up -d

4. Выполните команду создания базовых шаблонов:

docker exec --env-file .env -it swarmica-django-1 python manage.py restore_bot_messages

5. Для дальнейшей настройки следуйте инструкции https://support.swarmica.com/article/ru/317-ru.html

Обновлена: 14 окт. 2026 г.

Telegram можно подключить к Swarmica при помощи telegram-бота, в том числе и в качестве группового телеграм-бота. Подключение канала или личного аккаунта на данный момент невозможно.

Суть работы интеграции с telegram-ботом такова: клиент подписывается на бота, отправляет в него сообщение. Сообщение передаётся в Swarmica в качестве заявки, и на неё может отвечать агент. Агент не может инициировать переписку с клиентом, который пока не подписался на бота и ничего не написал.


Telegram работает по принципу одно подключение = 1 бот, поэтому, если ваш бот уже подключен к какому-либо сервису, необходимо отключить бота от этого сервиса или создать нового бота.


Создание telegram-бота

Для создания нового бота перейдите по ссылке https://t.me/botfather в официальный бот Telegram, который создаёт новых ботов.

Запустите бота и введите или выберите /newbot

Введите и отправьте имя вашего бота. Это имя будут видеть ваши клиенты.

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

Если никнейм не занят, бот будет успешно создан, и Telegram выдаст такое сообщение:

В первом сообщении BotFather, которое вы получили после запуска бота, можно найти список команд для редактирования бота:

Можно нажимать на эти команды или вводить в поле сообщения и отправлять.

/setuserpic позволит вам установить аватар вашего бота. Картинку нужно будет прикрепить к ответному сообщению:

/setdescription позволит добавить боту описание, которое увидят ваши клиенты при подключении к боту:

Описание тоже нужно будет отправить ответным сообщением:

После завершения необходимых настроек подключите бот к Swarmica.

Подключение telegram-бота

Перейдите в Swarmica в раздел Настройки - Каналы и выберите Telegram. На открывшейся странице нажмите Создать:

Введите название канала, на которое вам удобно будет ориентироваться при обработке заявок и нажмите "Сохранить"

Откроется страница настроек:

Прежде всего, сюда нужно ввести токен вашего бота. Его можно найти в сообщении, которое пришло вам в ответ на успешно добавленный никнейм бота. Найдите его в чате с BotFather и нажмите на токен (сочетание букв и цифр) чтобы его скопировать:

Вставьте его в соответствующее поле настроек Swarmica.

Выберите, куда будут попадать сообщения, полученные из Telegram-бота: в заявки или в чаты:

Про отличие специфик заявок и чатов мы написали в отдельной статье.

Активируйте бегунок "Включен", чтобы активировать канал, и сохраните настройки:

Действия на сервере

После сохранения настроек бота зайдите на сервер Swarmica по SSH:

1 - Проверьте, что в /root/swarmica/docker-compose.yml контейнер telegram раскоментирован и выглядит следующим образом:

  telegram:
    <<: *django
    depends_on:
      django:
        condition: service_healthy
    command: /start-telegram
    labels:
      - "traefik.enable=false"

В предыдущих версия Свормики может быть:

  telegram:
    <<: *django
    depends_on:
      - postgres
      - redis
    command: /start-telegram
    labels:
      - "traefik.enable=false"

При необходимости контейнер раскоментируйте контейнер.

2 - Если вносились изменения в /root/swarmica/docker-compose.yml, то выполните команду, чтобы пересоздать все контейнеры:

docker compose down && docker compose up -d

Иначе выполните

docker compose restart telegram

Для облачных инсталляций или в случае возникновения трудностей обратитесь в службу поддержки Swarmica для его активации!

Обновлена: 13 окт. 2026 г.

Симптомы

Не доходят сообщения в whatsapp - не создается тикет, не добавляется ответ в тикет/чат

В логах docker logs -f swarmica-whatsapp_green-1 ошибка:

Request was failed with status code: 400. Data: Message cannot be received because custom webhook url is set. Go to cabinet, clear webhook url for instance: XXXXXXXXXX and wait for about 1 minute for another attempt

Решение

  1. Зайти в https://console.green-api.com/app/api/setSettings
  2. Сохранить пустые поля:

Причина

Интеграция рассчитана на стандартный вебхук, с кастомным вебхуком сообщения из Whatsapp не будут доходить по Swarmica

Обновлена: 14 окт. 2026 г.

Необходимые условия интеграции

  1. Зарегистрированная учетная запись Green API с тарифом "Бизнес".
  2. Прогретый номер телефона, к которому будет привязан инстанс Green API.
  3. Подписка Swarmica уровня "Про" или выше.

Подготовка нового номера

Для связи по Whatsapp через Green API нужен действующий номер телефона. Если у вас уже есть учетная запись Green API с подключенным номером телефона, то можете сразу перейти к разделу Интеграция в Swarmica

Использование личного номера / учетной записи Whatsapp не рекомендуется – все личные переписки будут переводиться в заявки, а так же высок риск перманентной блокировки номера на стороне Whatsapp.

Чтобы подготовить и использовать новый номер, можно приобрести виртуальную SIM-карту любого сотового оператора на ваш выбор и установить приложение Whatsapp Business на телефон. После активации виртуальной SIM-карты необходимо зарегистрировать учетную запись в Whatsapp Business на номер этой карты и в течение 10-14 дней периодически вести переписку с этим номером с разных учетных записей, чтобы его прогреть.

Через 10-14 дней прогрева можно переходить к настройке Green API.

Внимание! 100% защиты от блокировки номера не существует. Блокирует сам WhatsApp, и, поскольку WhatsApp не раскрывает публично механизмы блокировки, нет и точных алгоритмов пути их обхода. Однако, если следовать указаниям, описанным в этой статье, вероятность блокировки будет очень низкой.

Если ваш номер всё же заблокируют, вам пригодится статья о том, как попытаться его разблокировать. Но WhatsApp может оставить решение о блокировке в силе навсегда.



Нюанс: входящие звонки на WhatsApp не видны в Swarmica. Если кто-то позвонит вам на WhatsApp, вы это не увидите.

Настройки Green API

1. Если у вас еще нет учетной записи Green API, зарегистрируйте аккаунт: https://console.green-api.com/registration

2. Нажмите "Создать инстанс" и выберите тариф.

Можно сначала потестировать возможности интеграции на бесплатном тарифе, а потом подключить платный тариф.

Вы попадёте на страницу инстанса. Также на страницу инстанса можно попасть по ссылке https://console.green-api.com, после нажатия на открывшейся странице на ваш инстанс.

3. На странице инстанса привяжите ваш аккаунт WhatsApp к Green Api. Для этого перейдите к вкладке "Связать по QR-коду" и нажмите "Получить QR":

4. В телефоне откройте приложение WhatsApp, нажмите на меню действий справа вверху и выберите "Связанные устройства"

Нажмите "Связывание устройства" и отсканируйте QR-код.

Если всё получилось, статус инстанса должен стать "Авторизован":

Если наблюдаются проблемы с привязкой номера по QR, вы можете попробовать воспользоваться вкладкой "Связать по номеру телефона":

5. https://console.green-api.com/app/api/setSettings, включите параметр Получать уведомления о входящих сообщениях и файлах и нажмите Отправить:

Интеграция в Swarmica

Перейдите в Swarmica в раздел Настройки - Каналы, выберите "WhatsApp" и заполните предлагаемые поля. Вам понадобятся настройки на странице инстанса Green Api. Чтобы перейти на страницу инстанса, нажмите https://console.green-api.com/instanceList/ и затем на ваш инстанс.

Настройки WhatsApp в Swarmica выглядят так:

Название - произвольное название канала.

Токен - apiTokenInstance со страницы инстанса Green Api.

ID инстанса - idInstance со страницы инстанса Green Api.

URL инстанса - apiUrl со страницы инстанса Green Api.

URL медиафайлов инстанса - mediaUrl со страницы инстанса Green Api.

Вот эти четыре параметра на странице инстанса:

Справа от каждого параметра находится кнопка копирования его содержимого.

Создавать заявки или чаты - выбор режима работы канала. Подробнее о режимах работы рассказали в отдельной статье.

Активируйте бегунок "Включен", чтобы активировать канал, и сохраните настройки.

Обновлена: 16 окт. 2026 г.
Всего результатов: 37
Элементов на странице
Страница