פונקציות זמינות (Available Functions)

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

15
פונקציות זמינות
5
קטגוריות
30+
פרמטרים
100%
תיעוד מלא

פונקציות לקוחות (Customer)

get_customer_info לקוחות
פעיל

מחזיר מידע מפורט על לקוח לפי מזהה או מספר טלפון.

פרמטרים:
שם סוג חובה תיאור
customer_id integer לא מזהה הלקוח במערכת
phone string לא מספר טלפון של הלקוח
דוגמת קריאה:
{ "function": "get_customer_info", "parameters": { "phone": "0501234567" } }
דוגמת תגובה:
{ "success": true, "customer": { "id": 123, "name": "ישראל ישראלי", "phone": "0501234567", "email": "israel@example.com", "balance": 1500.00, "total_purchases": 45000.00, "open_repairs": 2, "created_at": "2023-01-15" } }
get_customer_balance לקוחות
פעיל

מחזיר יתרת חוב/זכות של לקוח כולל פירוט חשבוניות פתוחות.

פרמטרים:
שם סוג חובה תיאור
customer_id integer לא מזהה הלקוח
phone string לא מספר טלפון
דוגמת תגובה:
{ "success": true, "balance": { "customer_name": "ישראל ישראלי", "total_balance": 2500.00, "open_invoices": [ {"id": 1001, "amount": 1500.00, "date": "2024-11-01"}, {"id": 1002, "amount": 1000.00, "date": "2024-11-15"} ], "last_payment": { "amount": 500.00, "date": "2024-11-20" } } }
search_customers לקוחות
פעיל

חיפוש לקוחות לפי שם, טלפון, אימייל או כל שדה אחר.

פרמטרים:
שם סוג חובה תיאור
query string כן מחרוזת חיפוש
limit integer לא מספר תוצאות מקסימלי (ברירת מחדל: 10)

פונקציות חשבוניות (Invoice)

get_invoice_details חשבוניות
פעיל

מחזיר פרטים מלאים של חשבונית כולל פריטים ותשלומים.

פרמטרים:
שם סוג חובה תיאור
invoice_id integer כן מזהה/מספר החשבונית
דוגמת תגובה:
{ "success": true, "invoice": { "id": 12345, "customer": {"id": 123, "name": "ישראל ישראלי"}, "date": "2024-11-20", "due_date": "2024-12-20", "status": "pending", "subtotal": 1000.00, "vat": 170.00, "total": 1170.00, "items": [ {"name": "מוצר א", "qty": 2, "price": 500.00} ], "payments": [] } }
search_invoices חשבוניות
פעיל

חיפוש חשבוניות לפי קריטריונים שונים (לקוח, תאריך, סטטוס).

פרמטרים:
שם סוג חובה תיאור
customer_id integer לא סינון לפי לקוח
status string לא סינון לפי סטטוס (pending/paid/cancelled)
from_date string לא מתאריך (YYYY-MM-DD)
to_date string לא עד תאריך (YYYY-MM-DD)
get_open_invoices חשבוניות
פעיל

מחזיר רשימת חשבוניות פתוחות (לא שולמו) עם אפשרות סינון לפי לקוח.

פרמטרים:
שם סוג חובה תיאור
customer_id integer לא סינון לפי לקוח ספציפי
limit integer לא מספר תוצאות (ברירת מחדל: 20)

פונקציות תיקונים (Repair)

get_repair_status תיקונים
פעיל

בדיקת סטטוס תיקון לפי מספר תיקון או מספר טלפון של הלקוח.

פרמטרים:
שם סוג חובה תיאור
repair_id string לא מספר תיקון (פורמט: R-YYYY-NNN)
phone string לא טלפון הלקוח לחיפוש תיקונים
דוגמת תגובה:
{ "success": true, "repair": { "id": "R-2024-001", "customer": {"name": "ישראל ישראלי", "phone": "0501234567"}, "device": "iPhone 14 Pro", "issue": "מסך שבור", "status": "in_progress", "status_text": "בתיקון", "received_date": "2024-11-20", "estimated_completion": "2024-11-25", "technician": "משה כהן", "cost_estimate": 850.00 } }
get_repair_queue תיקונים
פעיל

