שליחת הודעות WhatsApp מכל כלי אוטומציה

ברוב פלטפורמות האוטומציה יש פעולה ששולחת בקשת HTTP, ולרוב היא נקראת HTTP Request, API request או Outgoing webhook. כוונו את הפעולה הזו לנקודת הקצה שליחת הודעה של Wbiztool, וכל הרצה של תהליך העבודה תשלח הודעת WhatsApp מהמספר המחובר שלכם.

הדף הזה מסביר את ההגדרה פעם אחת, ואז מראה איפה למצוא את הפעולה ב-Pabbly Connect, ב-Albato, ב-Activepieces וב-Make.

לפני שמתחילים#

תצטרכו שלושה ערכים מחשבון ה-Wbiztool שלכם:

• ה-Client ID (מזהה לקוח) וה-API key (מפתח API) מהדף Settings → API keys (הגדרות ← מפתחות API).
• ה-WhatsApp Client ID (מזהה לקוח WhatsApp) של המספר שממנו שולחים, שמוצג בדף WhatsApp settings (הגדרות WhatsApp). המספר צריך להיות מחובר; הודעות שנשלחות כשהוא מנותק ממתינות בתור.

פרטים נוספים בסעיף אימות.

הגדרת פעולת ה-HTTP#

1. הוסיפו פעולת בקשת HTTP

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

2. הגדירו את השיטה ואת ה-URL

   השיטה (Method) היא POST, וה-URL הוא https://wbiztool.com/api/v1/send_msg/. השאירו את האימות (authentication) על ללא: פרטי הגישה נשלחים בגוף הבקשה.

3. בחרו את סוג הגוף

   בחרו JSON אם הכלי שלכם מציע זאת. גם Form data (שדות טופס) עובד, אז השתמשו במה שנוח יותר בכלי שלכם. אין צורך בכותרות (headers) נוספות.

4. הוסיפו את שדות הגוף

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

5. בדקו את השלב

   הריצו את השלב פעם אחת עם נתוני בדיקה. תגובה עם "status": 1 פירושה שההודעה נכנסה לתור.

שדות הגוף#

כדי לשלוח לקבוצת WhatsApp במקום למספר, שלחו group_name במקום phone. ראו שליחה לקבוצה. כל שאר האפשרויות מפורטות בדף שליחת הודעה.

דוגמה לגוף JSON#

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

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "PHONE_FROM_TRIGGER",
  "msg": "Hi NAME_FROM_TRIGGER, thanks for your order. We will update you here on WhatsApp."
}

כדי לשלוח לקבוצה, החליפו את phone ואת country_code ב-group_name:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "group_name": "Sales Team Mumbai",
  "msg": "New lead: NAME_FROM_TRIGGER, PHONE_FROM_TRIGGER"
}

כדי לשלוח תמונה, הגדירו את msg_type ל-1 והוסיפו img_url. ה-msg הופך לכיתוב של התמונה. לשליחת קובץ, הגדירו את msg_type ל-2 והוסיפו file_url ו-file_name:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 2,
  "country_code": "91",
  "phone": "PHONE_FROM_TRIGGER",
  "file_url": "https://example.com/invoices/INV-1042.pdf",
  "file_name": "INV-1042.pdf",
  "msg": "Here is your invoice."
}

תגובה#

בקשה מוצלחת מחזירה:

{
  "status": 1,
  "message": "Created",
  "msg_id": 9817263
}

הערך "status": 1 פירושו שההודעה נכנסה לתור, ועדיין לא נשלחה. אם משהו לא תקין, ה-API מחזיר HTTP 400 עם "status": 0 ו-message כמו Auth Error: invalid api key או Invalid phone number. חלק מהכלים עוצרים את תהליך העבודה בתגובת 400. פתחו את הפלט של השלב כדי לקרוא את ה-message. הרשימה המלאה נמצאת בדף שליחת הודעה ← שגיאות.

כדי לדעת מתי ההודעה נשלחה בפועל, העבירו כתובת URL בשדה webhook (למשל טריגר Webhook באותו כלי). הכתובת מקבלת בקשת POST מקודדת כטופס עם msg_id ועם status שערכו SENT או FAILED. ראו Webhook.

Pabbly Connect#

1. הוסיפו את פעולת ה-API

   בתהליך העבודה שלכם, הוסיפו שלב פעולה, בחרו את האפליקציה API (Pabbly) ואת אירוע הפעולה Execute API Request.

   

2. הגדירו את הבקשה

   הגדירו את Action Event Method ל-POST, את API Endpoint URL ל-https://wbiztool.com/api/v1/send_msg/, את Payload Type ל-Form Data או ל-JSON, ואת Authentication ל-No Auth.

   

3. הגדירו את הפרמטרים

   סמנו את Set Parameters והוסיפו שורה לכל שדה בגוף: client_id, api_key, whatsapp_client, phone, country_code, msg ו-msg_type. מפו את phone ואת msg מהטריגר שלכם.

   

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

4. שמרו ושלחו בקשת בדיקה

   בדקו שהתגובה מכילה "status": 1.

Albato#

1. הוסיפו את פעולת ה-HTTP

   באוטומציה שלכם, הוסיפו פעולה ובחרו HTTP Request/Outgoing webhook, ואז את הפעולה Send request שלה. למשל, השתמשו בטריגר New row created של Google Sheets כדי לשלוח הודעה על כל שורה חדשה.

   

2. צרו את החיבור

   תנו לחיבור שם, למשל „Wbiztool“. אפשר להזין https://wbiztool.com/api/v1/send_msg/ ככתובת ה-URL שלו ולהגדיר את סוג התוכן ל-JSON.

3. מפו את השדות

   הגדירו את URL ל-https://wbiztool.com/api/v1/send_msg/ (אם הוא נשאר ריק, נעשה שימוש בכתובת של החיבור) ואת Request method ל-POST. תחת Request parameters, הוסיפו client_id, api_key, whatsapp_client, msg_type, country_code, phone ו-msg, ובחרו את phone ואת msg מתוך השדות של הטריגר.

   

   

   צילום המסך משתמש ב-message, שעובד במקום msg. הוא משמיט את country_code כי מספר הבדיקה כבר כולל אותה.

4. בדקו והפעילו

   הריצו בדיקה, ודאו שבתגובה יש "status": 1, ואז הפעילו את האוטומציה.

   

Activepieces#

1. הוסיפו את ה-piece של HTTP

   לחצו על + אחרי הטריגר ובחרו HTTP ← Send HTTP request.

2. הגדירו את הבקשה

   הגדירו את Method ל-POST ואת URL ל-https://wbiztool.com/api/v1/send_msg/. בחרו JSON או Form Data בשדה Body Type.

   

3. הוסיפו את שדות הגוף

   הוסיפו פריט אחד לכל שדה. השתמשו ב-Data Selector כדי להכניס ערכים מהטריגר לשדות phone ו-msg. אם phone כבר כולל את קידומת המדינה (למשל 919876543210), אפשר להשמיט את country_code.

4. בדקו את השלב

   לחצו על Test Step ובדקו שבתגובה יש "status": 1, ואז פרסמו את ה-flow.

Make#

השתמשו במודול HTTP של Make עם הפעולה Make a request. הגדירו את השיטה ל-POST, את ה-URL ל-https://wbiztool.com/api/v1/send_msg/, את סוג הגוף ל-JSON (raw, עם סוג תוכן application/json) או ל-form data, ומלאו את שדות הגוף שלמעלה.

פתרון בעיות#