Giriş yapınÜcretsiz denemeyi başlatın
Meta Tech Provider

WhatsApp üzerinden doğrulama kodları (OTP) gönderin

WhatsApp üzerinden doğrulama kodu (OTP) göndermek için işletme bir kimlik doğrulama şablonu oluşturur. Bu şablon Meta'nın sabit biçimindedir: “<code> doğrulama kodunuzdur.” Metne kopyalama veya tek dokunuşla kullanılan bir düğme eklenir ve arka ucunuz şablonu Cloud API üzerinden gönderir; kod hem metinde hem düğmede iki kez yer alır. Kodlar en fazla 15 karakter olabilir, isteğe bağlı son kullanma uyarısı ise 1 ila 90 dakika arasında çalışır.

easyCoexistence, WhatsApp Business numaranızı Coexistence aracılığıyla Meta'nın Cloud API'sine bağlar ve arka ucunuza kimlik doğrulama şablonlarını göndermek için gereken her şeyi verir: Gönderim uç noktası, erişim token'ı ve yapay zekâ asistanınız aracılığıyla create_template ile get_template_status.

15 characters

Kimlik doğrulama şablonunun kabul ettiği en uzun parametre; içeriğinde ve parametrelerinde URL, medya ve emoji kullanılamaz.

1 to 90 minutes

code_expiration_minutes değerinin aralığı; mesaja “Bu kodun süresi N dakika içinde dolar.” satırını ekler.

10 minutes

Kimlik doğrulama şablonunun varsayılan yaşam süresi (TTL); 30 saniye ile 15 dakika arasında ayarlanabilir.

131062

Kimlik doğrulama şablonu, telefon numarası yerine işletmeye özel bir kullanıcı kimliğine gönderildiğinde dönen hata.

Primary device

Kimlik doğrulama mesajları yalnızca kullanıcının birincil WhatsApp cihazına teslim edilir; bağlı cihazlar ise bunun yerine bir uyarı görür.

20 msg/s

Coexistence numarasının sabit iş hacmi; giriş kodlarının ani artışları için üst sınır.

WhatsApp kimlik doğrulama şablonu nedir?

Meta'nın tek kullanımlık şifreler ve doğrulama kodları için izin verdiği tek biçimdir: bir uygulama kodları WhatsApp ile sunuyorsa bu şablonu kullanmak zorundadır, hizmet ve pazarlama şablonları ise şifre taşıyamaz. Metin sabittir: “<code> doğrulama kodunuzdur.”, isteğe bağlı iki satırla birlikte: “Güvenliğiniz için bu kodu paylaşmayın.” ve “Bu kodun süresi <N> dakika içinde dolar.” Sizin seçtiğiniz şey düğmedir. WhatsApp bu mesajların iletilmesini devre dışı bırakır; iOS 26 ve sonrasında kod, sizin hiçbir ek çalışmanız olmadan klavyede öneri olarak da sunulur.

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

Kimlik doğrulama şablonunu nasıl oluşturursunuz?

WhatsApp Manager'daki Şablon Kitaplığı'ndan seçin ya da şablonu API üzerinden gönderin; bunu yapay zekâ asistanınız create_template aracı ve AUTHENTICATION kategorisiyle yapabilir. Gövde metni göndermezsiniz: Meta, ayarlarınızdan ve seçtiğiniz dilde metni yazar; OTP düğmesi oluşturma sırasında URL düğmesine dönüşür. Dil başına bir şablon kullanılır. Bağlayıcının create_template aracı message_send_ttl_seconds parametresini iletmez; bu nedenle Meta'nın API'si üzerinden değiştirmediğiniz sürece 10 dakikalık varsayılan yaşam süresi geçerli olur.

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

Arka ucunuz kodu nasıl gönderir?

Her kod için numaranızın /messages uç noktasına bir istek gönderilir; erişim token'ı get_api_credentials aracından ya da panelin “Plug in your own system” kartından alınır. Aynı kod iki kez, gövde parametresinde ve dizin 0'daki URL düğmesi parametresinde yer alır; alıcı bir telefon numarası olmalıdır. Göndermeden önce arka uç kodu üretir, kodun hash'ini bir son kullanma zamanı ve bir deneme sayacıyla birlikte saklar; sonrasında kullanıcının girdiğini bu hash ile karşılaştırır.

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

Kodu neden otomasyon değil de arka ucunuz gönderir?

Çünkü kullanıcıyı oturum açtıran sistem kodu üretmeli, hatırlamalı ve kontrol etmelidir; kodun ne zaman gerektiğini yalnızca bu sistem bilir. Otomasyonlar, müşterilerin gönderdiği mesajlara yanıt verir ve bir giriş ekranı numaranıza hiçbir zaman yazmaz. Şablonun kendisi de bunları dışarıda bırakır: OTP düğmesi kodu bir düğme değişkeni olarak taşır, “Şablon gönder” adımı ise yalnızca gövde değişkenlerini doldurur; bu yüzden kimlik doğrulama şablonu gönderemez. Yapay zekâ asistanınız bunu send_template ile gönderebilir; bu araç Meta'ya düğme bileşenlerini iletir, ancak bu bir test içindir, oturum açma akışı için değil.

Bir WhatsApp OTP akışını güvenli kılan nedir?

