כלי הודעות — WhatsApp ואימייל

הכלל שמפיל את רוב אינטגרציות ה‑WhatsApp

fromPhoneNumberId הוא ערך השדה Identity מטבלת Channels — מזהה מספר הטלפון אצל ספק ה‑WhatsApp, מחרוזת ארוכה של ספרות כמו 100000000000000.

זה לעולם לא ה‑objectId של שורת הערוץ. שני הערכים יושבים באותה שורה (בסכימת Channels: Identity, WaBaId, Key, TypeId), שניהם נראים כמו מזהה, ורק אחד עובד. Send-WhatsApp-Message עם getNumbers: true מחזיר את המספרים הזמינים בפורמט הנכון.

הכלי הזה שולח הודעה אמיתית ללקוח אמיתי

Send-WhatsApp-Message בלי getNumbers / getTemplates שולח. אין מצב טיוטה, אין ביטול, אין “שלח לעצמי”. בסוכן AI זה חייב לעבור שער אישור אנושי — הכלי מסווג כמשנה גם כשמפעילים אותו במצב גילוי. ראו סוכן במצב קריאה בלבד.

חסימת Data‑URI: ‏MCP פתוח, REST חסום במכוון

fileBase64 מחייב קידומת Data‑URI (data:image/png;base64,…), וה‑MCP הוא הצרכן הלגיטימי היחיד של הפורמט. חלוקת ה‑WAF מכוונת:

• MCP (mcp.mbapps.co.il) — עובר. ‏Send-WhatsApp-Message עם fileBase64 בפורמט הסכימה מגיע לכלי (במערכת בלי ערוץ WhatsApp חוזר {"message":"missing config"}, כלומר הבקשה עברה את ה‑WAF), וכך גם Count-Data עם data: בגוף.
• REST (api.mbapps.co.il) — נחסם, by‑design. מחרוזת data:<type>/<subtype> בשדה טקסט מחזירה 403 HTML. קבצים עולים ב‑POST /parse/files (base64 חשוף בגוף ייעודי).

הכלי דורש גם fileName: בלעדיו Error: fileName is required if fileBase64 is provided.. fileDBName הוא המסלול המוכר מקצה לקצה.

Send-WhatsApp-Message

כלי אחד, שני מצבי הפעלה: גילוי (מחזיר מידע, לא שולח) ושליחה.

מצב גילוי

הפרמטר	טיפוס	מה חוזר
getNumbers	Boolean	מספרי השליחה הזמינים — ומהם ערך ה‑fromPhoneNumberId
getTemplates	Boolean	התבניות המאושרות, כולל מערך ה‑components המלא של כל אחת

JSON

{ "getNumbers": true }
{ "getTemplates": true }

שתי הקריאות בטוחות ואינן שולחות דבר. הן תמיד הצעד הראשון.

במערכת בלי ערוץ WhatsApp — missing config

במערכת חדשה (טבלת Channels ריקה): getNumbers, getTemplates וניסיון שליחה מחזירים {"message":"missing config","success":false} — HTTP 200, בלי Error:. זו התשובה שאומרת “אין ערוץ WhatsApp מחובר”, והיא הבדיקה הראשונה לפני שבונים אוטומציה. חיבור הערוץ נעשה בממשק (MyChat), לא מ‑MCP.

שליחה — קבוצות הפרמטרים

הצירוף המינימלי, כפי שהשרת מנסח אותו כשחסר משהו: Every request must include phoneNumber and fromPhoneNumberId. Additionally, you must specify the content using either message, fileBase64, or a template. — שני פרמטרי הכתובת תמיד, ועוד בדיוק אחד מסוגי התוכן. fileDBName לבדו אינו נחשב תוכן.

כתובות

הפרמטר	טיפוס	המשמעות
phoneNumber	String	הנמען, בפורמט בינלאומי בלי + — למשל 972500000000
fromPhoneNumberId	String	מזהה מספר השולח. Channels.Identity
wabaId	String	חשבון WhatsApp Business, כשיש יותר מאחד

תוכן

הפרמטר	טיפוס	המשמעות
message	String	גוף ההודעה. תומך בסימון של WhatsApp: *מודגש*, _נטוי_, ~מחוק~, `קוד`, ואמוג’ים

שרשור ותיעוד

הפרמטר	טיפוס	המשמעות
conversationId	String	צירוף ההודעה לשיחה קיימת
contextId	String	מזהה ההודעה שאליה משיבים — מייצר תשובה משורשרת
savedInTable + savedInObjectId	String	היכן לתעד את ההודעה כשלא משתמשים ב‑conversationId

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

קבצים

