Telegram и WhatsApp в России работают с перебоями. Пишите нам в чат на сайте: ответ придёт и в окно, и на почту. Открыть чат

  1. Главная
  2. Каталог
  3. Рассылка отчетов в 1С в мессенджеры и HTTP-endpoint
#39

Рассылка отчетов в 1С в мессенджеры и HTTP-endpoint

Отчёты по расписанию уходят не только на почту, но и в мессенджеры и во внешние системы: один раз настроили канал — и руководитель получает файл в Telegram, а ваш сервер — данные по HTTP.

Текущий релиз 39.1.0.17 от  Что нового обновлено вчера

Подробное описание

Расширение дополняет штатную подсистему «Рассылка отчетов» Управления торговлей 11. К типовым способам доставки добавляются новые:

  • мессенджер Telegram;
  • мессенджер MAX;
  • мессенджер WhatsApp;
  • чаты Битрикс24;
  • внешний HTTP-endpoint.

Расписание, получатели и формат файлов остаются прежними, а в форме рассылки появляется страница «Каналы доставки». Руководитель получает отчёт в мессенджере, а ваша система — данные по HTTP без ручной выгрузки. Один и тот же отчёт по одному расписанию доставляется всеми выбранными способами сразу, результат каждой отправки записывается в историю. Проверено на УТ 11.5.27.

Каналы доставки

Каналы хранятся в справочнике «Каналы доставки отчетов». Один канал — одно подключение: инстанс Green-api для Telegram или MAX, вебхук Битрикс24 или адрес вашего сервера.

Справочник каналов доставки отчетов
Справочник «Каналы доставки отчетов»: по одному элементу на каждое подключение; в колонках тип канала, адрес API, таймаут, число и пауза повторов, предел размера файла.

Элемент справочника открывается в форме с полями «Код» и «Наименование» вверху. Остальные поля:

