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

> Готового модуля 1С для WhatsApp нет: 1С отправляет шаблон одним HTTP-запросом к открытому REST API WazzaBee, а ответы клиентов получает вебхуком. Разбираем запрос, цены и шаги для программиста.

Опубликовано: 2026-10-07

Страница на сайте: https://wazzabee.com/blog/integratsiya-whatsapp-s-1s

---

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

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

Ниже: что можно отправлять из 1С, почему первое сообщение идёт только шаблоном, как выглядит запрос к API, сколько стоит одно уведомление и что сделать программисту. Коротко о самой связке рассказывает страница [WhatsApp и 1С](https://wazzabee.com/whatsapp-1c).

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

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

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

|  | Ручная отправка | Уведомления из 1С через API |
| --- | --- | --- |
| Кто отправляет | Менеджер вручную | База сама, по событию в документе |
| С какого номера | Часто с личного телефона сотрудника | С официального номера компании |
| Когда уходит сообщение | Когда у менеджера появится время | В момент события, который выбрал программист |
| Где видны ответы клиента | В телефоне сотрудника | В чатах кабинета WazzaBee и в вебхуке на ваш сервер |
| Откуда берутся номер и сумма | Копируются руками | Подставляются из документа 1С |

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

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

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

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

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

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

| Ситуация | Что можно отправить из 1С | Поля в запросе |
| --- | --- | --- |
| Клиент написал вам за последние 24 часа | Обычный текст или файл | text или mediaUrl |
| Клиент не писал больше 24 часов или не писал никогда | Только согласованный шаблон | templateName и templateVariables |
| Клиент ответил на шаблон | Открывается новое 24-часовое окно, можно писать текстом | text |

Шаблон создаётся в кабинете WazzaBee для линии официального WhatsApp и уходит на модерацию Meta. Через API шаблоны отправляются, а создаются и правятся в кабинете. Переменные {{1}}, {{2}} подставляют имя, номер заказа, сумму или дату. Примеры текстов и категории шаблонов собраны в статье [HSM-шаблоны WhatsApp в WazzaBee](https://wazzabee.com/blog/hsm-templates-chat-scenarios).

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

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

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

```
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С |
| --- | --- | --- |
| channelId | ID линии официального WhatsApp | Один раз из GET /v1/channels, хранить в настройках базы |
| chatId | Номер клиента с кодом страны, без «+» | Из карточки контрагента, например 77001234567 |
| templateName | Системное имя согласованного шаблона | Из кабинета, у каждого события своё |
| templateLanguage | Код языка шаблона, по умолчанию ru | Обычно константа |
| templateVariables | Значения для {{1}}, {{2}} и дальше | Номер, сумма, дата из документа |
| templateHeader | Картинка, видео или документ в шапке, если шаблон её содержит | Ссылка на файл, например PDF счёта |

В самой 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 держите в защищённых настройках базы, а не в тексте модуля. Все параметры, отправка файлов и коды ошибок описаны в разделе [Отправка сообщений](https://docs.wazzabee.com/api/api-send-message).

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

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

| Подписка | Что приходит в 1С |
| --- | --- |
| messages_incoming | Входящие сообщения клиентов |
| messages_status | Статусы исходящих: sent, delivered, read, failed с кодом причины, связка по queueId |
| messages_button | Нажатия кнопок шаблона и указание, на какое сообщение ответил клиент |

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

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

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

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

| Что | Цена |
| --- | --- |
| Подписка линии официального WhatsApp | 29 900 ₸ в месяц |
| Подключение линии | 0 ₸ |
| Публичный API и вебхуки | Входят в подписку |
| Уведомление по шаблону Utility | 13,60 ₸ за сообщение |
| Рекламный шаблон Marketing | 40,97 ₸ за сообщение |
| Ответ в открытом 24-часовом окне | Первые 1000 в месяц на номер по минимальной цене, дальше 13,60 ₸ |
| Входящее сообщение | 0,99 ₸ |

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

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

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

1. Подключите линию официального WhatsApp в WazzaBee. Это занимает 15 минут, порядок есть в [пошаговой инструкции по подключению WABA](https://wazzabee.com/blog/kak-podklyuchit-ofitsialnyy-whatsapp-waba-poshagovaya-instruktsiya).
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](https://docs.wazzabee.com/docs/quick-start-api). На базовую отправку уведомлений программисту 1С обычно хватает нескольких часов. Саму доработку 1С мы не выполняем: даём ключ, документацию и отвечаем на вопросы по методам API.

## Часто задаваемые вопросы

### Есть ли готовый модуль 1С WhatsApp API?

Готового модуля нет. 1С подключается к открытому REST API WazzaBee. Связку пишет ваш программист 1С.

### Как работает WhatsApp API 1C?

1С отправляет POST-запрос на шлюз WazzaBee. Сообщение уходит клиенту с вашего официального номера. Ответы и статусы приходят обратно вебхуком.

### Можно ли сделать рассылку из 1С в WhatsApp?

Да, по согласованному шаблону. Один запрос отправляет одно сообщение, поэтому 1С проходит по списку клиентов. Рекламные шаблоны стоят дороже уведомлений.

### Что такое API-шлюз для WhatsApp?

Это сервер между вашей системой и WhatsApp. У WazzaBee его адрес api.wazzabee.com/api-gateway. Каждый запрос подписывается ключом API.

### Что такое chat API WhatsApp и чем он опасен?

Так называют программный доступ к отправке сообщений в WhatsApp. Надёжен только официальный WhatsApp Business API. Неофициальные способы подключения рискованны: Meta блокирует такие номера, и вместе с номером уходит база.

### Какие версии 1С подходят?

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

### Сколько стоит API для 1С?

Отдельной платы за API нет. Он входит в подписку линии за 29 900 ₸ в месяц. Каждое уведомление по шаблону стоит 13,60 ₸.

### Можно ли получать ответы клиентов в 1С?

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

---

WazzaBee — мессенджеры и CRM в одном окне: https://wazzabee.com