התחברותהתחילו תקופת ניסיון
Meta Tech Provider

שליחת קודי אימות (OTP) ב-WhatsApp

כדי לשלוח קוד אימות (OTP) ב-WhatsApp, העסק יוצר תבנית אימות, הפורמט הקבוע של Meta: "<code> is your verification code." עם כפתור העתקה או כפתור לחיצה אחת. השרת שלכם שולח אותה דרך Cloud API, והקוד מולא פעמיים, בגוף ההודעה ובכפתור. הקודים יכולים להכיל עד 15 תווים, ואזהרת התוקף האופציונלית פועלת בין דקה ל-90 דקות.

easyCoexistence מחברת את מספר ה-WhatsApp Business שלכם ל-Cloud API של Meta דרך Coexistence, ונותנת לשרת שלכם את מה שצריך כדי לשלוח תבניות אימות: נקודת הקצה לשליחה, אסימון הגישה, ודרך ה-AI שלכם את create_template ואת get_template_status.

15 characters

האורך המקסימלי של פרמטר שתבנית אימות מקבלת. קישורים, מדיה ואמוג'י אסורים בתוכן שלה ובפרמטרים שלה.

1 to 90 minutes

הטווח של code_expiration_minutes, שמוסיף להודעה את השורה "This code expires in N minutes."

10 minutes

ברירת המחדל של זמן החיים (TTL) של תבנית אימות. אפשר להגדיר אותו מ-30 שניות עד 15 דקות.

131062

השגיאה שמוחזרת כשתבנית אימות נשלחת למזהה משתמש ברמת העסק במקום למספר טלפון.

Primary device

הודעות אימות נמסרות רק למכשיר ה-WhatsApp הראשי של המשתמש. מכשירים מקושרים רואים במקום זאת הנחיה.

20 msg/s

התפוקה הקבועה של מספר Coexistence, התקרה לפרץ של קודי כניסה.

מהי תבנית אימות ב-WhatsApp?

זהו הפורמט היחיד ש-Meta מאשרת לסיסמאות חד-פעמיות וקודי אימות. אם אפליקציה מציעה קודים דרך WhatsApp, עליה להשתמש בתבנית כזו, ותבניות שירות או שיווק אינן יכולות לשאת סיסמה. הטקסט קבוע: "<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

איך יוצרים את תבנית האימות?

בוחרים אותה מספריית התבניות (Template Library) ב-WhatsApp Manager, או שולחים אותה דרך ה-API, מה ש-AI שלכם יכול לעשות עם create_template והקטגוריה AUTHENTICATION. לא שולחים טקסט גוף. Meta כותבת אותו מההגדרות שלכם, בשפה שתבחרו, והופכת את כפתור ה-OTP לכפתור מסוג כתובת ה-URL ביצירה. תבנית אחת לכל שפה. create_template של המחבר אינו מעביר את 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" }
    ]}
  ]
}

איך השרת שלכם שולח את הקוד?

בקשה אחת לנקודת הקצה /messages של המספר לכל קוד, עם אסימון גישה (Access Token) שמוחזר על ידי הפקודה get_api_credentials או מהכרטיס "Plug in your own system" בלוח הבקרה. אותו קוד נכנס פעמיים, בפרמטר body ובפרמטר של כפתור כתובת ה-URL באינדקס 0, והנמען חייב להיות מספר טלפון. לפני השליחה השרת יוצר את הקוד, שומר ממנו גיבוב (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" }] }
    ]
  }
}

למה הקוד מגיע מהשרת ולא מאוטומציה?

כי המערכת שמכניסה את המשתמש חייבת ליצור את הקוד, לזכור אותו ולבדוק אותו, ורק המערכת הזו יודעת מתי נדרש קוד. אוטומציות עונות להודעות שלקוחות שולחים, ומסך כניסה לעולם לא כותב למספר שלכם. גם התבנית עצמה שוללת אותן: כפתור ה-OTP נושא את הקוד כמשתנה כפתור, והשלב "Send a template" ממלא רק משתני גוף, ולכן אינו יכול לשלוח תבנית אימות. ה-AI שלכם יכול לשלוח אחת דרך send_template, שמעביר רכיבי כפתור ל-Meta, אבל זה מיועד לבדיקה ולא לזרימת כניסה.

מה הופך זרימת OTP ב-WhatsApp לבטוחה?

ההנחיות של Meta והמגבלות של הפורמט מצביעים על אותה רשימה. אף אחד מהפריטים לא דורש יותר מהשרת שלכם וה-Cloud API:

  • לוודא את מספר ה-WhatsApp מול המשתמש לפני הקוד הראשון, ולומר שהקוד יגיע ב-WhatsApp.
  • להגדיר את זמן החיים שווה לתוקף הקוד או קצר ממנו, כך שמשלוח מאוחר לעולם לא יציג קוד שפג תוקפו.
  • להגביל ניסיונות ושליחה חוזרת לכל מספר, ולפוג קודים בשימוש הראשון.
  • לא להפוך קוד WhatsApp לגורם היחיד לשחזור חשבון. מספרי טלפון שנמכרים מחדש עדיין יכולים להגיע לחשבון WhatsApp ישן.
  • לעקוב אחרי וובהוק (Webhook) הסטטוס ולהציע SMS או דוא"ל כשקוד לא נמסר.

מה משתנה כשהמספר פועל גם באפליקציית WhatsApp Business?

