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

עודכן 26.08.2026

חסימת Data‑URI: ‏MCP פתוח, REST חסום במכוון (mcp-b-01, נסגר by‑design)

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

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

הערה מהאימות של 26.08: הכלי דורש כעת גם fileName — ‏fileBase64 בלעדיו מחזיר Error: fileName is required if fileBase64 is provided.. שליחת קובץ אמיתית ב‑fileBase64 טרם אומתה מקצה לקצה (אין ערוץ WhatsApp בטננט הבדיקות) — fileDBName נשאר המסלול הבדוק.

היסטוריה: עד 25.08.2026 כלל ה‑WAF חל גם על נקודת ה‑MCP, ולכן fileBase64 לא היה שמיש מ‑MCP כלל (HTTP 403 עם דף HTML לפני שהכלי רץ). ההחרגה של MCP נכנסה בסבב התיקונים של 25.08.

`Send-WhatsApp-Message`

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

מצב גילוי

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

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

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

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

הצירוף המינימלי, כפי שהשרת עצמו מנסח אותו כשחסר משהו: 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`

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

קבצים

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

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

תבניות

הפרמטר	טיפוס	המשמעות
`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.

דוגמאות

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

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

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

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

`Get-WhatsApp-Template-Params`

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

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

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

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

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

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

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

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

הכלי ממיר את בלוקי ה‑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 }

`Get-SMTP-Accounts`

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

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

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

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

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

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

הערוץ	היכן מחפשים
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
כלי קבצים — הכנת קובץ לשליחה
סוכן במצב קריאה בלבד — למה כלי שנראה קריא מסווג כמשנה
אינדקס הכלים המלא