API ואוטומציות
כל מה שהקונסולה של שלח לי יודעת לעשות, אפשר לעשות גם מבחוץ: מצ'אט עם Claude או ChatGPT, מהאתר, ממערכת התורים, מה-CRM, מ-Make, או מקוד שמתכנת/ת כותבים. ארבע דרכים, מהקלה לגמישה.
1. עוזר AI: Claude או ChatGPT
מחברים פעם אחת וכותבים בשפה רגילה: "מי כתב לנו היום?", "תשלח תזכורת לכל מי שברשימה של מחר". העוזר עושה את זה בשלח לי, ומבקש אישור לפני כל שליחה.
איך מחברים2. אוטומציה נכנסת, בלי קוד
יוצרים אוטומציה בקונסולה, מקבלים כתובת, ומדביקים אותה באתר, בטופס או ב-CRM. כל לקוח שמגיע לכתובת מקבל הודעה. בלי מפתחות ובלי מתכנתים.
איך זה עובד3. האפליקציה ב-Make
מודולים מוכנים: שליחת תבנית, הודעה חופשית, אנשי קשר, רשימות, קמפיין, וטריגר "לקוח כתב". מתחברים עם מפתח API פעם אחת.
התקנה ב-Make4. ה-API
REST פשוט עם JSON, מפתח אחד לכל המספרים שלכם, תשובות ושגיאות בעברית. כל הנתיבים מתועדים כאן עם דוגמאות.
התחלה מהירהחיבור ל-Claude, ל-ChatGPT ולעוזרי AI
שלח לי מתחבר לעוזרי AI דרך MCP, התקן הפתוח לחיבור כלים לעוזרים. אחרי החיבור כותבים לעוזר כמו לעובד: "מי כתב לנו היום ועוד לא קיבל תשובה?", "הנה האקסל של התורים למחר, תשלח לכל אחד תזכורת עם השעה שלו", "תכין תבנית למבצע של 20% ותשלח לאישור". הוא עושה את זה בשלח לי, על המספרים והרשימות שלכם.
- Claude. בהגדרות ← Connectors מחפשים "Shlachli" ולוחצים Connect. אם עוד לא מופיע: Add custom connector עם הכתובת
https://api.shlach.li/mcp. - ChatGPT ושאר העוזרים. מוסיפים מחבר (connector) חדש עם אותה כתובת.
- התחברות. נפתח דף של שלח לי. נכנסים עם האימייל והסיסמה של שלח לי, בוחרים סביבת עבודה ולוחצים "אישור וחיבור". רק בעלים או מנהל של הסביבה יכולים לחבר, והחיבור זמין בחבילת אוטומציה.
מה העוזר יכול לעשות
| תחום | הכלים |
|---|---|
| שיחות | חיפוש אנשי קשר, קריאת שיחה, סימון כנקרא, הודעה חופשית, שליחת תבנית, שמירת איש קשר |
| תבניות | רשימת התבניות וסטטוס האישור, יצירה ושליחה לאישור של Meta, תבניות מוכנות של Meta, שמות למשתנים, מחיקה |
| רשימות דיוור | יצירה, צפייה, ייבוא מאקסל / CSV עם יישוב התנגשויות, הוספה מאנשי הקשר, הוספה ועריכה של נמען, שינוי שם ועמודות, הסרה, מחיקה |
| קמפיינים | שליחה לרשימה עכשיו או בזמן מתוזמן, רשימת הקמפיינים והתוצאות, עצירה |
| אוטומציות | יצירה, הגדרה (תבנית, טלפון, משתנים), היסטוריית קריאות, בדיקה, מחיקה |
| המספר והעסק | המספרים המחוברים, דירוג איכות ומגבלות, הגדרות הסרה וקצב שליחה, הפרופיל העסקי שהלקוחות רואים |
בטיחות
- כל שליחה וכל מחיקה מסומנות כפעולה שדורשת אישור, ולכן העוזר שואל לפני שהן רצות.
- קמפיין עובר בשני שלבים: קודם תצוגה מקדימה (כמה נמענים ואיך ההודעה תיראה אצל הראשון), ושליחה רק בקריאה שנייה עם קוד האישור.
- מי שביקש להפסיק לקבל הודעות (למשל כתב "הסר") לא מקבל אף הודעה.
- הודעות שלקוחות כתבו מגיעות לעוזר כמידע, לא כהוראות.
- הכללים של וואטסאפ חלים כרגיל: הודעה חופשית רק בתוך 24 שעות מההודעה האחרונה של הלקוח, אחרת תבנית מאושרת. Meta מחייבת על ההודעות ישירות בחשבון של העסק.
ניתוק
כל חיבור מופיע בקונסולה, בעמוד חשבונות בכרטיס "חיבור ל-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.
התחלה מהירה
- מפתח API. בקונסולה: חשבונות ← הכרטיס "מפתח API" ← העתקה. המפתח זמין בחבילת אוטומציה, מכסה את כל המספרים שחיברתם, ושומרים אותו כמו סיסמה.
- הכתובת.
https://api.shlach.li/v1 - הזדהות. בכל קריאה, כותרת
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/….
- מדביקים את הכתובת במערכת שממנה מגיעים הלקוחות (Wix, Elementor, Fillout, Make, Zapier, CRM) במקום שבו היא מבקשת "Webhook". ל-Google Forms יש תוסף רשמי בחנות Google Workspace: מתקינים, מדביקים את הכתובת, וזהו.
- כשהלקוח הראשון מגיע, הפרטים שלו מופיעים בקונסולה. בוחרים איזו תבנית לשלוח ומה נכנס בכל משתנה. פעם אחת.
- מרגע זה, כל לקוח שמגיע לכתובת מקבל את ההודעה שלו אוטומטית.
מה אפשר לשלוח לכתובת: 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 קריאות בדקה מאותו מפתח. מחכים דקה. |
- עד 100 שורות לכל קריאת רשימה, עם דפדוף ב-
offset. - עד 120 קריאות בדקה למפתח.
- הודעות חופשיות רק בתוך 24 שעות מההודעה האחרונה של הלקוח. תבניות תמיד.
- Meta מחייבת על ההודעות בנפרד, ישירות בחשבון Meta של העסק. ה-API לא משנה את זה.
האפליקציה ב-Make
במקום לכתוב קוד: מתקינים את האפליקציה "Shlachli" ב-Make, מתחברים עם מפתח ה-API פעם אחת, ומשתמשים במודולים בכל סצנריו.
| מודול | מה הוא עושה |
|---|---|
| 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.
- כתובת השרת. בקונסולה: הגדרות ← שותף. לפני השמירה אנחנו בודקים את השרת כמו ש-Meta בודקת: בקשת GET עם
hub.mode=subscribe,hub.verify_token(מוצג בכרטיס) ו-hub.challenge, שהשרת מחזיר כמו שהוא. כדאי שבכתובת יהיה חלק ארוך ואקראי. עד 200 תווים. - קישור לכל לקוח. המערכת שלכם מבקשת קישור ופותחת אותו ללקוח בחלון, ישר על פייסבוק. הקישור תקף לשעה ולחיבור אחד.
- בסיום. הדף שולח לחלון שפתח אותו
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"
});
- מה מגיע לשרת שלכם: הודעות נכנסות, סטטוסים, הודעות שהעסק שלח מהאפליקציה בטלפון, אנשי קשר והיסטוריה. בפורמט של Meta, כמו שהוא. אישורי תבניות ועדכוני חשבון ממשיכים להגיע אלינו.
- החתימה
X-Hub-Signature-256של Meta נעשית עם הסוד של האפליקציה שלנו, ולכן היא לא בשבילכם. האבטחה היא הכתובת הסודית. - מספר שמחובר גם לאפליקציה בטלפון: את אנשי הקשר וההיסטוריה Meta שולחת פעם אחת. אנחנו מבקשים אותם רק אחרי שהמספר מופנה לשרת שלכם והשרת עונה. אם משהו נכשל, אפשר לבקש שוב מהכרטיס עד 24 שעות מהחיבור.
- קבצים: מורידים עם הטוקן של הלקוח (
Authorization: Bearer). מזהה הקובץ בתוקף 7 ימים אצל Meta, אז שומרים אותו מיד.
שלח