WhatsApp

GetMyBot מחבר את WhatsApp דרך WhatsApp Cloud API (Meta Graph API). לאחר החיבור הבוט מקבל הודעות נכנסות מ-WhatsApp ומחיל עליהן את התגובות שלכם, ומפעילים יכולים לנהל התכתבות בדיאלוגים. סקירה כללית של הרב-ערוציות — בעמוד ערוצים.

חיבור ערוץ WhatsApp

לחיבור נדרשים חמישה פרטים מאפליקציית ה-Meta שלכם (WhatsApp Cloud API). כולם חובה:

  • Phone number ID — מזהה מספר WhatsApp Business.
  • WABA ID — מזהה WhatsApp Business Account.
  • Access token — טוקן גישה של אפליקציית Meta.
  • Verify token — מחרוזת שרירותית שאתם קובעים בעצמכם. היא משמשת באימות ה-webhook ב-Meta (ראו להלן).
  • App secret — סוד אפליקציית Meta. נחוץ לאימות חתימת HMAC של webhooks נכנסים (כותרת X-Hub-Signature-256).

השלבים בממשק:

  1. פתחו בוטים ← «הוסף ערוץ» ← WhatsApp.
  2. מלאו את חמשת השדות לעיל, ובמידת הרצון את שם הערוץ (אופציונלי).
  3. לחצו על «בדיקה» — GetMyBot מאמת את הפרטים דרך Meta.
  4. לחצו על «חבר».

הגדרת webhook ב-Meta

לאחר החיבור מופיע לערוץ Callback URL בצורה {כתובת}/ch/{channelID} (בממשק — אייקון webhook 🔗). יש להזין אותו יחד עם ה-Verify token שלכם באפליקציית Meta: WhatsApp → Configuration → Webhook.

איך זה עובד:

  1. Meta שולחת ל-Callback URL בקשת verify ומשווה את ה-verify_token שהועבר עם ה-Verify token שלכם. בהתאמה ה-webhook נחשב מאושר.
  2. לאחר מכן Meta שולחת לכתובת זו אירועים (הודעות נכנסות, סטטוסי מסירה, פסקי מודרציה של תבניות).
  3. כל בקשה נכנסת חתומה בכותרת X-Hub-Signature-256; GetMyBot מאמת את החתימה בעזרת ה-App secret — ולכן פרט זה נדרש בחיבור.

חלון סשן של 24 שעות

WhatsApp מגביל התכתבות יזומה: הודעות חופשיות אפשר לשלוח למשתמש רק במשך 24 שעות מההודעה הנכנסת האחרונה שלו. כל הודעה נכנסת חדשה מהמשתמש מרעננת את החלון.

מחוץ לחלון 24 השעות אי אפשר לשלוח הודעה חופשית — הדרך היחידה לכתוב שוב למשתמש (re-engage) היא תבנית הודעה מאושרת. לכן התבניות הן הכלי המרכזי לרסילות ולתזכורות ב-WhatsApp.

תבניות הודעה

תבנית (message template) היא הודעה שסוכמה מראש עם Meta, שאפשר לשלוח מחוץ לחלון הסשן. ניהול התבניות — בממשק GetMyBot.

היכן מנהלים תבניות

בוטים ← אצל ערוץ WhatsApp אייקון «תבניות הודעה» (📄) ← דיאלוג «תבניות ערוץ WhatsApp». בדיאלוג יש כפתורים:

  • «צור תבנית» — בניית תבנית חדשה.
  • «סנכרן» — משיכת קטלוג התבניות מ-Meta (עדכון סטטוסים ורשימה).

קטגוריות תבניות

  • MARKETING (שיווק) — מבצעים, הכרזות, רסילות.
  • UTILITY (שירותי) — התראות לפי פעולות המשתמש (סטטוסי הזמנות, תזכורות).
  • AUTHENTICATION (אימות) — קודי אישור.

שדות התבנית

  • שם — אותיות לטיניות קטנות, ספרות ו-_, עד 512 תווים.
  • שפה — locale של Meta.
  • קטגוריה — אחת משלוש הקטגוריות לעיל.

לקטגוריות שיווק ו-שירותי בנוסף:

  • כותרת — ללא / טקסט / תמונה / וידאו / מסמך. לכותרת מדיה מועלה קובץ דוגמה.
  • גוף — חובה, עד 1024 תווים. משתנים מסומנים ב-{{1}}, {{2}} … בסדר מדויק מ-1 עד N, ללא דילוגים.
  • כותרת תחתונה — עד 60 תווים.
  • כפתורים — עד 10: תשובה מהירה, קישור (עד 2), טלפון (1), העתקת קוד (1).
  • לכל משתנה {{n}} יש להגדיר ערך דוגמה — זו דרישה של Meta למודרציה.

לקטגוריית אימות הגוף קבוע על ידי Meta עצמה; מוגדרים: תוקף הקוד (1–90 דקות), המלצת אבטחה וטקסט כפתור העתקת הקוד.

מודרציה

הכפתור «צור» שולח מיד את התבנית למודרציה של Meta — אין שלב נפרד של «שלח לבדיקה». הפסק מגיע באופן אסינכרוני (דרך webhook), רשימת התבניות מתעדכנת אוטומטית. סטטוסים:

  • PENDING (בבדיקה)
  • APPROVED (מאושר)
  • REJECTED (נדחה) — עם ציון הסיבה
  • וכן PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION.

ניתן לערוך תבניות בסטטוסים APPROVED, REJECTED, PAUSED. אי אפשר לשנות שם ושפה; בתבניות מאושרות גם הקטגוריה נעולה.

שימוש בתבנית בתגובה

שליחת תבנית היא פעולה של תגובה:

  1. בבונה התגובה פתחו «פעולות» ← «הוסף פעולה» ← «שלח תבנית WhatsApp».
  2. הפעולה זמינה רק אם לבוט מחובר ערוץ WhatsApp עם תמיכה בתבניות.
  3. נבחרת רק תבנית מאושרת (APPROVED).
  4. ממלאים פרמטרים: ערכי המשתנים {{n}} בגוף, כותרת טקסט, כותרת מדיה לפי קישור, פרמטרים של כפתורי URL. בפרמטרים אפשר להשתמש במשתני החלפה.

ערוץ השליחה בפועל נקבע לפי ערוץ האירוע: אם האירוע הגיע מ-WhatsApp, התבנית תישלח ל-WhatsApp.

דיאלוגים וקבצים מצורפים

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

תמחור

GetMyBot מנהל רישום של שיחות WhatsApp (conversations) לפי קטגוריות — marketing / utility / authentication / service. בגרסה הנוכחית זהו רישום לצורכי תצפית בלבד (record-only): לא מנוכה מהיתרה עבור שיחות.

המשך