API ואוטומציות

כל מה שהקונסולה של שלח לי יודעת לעשות, אפשר לעשות גם מבחוץ: מצ'אט עם Claude או ChatGPT, מהאתר, ממערכת התורים, מה-CRM, מ-Make, או מקוד שמתכנת/ת כותבים. ארבע דרכים, מהקלה לגמישה.

1. עוזר AI: Claude או ChatGPT

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

איך מחברים

2. אוטומציה נכנסת, בלי קוד

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

איך זה עובד

3. האפליקציה ב-Make

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

התקנה ב-Make

4. ה-API

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

התחלה מהירה

חיבור ל-Claude, ל-ChatGPT ולעוזרי AI

שלח לי מתחבר לעוזרי AI דרך MCP, התקן הפתוח לחיבור כלים לעוזרים. אחרי החיבור כותבים לעוזר כמו לעובד: "מי כתב לנו היום ועוד לא קיבל תשובה?", "הנה האקסל של התורים למחר, תשלח לכל אחד תזכורת עם השעה שלו", "תכין תבנית למבצע של 20% ותשלח לאישור". הוא עושה את זה בשלח לי, על המספרים והרשימות שלכם.

  1. Claude. בהגדרות ← Connectors מחפשים "Shlachli" ולוחצים Connect. אם עוד לא מופיע: Add custom connector עם הכתובת https://api.shlach.li/mcp.
  2. ChatGPT ושאר העוזרים. מוסיפים מחבר (connector) חדש עם אותה כתובת.
  3. התחברות. נפתח דף של שלח לי. נכנסים עם האימייל והסיסמה של שלח לי, בוחרים סביבת עבודה ולוחצים "אישור וחיבור". רק בעלים או מנהל של הסביבה יכולים לחבר, והחיבור זמין בחבילת אוטומציה.

מה העוזר יכול לעשות

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

בטיחות

ניתוק

כל חיבור מופיע בקונסולה, בעמוד חשבונות בכרטיס "חיבור ל-AI": איזו אפליקציה, מי חיבר ומתי הייתה פעילה לאחרונה. מנהל יכול לנתק כל חיבור, והניתוק תקף מיד.

In English. Shlachli's remote MCP server is https://api.shlach.li/mcp (Streamable HTTP; OAuth 2.0 with dynamic client registration and PKCE). Add it in Claude (Settings → Connectors) or any MCP client, sign in with a Shlachli account (workspace owner or admin, Automation plan) and choose a workspace. Its 37 tools cover conversations, message templates, mailing lists, campaigns, automations and number settings. Every send and delete is annotated destructive, campaigns need a separate confirmation call, and people who opted out are never messaged. Any connection can be revoked in the console under Accounts. Support: support@shlach.li · Privacy Policy.

התחלה מהירה

  1. מפתח API. בקונסולה: חשבונות ← הכרטיס "מפתח API" ← העתקה. המפתח זמין בחבילת אוטומציה, מכסה את כל המספרים שחיברתם, ושומרים אותו כמו סיסמה.
  2. הכתובת. https://api.shlach.li/v1
  3. הזדהות. בכל קריאה, כותרת Authorization: Bearer <המפתח>. גוף הבקשה והתשובה ב-JSON.

הקריאה הראשונה: מי אני ואילו מספרים יש לי.

curl https://api.shlach.li/v1/me \
  -H "Authorization: Bearer shl_XXXXXXXXXXXXXXXX"
{
  "numbers": [
    {"phone_number_id": "1333825483152494", "name": "המכבסה", "display_phone": "+1 555-486-8309",
     "waba_id": "2162258054695462", "status": "active", "label": "המכבסה · +1 555-486-8309"}
  ]
}

ואז שליחת תבנית מאושרת ללקוח:

curl -X POST https://api.shlach.li/v1/messages/template \
  -H "Authorization: Bearer shl_XXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"to": "050-1234567", "name": "דנה", "template": "order_ready|he", "params": ["דנה", "1042"]}'
{"ok": true, "message_id": "wamid.HBgLOTcy…", "to": "972501234567"}

מספרים

