מה זה עושה

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

אף אחד לא צריך לשבת מול מסך בשביל זה. זה רץ בשתיים בלילה, בשבת, ובהזמנה החמישים של היום — והלקוח מקבל בדיוק את אותה הודעה בכל פעם.

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

מה צריך להכין

ארבעה דברים, ורק שני האחרונים דורשים עבודה.

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

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

הוציאו מפתח

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

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

2. צרו את המפתח. אחרי האישור אותו עמוד הופך למרכז המפתחים. היכנסו למפתחות API ← מפתח חדש, תנו לו שם על שם המערכת שתשתמש בו, ובחרו מאיזה סוכן מותר לו לשלוח.

המפתח הזה שולח הודעות ולא עושה שום דבר אחר — סמנו channel:send והשאירו את השאר כבוי.

המפתח המלא מוצג פעם אחת. אחר כך נשמר רק גיבוב שלו, כך שאף אחד — גם לא אנחנו — לא יכול לקרוא אותו.

התייחסו אליו כמו לסיסמה. הדביקו אותו בהגדרות ה-webhook של החנות או בכלי האוטומציה, לא במייל ולא בצ׳אט. אם הוא דלף, פתחו את תפריט המפתח ולחצו החלפה — תקבלו סוד חדש, והישן מפסיק לעבוד באותה שנייה.

שלושת הדברים שממלאים

לא משנה במה אתם משתמשים — הגדרות ה-webhook של החנות, שלב ב-Make או ב-Zapier, או קוד שהמפתח שלכם כותב — כולם מבקשים את אותם שלושה דברים. הנה הם.

1. הכתובת. סוג הבקשה הוא POST. החליפו את YOUR_AGENT_ID במזהה הסוכן שלכם, שמופיע בשורת הכתובת כשהסוכן פתוח, וגם בעמוד הסקירה של מרכז המפתחים.

Address

https://server-150134556021.us-central1.run.app/api/v1/assistants/YOUR_AGENT_ID/whatsapp/send-template

2. שתי שורות כותרת. הראשונה נושאת את המפתח — המילה Bearer, רווח, ואז המפתח עצמו.

Headers

Authorization: Bearer al_live_your_key_here
Content-Type: application/json

3. ההודעה עצמה, כ-JSON. למי היא הולכת, איזו תבנית, באיזו שפה, ומה למלא במקומות הריקים.

Body

{
  "to": "+972501234567",
  "templateName": "order_shipped",
  "language": "he",
  "body": {
    "order_id": "4021"
  }
}

זו כל האינטגרציה. אין קריאה שנייה, אין מה לתשאל שוב, ואין מה להתקין.

איך ממלאים את הפרטים

ארבעה שדות, ובשלושה מהם קורות רוב הטעויות.

to — מספר הלקוח בפורמט בינלאומי: +, קידומת מדינה, ואז המספר בלי האפס בהתחלה. 050-123-4567 הופך ל-+972501234567
templateName — בדיוק כפי שאושר, תו בתו. תבניות נקראות בדרך כלל באותיות קטנות עם קווים תחתונים, וכמעט-נכון פשוט לא יימצא
language — קוד השפה שבה התבנית אושרה, למשל he או en. תבנית שאושרה בעברית לא תימצא עם en
body — המשתנים, לפי שם. אם בתבנית כתוב ״ההזמנה {{order_id}} שלך יצאה לדרך״, שלחו { "order_id": "4021" }. תבניות ותיקות עם משתנים ממוספרים מקבלות { "1": "4021" } במקום

תבניות עם כפתור או תמונה הוסיפו buttons ללינק דינמי על כפתור, ו-header לתמונה או ל-PDF — הקובץ צריך לשבת בכתובת ציבורית, והוא חייב להתאים למה שהתבנית אושרה איתו. המבנה המדויק נמצא בתיעוד ה-API במרכז המפתחים.

מה חוזר בתשובה

התשובה מגיעה באותה קריאה, כך שהמערכת שלכם יודעת מיד אם ההודעה הגיעה ללקוח.

Sent

{ "status": "sent", "messageId": "wamid.HBgLM…", "threadId": "thread_9f2c" }

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

Skipped

{ "status": "skipped", "reason": "contact_opted_out", "threadId": null }

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

Failed

{ "status": "failed", "error": "…", "threadId": "thread_9f2c" }

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

403 זה מכסה, לא הרשאה. כל תבנית שאתם שולחים היא הודעת ווטסאפ בתשלום ונספרת בחבילה שלכם. אם חזר 403 עם הודעה על מכסה, השליחות נעצרו כי המכסה החודשית נגמרה — כמה וואטסאפ באמת עולה שווה קריאה לפני שמפעילים את זה על אירוע עם הרבה נפח.

לחבר את זה למערכת שלכם

שלושת השדות כבר בידיים שלכם. נשארה שאלה אחת: מי ממלא אותם כשהזמנה משתנה. יש שלוש תשובות כנות.

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

כלי אוטומציה מסדר את הנתונים קודם. הרבה מערכות שולחות רק מבנה קבוע משלהן, עם קודי סטטוס פנימיים, ולא נותנות לשנות אותו. במקרה כזה צריך שלב אחד באמצע — Make, Zapier, n8n, מה שכבר יש לכם: הוא תופס את האירוע, מתרגם ״סטטוס 7״ ל-order_shipped, מסדר את מספר הטלפון וקורא לכתובת שלמעלה. השתמשו בשלב ה-HTTP הרגיל של הכלי והדביקו לו את אותם שלושה שדות.

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

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

כשזה לא עובד

התקלות מעטות והן חוזרות על עצמן. לפי סדר השכיחות:

401 או 403 מיד — המפתח שגוי, בוטל, או חסרה לו הרשאת השליחה; או שמזהה הסוכן אינו אחד מאלה שהמפתח הורשה להם. בדקו את שורת המפתח תחת מפתחות API
״התבנית לא נמצאה״ — טעות הקלדה בשם, או שהשפה לא תואמת לזו שבה היא אושרה. העתיקו את שניהם מרשימת התבניות תחת בנייה ← ערוצים
נשלח, אבל הלקוח לא ראה כלום — כמעט תמיד מספר הטלפון: אפס שנשאר בהתחלה, פורמט מקומי, או קידומת מדינה חסרה
הכול חוזר skipped — אתם פונים לאנשים שביקשו להפסיק. ככה זה אמור לעבוד

התיעוד המלא — כל שדה, כל תשובה, וקובץ מפרט להורדה — נמצא באפליקציה תחת חשבון ← מפתחים ← תיעוד ה-API. אם נתקעתם על שליחה מסוימת, שלחו לנו את טקסט התשובה ואת שם התבנית ונגיד לכם במה מדובר.

זה עזר לך?