Как связать 1С с WhatsApp Business API: уведомления из базы через REST API

Готового модуля 1С для WhatsApp в WazzaBee нет: 1С отправляет сообщения через открытый REST API, и на одно уведомление уходит один HTTP-запрос POST /v1/messages/send с согласованным шаблоном. Ответы клиентов и статусы доставки 1С получает вебхуком, который WazzaBee отправляет на адрес вашего сервера.

Знакомая картина: счёт выставлен в 1С, товар отгружен, а клиент об этом не знает. Менеджер копирует номер из карточки контрагента, открывает WhatsApp на своём телефоне и пишет вручную. На десятке заказов в день это терпимо. На сотне уходят часы, путаются номера, а оплата задерживается просто потому, что никто не сообщил.

Ниже: что можно отправлять из 1С, почему первое сообщение идёт только шаблоном, как выглядит запрос к API, сколько стоит одно уведомление и что сделать программисту. Коротко о самой связке рассказывает страница WhatsApp и 1С.

Что такое WhatsApp API для 1С простыми словами?

Это адрес в интернете, на который ваша база отправляет команду «отправь клиенту такое сообщение». Адрес принадлежит WazzaBee, а сообщение уходит клиенту с вашего номера официального WhatsApp Business API. Сама 1С с WhatsApp напрямую не общается: она отправляет HTTPS-запросы на API-шлюз WazzaBee.

Базовый адрес шлюза: https://api.wazzabee.com/api-gateway. Каждый запрос несёт ключ в заголовке Authorization: Bearer. Ключ выдаётся в кабинете, в разделе «Коннекторы» → «API». Как устроена проверка ключа и какие ошибки возвращает шлюз, описано в статье Авторизация в API.

Какие уведомления можно отправлять из 1С в WhatsApp?

Любые, для которых в базе есть событие, а у Meta согласован шаблон. Чаще всего автоматизируют такие сценарии:

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

Это сценарии, а не готовые настройки. Какой документ 1С запускает отправку и какой текст получает клиент, решаете вы и ваш программист. У каждого события свой шаблон.

Почему первое сообщение из 1С нужно отправлять шаблоном?

Так устроены правила Meta: бизнес может написать клиенту первым только согласованным шаблоном. Свободный текст разрешён в течение 24 часов после последнего входящего сообщения клиента. Уведомление из 1С почти всегда уходит первым, поэтому под каждое событие нужен свой шаблон.

Шаблон создаётся в кабинете WazzaBee для линии официального WhatsApp и уходит на модерацию Meta. Через API шаблоны отправляются, а создаются и правятся в кабинете. Переменные {{1}}, {{2}} подставляют имя, номер заказа, сумму или дату. Примеры текстов и категории шаблонов собраны в статье HSM-шаблоны WhatsApp в WazzaBee.

Следите за текстом: если в уведомлении появляется скидка или призыв купить, Meta может отнести шаблон к маркетинговой категории, и каждое сообщение будет стоить дороже.

Как устроен запрос из 1С к API-шлюзу WazzaBee?

Одно уведомление: один POST-запрос на https://api.wazzabee.com/api-gateway/v1/messages/send с JSON в теле. Для шаблона вместо поля text передаются templateName и переменные. Так выглядит запрос по документации Отправка WABA-шаблонов через API:

curl -X POST "https://api.wazzabee.com/api-gateway/v1/messages/send" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "channelId": "550e8400-e29b-41d4-a716-446655440000",
    "chatId": "77001234567",
    "templateName": "order_shipped",
    "templateLanguage": "ru",
    "templateVariables": {"1": "Айгерим", "2": "1234"}
  }'

Здесь order_shipped: условное имя вашего шаблона об отгрузке, {{1}} получает имя клиента, {{2}} номер заказа. Что означает каждое поле:

В самой 1С запрос собирается стандартными объектами платформы HTTPСоединение и HTTPЗапрос. Строку JSON удобно сформировать через ЗаписьJSON. Набросок для программиста:

