IngiaAnza kipindi cha majaribio bila malipo
Meta Tech Provider

Tuma misimbo ya uthibitishaji (OTP) kwenye WhatsApp

Ili kutuma msimbo wa uthibitishaji (OTP) kwenye WhatsApp, biashara huunda template ya uthibitishaji, muundo uliowekwa wa Meta: "<code> ni msimbo wako wa uthibitishaji." pamoja na kitufe cha kunakili msimbo au kitufe cha mguso mmoja. Kisha backend yake huutuma kupitia Cloud API, msimbo ukiwekwa mara mbili, kwenye maandishi na kwenye kitufe. Misimbo inaweza kuwa na herufi hadi 15, na onyo la hiari la kuisha kwa muda linaweza kuwa kati ya dakika 1 na 90.

easyCoexistence huunganisha nambari yako ya WhatsApp Business na Cloud API ya Meta kupitia Coexistence, na kumpa backend yako kile kinachohitajika kutuma template za uthibitishaji: endpoint ya Send, access token na, kupitia AI yako, create_template na get_template_status.

15 characters

Parameta ndefu zaidi ambayo template ya uthibitishaji inakubali; URL, maudhui ya midia na emoji haviruhusiwi kwenye maudhui yake wala kwenye parameta zake.

1 to 90 minutes

Masafa ya code_expiration_minutes, ambayo huongeza mstari "Msimbo huu unaisha baada ya dakika N." kwenye ujumbe.

10 minutes

Muda wa kuishi (TTL) chaguo-msingi wa template ya uthibitishaji; unaweza kuwekwa kuanzia sekunde 30 hadi dakika 15.

131062

Hitilafu inayorudishwa template ya uthibitishaji inapotumwa kwa kitambulisho cha mtumiaji (user ID) kilichofungwa kwenye biashara badala ya nambari ya simu.

Primary device

Ujumbe wa uthibitishaji hutumwa tu kwenye kifaa kikuu cha WhatsApp cha mtumiaji; vifaa vilivyounganishwa huona kidokezo badala yake.

20 msg/s

Kasi isiyobadilika ya nambari ya Coexistence, kikomo cha mlipuko wa misimbo ya kuingia.

Template ya uthibitishaji ya WhatsApp ni nini?

Ndiyo muundo pekee unaoruhusiwa na Meta kwa nywila za matumizi moja na misimbo ya uthibitishaji: programu inayotoa misimbo kupitia WhatsApp lazima itumie mmoja, na template za huduma au za matangazo haziwezi kubeba nywila. Maandishi yamewekwa: "<code> ni msimbo wako wa uthibitishaji.", pamoja na mistari miwili ya hiari: "Kwa usalama wako, usishiriki msimbo huu." na "Msimbo huu unaisha baada ya dakika <N>." Unachochagua ni kitufe. WhatsApp huzima usambazaji wa ujumbe huu, na kwenye iOS 26 na matoleo mapya msimbo pia hutolewa kama pendekezo kwenye kibodi bila kazi yoyote upande wako.

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

Unaundaje template ya uthibitishaji?

Chagua kutoka Template Library kwenye WhatsApp Manager, au wasilisha kupitia API, jambo ambalo AI yako inaweza kufanya kwa create_template na kategoria AUTHENTICATION. Huandiki maandishi yoyote ya ujumbe: Meta huyaandika kutoka mipangilio yako, kwa lugha utakayochagua, na hugeuza kitufe cha OTP kuwa kitufe cha URL wakati wa kuundwa. Template moja kwa kila lugha. create_template ya kiunganishi haipitishi message_send_ttl_seconds, kwa hiyo muda chaguo-msingi wa kuishi wa dakika 10 unatumika isipokuwa ubadilishe kupitia API ya 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" }
    ]}
  ]
}

Backend yako inatumaje msimbo?

Ombi moja kwa endpoint ya /messages ya nambari kwa kila msimbo, pamoja na access token kutoka get_api_credentials au kadi ya "Plug in your own system" ya dashboard. Msimbo uleule huwekwa mara mbili, kwenye parameta ya mwili na kwenye parameta ya kitufe cha URL kwenye nafasi ya 0, na mpokeaji lazima awe nambari ya simu. Kabla ya kutuma, backend hutengeneza msimbo, huhifadhi hash yake pamoja na muda wa kuisha na kaunta ya majaribio, kisha baadaye hulinganisha kile mtumiaji anachoandika na hash hiyo.

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

Kwa nini msimbo unatoka kwenye backend na si kwenye automation?

Kwa sababu mfumo unaomwingiza mtumiaji lazima utengeneze msimbo, uukumbuke na uukague, na ni mfumo huo pekee unaojua wakati msimbo unahitajika. Automation hujibu ujumbe ambao wateja hutuma, na skrini ya kuingia haiandiki kamwe kwenye nambari yako. Template yenyewe pia inazikataa: kitufe cha OTP hubeba msimbo kama kigezo cha kitufe, na hatua ya "Send a template" hujaza vigezo vya mwili pekee, kwa hiyo haiwezi kutuma template ya uthibitishaji. AI yako inaweza kutuma moja kupitia send_template, ambayo hupitisha vipengele vya kitufe kwa Meta, lakini hiyo ni kwa majaribio, si kwa mtiririko wa kuingia.

Nini hufanya mtiririko wa OTP wa WhatsApp kuwa salama?