כל פעולה מתבצעת על מספר וואטסאפ אחד. מזהים אותו ב-phone_number_id, בגוף הבקשה (POST) או בשורת הכתובת (GET). אם חיברתם מספר אחד, אפשר להשמיט אותו. עם כמה מספרים ובלי לציין, תקבלו 400 עם רשימת המספרים לבחירה.

GET /v1/numbersרשימת המספרים שהמפתח רשאי לפעול עליהם. אותו מבנה כמו /v1/me.

תבניות

הודעה ראשונה ללקוח (מחוץ ל-24 שעות מההודעה האחרונה שלו) חייבת להיות תבנית ש-Meta אישרה. יוצרים אותה בקונסולה, בלשונית "תבניות". בכל מקום ב-API תבנית מזוהה כ-שם|שפה, למשל order_ready|he.

GET /v1/templatesהתבניות המאושרות של המספר, עם גוף ההודעה ושמות המשתנים.
GET /v1/templates/fields?template=order_ready|heאילו שדות התבנית צריכה (לכל משתנה: שם ותווית). בזה Make משתמשת כדי להציג משתנים בשמות.
GET /v1/templates
{"data": [
  {"name": "order_ready", "language": "he", "category": "UTILITY", "label": "order_ready (he)",
   "body": "שלום {{1}}, ההזמנה שלך מספר {{2}} מוכנה לאיסוף.",
   "variables": {"1": "שם הלקוח", "2": "מספר הזמנה"}}
]}

שליחת הודעות

POST /v1/messages/templateתבנית מאושרת. פותחת שיחה גם אם הלקוח לא כתב לכם.
POST /v1/messages/textהודעה חופשית. עובדת רק בתוך 24 שעות מההודעה האחרונה של הלקוח (כלל של Meta). אחרת תקבלו שגיאה ברורה ותשלחו תבנית.

שדות

שדהחובהמה זה
toכןהטלפון של הלקוח, בכל פורמט: 050-1234567, +972501234567, 972501234567.
nameלאשם הלקוח. נשמר באנשי הקשר ומוצג בשיחות.
templateלתבניתשם|שפה. אפשר גם template + language בנפרד.
paramsלפי התבניתערכי המשתנים של גוף ההודעה, לפי הסדר: רשימה ["דנה", "1042"], או אובייקט {"v1": "דנה", "v2": "1042"}.
headerאם ישערך למשתנה בכותרת התבנית, באותו מבנה.
textלהודעה חופשיתהטקסט.
phone_number_idעם כמה מספריםמאיזה מספר לשלוח.
POST /v1/messages/text
{"to": "0501234567", "text": "ההזמנה שלך מוכנה, אפשר לבוא לאסוף."}
{"ok": true, "message_id": "wamid.HBgLOTcy…", "to": "972501234567"}

// וכשזה לא מצליח (400):
{"ok": false, "error": "עברו יותר מ-24 שעות מההודעה האחרונה של הלקוח, אפשר לשלוח לו רק תבנית מאושרת ((#131047) Re-engagement message)"}

אנשי קשר ושיחות

GET /v1/contacts?q=דנה&limit=20חיפוש לפי שם או טלפון. בלי q: כולם, מהשיחה האחרונה.
GET /v1/contacts/get?phone=0501234567איש קשר אחד.
POST /v1/contactsיצירה או עדכון: {"phone", "name", "opted_out"}. opted_out: true מוציא מדיוורים.
GET /v1/messages?phone=0501234567&limit=20ההודעות עם לקוח אחד, מהחדשה לישנה.
GET /v1/contacts/get?phone=0501234567
{"phone": "972501234567", "name": "דנה כהן", "username": null, "unread": 1,
 "last_message_at": "2026-10-08T14:03:23+00:00", "last_inbound_at": "2026-10-08T14:03:23+00:00", "opted_out": false}

GET /v1/messages?phone=0501234567&limit=2
{"data": [
  {"message_id": "wamid.…", "direction": "in",  "type": "text", "text": "היי, אפשר לקבוע תור?", "status": "received", "at": "2026-10-08T14:03:23+00:00"},
  {"message_id": "wamid.…", "direction": "out", "type": "template", "text": "שלום דנה, ההזמנה…",  "status": "read",     "at": "2026-10-07T09:10:00+00:00"}
], "next_offset": 2}

