ВойтиНачать бесплатный пробный период
Meta Tech Provider

Отправка проверочных кодов (OTP) в WhatsApp

Чтобы отправить проверочный код (OTP) в WhatsApp, бизнес создаёт шаблон аутентификации в формате Meta «<code> is your verification code.» с кнопкой копирования кода или кнопкой в одно нажатие. Его бэкенд отправляет шаблон через Cloud API, подставляя код дважды: в тело сообщения и в кнопку. Коды могут содержать до 15 символов, а необязательное предупреждение о сроке действия задаётся в диапазоне от 1 до 90 минут.

easyCoexistence подключает ваш номер WhatsApp Business к Cloud API Meta через Coexistence и предоставляет вашему бэкенду всё необходимое для отправки шаблонов аутентификации: эндпоинт Send, токен доступа и через ваш AI-ассистент create_template и get_template_status.

15 characters

Наибольшая длина параметра, который принимает шаблон аутентификации. URL, медиа и эмодзи в его содержимом и параметрах не допускаются.

1 to 90 minutes

Диапазон значений code_expiration_minutes, которое добавляет в сообщение строку «This code expires in N minutes.»

10 minutes

Срок жизни (TTL) шаблона аутентификации по умолчанию; его можно задать от 30 секунд до 15 минут.

131062

Ошибка, которую возвращает Meta, если шаблон аутентификации отправляют на business-scoped user ID вместо номера телефона.

Primary device

Сообщения аутентификации доставляются только на основное устройство пользователя WhatsApp; на связанных устройствах вместо кода появляется подсказка.

20 msg/s

Фиксированная пропускная способность номера Coexistence, предел для всплеска кодов входа.

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

Это единственный формат, который Meta разрешает для одноразовых паролей и проверочных кодов: если приложение отправляет коды через WhatsApp, оно обязано использовать именно его, а служебные и маркетинговые шаблоны не могут содержать пароль. Текст фиксирован: «<code> is your verification code.», к нему можно добавить две необязательные строки: «For your security, do not share this code.» и «This code expires in <N> minutes.». Настраивается только кнопка. WhatsApp отключает пересылку таких сообщений, а в iOS 26 и новее код также предлагается как подсказка на клавиатуре без каких-либо действий с вашей стороны.

Copy codeTapping copies the code to the clipboard; the user pastes it in your app or site
One-tap autofillAndroid: the button opens your app and hands it the code; needs app changes and a handshake
Zero-tapAndroid only, no button: your app receives the code through a broadcast receiver

Как создать шаблон аутентификации?

Выберите его в Template Library в WhatsApp Manager или отправьте через API, что ваш AI-ассистент может сделать с помощью create_template и категории AUTHENTICATION. Текст тела сообщения не передаётся: Meta формирует его из ваших настроек на выбранном языке, а при создании превращает кнопку OTP в кнопку URL. Один шаблон на каждый язык. Коннектор не передаёт параметр message_send_ttl_seconds в create_template, поэтому применяется срок жизни по умолчанию 10 минут, если вы не измените его через API Meta.

create_template arguments for a copy-code template
{
  "connection_id": "<from list_numbers>",
  "name": "login_code",
  "language": "en_US",
  "category": "AUTHENTICATION",
  "components": [
    { "type": "BODY", "add_security_recommendation": true },
    { "type": "FOOTER", "code_expiration_minutes": 5 },
    { "type": "BUTTONS", "buttons": [
      { "type": "OTP", "otp_type": "COPY_CODE", "text": "Copy code" }
    ]}
  ]
}

Как ваш бэкенд отправляет код?

Один запрос к эндпоинту /messages номера на каждый код, с токеном доступа из get_api_credentials или из карточки «Plug in your own system» на панели управления. Один и тот же код передаётся дважды: в параметр тела и в параметр URL-кнопки с индексом 0, а получатель должен быть указан номером телефона. Перед отправкой бэкенд генерирует код, сохраняет его хеш со временем истечения и счётчиком попыток, а затем сравнивает то, что ввёл пользователь, с этим хешем.

Sending a login code from your backend
POST https://graph.facebook.com/<VERSION>/<PHONE_NUMBER_ID>/messages
Authorization: Bearer <ACCESS_TOKEN>

{
  "messaging_product": "whatsapp",
  "to": "5511987654321",
  "type": "template",
  "template": {
    "name": "login_code",
    "language": { "code": "en_US" },
    "components": [
      { "type": "body",
        "parameters": [{ "type": "text", "text": "482913" }] },
      { "type": "button", "sub_type": "url", "index": "0",
        "parameters": [{ "type": "text", "text": "482913" }] }
    ]
  }
}

Почему код отправляет бэкенд, а не автоматизация?

Потому что система, которая выполняет вход пользователя, должна создать код, запомнить его и проверить, и только она знает, когда код нужен. Автоматизации отвечают на сообщения, которые присылают клиенты, а экран входа никогда не пишет на ваш номер. Сам шаблон тоже исключает их: кнопка OTP передаёт код как переменную кнопки, а шаг «Send a template» заполняет только переменные тела, поэтому отправить шаблон аутентификации он не может. Ваш AI-ассистент может отправить такой шаблон через send_template, который передаёт компоненты кнопок Meta, но это для теста, а не для потока входа.

Что делает поток OTP в WhatsApp безопасным?