Miongozo bora ya Meta na mipaka ya muundo vinaelekeza kwenye orodha moja ya ukaguzi. Hakuna kati ya hizi inayohitaji chochote zaidi ya backend yako na Cloud API:

  • Thibitisha nambari ya WhatsApp na mtumiaji kabla ya msimbo wa kwanza, na mwambie msimbo utafika kwenye WhatsApp.
  • Weka muda wa kuishi sawa au chini ya muda wa kuisha wa msimbo, ili msimbo uliochelewa usionyeshe msimbo uliokwisha.
  • Weka kikomo cha majaribio na cha kutuma tena kwa kila nambari, na fanya msimbo uishe ukitumika mara ya kwanza.
  • Usifanye msimbo wa WhatsApp kuwa kipengele pekee cha kurejesha akaunti: nambari za simu zilizotumiwa tena bado zinaweza kufikia akaunti ya zamani ya WhatsApp.
  • Fuatilia webhook ya hali na utoe SMS au barua pepe msimbo unaposhindwa kufika.

Kinabadilika nini nambari ikiendeshwa pia kwenye programu ya WhatsApp Business?

Kutuma kunafanya kazi kama kwenye nambari yoyote ya Cloud API, hadi ujumbe 20 kwa sekunde. Meta huakisi ujumbe unaotumwa kupitia API kwenye mazungumzo ya programu, kwa hiyo kwenye nambari ya Coexistence misimbo unayotuma pia huonekana kwenye mazungumzo hayo kwenye simu ya biashara; iweke simu hiyo kwa watu unaowaamini, au tuma misimbo kutoka nambari tofauti. Miongozo bora ya Meta pia inataka kila biashara itume template za uthibitishaji kutoka nambari yake yenyewe, si nambari inayoshirikiwa kati ya biashara. Uthibitishaji ni kategoria ya template inayolipiwa, inayotozwa kwa kila ujumbe uliowasilishwa kulingana na nchi ya mpokeaji, na viwango tofauti vya uthibitishaji wa kimataifa katika baadhi ya masoko; easyCoexistence haiongezi nyongeza ya bei.

Jinsi ya kuisanidi

  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.

Makosa ya kawaida

  • Kuandika msimbo ndani ya template ya huduma kama "Msimbo wako ni {{1}}". Meta inaruhusu nywila kwenye template za uthibitishaji pekee, na hukataa template za huduma au za matangazo zinazobeba nywila.
  • Kutuma msimbo kwenye mwili wa ujumbe pekee. Kitufe cha kunakili msimbo kinahitaji thamani ile ile kama parameta yake; Meta inatarajia msimbo mara mbili kwenye ombi.
  • Kuweka TTL ya siku 30 kwenye template ya zamani ya uthibitishaji. Simu iliyozimwa kwa saa moja kisha hupokea msimbo uliokwisha; iweke sawa au chini ya muda wa kuisha wa msimbo.
  • Kuelekeza msimbo kwa user ID iliyofungwa kwenye biashara. Template za uthibitishaji hutumwa kwa nambari za simu pekee, na Meta hurudisha hitilafu 131062.
Kufanya hili ukitumia EasyCoexistence

Nambari inafuatiliwa saa 24 kwa siku, kwa hiyo kukatika kunakoweza kusimamisha misimbo ya kuingia kunakufikia kwa barua pepe. Kuanzia US$ 9 hadi US$ 0.75 kwa nambari kwa mwezi, inashuka kadri unavyoongeza nambari, ikiwa na kipindi cha majaribio bila malipo cha siku 3.

Maswali yanayoulizwa mara kwa mara

Je, OTP ya WhatsApp ni nafuu kuliko msimbo wa SMS?

Meta hutoza kila ujumbe wa uthibitishaji uliowasilishwa kwa kiwango cha nchi ya mpokeaji, pamoja na viwango maalum katika baadhi ya masoko, na bei za SMS hutofautiana kulingana na mtoa huduma na njia. Linganisha orodha ya bei ya Meta na ya mtoa huduma wako wa SMS kwa nchi zako kuu kabla ya kubadilisha.

Je, hii ni sawa na PIN ya uthibitishaji wa hatua mbili ya WhatsApp?

Hapana. Uthibitishaji wa hatua mbili ni PIN ya tarakimu sita inayolinda nambari ya WhatsApp ya biashara yenyewe. Template ya uthibitishaji hutuma msimbo kwa wateja wako ili programu au tovuti yako iweze kuthibitisha ni nani.

Je, watumiaji lazima wakubali kupokea misimbo?

Ndiyo. Sera ya Meta inahitaji ruhusa kabla biashara haijamtumia mtu ujumbe, na mwongozo wake wa OTP unapendekeza kutoa chaguo la njia, kama WhatsApp, SMS au barua pepe. Kuchagua WhatsApp kwenye skrini yako ya kuingia, karibu na nambari, ndiyo ruhusa hiyo.

Je, wakala anaweza kutuma misimbo kwa wateja kadhaa kutoka nambari moja?

Hapana. Miongozo bora ya Meta inahitaji kila biashara iwe na akaunti yake ya WhatsApp Business na nambari yake ya simu kwa template za uthibitishaji; kushiriki nambari moja kati ya biashara ni kinyume cha masharti na sera za Meta. Unganisha nambari kwa kila mteja badala yake.

Endelea kusoma

Uko tayari kuanza?

Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.

Anza kipindi cha majaribio bila malipo

Imethibitishwa kwenye