הפרמטר	טיפוס	המשמעות
fileBase64	String	תוכן הקובץ. לפי הסכימה חייב לכלול קידומת Data‑URI (data:application/pdf;base64,…). ה‑WAF אינו חוסם את הקידומת מול MCP (ב‑REST כן — במכוון) — ראו למעלה
fileName	String	שם הקובץ הנשלח. חובה יחד עם fileBase64 — בלעדיו: Error: fileName is required if fileBase64 is provided.
fileDBName	String	שליחת קובץ שכבר שמור ב‑CRM, לפי שמו (יחד עם message או template). המסלול המוכר מקצה לקצה

תיאור הכלי מונה תמונה, וידאו, אודיו ומסמך (PDF). רשימת הפורמטים המדויקת היא של WhatsApp Cloud API (Meta), לא של המוצר.

אסימטריית ה‑base64

Send-WhatsApp-Message.fileBase64 דורש קידומת Data‑URI. Upload-Public-File.data דורש base64 חשוף בלי קידומת. הפירוט: כלי קבצים.

תבניות

הפרמטר	טיפוס	המשמעות
template	Object	{ name ✔, language, components ✔ } — ה‑components מועתקים כמות שהם מ‑getTemplates
WATemplateParams	Object	הערכים שממלאים את ה‑{{1}}, {{2}} של התבנית

אלמנטים אינטראקטיביים

הפרמטר	המבנה	המגבלה
interactiveButtons	[{ title ✔, id }]	עד 3 כפתורי תשובה מהירה
interactiveCTA	{ title ✔, url, HEADER_TEXT, FOOTER_TEXT }	כפתור קריאה‑לפעולה אחד
interactiveLIST	{ BUTTON_TEXT ✔, SECTIONS ✔, HEADER_TEXT, FOOTER_TEXT }	1–10 מקטעים { title ✔, rows ✔ }, בכל מקטע 1–10 שורות { id ✔, title ✔, description }

המגבלות נאכפות בוולידציית הסכימה, לפני השרת: כפתור רביעי ⇒ interactiveButtons: Too big: expected array to have <=3 items; מקטע בלי title ⇒ interactiveLIST.SECTIONS.0.title: Invalid input; 11 שורות ⇒ rows: Too big: expected array to have <=10 items; interactiveCTA בלי title, או template בלי components — אותו סוג שגיאה. כולן מתחילות ב‑Input validation error.

דוגמאות

JSON

// הודעת טקסט מינימלית
{ "fromPhoneNumberId": "100000000000000",
  "phoneNumber": "972500000000",
  "message": "*שלום רב!*\nההצעה שביקשת מוכנה 🚀" }

JSON

// תשובה עם PDF, בתוך שיחה קיימת
{ "conversationId": "L7y9ieFPBh",
  "fromPhoneNumberId": "100000000000000",
  "phoneNumber": "972500000000",
  "contextId": "RoUWBMnQoM",
  "message": "מצורף המסמך המבוקש",
  "fileBase64": "data:application/pdf;base64,JVBERi0xLjcKJc…",
  "fileName": "quote-1042.pdf" }

JSON

// הודעה עם כפתורים
{ "fromPhoneNumberId": "100000000000000",
  "phoneNumber": "972500000000",
  "message": "לאשר את מועד הפגישה?",
  "interactiveButtons": [
    { "title": "מאשר",  "id": "confirm" },
    { "title": "לשנות", "id": "reschedule" }
  ] }

חלון 24 השעות — מגבלת פלטפורמה, לא של המוצר

טקסט חופשי מותר רק בתוך 24 שעות מההודעה האחרונה של הלקוח

כלל של Meta, לא של MyBusiness; אין פרמטר שעוקף אותו.

בתוך החלון: message חופשי, כולל קבצים וכפתורים. מחוץ לחלון: רק תבנית מאושרת; טקסט חופשי ייכשל.

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

Get-WhatsApp-Template-Params

בונה את שלד ה‑WATemplateParams מתוך רכיבי תבנית.

הפרמטר	טיפוס	חובה	המשמעות
templateComponents	Array<Object>	✔	מערך ה‑components שהועתק מפלט getTemplates

JSON

// רכיב קלט — כפי שהוא חוזר מ-getTemplates, כולל בלוק example:
{ "type": "BODY", "text": "שלום {{1}}, בהמשך לפנייתך מספר {{2}}…",
  "example": { "body_text": [["דנה", "1042"]] } }

// מה שחוזר:
{ "BODY": ["דנה", "1042"] }

הערכים שחוזרים הם הדוגמאות של Meta מתוך example. לתבנית שמיועדת לטריגר או לקמפיין, החליפו אותם ב‑placeholders של ה‑CRM:

JSON

{ "BODY": ["{{{AccountId.Name}}}", "{{{Name}}}"] }