השליחה עובדת כמו בכל מספר Cloud API, עד 20 הודעות בשנייה. Meta משקפת הודעות שנשלחו דרך ה-API לצ'אטים של האפליקציה, ולכן במספר Coexistence הקודים שאתם שולחים מופיעים גם בצ'אטים האלה בטלפון העסקי. שמרו את הטלפון הזה אצל אנשים שאתם סומכים עליהם, או שלחו קודים ממספר נפרד. ההנחיות של Meta מבקשות גם שכל עסק ישלח תבניות אימות מהמספר שלו, לעולם לא ממספר משותף בין עסקים. קטגוריית האימות היא קטגוריית תבניות בתשלום, שנגבית לפי הודעה שנמסרה ולפי מדינת הנמען. בחלק מהשווקים יש תעריפי 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.

טעויות נפוצות

  • כתיבת הקוד לתוך תבנית שירות כמו "Your code is {{1}}". Meta מאפשרת סיסמאות רק בתבניות אימות, ודוחה תבניות שירות או שיווק שהיא מוצאת בהן סיסמה.
  • שליחת הקוד בגוף בלבד. לכפתור ההעתקה נדרש אותו ערך כפרמטר שלו, ו-Meta מצפה לקוד פעמיים בבקשה.
  • השארת זמן חיים של 30 יום בתבנית אימות ישנה. טלפון שלא היה מחובר במשך שעה יקבל אז קוד שפג תוקפו. הגדירו אותו שווה לתוקף הקוד או נמוך ממנו.
  • שליחת הקוד למזהה משתמש ברמת עסק. תבניות אימות נשלחות למספרי טלפון בלבד, ו-Meta מחזירה שגיאה 131062.
עושים את זה עם EasyCoexistence

המספר מנוטר 24/7, כך שניתוק שהיה עוצר את קודי הכניסה מגיע אליכם בדוא"ל. המחיר הוא מ-US$ 9 ועד US$ 0.75 למספר בחודש, שיורד ככל שמוסיפים מספרים, עם תקופת ניסיון של 3 ימים.

שאלות נפוצות

האם OTP ב-WhatsApp זול יותר מקוד SMS?

Meta גובה על כל הודעת אימות שנמסרה לפי התעריף של מדינת הנמען, עם תעריפים מיוחדים בחלק מהשווקים. תעריפי SMS משתנים לפי ספק ונתיב. אנחנו לא מוסיפים עמלה על תעריף Meta. לפני המעבר השוו את לוח התעריפים של Meta מול ספק ה-SMS שלכם למדינות העיקריות שלכם.

האם זה אותו דבר כמו קוד האימות הדו-שלבי של WhatsApp?

לא. אימות דו-שלבי הוא קוד PIN בן שש ספרות שמגן על מספר ה-WhatsApp של העסק עצמו. תבנית אימות שולחת קוד ללקוחות שלכם, כדי שהאפליקציה או האתר שלכם יוכלו לאשר מי הם.

האם המשתמשים צריכים להסכים לקבל קודים?

כן. מדיניות Meta דורשת הרשאה לפני שעסק שולח הודעה למישהו, וההנחיות שלה ל-OTP מציעות לתת בחירה בערוצים, כמו WhatsApp, SMS או דוא"ל. בחירת WhatsApp במסך הכניסה, ליד המספר, היא ההרשאה הזו.

האם סוכנות יכולה לשלוח קודים לכמה לקוחות ממספר אחד?

לא. ההנחיות של Meta דורשות שלכל עסק יהיה חשבון WhatsApp Business ומספר טלפון משלו לתבניות אימות. שיתוף מספר בין עסקים הוא נגד התנאים והמדיניות של Meta. במקום זה חברו מספר לכל לקוח.

המשיכו לקרוא

אישורי הזמנה ועדכוני משלוח ב-WhatsApp, אוטומטיתשליחה אוטומטית של אישורי הזמנה ועדכוני משלוח ב-WhatsApp: תבניות utility, האירוע בחנות שמאחוריהן, קישורי מעקב, תשובות וסטטוסים.אבטחת אוטומציות ב-WhatsApp: מפתחות, וובהוקים וחתימותאבטחת אוטומציות ב-WhatsApp: מפתחות AI מוצפנים, X-EC-Signature בקריאות וובהוק (Webhook), סודות שמוצגים פעם אחת, וגישה מינימלית.יצירת תבניות WhatsApp עם ה-AI ותיקון דחיותבקשו מ-ChatGPT או Claude לכתוב, להגיש ולעקוב אחר תבניות WhatsApp: קטגוריות, משתנים עם דוגמאות, זמני בדיקה, סיבות הדחייה של Meta והגשה מחדש.שליחת הודעות WhatsApp אוטומטית ממערכות שלכםשליחת הודעות WhatsApp אוטומטית מהחנות, מ-CRM או מ-n8n דרך Cloud API של Meta: תבניות, כלל 24 השעות, אישורי גישה, תגובות ומגבלות.קטגוריות תבניות: שירות, שיווק ואימותשלוש קטגוריות התבניות, מה שייך לכל אחת, איך הן משפיעות על חיוב ובדיקה, ולמה בחירה שגויה מובילה לדחייה.שמות משתמש ב-WhatsApp ומזהי BSUID: מה משתנה בוובהוקים (Webhook) של Cloud APIאיך שמות משתמש ב-WhatsApp משנים את הוובהוקים של Cloud API: ה-BSUID בשדה user_id, מתי השדה wa_id נעלם, מענה לנמען ושינויים ב-Coexistence.

מוכנים להתחיל?

מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.

התחילו תקופת ניסיון בחינם

נבדק ב-