ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
Meta Tech Provider

Αποστολή κωδικών επαλήθευσης (OTP) στο WhatsApp

Για να στείλει κωδικό επαλήθευσης (OTP) στο WhatsApp, η επιχείρηση δημιουργεί ένα authentication template: τη σταθερή μορφή της Meta «<code> is your verification code.», με κουμπί αντιγραφής ή κουμπί ενός πατήματος. Το backend της το στέλνει μέσω του Cloud API, με τον κωδικό συμπληρωμένο δύο φορές, στο σώμα και στο κουμπί. Οι κωδικοί έχουν έως 15 χαρακτήρες, και η προαιρετική προειδοποίηση λήξης κυμαίνεται από 1 έως 90 λεπτά.

Η easyCoexistence συνδέει τον αριθμό σας WhatsApp Business με το Cloud API της Meta μέσω Coexistence, και δίνει στο backend σας ό,τι χρειάζεται για να στέλνει authentication templates: το endpoint Send, το access token και, μέσω της AI σας, το create_template και το get_template_status.

15 characters

Το μέγιστο μήκος παραμέτρου που δέχεται ένα authentication template. Στο περιεχόμενο και στις παραμέτρους του δεν επιτρέπονται URL, πολυμέσα ή emojis.

1 to 90 minutes

Το εύρος τιμών του code_expiration_minutes, που προσθέτει στο μήνυμα τη φράση «This code expires in N minutes.».

10 minutes

Ο προεπιλεγμένος χρόνος ζωής (time-to-live) ενός authentication template. Μπορεί να οριστεί από 30 δευτερόλεπτα έως 15 λεπτά.

131062

Το σφάλμα που επιστρέφεται όταν ένα authentication template στέλνεται σε ID χρήστη με εύρος επιχείρησης αντί για αριθμό τηλεφώνου.

Primary device

Τα μηνύματα ελέγχου ταυτότητας παραδίδονται μόνο στην κύρια συσκευή WhatsApp του χρήστη. Οι συνδεδεμένες συσκευές βλέπουν αντί αυτού μια προτροπή.

20 msg/s

Η σταθερή απόδοση (throughput) ενός αριθμού Coexistence, το ανώτατο όριο για ένα ξέσπασμα κωδικών σύνδεσης.

Τι είναι ένα authentication template του WhatsApp;

Η μοναδική μορφή που επιτρέπει η Meta για κωδικούς μίας χρήσης και κωδικούς επαλήθευσης: αν μια εφαρμογή προσφέρει κωδικούς μέσω WhatsApp, πρέπει να χρησιμοποιήσει αυτήν, και τα templates utility ή marketing δεν μπορούν να φέρουν κωδικό πρόσβασης. Το κείμενο είναι σταθερό, «<code> is your verification code.», με δύο προαιρετικές γραμμές, «For your security, do not share this code.» και «This code expires in <N> minutes.». Την επιλογή την κάνετε εσείς στο κουμπί. Το WhatsApp απενεργοποιεί την προώθηση αυτών των μηνυμάτων, και σε iOS 26 και νεότερα ο κωδικός προτείνεται επίσης ως πρόταση πληκτρολογίου, χωρίς καμία ενέργεια από την πλευρά σας.

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

Πώς δημιουργείτε το authentication template;

Το επιλέγετε από το Template Library στο WhatsApp Manager, ή το υποβάλλετε μέσω του API, κάτι που μπορεί να κάνει η AI σας με το create_template και την κατηγορία AUTHENTICATION. Δεν στέλνετε κείμενο σώματος: η Meta το γράφει από τις ρυθμίσεις σας, στη γλώσσα που επιλέγετε, και μετατρέπει το κουμπί OTP σε κουμπί URL κατά τη δημιουργία. Ένα template ανά γλώσσα. Το create_template του connector δεν περνά το message_send_ttl_seconds, άρα ισχύει η προεπιλεγμένη διάρκεια ζωής των 10 λεπτών, εκτός αν την αλλάξετε μέσω του 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" }
    ]}
  ]
}

Πώς στέλνει το backend σας τον κωδικό;

Ένα αίτημα στο endpoint /messages του αριθμού για κάθε κωδικό, με το access token από το get_api_credentials ή από την κάρτα «Plug in your own system» του dashboard. Ο ίδιος κωδικός στέλνεται δύο φορές, στην παράμετρο σώματος και στην παράμετρο του κουμπιού URL με δείκτη 0, και ο παραλήπτης πρέπει να είναι αριθμός τηλεφώνου. Πριν από την αποστολή, το backend δημιουργεί τον κωδικό, αποθηκεύει ένα hash του μαζί με χρόνο λήξης και μετρητή προσπαθειών, και στη συνέχεια συγκρίνει ό,τι πληκτρολογεί ο χρήστης με αυτό το hash.

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

