Zaloguj sięRozpocznij bezpłatny okres próbny
Meta Tech Provider

Wysyłanie kodów weryfikacyjnych (OTP) przez WhatsApp

Aby wysłać kod weryfikacyjny (OTP) przez WhatsApp, firma tworzy szablon uwierzytelniania, czyli stały format Meta „<kod> to Twój kod weryfikacyjny.” z przyciskiem kopiowania kodu lub przyciskiem jednym dotknięciem. Jej backend wysyła go przez Cloud API, wstawiając kod dwukrotnie: w treści i w przycisku. Kody mogą mieć do 15 znaków, a opcjonalne ostrzeżenie o wygaśnięciu działa w przedziale od 1 do 90 minut.

easyCoexistence łączy Twój numer WhatsApp Business z Cloud API Meta przez Coexistence i daje backendowi wszystko, czego potrzeba do wysyłania szablonów uwierzytelniania: endpoint Send, token dostępu oraz, przez asystenta AI, create_template i get_template_status.

15 characters

Najdłuższy parametr, jaki akceptuje szablon uwierzytelniania; w jego treści ani parametrach nie są dozwolone adresy URL, multimedia ani emoji.

1 to 90 minutes

Zakres code_expiration_minutes, który dodaje do wiadomości linijkę „Ten kod wygasa za N minut.”

10 minutes

Domyślny czas życia szablonu uwierzytelniania; można go ustawić od 30 sekund do 15 minut.

131062

Błąd zwracany, gdy szablon uwierzytelniania zostanie wysłany do identyfikatora użytkownika przypisanego do firmy zamiast do numeru telefonu.

Primary device

Wiadomości uwierzytelniające są dostarczane wyłącznie na główne urządzenie WhatsApp użytkownika; połączone urządzenia zamiast tego widzą monit.

20 msg/s

Stała przepustowość numeru w trybie Coexistence, czyli górny limit dla serii kodów logowania.

Czym jest szablon uwierzytelniania WhatsApp?

Jedyny dozwolony przez Meta format jednorazowych haseł i kodów weryfikacyjnych: jeśli aplikacja wysyła kody przez WhatsApp, musi używać właśnie jego; szablony usługowe i marketingowe nie mogą zawierać kodu. Tekst jest stały: „<kod> to Twój kod weryfikacyjny.”, z dwiema opcjonalnymi linijkami: „Dla Twojego bezpieczeństwa nie udostępniaj tego kodu.” oraz „Ten kod wygasa za <N> minut.”. Wybierasz przycisk. WhatsApp wyłącza przekazywanie tych wiadomości, a na iOS 26 i nowszych kod jest też podpowiadany na klawiaturze bez żadnej pracy po Twojej stronie.

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

Jak utworzyć szablon uwierzytelniania?

Wybierz go z biblioteki szablonów w WhatsApp Manager albo prześlij przez API, co Twój asystent AI może zrobić poleceniem create_template z kategorią AUTHENTICATION. Nie wysyłasz treści: Meta ją układa z Twoich ustawień, w wybranym języku, a przycisk OTP zamienia na przycisk z adresem URL przy tworzeniu. Jeden szablon na każdy język. Funkcja create_template konektora nie przekazuje message_send_ttl_seconds, więc obowiązuje domyślny czas życia wynoszący 10 minut, chyba że zmienisz go przez 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" }
    ]}
  ]
}

Jak Twój backend wysyła kod?

Jedno żądanie do endpointu /messages numeru na każdy kod, z tokenem dostępu z get_api_credentials albo z karty „Podłącz własny system” w panelu. Ten sam kod trafia dwukrotnie: w parametrze treści i w parametrze przycisku z adresem URL o indeksie 0, a odbiorca musi być numerem telefonu. Przed wysłaniem backend generuje kod, zapisuje jego hash z czasem wygaśnięcia i licznikiem prób, a potem porównuje to, co wpisze użytkownik, z tym hashem.

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" }] }
    ]
  }
}

Dlaczego kod pochodzi z backendu, a nie z automatyzacji?

Ponieważ system, który loguje użytkownika, musi wygenerować kod, zapamiętać go i sprawdzić, a tylko on wie, kiedy kod jest potrzebny. Automatyzacje odpowiadają na wiadomości wysłane przez klientów, a ekran logowania nigdy nie pisze do Twojego numeru. Sam szablon też je wyklucza: przycisk OTP przenosi kod jako zmienną przycisku, a krok Wyślij szablon wypełnia wyłącznie zmienne treści, więc nie może wysłać szablonu uwierzytelniania. Twój asystent AI może go wysłać przez send_template, która przekazuje komponenty przycisków do Meta, ale to służy do testu, a nie do przepływu logowania.

Co czyni przepływ OTP w WhatsApp bezpiecznym?