דפדוף: עד 100 שורות לקריאה. כשיש עוד, התשובה כוללת next_offset; שולחים אותו חזרה כ-offset.

רשימות דיוור וקמפיינים

GET /v1/listsהרשימות של המספר: שם, משתנים (עמודות), כמות נמענים.
POST /v1/lists/membersהוספת נמען לרשימה (או עדכון): {"list_id", "phone", "name", "fields": {"מועד התור": "12.3 ב-10:00"}}. משתנה שלא קיים ברשימה נוסף אליה.
POST /v1/campaignsשליחת תבנית לכל הרשימה: {"list_id", "template": "שם|שפה", "scheduled_at": "2026-10-09T08:00:00+03:00"}. בלי scheduled_at: עכשיו. המשתנים מתמלאים לפי שם מהעמודות של הרשימה.
POST /v1/campaigns
{"id": 12, "total": 140, "scheduled": false}

מצב המספר

GET /v1/accountמה ש-Meta אומרת על המספר: מגבלת שיחות חדשות ב-24 שעות, דירוג איכות, קצב.
{"name": "המכבסה", "status": "active", "messaging_limit": 1000, "quality": "GREEN", "throughput": "STANDARD"}

הודעות נכנסות (webhook יוצא)

רוצים שהמערכת שלכם תדע מיד כשלקוח כותב? רושמים כתובת, ושלח לי שולחת אליה POST על כל הודעה נכנסת. ב-Make זה המודול "Watch Incoming Messages", והרישום קורה לבד.

POST /v1/webhooks{"url": "https://…"}. רק https ציבורי. מחזיר {"id"}.
DELETE /v1/webhooks/{id}ביטול.

מה מגיע לכתובת שלכם:

POST https://your-system.example/whatsapp
{"event": "message.received", "phone_number_id": "1333825483152494",
 "wa_id": "972501234567", "name": "דנה כהן", "username": null,
 "type": "text", "text": "היי, אפשר לקבוע תור למחר?",
 "message_id": "wamid.HBgLOTcy…", "received_at": "2026-10-08T14:03:23+00:00"}

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

אוטומציה נכנסת: הדרך בלי קוד

זה הכיוון ההפוך: המערכת שלכם שולחת לנו פרטים של לקוח, ואנחנו שולחים לו הודעה. בקונסולה, בלשונית אוטומציות, יוצרים אוטומציה ומקבלים כתובת פרטית בסגנון https://hooks.shlach.li/h/….

  1. מדביקים את הכתובת במערכת שממנה מגיעים הלקוחות (Wix, Elementor, Fillout, Make, Zapier, CRM) במקום שבו היא מבקשת "Webhook". ל-Google Forms יש תוסף רשמי בחנות Google Workspace: מתקינים, מדביקים את הכתובת, וזהו.
  2. כשהלקוח הראשון מגיע, הפרטים שלו מופיעים בקונסולה. בוחרים איזו תבנית לשלוח ומה נכנס בכל משתנה. פעם אחת.
  3. מרגע זה, כל לקוח שמגיע לכתובת מקבל את ההודעה שלו אוטומטית.

מה אפשר לשלוח לכתובת: POST עם JSON (גם מקונן), POST עם שדות טופס, או GET עם פרמטרים. אין צורך במפתח: הכתובת עצמה היא הסוד.

curl -X POST "https://hooks.shlach.li/h/XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"phone": "0501234567", "name": "דנה", "date": "מחר ב-10:00"}'
{"ok": true, "status": "sent", "info": null, "message_id": "wamid.…"}

// לפני שבחרתם הודעה בקונסולה:
{"ok": true, "status": "learning", "info": "עדיין לא נבחרה הודעה", "message_id": null}

// כשלא נשלח (400), למשל טלפון חסר:
{"ok": false, "status": "failed", "info": "לא נמצא מספר טלפון בפרט \"phone\"", "message_id": null}

שגיאות וגבולות

