Инструкция по отправке СМС, WhatsApp, MAX, Telegram через 1С — CHATPUSH

Пушок держит логотип 1С, из которого вылетают сообщения в WhatsApp, Telegram, MAX и СМС

ChatPush позволяет отправлять сообщения клиентам через WhatsApp, Telegram, MAX и СМС прямо из 1С: вручную, списком или из формы документа.

Модуль работает в любой типовой конфигурации на базе БСП: УТ 11, БП 3.0, ЗУП 3, Розница, УНФ, Салон красоты и других. Он совместим с тонким и веб-клиентом, с Windows, Linux и macOS.

Что понадобится

  • Пользователь 1С с полными правами (на скриншотах это «Administrator»). У обычного пользователя раздел администрирования может быть недоступен.
  • Два файла модуля на вашем компьютере (кнопки ниже).
  • Аккаунт ChatPush. Из него вы возьмёте токен (шаг 11).

Модуль состоит из двух файлов

  • CHATPUSH_GLOBAL.epf — основная обработка. Здесь настраивается токен, запускаются массовые рассылки и открывается Мультичат.
  • CHATPUSH_DOC.epf — обработка для отправки прямо из документа. Она добавляет команду «Отправить в CHATPUSH» в меню «Ещё» (More Actions) любого документа: заказа клиента, счёта, накладной. Телефон клиента и печатная форма документа подставляются автоматически.

Оба файла ставятся по одной и той же процедуре. Токен вводится один раз в любой из них: настройки общие для обеих обработок.

Весь путь в двух словах
  1. «НСИ и администрирование» → «Печатные формы, отчёты и обработки» → «Дополнительные отчёты и обработки».
  2. «Добавить из файла...» → выбрать файл .epf → «OK» → «Записать и закрыть». То же самое для второго файла.
  3. В списке дважды кликнуть CHATPUSH → выбрать команду ChatPush → «Выполнить».
  4. Вкладка «Настройки» → вставить токен → «Обновить».
  5. Вкладка «Отправка» → получатели и текст → канал → «Отправить».
Ниже каждый шаг расписан подробно: где вы находитесь, на что нажать и что должно появиться.

1. Установка обработок в базу

Установите оба файла: CHATPUSH_GLOBAL.epf и CHATPUSH_DOC.epf. Процедура одинаковая. Пройдите шаги 1–8 для первого файла, потом повторите шаги 3–8 для второго.

Шаг 1. Откройте «Печатные формы, отчёты и обработки»

Где вы: главное окно 1С. Слева панель с разделами: «CRM и маркетинг», «Продажи», «Закупки» и другие.

  1. В левой панели нажмите «НСИ и администрирование». В некоторых конфигурациях этот раздел называется просто «Администрирование».
  2. На открывшейся странице найдите блок «Администрирование» и нажмите пункт «Печатные формы, отчёты и обработки» (на скриншоте цифра 1).

Что увидите: страницу «Печатные формы, отчёты и обработки» (следующий скриншот).

Пункт «Печатные формы, отчёты и обработки» в разделе НСИ и администрирование
Пункт «Печатные формы, отчёты и обработки» в разделе «НСИ и администрирование»

Шаг 2. Откройте список дополнительных обработок

Где вы: страница «Печатные формы, отчёты и обработки» (вкладка с таким названием открыта вверху окна).

  1. Проверьте галку «Дополнительные отчёты и обработки» слева (цифра 1). Если её нет, поставьте.
  2. Нажмите синюю ссылку «Дополнительные отчёты и обработки» справа (цифра 2).

Что увидите: наверху откроется новая вкладка «Дополнительные отчёты и обработки». Это и есть список, о котором говорится в следующих шагах. Если обработок ещё не было, список пустой.

Галка и ссылка «Дополнительные отчёты и обработки»
1 — галка должна стоять. 2 — ссылка открывает список обработок

Шаг 3. Добавьте обработку из файла