Рекомендации Meta и ограничения формата указывают на один и тот же перечень. Для этого не нужно ничего, кроме вашего бэкенда и Cloud API:

  • Подтвердите номер WhatsApp у пользователя до первого кода и сообщите, что код придёт в WhatsApp.
  • Задавайте срок жизни не больше срока действия кода, чтобы запоздавшая доставка не приводила к уже недействительному коду.
  • Ограничивайте число попыток и повторных отправок на номер и делайте коды недействительными после первого использования.
  • Не делайте код WhatsApp единственным фактором восстановления аккаунта: повторно выданные номера телефонов всё ещё могут получить старый аккаунт WhatsApp.
  • Следите за вебхуком статусов и предлагайте SMS или email, если код не доставлен.

Что меняется, если номер также работает в приложении WhatsApp Business?

Отправка работает так же, как на любом номере Cloud API, до 20 сообщений в секунду. Meta дублирует сообщения, отправленные через API, в чаты приложения, поэтому на номере Coexistence коды, которые вы отправляете, также видны в этих чатах на бизнес-телефоне. Держите этот телефон у людей, которым доверяете, или отправляйте коды с отдельного номера. Рекомендации Meta также требуют, чтобы каждый бизнес отправлял шаблоны аутентификации с собственного номера, а не с номера, общего для нескольких бизнесов. Аутентификация является платной категорией шаблонов: оплата взимается за каждое доставленное сообщение по стране получателя, а в некоторых странах действуют отдельные тарифы authentication-international. easyCoexistence работает без наценки.

Как настроить

  1. Connect the numberConnect your WhatsApp Business number to easyCoexistence through Meta's Coexistence flow, or use a separate number reserved for codes.
  2. Create the authentication templateAsk your AI to submit login_code with create_template, category AUTHENTICATION, a copy-code button and an expiry, then check get_template_status for APPROVED.
  3. Store the credentials on your serverCall get_api_credentials or open "Plug in your own system" in the dashboard, and put the Send endpoint and access token in your backend's secrets.
  4. Build generate, send and verifyGenerate the code, store its hash with an expiry, send the template with the code in the body and button, then check the user's entry against the hash.
  5. Handle failuresRead failed statuses from the number's webhook, then offer SMS or email and show the user which number the code went to.

Распространённые ошибки

  • Запись кода в служебный шаблон, например «Your code is {{1}}». Meta разрешает пароли только в шаблонах аутентификации и отклоняет служебные или маркетинговые шаблоны, если в них обнаружены пароли.
  • Отправка кода только в теле сообщения. Кнопке копирования нужно то же значение в качестве параметра: Meta ожидает код в запросе дважды.
  • Сохранение срока жизни 30 дней в старом шаблоне аутентификации. Телефон, который час был не в сети, получит уже недействительный код; задавайте срок не больше срока действия кода.
  • Отправка кода на business-scoped user ID. Шаблоны аутентификации отправляются только на номера телефонов, а Meta возвращает ошибку 131062.
Настройка с EasyCoexistence

Номер отслеживается круглосуточно, поэтому отключение, которое остановило бы коды входа, придёт к вам на email. От US$ 9 до US$ 0,75 за номер в месяц, с понижением по мере добавления номеров, с бесплатным пробным периодом в первые 3 дня.

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

Дешевле ли OTP в WhatsApp, чем код по SMS?

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

Это то же самое, что PIN двухшаговой проверки WhatsApp?

Нет. Двухшаговая проверка представляет собой шестизначный PIN, который защищает собственный номер WhatsApp бизнеса. Шаблон аутентификации отправляет код вашим клиентам, чтобы ваше приложение или сайт могли подтвердить, кто они.

Должны ли пользователи дать согласие на получение кодов?

Да. Политика Meta требует разрешения, прежде чем бизнес напишет человеку, а рекомендации Meta по OTP советуют предлагать выбор каналов, например WhatsApp, SMS или email. Выбор WhatsApp на экране входа, рядом с номером, является таким разрешением.

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

Нет. Рекомендации Meta требуют, чтобы у каждого бизнеса был собственный аккаунт WhatsApp Business и номер телефона для шаблонов аутентификации; совместное использование одного номера между бизнесами противоречит условиям и политике Meta. Вместо этого подключайте отдельный номер для каждого клиента.

Читайте дальше

Подтверждения заказов и отправки в WhatsApp, автоматическиАвтоматические подтверждения заказов и обновления доставки в WhatsApp: служебные шаблоны, событие магазина, ссылки для отслеживания, ответы и статусы.Защитите автоматизации WhatsApp: ключи, вебхуки и подписиЗащита автоматизаций WhatsApp: ключи ИИ зашифрованы и не показываются повторно, подпись X-EC-Signature для вебхуков и пересылки, секреты с ротацией.Создавайте шаблоны WhatsApp с помощью ИИ и исправляйте отклоненияПопросите ИИ написать, отправить и отслеживать шаблоны WhatsApp: категории, переменные, сроки проверки, причины отклонения Meta и повторную отправку.Автоматическая отправка сообщений WhatsApp из ваших системОтправляйте сообщения WhatsApp из магазина, CRM или n8n через Cloud API Meta: шаблоны, правило 24 часов, токены, ответы и ограничения.Категории шаблонов: служебные, маркетинговые и аутентификацияТри категории шаблонов: что входит в каждую, как они влияют на оплату и проверку и почему неверная категория ведёт к отказу.Имена пользователей WhatsApp и BSUID: что меняется в вебхуках Cloud APIКак имена пользователей WhatsApp меняют вебхуки Cloud API: BSUID в user_id, когда пропадают wa_id и from, ответ по recipient и изменения Coexistence.

Готовы начать?

Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.

Начать бесплатный пробный период

Проверено по состоянию на