Соединение = Новый HTTPСоединение("api.wazzabee.com", 443, , , , 30, Новый ЗащищенноеСоединениеOpenSSL);
Запрос = Новый HTTPЗапрос("/api-gateway/v1/messages/send");
Запрос.Заголовки.Вставить("Authorization", "Bearer " + КлючAPI);
Запрос.Заголовки.Вставить("Content-Type", "application/json");
Запрос.УстановитьТелоИзСтроки(ТелоJSON, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
Ответ = Соединение.ОтправитьДляОбработки(Запрос);
// Ответ.КодСостояния 202: сообщение принято в очередь

Код 202 значит, что сообщение принято в очередь, а не что оно уже доставлено. В ответе приходит queueId: сохраните его в документе 1С, по нему потом сверяется статус. Ключ API держите в защищённых настройках базы, а не в тексте модуля. Все параметры, отправка файлов и коды ошибок описаны в разделе Отправка сообщений.

Как получать ответы клиентов и статусы доставки в 1С?

Через вебхук: WazzaBee сам отправляет POST-запрос на адрес вашего сервера, когда клиент отвечает или у сообщения меняется статус. Подключить вебхук можно в кабинете, «Коннекторы» → «API» → блок «Webhook для входящих», или запросом PATCH /v1/webhooks.

Принимать вебхук в 1С можно HTTP-сервисом, опубликованным на веб-сервере. Требования шлюза: адрес только https, доступен из интернета, не локальный и не во внутренней сети. На тестовый запрос сервер должен ответить кодом 200, иначе вебхук не подключится. Каждое уведомление подписано HMAC-SHA256, проверка подписи описана в разделе Webhooks.

Если сервер не ответил за 10 секунд, WazzaBee повторит отправку, всего до 8 попыток примерно за сутки. Поэтому отвечайте 200 сразу, а обработку делайте после ответа. У повторов тот же X-Webhook-Delivery-Id, по нему легко не записать одно сообщение дважды. Ответы клиентов при этом видны и в чатах кабинета WazzaBee, так что менеджер может продолжить разговор сам.

Сколько стоит уведомление из 1С в WhatsApp?

Одно уведомление по шаблону категории Utility (заказ, счёт, отгрузка) стоит 13,60 ₸. Отдельной платы за API нет: публичный API и вебхуки входят в подписку линии официального WhatsApp за 29 900 ₸ в месяц.

Пример: 1000 уведомлений об отгрузке в месяц обойдутся примерно в 13 600 ₸ плюс подписка линии. Сообщения тарифицирует Meta по своим правилам. С 1 октября 2026 года Казахстан у Meta отдельный рынок, и ответы в 24-часовом окне тоже стали платными.

Что сделать программисту 1С по шагам?

Семь шагов от пустой базы до работающих уведомлений:

1. Подключите линию официального WhatsApp в WazzaBee. Это занимает 15 минут, порядок есть в пошаговой инструкции по подключению WABA.
2. Создайте в кабинете шаблоны под события 1С и дождитесь их одобрения Meta.
3. Получите ключ: «Коннекторы» → карточка «API» → «Подключить». Ключ показывается один раз, сразу сохраните его.
4. Узнайте channelId линии запросом GET /v1/channels и запишите его в настройки 1С.
5. Сделайте отправку: при записи нужного документа 1С собирает JSON и отправляет POST /v1/messages/send, а queueId сохраняет в документ.
6. Подключите вебхук с подписками messages_incoming и messages_status и проверяйте подпись каждого уведомления.
7. Проверьте связку: линия видна в GET /v1/channels со статусом active, тестовое сообщение доходит на ваш второй номер, ответ появляется в чате кабинета и в вебхуке.

Короткий маршрут с готовыми запросами собран в статье Быстрый старт с API. На базовую отправку уведомлений программисту 1С обычно хватает нескольких часов. Саму доработку 1С мы не выполняем: даём ключ, документацию и отвечаем на вопросы по методам API.