Dobre praktyki Meta i ograniczenia formatu wskazują tę samą listę kontrolną. Żadna jej pozycja nie wymaga niczego poza backendem i Cloud API:

  • Potwierdź numer WhatsApp z użytkownikiem przed pierwszym kodem i powiedz, że kod przyjdzie przez WhatsApp.
  • Ustaw czas życia na równy lub krótszy niż czas wygaśnięcia kodu, aby spóźnione dostarczenie nigdy nie pokazało nieaktualnego kodu.
  • Ogranicz liczbę prób i ponownych wysyłek na numer, a kody wygaszaj po pierwszym użyciu.
  • Nie czyń kodu WhatsApp jedynym czynnikiem odzyskiwania konta: przydzielone ponownie numery telefonów mogą nadal docierać do starego konta WhatsApp.
  • Obserwuj webhook statusu i w razie niedostarczenia kodu zaproponuj SMS lub e-mail.

Co się zmienia, gdy numer działa także w aplikacji WhatsApp Business?

Wysyłka działa tak samo jak na każdym numerze Cloud API, do 20 wiadomości na sekundę. Meta odzwierciedla wiadomości wysłane przez API w czatach aplikacji, więc na numerze w trybie Coexistence wysłane przez Ciebie kody widać także w tych czatach na telefonie firmowym. Trzymaj ten telefon wyłącznie z zaufanymi osobami albo wysyłaj kody z osobnego numeru. Dobre praktyki Meta wymagają też, by każda firma wysyłała szablony uwierzytelniania z własnego numeru, nigdy z numeru współdzielonego między firmami. Uwierzytelnianie to płatna kategoria szablonów, rozliczana za każdą dostarczoną wiadomość według kraju odbiorcy, z osobnymi stawkami uwierzytelnienia międzynarodowego w niektórych rynkach; easyCoexistence nie dolicza do tego żadnej marży.

Jak to skonfigurować

  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.

Typowe błędy

  • Wpisywanie kodu do szablonu usługowego, np. „Twój kod to {{1}}”. Meta dopuszcza kody wyłącznie w szablonach uwierzytelniania i odrzuca szablony usługowe lub marketingowe, w których je wykryje.
  • Wysyłanie kodu tylko w treści. Przycisk kopiowania kodu potrzebuje tej samej wartości jako parametru; Meta oczekuje kodu w żądaniu dwukrotnie.
  • Zachowanie 30-dniowego czasu życia w starszym szablonie uwierzytelniania. Telefon offline przez godzinę odbiera wtedy wygasły kod; ustaw czas równy lub krótszy niż wygaśnięcie kodu.
  • Adresowanie kodu do identyfikatora użytkownika przypisanego do firmy. Szablony uwierzytelniania trafiają wyłącznie na numery telefonów, a Meta zwraca błąd 131062.
Z EasyCoexistence zrobisz to

Numer jest monitorowany całą dobę, więc rozłączenie, które zatrzymałoby kody logowania, dociera do Ciebie e-mailem. Od US$ 9 za połączony numer miesięcznie, spadając do US$ 0,75 w miarę dodawania numerów, z bezpłatnym okresem próbnym wynoszącym 3 dni.

Najczęściej zadawane pytania

Czy kod OTP w WhatsApp jest tańszy niż kod SMS?

Meta nalicza każdą dostarczoną wiadomość uwierzytelniającą według stawki dla kraju odbiorcy, z osobnymi stawkami w niektórych rynkach, a ceny SMS różnią się u operatorów i w trasach. Przed przełączeniem porównaj cennik Meta z cennikiem Twojego dostawcy SMS dla głównych krajów.

Czy to jest to samo co PIN weryfikacji dwuetapowej w WhatsApp?

Nie. Weryfikacja dwuetapowa to sześciocyfrowy PIN chroniący własny numer WhatsApp firmy. Szablon uwierzytelniania wysyła kod do Twoich klientów, aby Twoja aplikacja lub strona mogła potwierdzić, kim są.

Czy użytkownicy muszą wyrazić zgodę, by otrzymywać kody?

Tak. Zasady Meta wymagają zgody, zanim firma wyśle komuś wiadomość, a wytyczne OTP sugerują oferowanie wyboru kanałów, np. WhatsApp, SMS lub e-mail. Wybór WhatsApp na ekranie logowania, obok numeru, jest tą zgodą.

Czy agencja może wysyłać kody dla kilku klientów z jednego numeru?

Nie. Dobre praktyki Meta wymagają, by każda firma miała własne konto WhatsApp Business i własny numer telefonu do szablonów uwierzytelniania; współdzielenie jednego numeru między firmami narusza warunki i zasady Meta. Zamiast tego podłącz numer dla każdego klienta.

Czytaj dalej

Gotowy, aby zacząć?

Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.

Rozpocznij bezpłatny okres próbny

Zweryfikowano w