מחזיר את תור התיקונים הנוכחי עם אפשרות סינון לפי סטטוס.

פרמטרים:
שם סוג חובה תיאור
status string לא סינון: pending/in_progress/ready/completed
technician_id integer לא סינון לפי טכנאי
search_repairs תיקונים
פעיל

חיפוש תיקונים לפי לקוח, מכשיר או תאריכים.

פרמטרים:
שם סוג חובה תיאור
customer_id integer לא מזהה לקוח
device string לא חיפוש לפי שם מכשיר

פונקציות מלאי (Inventory)

check_inventory מלאי
פעיל

בדיקת מלאי למוצר ספציפי או קטגוריה.

פרמטרים:
שם סוג חובה תיאור
product_id integer לא מזהה מוצר
sku string לא מק"ט מוצר
name string לא חיפוש לפי שם
דוגמת תגובה:
{ "success": true, "product": { "id": 456, "sku": "IP15PM-256-BLK", "name": "iPhone 15 Pro Max 256GB Black", "quantity": 12, "min_quantity": 5, "status": "in_stock", "price": 5999.00, "cost": 4500.00, "location": "מדף A-12" } }
get_low_stock מלאי
פעיל

מחזיר רשימת מוצרים עם מלאי נמוך מהמינימום המוגדר.

פרמטרים:
שם סוג חובה תיאור
category string לא סינון לפי קטגוריה
limit integer לא מספר תוצאות (ברירת מחדל: 20)
get_product_price מלאי
פעיל

מחזיר מחיר מוצר כולל מבצעים פעילים.

פרמטרים:
שם סוג חובה תיאור
product_id integer לא מזהה מוצר
sku string לא מק"ט מוצר

פונקציות אנליטיקס (Analytics)

get_daily_summary אנליטיקס
פעיל

מחזיר סיכום יומי: מכירות, לקוחות חדשים, תיקונים וכו'.

פרמטרים:
שם סוג חובה תיאור
date string לא תאריך (YYYY-MM-DD), ברירת מחדל: היום
דוגמת תגובה:
{ "success": true, "summary": { "date": "2024-11-24", "sales": { "count": 15, "total": 25000.00, "average": 1666.67 }, "customers": { "new": 3, "returning": 12 }, "repairs": { "received": 8, "completed": 5, "pending": 23 }, "top_products": [ {"name": "iPhone 15", "quantity": 4} ] } }
get_sales_report אנליטיקס
פעיל

דוח מכירות לטווח תאריכים עם פילוח לפי קטגוריות.

פרמטרים:
שם סוג חובה תיאור
from_date string לא מתאריך (ברירת מחדל: תחילת החודש)
to_date string לא עד תאריך (ברירת מחדל: היום)
group_by string לא קיבוץ: day/week/month/category
get_top_customers אנליטיקס
פעיל

מחזיר רשימת הלקוחות המובילים לפי סכום רכישות.

פרמטרים:
שם סוג חובה תיאור
limit integer לא מספר לקוחות להציג (ברירת מחדל: 10)
period string לא תקופה: month/quarter/year/all
תהליך קריאת פונקציה
# 1. זיהוי כוונה מההודעה intent = service.detect_intent("מה היתרה של 0501234567?") # {'intent': 'CUSTOMER_BALANCE', 'confidence': 0.9} # 2. חילוץ ישויות entities = service.extract_entities("מה היתרה של 0501234567?") # {'phone': '0501234567'} # 3. בחירת פונקציה מתאימה function = service.select_function(intent) # 'get_customer_balance' # 4. הפעלת הפונקציה result = service.execute_function(function, entities) # {'success': True, 'balance': {...}} # 5. עיצוב תגובה בעברית response = service.format_response(result) # "יתרת הלקוח ישראל ישראלי: 2,500 ₪"