Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

Lähetä vahvistuskoodit (OTP) WhatsAppissa

Vahvistuskoodin (OTP) lähettämiseksi WhatsAppissa yritys luo todennusviestipohjan, Metan kiinteän muodon ”<code> on vahvistuskoodisi.”, jossa on koodin kopiointi- tai yhden napautuksen painike. Backend lähettää viestin Cloud API:n kautta, ja koodi täytetään kahteen kohtaan: viestin runkoon ja painikkeeseen. Koodit voivat olla enintään 15 merkkiä pitkiä, ja valinnainen vanhenemisvaroitus on 1–90 minuuttia.

easyCoexistence yhdistää WhatsApp Business -numerosi Metan Cloud API:in Coexistencen kautta ja antaa backendillesi kaiken, mitä todennusviestipohjien lähettämiseen tarvitaan: Send-päätepisteen, access tokenin ja tekoälysi kautta create_template- ja get_template_status-työkalut.

15 characters

Pisin parametri, jonka todennusviestipohja hyväksyy; URL-osoitteet, media ja emojit eivät ole sallittuja sen sisällössä tai parametreissa.

1 to 90 minutes

code_expiration_minutes-arvon vaihteluväli; se lisää viestiin rivin ”Tämä koodi vanhenee N minuutin kuluttua.”

10 minutes

Todennusviestipohjan oletuksena oleva elinaika (TTL); sen voi asettaa 30 sekunnista 15 minuuttiin.

131062

Virhe, joka palautuu, kun todennusviestipohja lähetetään yrityskohtaiseen käyttäjätunnukseen puhelinnumeron sijaan.

Primary device

Todennusviestit toimitetaan vain käyttäjän ensisijaiseen WhatsApp-laitteeseen; linkitetyt laitteet näyttävät sen sijaan kehotteen.

20 msg/s

Coexistence-numeron kiinteä läpäisykyky, joka on kirjautumiskoodien purskeen yläraja.

Mikä on WhatsAppin todennusviestipohja?

Metan ainoa sallittu muoto kertakäyttösalasanoille ja vahvistuskoodeille: jos sovellus tarjoaa koodeja WhatsAppilla, sen on käytettävä tätä, eikä utility- tai markkinointiviestipohjat saa sisältää salasanaa. Teksti on kiinteä: ”<code> on vahvistuskoodisi.”, ja siihen voi lisätä kaksi valinnaista riviä: ”Turvallisuutesi vuoksi älä jaa tätä koodia.” ja ”Tämä koodi vanhenee <N> minuutin kuluttua.” Valitset painikkeen. WhatsApp estää näiden viestien edelleenlähetyksen, ja iOS 26:sta alkaen koodi tarjotaan myös näppäimistön ehdotuksena ilman mitään toimenpiteitä sinun puoleltasi.

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

Miten todennusviestipohja luodaan?

Valitse se WhatsApp Managerin viestipohjakirjastosta tai lähetä se API:n kautta, minkä tekoälysi voi tehdä create_template-työkalulla ja kategorialla AUTHENTICATION. Runkotekstiä ei lähetetä: Meta kirjoittaa sen asetuksistasi valitsemallasi kielellä ja muuttaa OTP-painikkeen URL-painikkeeksi luonnin yhteydessä. Yksi viestipohja kullekin kielelle. Yhteyden create_template ei välitä message_send_ttl_seconds-arvoa, joten 10 minuutin oletuselinaika pätee, ellet muuta sitä Metan API:n kautta.

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

Miten backend lähettää koodin?

Yksi pyyntö kohdenumeron /messages-päätepisteeseen per koodi, käyttäen access tokenia get_api_credentials-työkalusta tai hallintapaneelin kortista ”Plug in your own system”. Sama koodi lähetetään kahdesti: runko-parametriin ja URL-painikkeen parametriin indeksillä 0, ja vastaanottajan on oltava puhelinnumero. Ennen lähettämistä backend luo koodin, tallentaa sen tiivisteen vanhenemisajalla ja yrityskertojen laskurilla, ja myöhemmin vertaa käyttäjän kirjoittamaa koodia tähän tiivisteeseen.

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

Miksi koodi tulee backendistä eikä automaatiosta?

Koska järjestelmän, joka kirjaa käyttäjän sisään, on luotava koodi, muistettava se ja tarkistettava se, ja vain tuo järjestelmä tietää, milloin koodia tarvitaan. Automaatiot vastaavat asiakkaiden lähettämiin viesteihin, eikä kirjautumisnäkymä koskaan kirjoita numerollesi. Viestipohja itsessään sulkee ne pois: OTP-painike kantaa koodin painikemuuttujana, ja viestipohjan lähetysvaihe täyttää vain runkomuuttujat, joten se ei voi lähettää todennusviestipohjaa. Tekoälysi voi lähettää sellaisen send_template-työkalulla, joka välittää painikekomponentit Metalle, mutta se on tarkoitettu testiin, ei kirjautumisvirtaan.

Mikä tekee WhatsApp OTP -virrasta turvallisen?