Где вы: вкладка «Дополнительные отчёты и обработки» (список из шага 2).

  1. Над таблицей нажмите кнопку «Добавить из файла...». В некоторых конфигурациях такая кнопка называется «Создать».
  2. Появится окно «Предупреждение безопасности». Нажмите в нём «Продолжить» (цифра 1).

Что увидите: на скриншоте окно после нажатия кнопки. Оно называется «Дополнительная обработка (создание)», поверх него предупреждение безопасности.

Кнопка «Продолжить» в диалоге предупреждения безопасности
Кнопка «Продолжить» в диалоге предупреждения безопасности

Шаг 4. Пропустите установку расширения

Где вы: окно «Дополнительная обработка (создание)». Поверх него может появиться диалог «Установка расширения для работы с 1С:Предприятием».

  1. Если диалог появился, нажмите «Продолжить без установки». Расширение не требуется.
  2. Если диалога нет, переходите к шагу 5.
Кнопка «Продолжить без установки»
Пропустить установку расширения: «Продолжить без установки»

Шаг 5. Выберите файл на диске

Где вы: небольшое окно «Выберите файл внешнего отчёта или обработки» с областью для перетаскивания файла.

  1. Нажмите ссылку «select from disk» (цифра 1). Откроется окно выбора файла вашей системы.
  2. Другой способ: перетащите файл .epf прямо в область окна.
Ссылка «select from disk» для выбора файла обработки
Ссылка «select from disk» для выбора файла обработки

Шаг 6. Найдите и выберите нужный файл

Где вы: системное окно выбора файла (Finder на macOS, Проводник на Windows).

  1. Откройте папку, в которую скачали файлы. Обычно это «Загрузки».
  2. Выберите файл (цифра 1). При первой установке это CHATPUSH_GLOBAL.epf. Для второй обработки выберите CHATPUSH_DOC.epf.
  3. Нажмите «Открыть» (цифра 2).
Выбор файла CHATPUSH_GLOBAL.epf в файловом диалоге
На скриншоте выделен CHATPUSH_GLOBAL.epf: его выбирают при первой установке

Шаг 7. Подтвердите выбор файла

Где вы: снова окно 1С «Выберите файл внешнего отчёта или обработки». В нём теперь написано имя файла и его размер.

  1. Нажмите «OK» (цифра 1). Файл загрузится в 1С.
Подтверждение выбора файла, кнопка OK
Подтверждение выбора файла: кнопка «OK»

Шаг 8. Запишите обработку

Где вы: окно «Дополнительная обработка (создание)». Поля «Description» и «Имя объекта» заполнились сами.

  1. Проверьте имя. Для CHATPUSH_GLOBAL.epf это CHATPUSH, для CHATPUSH_DOC.epf это CHATPUSH_DOC.
  2. Нажмите «Записать и закрыть» (цифра 1).

Что увидите: окно закроется, вы вернётесь в список «Дополнительные отчёты и обработки», в нём появится новая строка.

Сохранение обработки, кнопка «Записать и закрыть»
Сохранение обработки: кнопка «Записать и закрыть»

Шаг 8а. Повторите шаги 3–8 для второй обработки

Где вы: список «Дополнительные отчёты и обработки».

  1. Снова нажмите «Добавить из файла...» и пройдите шаги 3–8 для второго файла. Если первым был CHATPUSH_GLOBAL.epf, теперь добавьте CHATPUSH_DOC.epf, и наоборот.

Что увидите: в списке две строки: CHATPUSH (основная) и CHATPUSH_DOC.

2. Настройка токена (первый запуск)

Токен нужен один раз. С ним обработка подключается к вашему аккаунту ChatPush и отправляет сообщения от вашего имени.

Важно. Обе обработки (GLOBAL и DOC) используют общее хранилище настроек. Токен вводится один раз, в основной обработке CHATPUSH. Обработка DOC подхватит его автоматически.
Пушок с ключом: токен открывает доступ к аккаунту ChatPush

