# Коды подтверждения в WhatsApp через API: как отправлять OTP вместо SMS

> Как отправлять одноразовые коды для входа и подтверждений в WhatsApp: шаблон категории «Аутентификация», пример запроса к API, цена одного кода, статусы доставки и что проверить, если код не пришёл.

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

Страница на сайте: https://wazzabee.com/blog/kody-podtverzhdeniya-whatsapp-cherez-api

---

**Коды подтверждения в WhatsApp отправляются специальным шаблоном категории «Аутентификация»: ваш сайт или приложение передаёт код в API, и клиент получает сообщение с кодом и кнопкой его копирования. Один такой код стоит 13,56 ₸, писать клиенту первым можно в любой момент.** Ниже разбираем, как создать шаблон, как отправить код одним запросом и что делать, если код не пришёл.

Код в WhatsApp удобен клиенту: мессенджер уже открыт, сообщение приходит от вашей компании с её названием, а код копируется одним нажатием. Подходит для входа на сайт, регистрации, подтверждения заказа или смены пароля.

## Что такое шаблон аутентификации в WhatsApp?

Это отдельная категория шаблонов WhatsApp Business API только для одноразовых кодов. Свой текст в нём написать нельзя: Meta собирает сообщение сама из кода, короткой фразы о том, что это код, и кнопки копирования.

Для рассылок, напоминаний и переписки этот тип не подходит. Для них есть категории «Маркетинг» и «Уведомления и напоминания».

## Как выглядит сообщение с кодом?

Клиент видит сам код, фразу о том, что это код подтверждения, и кнопку копирования. При создании шаблона можно добавить ещё две вещи:

- предупреждение никому не сообщать код;

- подпись о сроке действия кода, от 1 до 90 минут;

- кнопка копирования есть всегда, её текст Meta задаёт по языку шаблона.

Шаблон можно завести, например, на русском, казахском или английском, у каждого языка своя версия текста.

## Сколько стоит один код подтверждения?

Код подтверждения в WhatsApp стоит 13,56 ₸ за сообщение. Это отдельный тариф Meta для категории «Аутентификация»: столько же, сколько служебное сообщение, и дешевле рекламного. Ещё нужна подписка на линию {{price.waba}} ₸ в месяц. Платите только за коды, которые дошли до клиента.

Подробнее о ценах всех категорий в статье [о тарифах WhatsApp Business API](https://wazzabee.com/blog/tarify-whatsapp-business-api-1-iyulya-2026-kazahstan).

## Как создать шаблон с кодом в WazzaBee?

Шаблон создаётся один раз в кабинете и уходит на модерацию в Meta. Порядок такой:

1. Подключите [линию официального WhatsApp](https://wazzabee.com/waba), это занимает 15 минут.

2. Откройте раздел «Шаблоны», вкладку «HSM (WABA)», выберите линию и нажмите «Создать».

3. Выберите язык и категорию «Аутентификация (коды подтверждения)».

4. Включите или выключите предупреждение о безопасности и подпись со сроком действия кода.

5. Придумайте системное имя латиницей, например kod_vhoda, и отправьте шаблон на модерацию.

Когда шаблон одобрен, его статус в списке меняется на «Одобрен», и можно отправлять коды.

## Как отправить код через API?

Код отправляется одним запросом на адрес отправки сообщений. Передайте имя шаблона и сам код в переменной «1», кнопку копирования WazzaBee добавит сама.

```
curl -X POST "https://api.wazzabee.com/api-gateway/v1/messages/send" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "channelId": "ID_ВАШЕЙ_ЛИНИИ",
    "chatId": "77001234567",
    "templateName": "kod_vhoda",
    "templateLanguage": "ru",
    "templateVariables": {"1": "482913"}
  }'
```

| Параметр | Что передать |
| --- | --- |
| channelId | ID линии WhatsApp, список линий отдаёт запрос GET /v1/channels |
| chatId | Номер клиента с кодом страны, без плюса |
| templateName | Системное имя одобренного шаблона |
| templateLanguage | Язык шаблона: ru, kk или en |
| templateVariables | Сам код в переменной «1» |

API-ключ выдаётся в кабинете: «Коннекторы» → «API» → «Подключить». Все параметры описаны в [документации API](https://docs.wazzabee.com/api/api-templates-otp).

## Как узнать, что код дошёл до клиента?

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

Так ваша система сама решает, что делать дальше: ждать ввода кода или предложить клиенту другой способ входа.

## Что делать, если код не пришёл?

Чаще всего у номера просто нет WhatsApp или номер записан с ошибкой. Такой код вернётся статусом «ошибка», и за него вы не платите. Вот что проверить:

- номер записан полностью, с кодом страны, например 77001234567;

- шаблон одобрен, а язык в запросе совпадает с языком шаблона;

- код передан в templateVariables, без него сообщение не уйдёт, а в статусе будет понятная ошибка;

- на балансе линии есть деньги на сообщения.

Если у клиента нет WhatsApp, предложите ему другой способ входа на своей стороне, например звонок или почту.

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

### Можно ли написать свой текст в сообщении с кодом?

Нет. Текст шаблона аутентификации задаёт Meta, менять можно только язык, предупреждение о безопасности и срок действия кода.

### Нужно ли ждать, пока клиент напишет первым?

Нет. Шаблон с кодом отправляется в любой момент, суточное окно переписки для него не нужно.

### Сколько стоит один код в WhatsApp?

Один код подтверждения стоит 13,56 ₸ и списывается только за доставленное сообщение.

### Можно ли отправлять коды без программиста?

Код создаёт ваш сайт или приложение, поэтому запрос к API настраивает разработчик. Это один запрос, пример выше подходит для любого языка программирования.

### На каких языках можно отправить код?

Например, на русском, казахском и английском. Для каждого языка создаётся своя версия шаблона с тем же именем.

Подключите линию официального WhatsApp за 15 минут, создайте шаблон с кодом и отправьте первый код через API. На пробу даётся 7 дней, а новым клиентам приветственный бонус {{price.welcome_bonus}} ₸ на баланс. Подробнее о работе с API на странице [WhatsApp API для бизнеса](https://wazzabee.com/whatsapp-api).

---

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