שאילתות והקלטות

services לשליפת נתוני שיחות (CDR), הורדת הקלטה בודדת, קבלת מטא-דאטה, יצירת רשומת שיחה ידנית וניהול המרות אופליין ל-Google Ads.

---

cdr_query

שליפת נתוני שיחות לפי שאילתה שאתם בונים. ה-service מקבל שאילתה קריאה (SELECT בלבד) על מאגר הנתונים הפומבי של החשבון ומחזיר את התוצאות ב-JSON או XML.

Endpoint: /api/?service=cdr_query

דרישות

פונקציה זו דורשת היכרות בסיסית עם שפת SQL.

כללים

• השאילתה חייבת להיות שאילתת קריאה בלבד (SELECT).
• ניתן לפנות רק למאגר הפומבי שמסקיו חושפת ללקוחותיה.
• אסור לבצע פעולות כתיבה, שינוי נתונים או הרצת שאילתות מערכת.
• אם השאילתה נפסלת, הסיבה מוחזרת בשדה description.

פרמטרים

פרמטר	סוג	חובה	תיאור
sql	string	כן	שאילתת קריאה חוקית.
format	string	לא	json / xml.

קודי שגיאה

קוד	תיאור
1011	sql חסר
1012	השאילתה נפסלה
1013	אין תוצאות / שאילתה לא חוקית

דוגמה

curl -H "Authorization: Bearer TOKEN" \
     -X POST "https://[MASKYOO_URL]/api/" \
     --data-urlencode "service=cdr_query" \
     --data-urlencode "sql=SELECT ... WHERE ... LIMIT 100" \
     -d "format=json"

לפירוט המלא של השדות שניתן לשלוף, פנו לנציג התמיכה של מסקיו לקבלת סכמה.

---

cdr_subunique_query

דוח אגרגטיבי של שיחות שנענו בטווח זמנים נתון, כולל ספירת קריאות למספר מתקשר ייחודי. מחזיר עד 2000 שורות.

Endpoint: /api/?service=cdr_subunique_query

פרמטרים

פרמטר	סוג	חובה	תיאור
start_time	string	כן	Y-m-d H:i:s.
end_time	string	כן	Y-m-d H:i:s.
format	string	לא	json / xml.

קודי שגיאה

קוד	תיאור
1001	start_time חסר / לא תקין
1002	end_time חסר / לא תקין
1003	אין תוצאות

---

get_record_by_call_uuid

הורדת קובץ ההקלטה של שיחה יחידה.

Endpoint: /api/?service=get_record_by_call_uuid

פרמטרים

פרמטר	סוג	חובה	תיאור
call_uuid	string	כן	מזהה ייחודי של השיחה.
type	string	לא	wav (ברירת מחדל) / mp3.
only_file	any	לא	אם קיים, יוחזר רק הקובץ (שימושי לכלי בדיקה כמו Postman).
format	string	לא	json / xml (רלוונטי רק להודעות שגיאה).

המערכת ממירה את ההקלטה לפורמט המבוקש בזמן אמת.

קודי שגיאה

קוד	תיאור
3001	call_uuid חסר
3002	ההקלטה לא קיימת

דוגמה

curl -H "Authorization: Bearer TOKEN" \
     -o call.mp3 \
     "https://[MASKYOO_URL]/api/?service=get_record_by_call_uuid&call_uuid=XXXXXXX&type=mp3"

---

get_cdr_metadata_by_call_uuid

החזרת מידע מורחב על שיחה בודדת, כולל נתוני פיקסל, נתוני Google Ads ותמלול (אם קיימים).

Endpoint: /api/?service=get_cdr_metadata_by_call_uuid

פרמטרים

פרמטר	סוג	חובה	תיאור
call_uuid	string	כן	מזהה ייחודי של השיחה.
format	string	לא	json / xml.

מבנה התגובה

התגובה כוללת את הסעיפים הבאים (לפי זמינות הנתונים):

• cdr – נתוני השיחה.
• pixel_data – נתוני פיקסל שנאספו עבור השיחה.
• adwords_data – נתוני Google Ads הרלוונטיים לשיחה.
• adwords_call_extension_data – נתוני Call Extension מ-Google Ads.
• speech_recognition – תמלול שיחה (אם הופעל תמלול בחשבון).

קודי שגיאה

קוד	תיאור
1014	call_uuid חסר
1015	אין תוצאות

---