Шаг 9. Откройте обработку CHATPUSH

Где вы: список «Дополнительные отчёты и обработки». Если вкладку закрыли, откройте её снова: «НСИ и администрирование» → «Печатные формы, отчёты и обработки» → «Дополнительные отчёты и обработки».

  1. Дважды кликните по строке CHATPUSH (цифра 1). Выбирайте основную, не CHATPUSH_DOC.

Что увидите: карточку обработки с таблицей команд.

Строка CHATPUSH в списке дополнительных отчётов и обработок
Строка CHATPUSH в списке дополнительных отчётов и обработок

Шаг 10. Запустите команду ChatPush

Где вы: карточка обработки CHATPUSH. В её таблице команд есть строка «ChatPush».

  1. Выделите строку с командой ChatPush (цифра 2).
  2. Нажмите кнопку «Выполнить» (цифра 1).

Что увидите: откроется рабочая форма CHATPUSH с двумя вкладками: «Отправка» и «Настройки».

Запуск команды ChatPush кнопкой «Выполнить»
Запуск команды ChatPush кнопкой «Выполнить»

Шаг 11. Скопируйте токен из личного кабинета

Где вы: браузер, сайт chatpush.ru. Это другое окно, не 1С.

  1. Войдите в личный кабинет ChatPush.
  2. В меню слева откройте «Настройки» → «API/Доступы» (цифра 1).
  3. В блоке HTTP найдите значение BEARER TOKEN (цифра 2) и скопируйте его целиком.
Токен длинный, около 200 символов. Убедитесь, что он скопировался полностью, без пробелов в начале и в конце. Никому не показывайте токен: с ним можно отправлять сообщения от вашего имени.
Раздел API/Доступы в личном кабинете ChatPush, значение Bearer Token
1 — раздел «API/Доступы». 2 — значение Bearer Token для копирования (на скриншоте скрыто)

Шаг 12. Вставьте токен в обработку и проверьте подключение

Где вы: форма CHATPUSH в 1С (шаг 10).

  1. Откройте вкладку «Настройки» (цифра 1).
  2. Вставьте скопированный токен в поле «Токен» (цифра 2).
  3. Нажмите кнопку «Обновить» (цифра 3).

Что увидите: статус «Подключено» с зелёной галочкой, баланс аккаунта, дату окончания подписки и статусы каналов: WhatsApp, Telegram, Telegram Bot, MAX, MAX Bot.

Каналы со статусом «Не подключён» (красный крестик) пока не активированы в вашем аккаунте ChatPush. Отправка идёт только через каналы с зелёной галочкой.

Вкладка «Настройки»: поле токена и кнопка «Обновить»
1 — вкладка «Настройки». 2 — поле для токена. 3 — кнопка «Обновить»
Как открыть CHATPUSH в следующий раз. «НСИ и администрирование» → «Печатные формы, отчёты и обработки» → «Дополнительные отчёты и обработки» → двойной клик по CHATPUSH → выделить команду ChatPush → «Выполнить». Токен вводить повторно не нужно.

3. Отправка сообщений

Где вы: форма CHATPUSH. Если она закрыта, откройте её как описано выше.

Перейдите на вкладку «Отправка». Здесь вы формируете список получателей, пишете текст сообщения и запускаете рассылку.

Вкладка «Отправка», общий обзор элементов
Вкладка «Отправка»: общий обзор элементов

На скриншоте отмечены основные элементы:

  • 1 — переключение на вкладку «Отправка»;
  • 2 — кнопка «Открыть Мультичат» (переход в браузерный интерфейс переписки);
  • 3 — добавить получателя вручную (стрелки вверх и вниз меняют порядок);
  • 4 — «Подбор»: выбор получателей из справочника контрагентов;
  • 5 — «Отправить»: запустить рассылку;
  • 6 — «Обновить статусы»: актуализировать статусы отправленных сообщений;
  • 7 — выпадающий список каналов (по умолчанию «Умный каскад»).