תבנית מלאה מחזירה מפתח לכל רכיב: HEADER — מתוך example.header_text (כותרת טקסט) או example.header_handle (כותרת תמונה — ה‑URL של התמונה), BODY — מתוך example.body_text, ו‑button-URL — מתוך ה‑example של כפתור URL דינמי. רכיבי FOOTER וכפתורי QUICK_REPLY לא מייצרים מפתח.

מגבלה ידועה — הכלי לא מנתח את הטקסט; בלי example חוזר {}

הכלי ממיר את בלוקי ה‑example של Meta ל‑WATemplateParams, ואינו סופר את מופעי {{N}} ב‑text. רכיב שנבנה ביד בלי example ⇒ {} ריק, גם כשיש פרמטר אחד. עם example חוזרים כל הפרמטרים.

העתיקו את ה‑components כמות שהם מפלט getTemplates. אובייקט ריק פירושו “אין example”, לא “אין פרמטרים”: ספרו בעצמכם את מופעי {{N}} ב‑text, ובנו מערך עם ערך אחד לכל מופע, לפי הסדר.

זרימת התבניות המאושרות

1. Send-WhatsApp-Message { getTemplates: true }
       ↓ בחירת התבנית, העתקת components כמות שהם
2. Get-WhatsApp-Template-Params { templateComponents: [...] }
       ↓ קבלת שלד WATemplateParams
3. החלפת ערכי הדוגמה בערכים אמיתיים או ב-{{{placeholders}}}
       ↓
4. Send-WhatsApp-Message { fromPhoneNumberId, phoneNumber, template, WATemplateParams }

תבניות נוצרות ומאושרות מחוץ למערכת

אי אפשר ליצור תבנית WhatsApp מ‑MCP. תבנית נכתבת בממשק ועוברת אישור של Meta, וזמן האישור אינו בשליטת המוצר. תבנית שסטטוסה אינו APPROVED לא תישלח. בתכנון פרויקט זה פריט לוח זמנים, לא פריט פיתוח.

Get-SMTP-Accounts

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

JSON

[ { "objectId": "smtp12345x",
    "SenderEmail": "info@company.co.il",
    "SenderName": "שירות לקוחות",
    "UserId": { "__type": "Pointer", "className": "_User", "objectId": "2b0QVKoigE" } } ]

ה‑objectId הוא הערך של emailAccount בפעולת אימייל בטריגר. SenderName ו‑SenderEmail הם מה שהנמען רואה.

JSON

{ "actionType": "email",
  "actionData": { "email": {
    "emailAccount": "smtp12345x",
    "template": "tmpl098765",
    "emailType": "field", "emailTarget": "Email",
    "emailSubject": "עדכון בנוגע ל-{{{Name}}}",
    "saveToEmailsTable": true } } }

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

במערכת שעדיין לא הוגדרה בה שליחת מייל הכלי מחזיר [], לא שגיאה (המחלקה SMTP עוד לא קיימת בסכימה, Get-Schema עליה מחזיר {}).

טריגר אימייל שנבנה לפני שקיים חשבון SMTP ייווצר בהצלחה — גם עם emailAccount ו‑template שאינם קיימים — ולא ישלח כלום. קראו לכלי הזה לפני שאתם בונים אוטומציית מייל.

אין כלי לתבניות מייל

template בפעולת האימייל הוא objectId מטבלת EmailTemplate. אפשר לקרוא אותה עם Get-Data, אבל אין כלי MCP ליצירת תבנית מייל — היא נוצרת בממשק, כמו חשבון ה‑SMTP.

היכן מתועדות ההודעות

אין יומן הודעות אחד. כל ערוץ כותב למקום אחר:

הערוץ	היכן מחפשים
WhatsApp דרך הערוץ	Conversations + ConversationMessages (שדות Message, Direction, failed, failedAt, errors) — טבלאות השיחות של MyChat. טבלת _syslogWA אינה קיימת במערכת חדשה
WhatsApp — דיוור (MyCampaigns)	_syslogCampaignWA
SMS	טבלת SMS (From, To, Content, Status, TemplateId) · ברמת הספק: _syslogSMS
אימייל שנשלח מטריגר עם saveToEmailsTable	טבלת Emails (MailFrom, MailTo, Subject, SendAt, SendStatus, ErrorMessage)
שינוי ברשומה שההודעה נקשרה אליה	_Timeline

הפירוט המלא: יומנים וראיות.

המשך

• כלי טריגרים ואוטומציות — פעולות email, sms ו‑whatsapp-message
• כלי קבצים — הכנת קובץ לשליחה
• סוכן במצב קריאה בלבד — למה כלי שנראה קריא מסווג כמשנה
• אינדקס הכלים המלא