ПолеЧто задаётЗначения
Код (стандартный реквизит code)Номер подключения в справочникеПрисваивается автоматически
Наименование (стандартный реквизит description)Название подключения, под которым канал выбирают в рассылкеЛюбой понятный текст, например «Telegram бот отдела продаж»
Тип каналаКуда уходят отчётыTelegram, MAX, WhatsApp, Битрикс24, HTTPEndpoint
Адрес APIКуда отправлять запросыДля Telegram, MAX и WhatsApp — адрес Green-api (по умолчанию https://api.green-api.com), для Битрикс24 — адрес входящего вебхука, для endpoint — адрес вашего приёмника
Таймаут, секСколько ждать ответа сервераЧисло секунд
Число повторов, Пауза между повторами, секКак повторять отправку при временном сбоеЧисла
Макс. размер файла, МБПредел, выше которого включаются сжатие и разбиениеЧисло мегабайт
Режим отправки (endpoint)Что уходит на приёмник«Файл» или «JSON»
Метод HTTPМетод запроса к endpointPOST или PUT
АвторизацияСпособ входа на endpointБез, Basic или Bearer; для Basic отдельно хранится логин
Логин (Basic) / idInstance Green-apiЛогин или идентификатор инстансаСтрока
Пароль (Basic)Пароль для входа на endpoint при авторизации Basic; для Bearer в поле токена вводится сам токенПоле в режиме пароля; хранится в безопасном хранилище и после записи не показывается
Токен (apiTokenInstance / токен бота)Секрет доступа: токен бота Telegram или apiTokenInstance Green-apiПоле в режиме пароля; после записи не показывается, пустое поле сохранённый токен не меняет
Проверять сертификат сервераПроверка сертификата HTTPSВыключатель
Форма элемента справочника каналов доставки
Форма канала «Telegram бот отдела продаж» с группами «Основное», «Авторизация» и «Отправка»: поля «Код» и «Наименование», тип канала, адрес API, таймаут, число и пауза повторов, предел размера файла, режим отправки и метод HTTP для endpoint, авторизация, логин (для Green-api — idInstance), поле токена (apiTokenInstance) и выключатель проверки сертификата сервера.

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

⚠️ Токен и сертификат


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

Как подключить инстанс Green-api.

  1. Зарегистрируйтесь на сайте green-api.com и создайте инстанс нужного мессенджера (WhatsApp, Telegram или MAX).
  2. В личном кабинете Green-api авторизуйте инстанс: отсканируйте QR-код или введите код из приложения мессенджера. Дождитесь статуса «authorized».
  3. Скопируйте из кабинета idInstance и apiTokenInstance.
  4. В 1С создайте элемент справочника «Каналы доставки отчетов», выберите тип WhatsApp, Telegram или MAX. Адрес API оставьте пустым (используется https://api.green-api.com) или укажите адрес, выданный кабинетом для вашего инстанса.
  5. В поле «Логин» введите idInstance, в поле токена — apiTokenInstance, запишите элемент.
  6. Нажмите «Проверить подключение»: расширение вызывает метод getStateInstance и показывает ответ. Нужен статус authorized.
  7. Для каждого получателя укажите в регистре идентификатор: для WhatsApp — номер телефона цифрами с кодом страны (например, 79161234567), суффикс @c.us расширение добавит само; для Telegram и MAX — идентификатор чата. Затем добавьте канал на страницу «Каналы доставки» рассылки.

⚠️ Инстанс должен быть на связи


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

Идентификаторы получателей.

Чтобы бот написал человеку, требуется его идентификатор в мессенджере: chat_id Telegram, ID пользователя MAX или Битрикс24. Идентификаторы хранятся в регистре сведений «Идентификаторы получателей в мессенджерах» по трём измерениям: получатель, тип канала, значение. Получатель без идентификатора не блокирует рассылку: ему в историю записывается ошибка «Не указан ID в Telegram» (или MAX, Битрикс24), остальные получают файлы.

Права доступа.

РольЧто разрешает
Использование каналов доставки отчетовВыбирать каналы в рассылках и смотреть историю доставки
Настройка каналов доставки отчетовСоздавать и менять каналы, вводить токены, проверять подключение

Роли выдаются независимо: автор рассылок выбирает каналы, а токены остаются у администратора.

Рассылка с каналами

В форме рассылки появилась страница «Каналы доставки» с таблицей каналов: в каждой строке выбираются канал, режим отправки, шаблон текста сообщения и флажок «Использовать». Над таблицей стоит кнопка «Проверить подключение»: она отправляет тестовый запрос выбранному каналу и показывает код ответа сервера. Типовые способы (почта, сетевой каталог, FTP) работают как раньше и включаются одновременно с каналами.

Форма рассылки с каналами доставки
Форма рассылки «Продажи за месяц в Telegram»: страница «Каналы доставки» с кнопкой «Проверить подключение» и таблицей каналов; у канала «Telegram бот отдела продаж» заданы режим отправки «Файл» и шаблон текста.

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

Как отправляются файлы.

КаналЧто уходитПодпись
Telegram, MAX и WhatsApp (через Green-api)Каждый файл отдельным запросом sendFileByUpload сервиса Green-api на чат получателяТолько у первого файла
Битрикс24Файл на диск чата и сообщение о нёмТекст сообщения
HTTPEndpoint, «Файл»Один запрос multipart/form-data: поле file на каждое вложение и поле metaОписание в meta
HTTPEndpoint, «JSON»Один запрос application/json: файлы отчётов в кодировке base64 в поле dataОписание в meta

Если рассылка персонализирована, каждый получатель получает собственный экземпляр отчёта с отбором по себе. Отчёты уходят в нескольких форматах сразу, например XLSX и PDF.

Лимиты размера.

У каждого мессенджера есть предел размера файла. Перед отправкой расширение действует по трём ступеням:

СитуацияЧто уходит
Файл больше лимита, ZIP помещаетсяОдин ZIP
Архив из нескольких отчётов не помещается, отдельные файлы помещаютсяПо одному файлу на отчёт
Отдельный файл не помещается даже в ZIPЗапрос не отправляется; в истории статус «ПревышенРазмер» и текст «Файл … — N МБ, лимит … МБ. Уменьшите период или формат»

HTTP-endpoint для интеграций.

В режиме «Файл» вместе с вложениями уходит поле meta в формате JSON. В нём передаются:

  • идентификатор и название рассылки;
  • идентификатор запуска;
  • время формирования;
  • получатели рассылки;
  • список отчётов с названием, форматом и именем файла;
  • признак тестового запроса;
  • имя информационной базы.

В режиме «JSON» вместо multipart-вложений файлы отчётов передаются в самом JSON: поле data содержит массив объектов с именем файла и содержимым в base64.

Каждый запрос несёт заголовок Idempotency-Key с идентификатором запуска, поэтому повторная отправка не создаёт дублей на стороне приёмника. При ответах 429 и 5xx расширение повторяет запрос столько раз, сколько указано в канале; при ответе 401 повторов нет, ошибка записывается в историю доставки, а рассылка получает состояние «С ошибками». В поставку входит готовый приёмник на Python и описание его интерфейса в формате OpenAPI: запустите приёмник, укажите его адрес в канале и проверьте настройку до подключения боевой системы.

ℹ️ Повторы и дубли


Одинаковый Idempotency-Key во всех попытках одного запуска — основа безопасных повторов. Ваш приёмник должен игнорировать запрос с уже виденным ключом.

⚠️ Конфиденциальные данные


Отчёт уходит во внешний сервис. Убедитесь, что политика вашей организации разрешает передачу таких данных в выбранный мессенджер или систему.

История доставки

Каждая попытка отправки записывается в регистр «История доставки по каналам». В записи хранятся:

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

Просматривать историю удобнее в отчёте «История доставки отчетов по каналам».

Отчет История доставки отчетов по каналам
Отчёт «История доставки отчетов по каналам» после нажатия «Сформировать»: период, рассылка, канал, получатель, номер попытки, статус, код ответа, текст ошибки и имена файлов; видны и попытка повтора, и получатель без ID.

Статусы показывают исход попытки: «Доставлено», «Ошибка», «ПовторЗапланирован» (после временного сбоя) и «ПревышенРазмер». По итогам запуска состояние рассылки становится «Выполнена» или «С ошибками», а ошибки пишутся в журнал регистрации с событием «Рассылка отчетов.Доставка в каналы».

История релизов

  1. 39.1.0.17 текущий

    Новый продукт вместо отчёта о днях рождения сотрудников: рассылка отчётов в Telegram, MAX, Битрикс24 и на HTTP-endpoint с повторами, лимитами размера файлов и историей доставки по каждому получателю.

  2. 39.1.0.16

    Новый продукт вместо отчёта о днях рождения сотрудников: рассылка отчётов в Telegram, MAX, Битрикс24 и на HTTP-endpoint с повторами, лимитами размера файлов и историей доставки по каждому получателю.

  3. 39.1.0.15

    Новый продукт вместо отчёта о днях рождения сотрудников: рассылка отчётов в Telegram, MAX, Битрикс24 и на HTTP-endpoint с повторами, лимитами размера файлов и историей доставки по каждому получателю.

  4. 39.1.0.12

    Новый продукт вместо отчёта о днях рождения сотрудников: рассылка отчётов в Telegram, MAX, Битрикс24 и на HTTP-endpoint с повторами, лимитами размера файлов и историей доставки по каждому получателю.

Комментарии

Чтобы оставить комментарий, войдите или зарегистрируйтесь.

Что вы получаете

  • Видно и без демо. Скриншоты и GIF ниже показывают работу вживую — по шагам, на реальных данных. Персональная демонстрация для такой разработки не нужна.

  • Готовое решение. Не идея и не ТЗ — рабочая разработка для текущего и предыдущих релизов конфигураций, со скриншотами и инструкцией.

  • Безопасно для конфигурации. Разработки подключаются без вмешательства в типовую конфигурацию. Снимаются за минуту, если что-то пойдет не так.

  • Полная прозрачность. Открытый код, честные отзывы, закрывающие документы.

Сколько стоит заказать такую доработку с нуля

Сравнение стоимости и сроков: разработка с нуля у стороннего программиста против готового решения
У стороннего программиста 1С Готовое решение
Стоимость 30 000–50 000 ₽ 8 000 ₽
Сроки 2 недели на ТЗ и согласование, затем ~10 часов работы 5 минут на установку
Ваше участие ~2 часа на постановку задачи, приемку и тесты Скачать файл и подключить по инструкции
Риск Результат виден только в конце работ Разработка уже написана и работает у других компаний

Расчет по рыночной ставке 3 000–5 000 ₽/час: столько стоит час стороннего программиста 1С. Итоговая экономия — от 22 000 ₽ и около двух недель ожидания.

Как установить — 5 минут

  1. Скачиваете архив сразу после оплаты — из личного кабинета или прямо с этой страницы — и распаковываете его.
  2. Открываете базу 1С и подключаете файл штатными средствами — конфигурация при этом не меняется.
Совместима с конфигурациями 1С:
RU
Управление торговлей 11 Комплексная автоматизация 2 Управление предприятием ERP
KZ
Управление торговлей 3 (KZ) Комплексная автоматизация 2 (KZ)
BY
Управление торговлей 3 (BY) Комплексная автоматизация 2 (BY)

Оцените разработку

Общий рейтинг появляется при ≥ 3 оценках. Мы не скрываем плохие — все оценки идут в общую статистику.

Покупаете разработки несколько раз в год?

Тогда выгоднее годовой абонемент: все 288 разработок каталога и обновления к ним за 50 000 ₽ в год.

Дмитрий Медведков

Дмитрий Медведков

Автор разработки · Программист, консультант, аналитик · Основатель CoderStar

Работаю с продуктами 1С с 2012 года. Партнер фирмы «1С» с 2014 года. Готовые разработки публикую с 2014.

  • 1С:Специалист по Платформе 8.3, УТ 11, БП 3.0
  • 1С:Специалист-консультант по УТ 11 и ERP 2
8 000 ₽ Счет и ЭДО для юрлиц