Metan parhaat käytännöt ja muodon rajoitukset viittaavat samaan tarkistuslistaan. Mikään siitä ei vaadi muuta kuin backendisi ja Cloud API:n:

  • Vahvista WhatsApp-numero käyttäjän kanssa ennen ensimmäistä koodia ja kerro, että koodi tulee WhatsAppiin.
  • Aseta elinaika koodin vanhenemisajan tasolle tai sen alle, jotta myöhässä perille tullut koodi ei ole jo vanhentunut.
  • Rajoita yrityskertoja ja uudelleenlähetyksiä per numero, ja vanhenna koodit ensimmäisellä käytöllä.
  • Älä tee WhatsApp-koodia ainoaksi tekijäksi tilin palautuksessa: kierrätetyt puhelinnumerot voivat yhä tavoittaa vanhan WhatsApp-tilin.
  • Seuraa tilan webhookia ja tarjoa SMS tai sähköposti, kun koodin toimitus epäonnistuu.

Mitä muuttuu, kun numero toimii myös WhatsApp Business -sovelluksessa?

Lähetys toimii kuten missä tahansa Cloud API -numerossa, enintään 20 viestiä sekunnissa. Meta peilaa API:n kautta lähetetyt viestit sovelluksen chateihin, joten Coexistence-numerolla lähettämäsi koodit näkyvät myös niissä chateissa yrityspuhelimella. Pidä se puhelin luotettavien ihmisten hallussa tai lähetä koodit erillisestä numerosta. Metan parhaat käytännöt edellyttävät myös, että jokainen yritys lähettää todennusviestipohjat omasta numerostaan, ei koskaan yritysten välillä jaetusta. Todennus on maksullinen viestipohjakategoria, jota veloitetaan toimitettua viestiä kohden vastaanottajan maan mukaan, joissakin markkinoissa erillisin kansainvälisin todennushinnoin. easyCoexistence ei lisää hintaan lisämaksua.

Näin otat sen käyttöön

  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.

Yleiset virheet

  • Koodin kirjoittaminen utility-viestipohjaan kuten ”Koodisi on {{1}}”. Meta sallii salasanat vain todennusviestipohjissa ja hylkää utility- tai markkinointiviestipohjat, joissa se havaitsee niitä.
  • Koodin lähettäminen vain runkoon. Kopiointipainikkeen on saatava sama arvo parametrinaan; Meta odottaa koodin kahdesti pyynnössä.
  • Vanhan todennusviestipohjan 30 päivän elinajan säilyttäminen. Tunnin offline-tilassa ollut puhelin saa vanhentuneen koodin; aseta se koodin vanhenemisajan tasolle tai sen alle.
  • Koodin osoittaminen yrityskohtaiseen käyttäjätunnukseen. Todennusviestipohjat menevät vain puhelinnumeroihin, ja Meta palauttaa virheen 131062.
Näin teet tämän EasyCoexistencen avulla

Numeroa valvotaan 24/7, joten katkos, joka pysäyttäisi kirjautumiskoodit, ilmoitetaan sinulle sähköpostitse. US$ 9:stä US$ 0,75:een numeroa kohden kuukaudessa, hinta laskee lisättäessä numeroita. Ensimmäiset 3 päivää ilmaista kokeilua.

Usein kysytyt kysymykset

Onko WhatsApp OTP halvempi kuin SMS-koodi?

Hinta määräytyy maan mukaan: Meta veloittaa jokaisesta toimitetusta todennusviestistä vastaanottajan maan hinnan, joissakin markkinoissa erikoishinnoin, ja SMS-hinnat vaihtelevat operaattorin ja reitin mukaan. Vertaa Metan hintataulukkoa SMS-palveluntarjoajasi hintoihin tärkeimmissä maissasi ennen vaihtoa.

Onko tämä sama kuin WhatsAppin kaksivaiheinen vahvistus -PIN?

Ei. Kaksivaiheinen vahvistus on kuusinumeroinen PIN-koodi, joka suojaa yrityksen oman WhatsApp-numeron. Todennusviestipohja lähettää koodin asiakkaillesi, jotta sovelluksesi tai sivustosi voi varmistaa, kuka he ovat.

Pitääkö käyttäjien suostua koodien vastaanottamiseen?

Kyllä. Metan käytännön mukaan lupa tarvitaan ennen kuin yritys lähettää viestejä jollekulle, ja sen OTP-ohjeet suosittelevat tarjoamaan valinnan kanavista, kuten WhatsApp, SMS tai sähköposti. Kirjautumisnäkymässäsi numeron vieressä oleva WhatsApp-valinta on tuo lupa.

Voiko toimisto lähettää koodeja useille asiakkaille yhdestä numerosta?

Ei. Metan parhaat käytännöt edellyttävät, että jokaisella yrityksellä on oma WhatsApp Business -tili ja puhelinnumero todennusviestipohjia varten; numeron jakaminen yritysten välillä on Metan ehtojen ja käytäntöjen vastaista. Yhdistä siis numero jokaista asiakasta kohden.

Lue lisää

Valmis aloittamaan?

Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.

Aloita ilmainen kokeilu

Vahvistettu