קודמתי
400בקשה לא תקינה, או ש-Meta סירבה לשלוח. השדה error מסביר בעברית, ובסוגריים ההודעה המקורית של Meta.
401מפתח חסר או לא תקין.
404איש קשר, רשימה או נתיב שלא קיימים.
429יותר מ-120 קריאות בדקה מאותו מפתח. מחכים דקה.

האפליקציה ב-Make

במקום לכתוב קוד: מתקינים את האפליקציה "Shlachli" ב-Make, מתחברים עם מפתח ה-API פעם אחת, ומשתמשים במודולים בכל סצנריו.

התקנת Shlachli ב-Make

מודולמה הוא עושה
Watch Incoming Messagesטריגר מיידי: לקוח כתב לכם. מקבלים טלפון, שם, טקסט.
Send a Template Messageבוחרים תבנית מרשימה, ממלאים את המשתנים בשמות שלהם.
Send a Text Messageהודעה חופשית בתוך חלון 24 השעות.
Send a Customer to an Automationבלי חיבור: מדביקים כתובת אוטומציה ושולחים טלפון, שם ופרטים.
Search Contacts / Get a Contact / Create or Update a Contactאנשי קשר.
List Messages of a Conversationההודעות עם לקוח.
Add a Contact to a Mailing List / Send a Template to a Mailing Listרשימות וקמפיינים, עכשיו או מתוזמן.
Get Number Statusמגבלה, איכות, קצב.
Make an API Callכל נתיב אחר מהעמוד הזה.

שגיאות של Meta מופיעות ב-Make בעברית, בדיוק כמו ב-API. שאלות: support@shlach.li.

שותפים: הלקוחות שלכם מתחברים מהמערכת שלכם

בחבילת שותף, הלקוחות שלכם מחברים את הוואטסאפ שלהם מתוך המערכת שלכם, ו-Meta שולחת את ההודעות של המספרים שלהם ישירות לשרת שלכם, בלי לעבור דרכנו. אתם מקבלים את הטוקן של כל לקוח, ורק של הלקוחות שלכם. המדריך המלא, צעד אחר צעד: shlach.li/partners.

  1. כתובת השרת. בקונסולה: הגדרות ← שותף. לפני השמירה אנחנו בודקים את השרת כמו ש-Meta בודקת: בקשת GET עם hub.mode=subscribe, hub.verify_token (מוצג בכרטיס) ו-hub.challenge, שהשרת מחזיר כמו שהוא. כדאי שבכתובת יהיה חלק ארוך ואקראי. עד 200 תווים.
  2. קישור לכל לקוח. המערכת שלכם מבקשת קישור ופותחת אותו ללקוח בחלון, ישר על פייסבוק. הקישור תקף לשעה ולחיבור אחד.
  3. בסיום. הדף שולח לחלון שפתח אותו postMessage מסוג SHLACHLI_SIGNUP, ואם אין חלון כזה הוא חוזר ל-return_url עם אותם פרטים. בלי טוקן. את הטוקן מושכים ב-API.
POST /v1/signup-links{"ref", "name", "return_url"}. ref הוא המזהה של הלקוח אצלכם, name הוא שם הלקוח לזיהוי אצלכם (ref_name). מחזיר {"url", "ref", "expires_in"}.
GET /v1/partner/numbers?ref=המספרים שלכם, לכל אחד token, ref, לאן הוובהוקים שלו נשלחים (webhook) ומצב ההיסטוריה מהאפליקציה (history).
curl -X POST https://api.shlach.li/v1/signup-links \
  -H "Authorization: Bearer shl_XXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"ref": "customer-1042", "name": "מספרת דנה", "return_url": "https://your-system.example/whatsapp/done"}'
{"url": "https://www.facebook.com/v24.0/dialog/oauth?…&state=shs_…", "ref": "customer-1042", "expires_in": 3600}

// בחלון שפתח את הקישור, בסיום:
window.addEventListener("message", e => {
  if (e.origin === "https://app.shlach.li" && e.data.type === "SHLACHLI_SIGNUP")
    console.log(e.data.ref, e.data.phone_number_id, e.data.waba_id);  // status: "connected"
});