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:
| שדה | ערך |
|---|---|
| Name | ask_mabel_permission |
| Method · URL | POST https://YOUR-SERVER/api/v1/actions/check |
| Headers | Authorization: Bearer mabel_... (כ-Secret של ElevenLabs, עם מפתח שיש לו רק הרשאת actions) |
| Body parameters | action (למשל give_discount), detail |
ובהנחיות של הסוכן: "לפני הנחה או התחייבות ללקוח, קרא ל-ask_mabel_permission. אם התשובה needs_approval, אמור ללקוח שהצוות יאשר ויחזור אליו. אם blocked, אל תעשה את זה." כך כל הסוכנים של העסק עובדים לפי אותם כללים, וכל בקשה נרשמת ביומן של מייבל.
שגיאות ומגבלות
| קוד | מתי |
|---|---|
401 | אין מפתח, או שהוא בוטל |
403 | למפתח אין את ההרשאה לנתיב הזה |
429 | יותר מ-60 בקשות בדקה לאותו מפתח |
400 | בקשה לא תקינה. הסיבה בשדה error |
כל פעולה דרך ה-API נרשמת ביומן הפעולות של העסק בשם המפתח.