Meta'nın en iyi uygulamaları ile biçimin sınırları aynı kontrol listesine işaret eder. Bunların hiçbiri arka ucunuz ve Cloud API dışında bir şey gerektirmez:

  • İlk koddan önce WhatsApp numarasını kullanıcıyla doğrulayın ve kodun WhatsApp'a geleceğini belirtin.
  • Yaşam süresini kodun son kullanma süresine eşit ya da daha kısa ayarlayın, böylece geç ulaşan bir kod hiçbir zaman geçersiz görünmez.
  • Numara başına deneme ve yeniden gönderme sayısını sınırlayın; kodları ilk kullanımda geçersiz kılın.
  • WhatsApp kodunu hesap kurtarma için tek faktör yapmayın: yeniden tahsis edilen telefon numaraları hâlâ eski bir WhatsApp hesabına ulaşabilir.
  • Durum webhook'unu izleyin ve kod teslim edilemediğinde SMS ya da e-posta sunun.

Numara WhatsApp Business uygulamasında da çalışıyorsa ne değişir?

Gönderim, herhangi bir Cloud API numarasında olduğu gibi çalışır: saniyede en fazla 20 mesaj. Meta, API üzerinden gönderilen mesajları uygulamadaki sohbetlere yansıtır; bu nedenle bir Coexistence numarasından gönderdiğiniz kodlar işletme telefonundaki bu sohbetlerde de görünür. Bu telefonu güvendiğiniz kişilerle birlikte tutun ya da kodları ayrı bir numaradan gönderin. Meta'nın en iyi uygulamaları ayrıca her işletmenin kimlik doğrulama şablonlarını kendi numarasından göndermesini ister; işletmeler arasında paylaşılan bir numara kullanılmaz. Kimlik doğrulama, teslim edilen mesaj başına, alıcının ülkesine göre ücretlendirilen ücretli bir şablon kategorisidir; bazı pazarlarda ayrı authentication-international tarifeleri vardır. easyCoexistence ek ücret eklemez.

Nasıl kurulur

  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.

Yaygın hatalar

  • Kodu, “Kodunuz: {{1}}” gibi bir hizmet şablonunun içine yazmak. Meta şifrelere yalnızca kimlik doğrulama şablonlarında izin verir; içinde şifre bulunan hizmet veya pazarlama şablonlarını reddeder.
  • Kodu yalnızca gövdeye yazmak. Kopyalama düğmesi, parametresi olarak aynı değeri ister; Meta isteğte kodun iki kez yer almasını bekler.
  • Eski bir kimlik doğrulama şablonunda 30 günlük yaşam süresini korumak. Bir saat çevrimdışı kalan bir telefon süresi dolmuş bir kod alır; yaşam süresini kodun son kullanma süresine eşit ya da daha kısa ayarlayın.
  • Kodu işletmeye özel bir kullanıcı kimliğine göndermek. Kimlik doğrulama şablonları yalnızca telefon numaralarına gönderilir; Meta bu durumda 131062 kodlu hata döndürür.
Bunu EasyCoexistence'la yapmak

Numara 7/24 izlenir; giriş kodlarını durduracak bir bağlantı kopması e-postayla size bildirilir. Numara başına ayda US$ 9'dan US$ 0,75'e kadar, numara ekledikçe fiyat düşer. İlk 3 gün ücretsiz deneme.

Sık sorulan sorular

WhatsApp OTP, SMS koduna göre daha mı ucuz?

Meta, teslim edilen her kimlik doğrulama mesajını alıcının ülkesi için kendi tarifesiyle ücretlendirir; bazı pazarlarda özel tarifeler vardır. SMS fiyatları ise operatöre ve rotaya göre değişir. Geçiş yapmadan önce ana ülkeleriniz için Meta'nın tarife tablosunu SMS sağlayıcınızınkiyle karşılaştırın.

Bu, WhatsApp'ın iki adımlı doğrulama PIN'i ile aynı mı?

Hayır. İki adımlı doğrulama, işletmenin kendi WhatsApp numarasını koruyan altı haneli PIN'dir. Kimlik doğrulama şablonu ise uygulamanızın ya da sitenizin müşterilerinin kim olduklarını doğrulayabilmesi için onlara kod gönderir.

Kullanıcılar kod almak için onay vermek zorunda mı?

Evet. Meta'nın politikası, bir işletmenin birine mesaj göndermeden önce izin almasını şart koşar; OTP rehberi ise WhatsApp, SMS veya e-posta gibi kanallardan bir seçenek sunulmasını önerir. Giriş ekranınızda numaranın yanında WhatsApp'ı seçmek bu izindir.

Bir ajans, tek bir numaradan birkaç müşteri için kod gönderebilir mi?

Hayır. Meta'nın en iyi uygulamaları, kimlik doğrulama şablonları için her işletmenin kendi WhatsApp Business Hesabına ve telefon numarasına sahip olmasını şart koşar; bir numarayı işletmeler arasında paylaşmak Meta'nın şartlarına ve politikasına aykırıdır. Bunun yerine her müşteri için ayrı bir numara bağlayın.

Okumaya devam edin

Başlamaya hazır mısınız?

WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.

Ücretsiz denemeyi başlatın

Doğrulama tarihi