תיעוד למפתחים

#מה OneLi עושה

OneLi מבצעת שיחות טלפון יוצאות בעברית בשביל סוכן ה־AI שלכם. הסוכן (Claude,‏ ChatGPT או קוד שכתבתם) שולח משימה: למי להתקשר ומה המטרה. סוכנת קולית בעברית מחייגת למספר ישראלי, מנהלת את השיחה, יכולה להתייעץ עם הסוכן שלכם באמצע השיחה כשצריך החלטה, מקבלת הנחיות חדשות תוך כדי, ובסוף מחזירה תמלול, סיכום ותוצאה.

• שיחות יוצאות בלבד, למספרים ישראליים (נייד, קווי ו־07X).
• השיחה מתנהלת בעברית. הסוכנת מציגה את עצמה כעוזרת דיגיטלית.
• החיוב לפי שניות שיחה מחוברות. שיחה שלא נענתה ותא קולי לא נספרים.

#שתי דרכים להתחבר

#שיחה ראשונה בשלוש דקות

1. נכנסים ל־oneli.io/app/connect, בכרטיס מפתחות API יוצרים מפתח ומעתיקים אותו. הוא מוצג פעם אחת בלבד.
2. שולחים משימת שיחה. בשיחת הבדיקה הראשונה כדאי לחייג למספר הנייד שלכם, במקום 05XXXXXXXX:

export ONELI_API_KEY="oli_..."   # oneli.io/app/connect → API keys (shown once)

curl -X POST https://api.oneli.io/v1/call-tasks \
  -H "Authorization: Bearer $ONELI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "idempotency_key": "quickstart-001",
    "to_number": "05XXXXXXXX",
    "goal": "לברר אם יש תור לתספורת ביום חמישי אחרי 17:00",
    "constraints": { "max_price_ils": 120 }
  }'

התשובה מגיעה מיד, והשיחה נכנסת לתור:

HTTP/1.1 201 Created

{
  "task": {
    "id": "task_44be8f8d43da4748",
    "status": "queued",
    "to_number": "972501234567",
    "goal": "לברר אם יש תור לתספורת ביום חמישי אחרי 17:00",
    "constraints": { "max_price_ils": 120 },
    "revision": 1,
    "not_before": "2026-10-22T09:14:03.120Z",
    "created_at": "2026-10-22T09:14:03.120Z"
  },
  "created": true
}

3. עוקבים אחרי השיחה: התמלול, ההתייעצויות וסיום השיחה מגיעים כאירועים.

curl "https://api.oneli.io/v1/call-tasks/task_44be8f8d43da4748/events?after=0" \
  -H "Authorization: Bearer $ONELI_API_KEY"

4. כשהסטטוס הוא completed, קוראים את התוצאה והסיכום:

curl https://api.oneli.io/v1/call-tasks/task_44be8f8d43da4748 \
  -H "Authorization: Bearer $ONELI_API_KEY"

# → "status": "completed", "outcome": "goal_achieved",
#   "summary": "נקבע תור ליום חמישי ב-17:30, 90 ש״ח."

#איך שיחה מתנהלת

1. משימההסוכן יוצר משימה עם to_number,‏ goal והנחיות. סטטוס queued.
2. חיוגOneLi מחייגת (dispatching) והשיחה מתחברת (active). קו תפוס או אין מענה: עוד שני ניסיונות, אחרי 5 ואחרי 15 דקות.
3. התייעצותכשנדרשת החלטה, למשל מחיר מעל התקרה, הסוכנת שואלת את הסוכן שלכם ומחכה כמה שניות לתשובה.
4. הנחיותאפשר לשלוח הנחיה חדשה בזמן השיחה. היא משפיעה מהתור הבא של הסוכנת.
5. תוצאהבסיום: outcome,‏ summary, משך ועלות, והתמלול המלא באירועים.

#מה הלאה

• תרחישי שימוש: מה סוכנים עושים עם OneLi, עם דוגמאות.
• REST API ומפתחות: מחזור החיים המלא של שיחה בקוד.
• אינטגרציות: Mastra, OpenAI Agents SDK, LangChain, n8n ועוד.
• Webhook להחלטות: מענה אוטומטי להתייעצויות.
• מדריך עזר · שגיאות ומגבלות