WhatsApp Cloud API: מדריך למתחילים על השכבה החינמית

WhatsApp Cloud API נשמע מאיים, אבל הרעיון המרכזי פשוט: זו הדרך של מטא, ללא עלות אחסון, לשלוח ולקבל הודעות וואטסאפ מהתוכנה שלכם. המדריך הזה מסביר מה זה, מה באמת חינמי, ואיך לשלוח את ההודעה הראשונה שלכם — בלי הז'רגון.

מה זה Cloud API באמת

ה-WhatsApp Cloud API הוא חלק מפלטפורמת WhatsApp Business. במקום להקליד הודעות בטלפון, המערכות שלכם שולחות ומקבלות אותן באופן תוכנתי. מטא מארחת אותו בענן, כך שאתם לא מריצים שרת וואטסאפ בעצמכם — שינוי משמעותי מ-API ה-on-premise הישן.

הוא מפעיל את הדברים שאפליקציית WhatsApp Business החינמית לא יכולה לעשות:

• אישורי הזמנה אוטומטיים, עדכוני משלוח ותזכורות.
• תיבת דואר נכנס משותפת שבה מספר נציגים מטפלים בשיחות ממספר אחד.
• צ'אטבוטים ואינטגרציות ל-CRM/מערכת תמיכה.
• שיווק בקנה מידה גדול למשתמשים שנתנו הסכמה.

אם אתם רק צריכים שיחות נכנסות מקישור, אתם לא צריכים את זה — קישור wa.me מיוצר קישורי הוואטסאפ החינמי שלנו מספיק. ה-Cloud API מיועד לאוטומציה ולקנה מידה.

אחסון חינמי מול הודעות חינמיות — אל תבלבלו ביניהם

שני דברים "חינמיים" שונים מתבלבלים:

1. האחסון חינמי. בניגוד ל-API ה-on-premise הישן, מטא מארחת את ה-Cloud API ללא עלות. אין שרתים לשכור.
2. להודעות יש שכבה חינמית בתוספת שימוש בתשלום. וואטסאפ מחייב לפי שיחה (חלון של 24 שעות), כשחלק מהשיחות חינמיות ואחרות בתשלום בהתאם לקטגוריה.

שינוי גדול נחת ב-2025: שיחות שירות שהמשתמש יזם הפכו לחינמיות — כשלקוח שולח לכם הודעה ואתם משיבים בתוך חלון השירות, זה בדרך כלל לא מחויב. קטגוריות שהעסק יוזם כמו שיווק ו(במקרים רבים) שירותיות/אימות הן בתשלום. הקצאות ומחירים מדויקים משתנים ומשתנים לפי מדינה, אז תמיד ודאו את התעריפים הנוכחיים במסמכי התמחור של מטא במקום לסמוך על מספר קבוע.

קטגוריות שיחה במונחים פשוטים

החיוב סובב סביב קטגוריות שיחה:

• שירות (Service) — הלקוח מתחיל את השיחה; אתם משיבים בתוך חלון של 24 שעות. חינמי ברובו מאז השינוי של 2025.
• שיווק (Marketing) — אתם מקדמים באופן יזום (הצעות, השקות). בתשלום, ודורש הסכמה + תבניות מאושרות.
• שירותיות (Utility) — עדכונים טרנזקציוניים הקשורים לפעולה (הזמנה נשלחה, תזכורת לתור). משתמש בתבניות; התמחור משתנה.
• אימות (Authentication) — קודים חד-פעמיים ואימות. משתמש בתבניות.

כלל האצבע: תגובות שירות שהלקוח יזם הן המסלול הזול/חינמי; שיווק שהעסק יוזם הוא המסלול בתשלום.

הודעות סשן מול הודעות תבנית

• בתוך חלון השירות של 24 שעות (אחרי שמשתמש שולח לכם הודעה), אתם יכולים לשלוח הודעות בטקסט חופשי.
• מחוץ לחלון הזה, או כדי להתחיל שיחה, חובה לשלוח הודעת תבנית מאושרת מראש. תבניות מונעות מעסקים לשלוח ספאם קר למשתמשים.

מה צריך כדי להתחיל

כדי לשלוח את ההודעה הראשונה שלכם תגדירו:

1. חשבון עסקי של מטא (פייסבוק).
2. אפליקציית פלטפורמת WhatsApp Business בלוח המחוונים למפתחים של מטא.
3. מספר טלפון רשום לפלטפורמה (מספר בדיקה מסופק להתחלה).
4. פרטי גישה ל-API — טוקן ומזהה מספר הטלפון שלכם.

מטא מספקת מספר בדיקה והקצאה קטנה כדי שתוכלו להתנסות לפני שאתם עולים לאוויר.

שליחת ההודעה הראשונה שלכם (המבנה שלה)

לאחר ההגדרה, השליחה היא בקשת HTTP ל-Graph API של מטא. מבחינה רעיונית:

POST https://graph.facebook.com/v22.0/${PHONE_NUMBER_ID}/messages
Authorization: Bearer ${ACCESS_TOKEN}
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "to": "972541234567",
  "type": "text",
  "text": { "body": "Hello from the Cloud API!" }
}

כדי לשלוח הודעה למישהו שלא שוחח איתכם קודם, החליפו את type: "text" בהודעת template שמפנה לתבנית מאושרת. החליפו את ${PHONE_NUMBER_ID} ו-${ACCESS_TOKEN} בערכים שלכם, ושימו לב שגרסת ה-API (v22.0 כאן) משתנה עם הזמן.

קבלת הודעות: webhooks

הודעות נכנסות מגיעות דרך webhook — כתובת URL שאתם מארחים שמטא קוראת לה בכל פעם שמשתמש שולח לכם הודעה. אתם מאמתים את ה-webhook פעם אחת, ואז מטא שולחת אליו אירועי הודעה. כך בוטים ותיבות דואר נכנס משותפות "שומעים" לקוחות.

האם מתחיל צריך להשתמש בזה?

שאלו שתי שאלות:

• האם אני צריך אוטומציה או תיבת דואר נכנס צוותית? אם לא, הישארו עם אפליקציית WhatsApp Business החינמית.
• האם אני שולח בקנה מידה גדול למשתמשים שנתנו הסכמה? אם כן, ה-Cloud API הוא המסלול התואם.

הרבה עסקים קטנים מגיעים ל-Cloud API דרך ספק פתרונות עסקיים (Business Solution Provider) (כמו Twilio, ‏360dialog או MessageBird) או כלי ללא קוד, שמסתירים את רוב ה-API הגולמי. למסלול ללא קוד, ראו אוטומציה של וואטסאפ עם Zapier ו-Make, ולתכנון עלויות, תמחור WhatsApp Business API.

נקודות מפתח

• האחסון חינמי; להודעות יש שכבה חינמית בתוספת קטגוריות בתשלום.
• שיחות שירות שהמשתמש יזם חינמיות ברובן מאז 2025.
• שיווק/שירותיות/אימות משתמשים בתבניות מאושרות ובדרך כלל בתשלום.
• מתחילים בלי צורכי אוטומציה לא צריכים את ה-API בכלל — קישור wa.me מכסה שיחות נכנסות.

התחילו פשוט עם קישור וואטסאפ חינמי והתקדמו ל-Cloud API כשהאוטומציה דורשת זאת.