Интеграция WA-Boom с 1С:Предприятие 8.3

Интеграция с 1С реализована через готовый модуль на встроенном языке 1С. Модуль встраивается в любую конфигурацию 1С:Предприятие 8.3 — Фитнес-клуб, Розница, УНФ, ERP, Бухгалтерия, Управление торговлей, самописная — и предоставляет функции отправки сообщений и получения статусов через сервис WA-Boom.

После встраивания вы получаете готовые функции, которые можно вызывать откуда угодно: из подписок на события, регламентных заданий, обработок и форм. Сервис автоматически выбирает канал доставки (Telegram, WhatsApp, MAX, SMS) согласно каскаду, настроенному в личном кабинете WA-Boom.

1. Войдите в личный кабинет: https://wa-boom.ru.
2. В разделе Аккаунты подключите хотя бы один канал (Telegram, WhatsApp или MAX).
3. В разделе Настройка каскада задайте порядок каналов доставки.
4. В разделе API скопируйте access_token и api_key — они понадобятся для авторизации запросов из 1С.

1. Откройте конфигурацию в Конфигураторе 1С:Предприятие.
2. В дереве конфигурации: Общие модули → ПКМ → Добавить.
3. Имя модуля: WABoom.
4. В свойствах модуля установите флаги: Сервер — Истина, Вызов сервера — Истина.
5. Откройте модуль и вставьте содержимое файла WABoom.bsl.
6. Обновите конфигурацию базы данных (F7).

Рекомендуемый способ — создать в конфигурации две константы WABoom_AccessToken и WABoom_APIKey типа Строка (длина 256) и заполнить их в режиме «1С:Предприятие». Альтернативно ключи можно сохранить в хранилище общих настроек.

Отправка сообщения:

Результат = WABoom.ОтправитьСообщение(
    "+79001234567",
    "Здравствуйте! Ваше посещение подтверждено.",
    Константы.WABoom_AccessToken.Получить(),
    Константы.WABoom_APIKey.Получить());

Если Результат.Успех Тогда
    Сообщить("Отправлено. ID: " + Результат.MessageID);
Иначе
    Сообщить("Ошибка: " + Результат.Ошибка);
КонецЕсли;

Проверка статуса доставки:

Статус = WABoom.ПолучитьСтатус(
    Результат.MessageID,
    Константы.WABoom_AccessToken.Получить(),
    Константы.WABoom_APIKey.Получить());

Сообщить(Статус.Статус + " (канал: " + Статус.Канал + ")");

Проверка подключённых каналов (диагностика):

Информация = WABoom.ПолучитьАккаунты(
    Константы.WABoom_AccessToken.Получить(),
    Константы.WABoom_APIKey.Получить());

Для Каждого Аккаунт Из Информация.Аккаунты Цикл
    Сообщить(Аккаунт.Канал + ": " + Аккаунт.Статус);
КонецЦикла;

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

Процедура ПоздравитьКлиентовСДнёмРождения() Экспорт

    Токен = Константы.WABoom_AccessToken.Получить();
    Ключ  = Константы.WABoom_APIKey.Получить();

    Запрос = Новый Запрос;
    Запрос.Текст =
        "ВЫБРАТЬ Телефон, Наименование
        |ИЗ Справочник.Клиенты
        |ГДЕ ДЕНЬ(ДатаРождения) = ДЕНЬ(&Сегодня)
        |  И МЕСЯЦ(ДатаРождения) = МЕСЯЦ(&Сегодня)";
    Запрос.УстановитьПараметр("Сегодня", ТекущаяДатаСеанса());

    Выборка = Запрос.Выполнить().Выбрать();
    Пока Выборка.Следующий() Цикл
        Текст = "С днём рождения, " + Выборка.Наименование + "!";
        WABoom.ОтправитьСообщение(Выборка.Телефон, Текст, Токен, Ключ);
    КонецЦикла;

КонецПроцедуры

ОтправитьСообщение(Телефон, Текст, AccessToken, APIKey)

Отправляет одно сообщение. Сервис автоматически выбирает канал по каскаду.

Поле результата	Описание
Успех	Булево — успешность операции
MessageID	Идентификатор сообщения для проверки статуса
НормализованныйТелефон	Номер в формате 7XXXXXXXXXX
Ошибка	Описание ошибки
Ответ	Полный ответ сервера для диагностики

Длина текста — до 1500 символов. Телефон в любом формате нормализуется автоматически.

ПолучитьСтатус(MessageID, AccessToken, APIKey)

Возвращает текущий статус доставки сообщения.

Поле результата	Описание
Успех	Булево
Статус	Отправлено / Доставлено / Прочитано / Ошибка / Неизвестно
КодСтатуса	Числовой код от сервера
Канал	Фактический канал доставки
Ошибка	Описание ошибки

ПолучитьАккаунты(AccessToken, APIKey)

Возвращает список подключённых каналов и аккаунтов из личного кабинета. Используется для диагностики — проверки, какие каналы доступны и активны.

НормализоватьТелефон(Телефон)

Утилитарная функция. Приводит номер телефона к формату 7XXXXXXXXXX. Возвращает пустую строку, если номер невалиден.

• Платформа: 1С:Предприятие 8.3.10 и выше.
• Режим: управляемое приложение.
• Серверная часть: требуется (для HTTP-вызовов).
• Конфигурации: любые — модуль не зависит от метаданных конкретной конфигурации.