get_google_ads_offline_conversion

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

Endpoint: /api/?service=get_google_ads_offline_conversion

פרמטרים

פרמטר	סוג	חובה	תיאור
call_uuid	string	כן	מזהה ייחודי של השיחה.
format	string	לא	json / xml.

קודי שגיאה

קוד	תיאור
1015	call_uuid חסר
1115	אין תוצאות לשיחה זו

---

set_google_ads_offline_conversion

רישום או עדכון של ערך המרת אופליין על שיחה. הערך יועבר ל-Google Ads בתזמון הסנכרון הבא.

Endpoint: /api/?service=set_google_ads_offline_conversion

פרמטרים

פרמטר	סוג	חובה	תיאור
call_uuid	string	כן	מזהה ייחודי של השיחה.
conversion_value	number	כן	ערך ההמרה (חייב להיות מספרי).
format	string	לא	json / xml.

קודי שגיאה

קוד	תיאור
1015	call_uuid חסר
1016	conversion_value חסר
1017	conversion_value לא מספרי
1125	לא נמצאה שיחה למזהה שנשלח
1126	השמירה נכשלה

דוגמה

curl -H "Authorization: Bearer TOKEN" \
     -X POST "https://[MASKYOO_URL]/api/?service=set_google_ads_offline_conversion" \
     -d "call_uuid=XXXXXXX" \
     -d "conversion_value=150.00" \
     -d "format=json"

---

create_maskyoo_cdr

יצירת רשומת שיחה ידנית – מתאים לאינטגרציות של מערכות IVR חיצוניות או לייבוא שיחות ממקור אחר. לאחר ההוספה המערכת מריצה אוטומטית את כללי האוטומציה של סיום שיחה ואת מנגנוני הפיקסל.

Endpoint: /api/?service=create_maskyoo_cdr

פרמטרים

פרמטר	סוג	חובה	תיאור
cdr_ddi	string	כן	מספר המסקיו (חייב להיות קיים בחשבון).
cdr_start_call	string	לא	Y-m-d H:i:s (ברירת מחדל: זמן הקריאה ל-API).
cdr_totac_sec	int	לא	משך השיחה בשניות (0–3599). אם חסר – 0. זמן הסיום מחושב אוטומטית.
cdr_ani	string	לא	מספר המתקשר (חייב להיות מספר ישראלי תקין).
cdr_destination	string	לא	מספר היעד (אותה ולידציה).
cdr_metadata	string	לא	מחרוזת JSON חוקית שתישמר כמטא-דאטה של השיחה.
format	string	לא	json / xml.

תגובה

בהצלחה מוחזר cdr_uniqueid – מזהה ייחודי שנוצר אוטומטית לשיחה.

קודי שגיאה

קוד	תיאור
2022	cdr_start_call לא בפורמט Y-m-d H:i:s
2024	cdr_totac_sec לא מספרי / מחוץ לטווח
2027	cdr_ani לא תקין
2028	cdr_destination לא תקין / cdr_ddi חסר או לא מוכר
2029	cdr_metadata לא JSON חוקי
2031	שמירת השיחה נכשלה

השפעות על המערכת

services של שאילתות והקלטות נוגעים ישירות ב‑CDR ובאינטגרציית Google Ads:

• שאילתות CDR — cdr_query מריץ SELECT בלבד על המאגר הפומבי; יכול לרוץ עד 10 דקות ולכן מומלץ להשתמש בפילטרים ו‑LIMIT לביצועים
• הקלטות — get_record_by_call_uuid מוריד ישירות את קובץ ההקלטה (WAV/MP3); הורדת קבצי ארכיון עלולה להיות ארוכה
• יצירת CDR ידני — create_maskyoo_cdr מריצה מיד את כללי האוטומציה של סיום שיחה ואת מנגנוני הפיקסל, כאילו השיחה בוצעה דרך הטלפוניה
• Google Ads Offline Conversion — set_google_ads_offline_conversion שומר ערך שיישלח ל‑Google בתזמון הסנכרון הבא; משפיע על דיווחי ROI בקמפיינים
• מטא‑דאטה — get_cdr_metadata_by_call_uuid מחזיר את אותם נתוני פיקסל ו‑Google Ads שרואים בדוח השיחות

ראו גם

• דו״ח פירוט שיחות
• אירועי אוטומציה
• דו״ח שיחות מקמפיין Google
• ניהול מסקיו