GetMeetingList - רשימת פגישות

שליפת רשימת פגישות עם פילטרים לפי תאריך, סטטוס וסניף, כולל פרטי הלקוח והנציג. עונה על "תן לי את כל הפגישות של השבוע".

שליפת רשימת פגישות (leads_meetings) עם פילטרים אופציונליים. כל פגישה בתשובה כוללת את פרטי הלקוח המקושר (שם, טלפון, עיר, כתובת), הנציג המשויך, הסטטוס והסניף. דורש חבילת Premium/Pro.

POST https://YOUR-SUBDOMAIN.taskey.co.il/webapi/GetMeetingList.php
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

🔒 דורש אימות: Authorization: Bearer תקין + חבילת Premium/Pro. ראו אימות.

פרמטרים (כולם אופציונליים)

שדה	תיאור	דוגמה
`start_date`	תאריך הפגישה - יום בודד, או תחילת טווח כשנשלח גם `end_date`. מקבל תאריך או מילת מפתח	`today`
`end_date`	סוף טווח החיפוש (נשלח יחד עם `start_date`)	`31/08/2026`
`status_id`	רק פגישות בסטטוס מסוים (ID)	`3`
`branch_id`	רק פגישות של סניף / יומן מסוים	`2`
`include_deleted`	`1` = לכלול גם פגישות שבוטלו (ברירת מחדל: פעילות בלבד)	`1`
`limit`	כמות תוצאות בעמוד (עד 50; ללא הפרמטר מוחזרות עד 100)	`50`
`page`	מספר עמוד (מתחיל מ-1) - לדפדוף כשיש יותר תוצאות מה-limit	`2`
`offset`	דילוג על X תוצאות (חלופה ל-`page`; מנצח אם נשלחו שניהם)	`50`

מילות מפתח לתאריכים: today, tomorrow, yesterday, week (השבוע), next_week, last_week, month (החודש), next_month, last_month, last_7_days, last_30_days - או תאריך מדויק (25/08/2026). ללא start_date מוחזרות כל הפגישות.

דוגמת בקשה - כל הפגישות של השבוע בסטטוס מסוים

{
  "start_date": "week",
  "status_id": 3
}

דוגמת בקשה - טווח תאריכים עם דפדוף

{
  "start_date": "01/09/2026",
  "end_date": "30/09/2026",
  "limit": 50,
  "page": 2
}

מבנה התשובה

{
  "status_code": 200,
  "total_rows": 1,
  "total_count": 34,
  "limit": 50,
  "offset": 0,
  "page": 1,
  "total_pages": 1,
  "has_more": false,
  "next_page": null,
  "meetings": [
    {
      "meeting_id": "4400",
      "meeting_title": "פגישת היכרות",
      "meeting_body": "פגישה ראשונה בסניף",
      "meeting_summary": "",
      "follow_id": "12345",
      "customer_name": "ישראל ישראלי",
      "customer_phone": "0501234567",
      "status": "3",
      "status_name": "בטיפול",
      "user_id": "4",
      "user_name": "דנה כהן",
      "user_phone": "0521234567",
      "meeting_format": "",
      "active": 1,
      "all_day": 0,
      "start_date": "25/08/2026",
      "start_date_time": "11:00",
      "end_date": "25/08/2026",
      "end_date_time": "11:30",
      "add_date": "20/08/2026",
      "add_date_time": "09:15",
      "city": "תל אביב",
      "address": "הרצל 10",
      "branches_id": 2,
      "branch_name": "סניף מרכז",
      "last_change_status_date": 1756100000,
      "last_change_status_date_fmt": "25/08/2026 09:33",
      "google_cal_evnt_id": "",
      "last_google_sync": "0"
    }
  ]
}

total_rows - כמות השורות שחזרו בעמוד הנוכחי; total_count - סך כל הפגישות התואמות.
דפדוף: כש-has_more הוא true - שלחו את אותה בקשה עם page: next_page לקבלת העמוד הבא.
הפגישות ממוינות לפי מועד ההתחלה, מהמוקדמת למאוחרת.
active: 0 = פגישה שבוטלה (מופיעה רק עם include_deleted: 1).

💡 להוספת פגישה ראו AddMeeting. לעדכון ראו UpdateMeeting. לביטול ראו CancelMeeting. לרשימת סטטוסי הפגישות - GetMeetingStatus.php (ראו נתוני עזר).