Γιατί ο κωδικός προέρχεται από το backend και όχι από αυτοματισμό;

Επειδή το σύστημα που συνδέει τον χρήστη πρέπει να δημιουργήσει τον κωδικό, να τον θυμάται και να τον ελέγχει, και μόνο αυτό γνωρίζει πότε χρειάζεται ένας κωδικός. Οι αυτοματισμοί απαντούν σε μηνύματα που στέλνουν οι πελάτες, και μια οθόνη σύνδεσης δεν γράφει ποτέ στον αριθμό σας. Το ίδιο το template τους αποκλείει: το κουμπί OTP μεταφέρει τον κωδικό ως μεταβλητή κουμπιού, και το βήμα «Send a template» συμπληρώνει μόνο μεταβλητές σώματος, οπότε δεν μπορεί να στείλει authentication template. Η AI σας μπορεί να στείλει ένα μέσω του send_template, που περνά στοιχεία κουμπιού στη Meta, αλλά αυτό προορίζεται για δοκιμή και όχι για ροή σύνδεσης.

Τι κάνει μια ροή OTP στο WhatsApp ασφαλή;

Οι βέλτιστες πρακτικές της Meta και τα όρια του μορφοτύπου καταλήγουν στην ίδια λίστα ελέγχου. Τίποτα από αυτά δεν απαιτεί κάτι πέρα από το backend σας και το Cloud API:

  • Επιβεβαιώστε τον αριθμό WhatsApp με τον χρήστη πριν από τον πρώτο κωδικό, και πείτε ότι ο κωδικός θα έρθει στο WhatsApp.
  • Ορίστε τον χρόνο ζωής ίσο ή μικρότερο από τη λήξη του κωδικού, ώστε μια καθυστερημένη παράδοση να μη δείξει ποτέ ανενεργό κωδικό.
  • Περιορίστε τις προσπάθειες και τις επαναποστολές ανά αριθμό, και λήγετε τους κωδικούς στην πρώτη χρήση.
  • Μην κάνετε τον κωδικό WhatsApp τον μοναδικό παράγοντα για ανάκτηση λογαριασμού: οι ανακυκλωμένοι αριθμοί τηλεφώνου μπορεί ακόμη να φτάσουν σε παλιό λογαριασμό WhatsApp.
  • Παρακολουθήστε το webhook κατάστασης και προσφέρετε SMS ή email όταν ένας κωδικός αποτυγχάνει να παραδοθεί.

Τι αλλάζει όταν ο αριθμός λειτουργεί και στην εφαρμογή WhatsApp Business;

Η αποστολή λειτουργεί όπως σε κάθε αριθμό Cloud API, έως 20 μηνύματα το δευτερόλεπτο. Η Meta αντιγράφει τα μηνύματα που στέλνονται μέσω του API στις συνομιλίες της εφαρμογής, οπότε σε αριθμό Coexistence οι κωδικοί που στέλνετε εμφανίζονται και στις συνομιλίες αυτές στο επαγγελματικό τηλέφωνο. Κρατήστε αυτό το τηλέφωνο με ανθρώπους που εμπιστεύεστε, ή στείλτε κωδικούς από ξεχωριστό αριθμό. Οι βέλτιστες πρακτικές της Meta ζητούν επίσης από κάθε επιχείρηση να στέλνει authentication templates από τον δικό της αριθμό, ποτέ από αριθμό που μοιράζεται με άλλες επιχειρήσεις. Ο έλεγχος ταυτότητας είναι κατηγορία πληρωμένου template, χρεώνεται ανά παραδομένο μήνυμα ανάλογα με τη χώρα του παραλήπτη, με ξεχωριστές τιμές authentication-international σε ορισμένες αγορές. Η easyCoexistence δεν προσθέτει καμία προσαύξηση.

Πώς να το ρυθμίσετε

  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.

Συνηθισμένα λάθη

  • Γράφετε τον κωδικό σε utility template, όπως το «Your code is {{1}}». Η Meta επιτρέπει κωδικούς πρόσβασης μόνο σε authentication templates και απορρίπτει utility ή marketing templates που τους περιέχουν.
  • Στέλνετε τον κωδικό μόνο στο σώμα. Το κουμπί αντιγραφής κωδικού χρειάζεται την ίδια τιμή ως παράμετρό του, και η Meta περιμένει τον κωδικό δύο φορές στο αίτημα.
  • Διατηρείτε χρόνο ζωής 30 ημερών σε παλαιότερο authentication template. Ένα τηλέφωνο εκτός σύνδεσης για μία ώρα λαμβάνει έναν ληγμένο κωδικό. Ορίστε τον ίσο ή μικρότερο από τη λήξη του κωδικού.
  • Στέλνετε τον κωδικό σε ID χρήστη με εύρος επιχείρησης. Τα authentication templates πηγαίνουν μόνο σε αριθμούς τηλεφώνου, και η Meta επιστρέφει σφάλμα 131062.
