API של מייבל לעסקים

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

התחלה

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

Authorization: Bearer mabel_...

המפתח שייך לשרת שלכם, לא לדפדפן. לצ'אט באתר משתמשים בשורת הצ'אט מאתר הניהול, שלא צריכה מפתח.

הרשאות

הרשאהמה היא מאפשרת
askלשאול את מייבל שאלה של לקוח, והיא עונה מהידע של העסק
leadsלקרוא לידים ולהוסיף ליד
appointmentsלקרוא את התורים שמייבל קבעה
actionsלשאול אם פעולה מותרת לפי המדיניות של העסק, ולבדוק אם מנהל אישר
summaryלקבל את הסיכום של 24 השעות האחרונות

נתיבים

POST /api/v1/ask

שאלה של לקוח. אפשר לשלוח question אחת, או messages עם השיחה עד עכשיו.

curl -X POST https://YOUR-SERVER/api/v1/ask \
  -H "Authorization: Bearer mabel_..." \
  -d '{"question": "מה שעות הפתיחה?"}'

{ "reply": "ראשון עד חמישי 8:00 עד 19:00...", "actions": [] }

GET /api/v1/leads

עד 200 הלידים האחרונים, מהחדש לישן.

{ "leads": [ { "id": "aB3x", "at": "2026-10-06T07:40:00Z", "name": "דנה", "phone": "0501234567",
               "need": "צבע", "channel": "phone", "consent": true, "called": null, "handled": null } ] }

POST /api/v1/leads

מוסיף ליד. צריך name או phone. את consent מסמנים true רק אם הלקוח באמת הסכים שיחזרו אליו.

{ "name": "דנה", "phone": "0501234567", "need": "צבע לשיער", "consent": true }

GET /api/v1/appointments

{ "appointments": [ { "id": "Q9s1", "name": "יעל", "phone": "0521112222", "when": "מחר ב-10:00",
                      "reason": "ניקוי אבנית", "channel": "phone", "status": "confirmed" } ] }

POST /api/v1/actions/check

לפני שמערכת שלכם עושה משהו בשם העסק, היא שואלת את מייבל. התשובה היא allowed, needs_approval (עם requestId) או blocked. הוצאת כסף אף פעם לא allowed.

{ "action": "give_discount", "detail": "10% ללקוח קבוע" }

{ "decision": "needs_approval", "requestId": "k2Jd81xQ" }

POST /api/v1/actions/status

{ "requestId": "k2Jd81xQ" }

{ "status": "approved", "by": "מיכל" }

GET /api/v1/summary

{ "text": "ב-24 השעות האחרונות היו 3 פניות של לקוחות...", "counts": { "asks": 3, "leads": 2, ... } }

התראות (webhooks)

באתר הניהול מוסיפים כתובת https ובוחרים אירועים. מייבל שולחת POST לכל אירוע, ולא מחכה לתשובה.

אירועמתי
lead.createdנכנס ליד חדש (טלפון, אתר, API או ידני)
appointment.confirmedמייבל קבעה תור
request.pendingפעולה מחכה לאישור מנהל
request.decidedמנהל אישר או דחה
POST https://your-system/hook
x-mabel-signature: 5f2c...   (HMAC-SHA256 של גוף הבקשה, עם הסוד שקיבלתם)

{ "event": "lead.created", "at": "2026-10-06T07:40:00Z", "company": "קליניקת חיוך",
  "data": { "id": "aB3x", "name": "דנה", "phone": "0501234567", "need": "הלבנה", "channel": "phone", "consent": true } }

בדיקת החתימה ב-Node:

const ok = crypto.createHmac('sha256', SECRET).update(rawBody).digest('hex') === req.headers['x-mabel-signature'];

דוגמה: סוכן ElevenLabs שמבקש רשות ממייבל

סוכן קולי של ElevenLabs יכול לעבוד תחת המדיניות של העסק: לפני שהוא נותן הנחה או קובע משהו, הוא שואל את מייבל. ב-ElevenLabs מוסיפים לסוכן כלי מסוג Webhook:

שדהערך
Nameask_mabel_permission
Method · URLPOST https://YOUR-SERVER/api/v1/actions/check
HeadersAuthorization: Bearer mabel_... (כ-Secret של ElevenLabs, עם מפתח שיש לו רק הרשאת actions)
Body parametersaction (למשל give_discount), detail

ובהנחיות של הסוכן: "לפני הנחה או התחייבות ללקוח, קרא ל-ask_mabel_permission. אם התשובה needs_approval, אמור ללקוח שהצוות יאשר ויחזור אליו. אם blocked, אל תעשה את זה." כך כל הסוכנים של העסק עובדים לפי אותם כללים, וכל בקשה נרשמת ביומן של מייבל.

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

קודמתי
401אין מפתח, או שהוא בוטל
403למפתח אין את ההרשאה לנתיב הזה
429יותר מ-60 בקשות בדקה לאותו מפתח
400בקשה לא תקינה. הסיבה בשדה error

כל פעולה דרך ה-API נרשמת ביומן הפעולות של העסק בשם המפתח.