WhatsApp-тағы растау кодтары API арқылы: SMS орнына OTP қалай жіберуге болады

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_kiru, және үлгіні модерацияға жіберіңіз.

Үлгі мақұлданған соң тізімдегі мәртебесі «Мақұлданды» болып өзгереді, енді код жіберуге болады.

Кодты 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_kiru",
    "templateLanguage": "kk",
    "templateVariables": {"1": "482913"}
  }'

Параметр	Не беру керек
channelId	WhatsApp желісінің ID, желілер тізімін GET /v1/channels сұранысы береді
chatId	Клиент нөмірі ел кодымен, плюссіз
templateName	Мақұлданған үлгінің жүйелік атауы
templateLanguage	Үлгі тілі: ru, kk немесе en
templateVariables	«1» айнымалысындағы кодтың өзі

API кілтін кабинетте аласыз: «Коннекторлар» → «API» → «Қосу». Барлық параметр API құжаттамасында сипатталған.

Кодтың клиентке жеткенін қалай білуге болады?

202 жауабы код кезекке қабылданғанын және бірнеше секундта жіберілетінін білдіреді. Жеткен-жетпегені webhook арқылы келеді: messages_status оқиғасына жазылыңыз, сонда сервер «жіберілді», «жеткізілді», «оқылды» немесе себебі көрсетілген «қате» мәртебелерін алады.

Осылайша жүйеңіз әрі қарай не істеу керегін өзі шешеді: кодты күту немесе клиентке кірудің басқа жолын ұсыну.

Код келмесе не істеу керек?

Көбінесе нөмірде WhatsApp жоқ немесе нөмір қате жазылған. Мұндай код «қате» мәртебесімен қайтады, ол үшін төлемейсіз. Мынаны тексеріңіз:

• нөмір толық, ел кодымен жазылған, мысалы 77001234567;
• үлгі мақұлданған, ал сұраныстағы тіл үлгі тілімен сәйкес;
• код templateVariables ішінде берілген, онсыз хабарлама жіберілмейді, ал мәртебеде түсінікті қате көрсетіледі;
• желі балансында хабарламаларға ақша бар.

Клиентте WhatsApp болмаса, өз тарапыңыздан кірудің басқа жолын ұсыныңыз, мысалы қоңырау немесе пошта.

Ресми WhatsApp желісін 15 минутта қосыңыз, коды бар үлгі құрып, алғашқы кодты API арқылы жіберіңіз. Сынап көруге 7 күн беріледі, ал жаңа клиенттерге балансқа 500 ₸ сәлемдесу бонусы түседі. API-мен жұмыс туралы толығырақ Бизнеске арналған WhatsApp API бетінде.