Как отправить сообщение: по порядку

  1. Добавьте получателей: вручную кнопкой «Add» (описание ниже) или кнопкой «Подбор» из справочника (раздел 4).
  2. В поле «Сообщение» внизу формы напишите текст. Один и тот же текст уйдёт всем получателям из таблицы.
  3. Выберите канал в списке «Канал» справа от поля сообщения (раздел 5). Если не уверены, оставьте «Умный каскад».
  4. Нажмите «Отправить» (цифра 5).
  5. Через некоторое время нажмите «Обновить статусы» (цифра 6), чтобы увидеть, что с доставкой.

Ручной ввод получателей

Нажмите кнопку «Add»: в таблице появится пустая строка. Заполните две колонки: «Получатель» (имя для отображения) и «Телефон» (в формате 79XXXXXXXXX или +7 (XXX) XXX-XX-XX). Повторите для каждого получателя.

4. Подбор получателей из справочника

Где вы: вкладка «Отправка» формы CHATPUSH.

Если контакты уже есть в 1С, вводить их вручную не нужно. Нажмите кнопку «Подбор» (цифра 4 на скриншоте раздела 3): откроется окно «Подбор абонентов» со списком контрагентов и физлиц с телефонами.

Окно «Подбор абонентов» для выбора получателей из контактов 1С
Окно «Подбор абонентов»: выбор получателей из контактов 1С (имена и телефоны скрыты)
  1. Поставьте галки в столбце «Отправлять» напротив нужных получателей (цифра 3). Чтобы отметить сразу всех, используйте кнопки массового выделения (цифра 1).
  2. Нажмите «Выбрать» (цифра 2). Отмеченные получатели добавятся в таблицу отправки.

5. Выбор канала и Умный каскад

Где вы: вкладка «Отправка», внизу формы.

Перед отправкой выберите канал в выпадающем списке «Канал» справа от поля сообщения.

Выпадающий список каналов, вверху Умный каскад
Выпадающий список каналов: «Умный каскад» в верхней строке

Доступные каналы

  • Умный каскад — рекомендуется по умолчанию;
  • WhatsApp — только через WhatsApp;
  • Telegram — только через Telegram;
  • Telegram Bot — через вашего Telegram-бота;
  • MAX — только через мессенджер MAX;
  • MAX Bot — через вашего MAX-бота;
  • СМС — обычные СМС-сообщения.

Что такое Умный каскад

Умный каскад сам выбирает для каждого получателя самый выгодный из доступных каналов. Логика такая: если у клиента есть WhatsApp, сообщение уходит в WhatsApp. Если нет, пробуем Telegram. Если и там нет, отправляем СМС.

Это экономит бюджет: мессенджеры заметно дешевле СМС. Если не уверены, какой канал выбрать, оставьте Умный каскад.

Пушок показывает путь Умного каскада: WhatsApp, затем Telegram, затем СМС

Отправка и статусы

После нажатия «Отправить» обработка разошлёт сообщения, и в таблице заполнятся колонки:

  • Канал — какой канал был использован (важно для Умного каскада);
  • ID сообщения — идентификатор в системе ChatPush;
  • Статус — текущий статус доставки;
  • Ошибка — если что-то пошло не так, причина будет здесь.

Чтобы обновить статусы позже, нажмите «Обновить статусы».

6. Мультичат в браузере

Где вы: вкладка «Отправка», кнопка «Открыть Мультичат» сверху (цифра 2 на скриншоте раздела 3).

Кнопка открывает в браузере полноценный интерфейс переписки ChatPush. В Мультичате можно:

  • видеть все входящие сообщения от клиентов в одном окне;
  • отвечать на них лично, в живом диалоге;
  • работать с несколькими каналами (WhatsApp, Telegram, MAX) одновременно;
  • смотреть историю переписки по каждому клиенту.

Это удобно, когда клиент ответил на рассылку: вы сразу переходите к диалогу и продолжаете общение вручную.