Κάντε το με EasyCoexistence

Ο αριθμός παρακολουθείται 24/7, οπότε κάθε αποσύνδεση που θα σταματούσε τους κωδικούς σύνδεσης φτάνει σε εσάς με email. US$ 9 έως US$ 0.75 ανά αριθμό τον μήνα, με μείωση όσο προσθέτετε αριθμούς, με τις πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Είναι ο κωδικός OTP στο WhatsApp φθηνότερος από έναν κωδικό SMS;

Η Meta χρεώνει κάθε παραδομένο μήνυμα ελέγχου ταυτότητας με την τιμή της χώρας του παραλήπτη, με ειδικές τιμές σε ορισμένες αγορές. Τα SMS κοστίζουν διαφορετικά ανά πάροχο και δρομολόγηση. Για τις κύριες χώρες σας, συγκρίνετε το τιμολόγιο της Meta με εκείνο του παρόχου SMS πριν αλλάξετε.

Είναι αυτό το ίδιο με τον PIN της επαλήθευσης σε δύο βήματα του WhatsApp;

Όχι. Η επαλήθευση σε δύο βήματα είναι ο εξαψήφιος PIN που προστατεύει τον δικό του αριθμό WhatsApp της επιχείρησης. Ένα authentication template στέλνει κωδικό στους πελάτες σας, ώστε η εφαρμογή ή ο ιστότοπός σας να επιβεβαιώσει ποιος είναι.

Πρέπει οι χρήστες να συναινούν για να λαμβάνουν κωδικούς;

Ναι. Η πολιτική της Meta απαιτεί άδεια πριν μια επιχείρηση στείλει μήνυμα σε κάποιον, και η καθοδήγησή της για OTP προτείνει να προσφέρεται επιλογή καναλιών, όπως WhatsApp, SMS ή email. Η επιλογή του WhatsApp στην οθόνη σύνδεσής σας, δίπλα στον αριθμό, αποτελεί αυτή την άδεια.

Μπορεί ένα πρακτορείο να στέλνει κωδικούς για πολλούς πελάτες από έναν αριθμό;

Όχι. Οι βέλτιστες πρακτικές της Meta απαιτούν κάθε επιχείρηση να έχει δικό της WhatsApp Business Account και αριθμό τηλεφώνου για authentication templates. Ο κοινός αριθμός μεταξύ επιχειρήσεων αντιβαίνει στους όρους και την πολιτική της Meta. Συνδέστε έναν αριθμό ανά πελάτη.

Συνεχίστε την ανάγνωση

Επιβεβαιώσεις παραγγελιών και ενημερώσεις αποστολής στο WhatsApp, αυτόματαΑυτόματες επιβεβαιώσεις παραγγελιών και ενημερώσεις αποστολής στο WhatsApp με utility templates, συνδέσμους παρακολούθησης και απαντήσεις.Ασφαλίστε τους αυτοματισμούς WhatsApp: κλειδιά, webhooks και υπογραφέςΑσφαλίστε τους αυτοματισμούς WhatsApp: κρυπτογραφημένα κλειδιά AI, υπογραφή X-EC-Signature σε κάθε κλήση webhook και μυστικά που ανανεώνονται.Δημιουργήστε templates WhatsApp με το AI σας και διορθώστε τις απορρίψειςΖητήστε από ένα AI να συντάξει, να υποβάλει και να παρακολουθεί templates WhatsApp: κατηγορίες, μεταβλητές, χρόνο έγκρισης και αιτίες απόρριψης.Αποστολή μηνυμάτων WhatsApp αυτόματα από τα δικά σας συστήματαΑυτόματη αποστολή μηνυμάτων WhatsApp από το κατάστημα, το CRM ή το n8n μέσω του Cloud API της Meta: τα templates, κανόνας 24 ωρών και όρια.Κατηγορίες template: χρησιμότητα, μάρκετινγκ και επαλήθευσηΟι τρεις κατηγορίες template, οι κανόνες τους και γιατί η λάθος κατηγορία οδηγεί σε απόρριψη.Ονόματα χρήστη του WhatsApp και BSUID: τι αλλάζει στα webhooks του Cloud APIΠώς τα ονόματα χρήστη αλλάζουν τα webhooks του Cloud API: το BSUID στο user_id, πότε λείπει ο αριθμός, η απάντηση με recipient και το Coexistence.

Έτοιμοι να ξεκινήσετε;

Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.

Ξεκινήστε δωρεάν δοκιμή

Επαληθεύτηκε στις