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

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

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

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

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

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

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

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

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

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

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

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

Подробнее о ценах всех категорий в статье о тарифах WhatsApp Business API.

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

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

1. Подключите линию официального WhatsApp, это занимает 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.

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

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

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

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

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

• номер записан полностью, с кодом страны, например 77001234567;
• шаблон одобрен, а язык в запросе совпадает с языком шаблона;
• код передан в templateVariables, без него сообщение не уйдёт, а в статусе будет понятная ошибка;
• на балансе линии есть деньги на сообщения.

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

Подключите линию официального WhatsApp за 15 минут, создайте шаблон с кодом и отправьте первый код через API. На пробу даётся 7 дней, а новым клиентам приветственный бонус 500 ₸ на баланс. Подробнее о работе с API на странице WhatsApp API для бизнеса.