7. Отправка из формы документа (CHATPUSH_DOC)

Эта возможность работает, когда установлена обработка CHATPUSH_DOC (шаг 8а). В меню «Ещё» (в англоязычном интерфейсе — «More Actions») каждого документа появляется команда «Отправить в CHATPUSH». Ручная настройка не нужна. Команда есть во всех документах: заказ клиента, счёт на оплату, реализация, накладная и других.

Пушок отправляет документ из 1С в мессенджер бумажным самолётиком

Как открыть форму отправки из документа

Где вы: любой документ в 1С. Например, откройте раздел «Продажи» → «Заказы клиентов» и дважды кликните по нужному заказу.

  1. В правом верхнем углу документа нажмите «Ещё» (цифра 1). Раскроется меню действий.
  2. Выберите в меню команду «Отправить в CHATPUSH» (цифра 2).
Меню «Ещё» документа, пункт «Отправить в CHATPUSH»
1 — кнопка «Ещё» (More Actions). 2 — пункт «Отправить в CHATPUSH» в меню

Что происходит после нажатия команды

Откроется форма CHATPUSH_DOC на вкладке «Отправить документ» (цифра 1). В ней уже подставлено:

  • 2 — сам документ (заказ клиента, из которого вы вошли);
  • 3 — телефон клиента, подтянутый из документа;
  • 4 — канал отправки (по умолчанию Умный каскад).

При необходимости смените канал и нажмите «Отправить печатную форму» (цифра 5). Обработка сформирует PDF печатной формы и отправит его клиенту в мессенджер.

Форма CHATPUSH_DOC: отправка печатной формы клиенту
Форма CHATPUSH_DOC: отправка печатной формы клиенту одним нажатием

8. Отправка печатных форм PDF-ом

Через форму CHATPUSH_DOC, вызванную из документа (раздел 7), можно отправить клиенту печатную форму документа (счёт, заказ, накладную) прямо в мессенджер PDF-файлом.

Как это работает

Обработка формирует печатную форму документа, сохраняет её в PDF и отправляет клиенту как файл. В WhatsApp, Telegram или MAX клиент получит документ, который можно открыть, распечатать или переслать.

Что можно отправлять

Всё, что есть в стандартном подменю «Печать» самого документа: печатные формы 1С для этого типа документа (счёт-фактура, ТОРГ-12, УПД) и любые дополнительные печатные формы, добавленные в конфигурацию.

Преимущества перед email

Мессенджеры доставляют документ мгновенно: клиент видит push-уведомление и открывает файл в течение минут. Письмо с тем же документом может лежать в спаме или ждать очередной проверки почты.

9. Частые вопросы

Обработка выдаёт ошибку про COM-объекты

Установлена старая версия модуля (PushSMS.epf). Обновите файл через «Обновить из файла...» в карточке обработки, выбрав новый CHATPUSH_GLOBAL.epf.

Установил CHATPUSH_DOC, а команды «Отправить в CHATPUSH» в меню документа нет

Проверьте, что публикация обработки установлена в значение «Используется» (переключатель «Публикация» в окне «Дополнительная обработка»). Ещё один вариант: в конфигурации отключено использование дополнительных обработок. Проверьте галку в разделе «Печатные формы, отчёты и обработки» (шаг 2).

Токен ввёл в CHATPUSH, а CHATPUSH_DOC говорит, что не настроен

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

Токен принят, но при отправке ошибка авторизации

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

Умный каскад отправляет только СМС, мессенджеры не используются

Нужные каналы не подключены в вашем аккаунте ChatPush. Проверьте статусы на вкладке «Настройки»: рядом с каждым каналом должна стоять зелёная галочка «Подключён».

В подборе абонентов пусто или мало контактов

Обработка подтягивает только контакты с заполненными телефонами. Проверьте, что у контрагентов заполнена контактная информация.

Поддержка: chatpush.ru → раздел «Поддержка» в личном кабинете.