ניהול תגיות
תגיות (Tags) משמשות לקיבוץ מספרי מסקיו לצורך דיווח, פילוחים ואוטומציה. services אלו מנהלים תגיות ואת שיוך המסקיו אליהן.
חברי תגית הם תמיד מספרי מסקיו. שם הפרמטר בקריאות ה-API הוא
maskyoo.
create_tag
יצירת תגית חדשה. שם התגית חייב להיות ייחודי.
Endpoint: /api/?service=create_tag
פרמטרים
| פרמטר | סוג | חובה | תיאור |
|---|---|---|---|
tag_name | string | כן | שם התגית. |
format | string | לא | json / xml. |
קודי שגיאה
| קוד | תיאור |
|---|---|
5071 | tag_name ריק |
5072 | שם התגית כבר קיים |
5073 | כשל ביצירת התגית |
update_tag
שינוי שם של תגית קיימת.
Endpoint: /api/?service=update_tag
פרמטרים
| פרמטר | סוג | חובה | תיאור |
|---|---|---|---|
tag_id | int | כן | מזהה התגית. |
tag_name | string | כן | השם החדש. |
format | string | לא | json / xml. |
קודי שגיאה
| קוד | תיאור |
|---|---|
5061 | חסר tag_id / tag_name |
5062 | tag_name ריק |
5063 | tag_id לא קיים |
5064 | לא בוצע עדכון |
delete_tag
מחיקת תגית וכל חבריה.
Endpoint: /api/?service=delete_tag
פרמטרים
| פרמטר | סוג | חובה | תיאור |
|---|---|---|---|
tag_id | int | כן | מזהה התגית. |
format | string | לא | json / xml. |
קודי שגיאה
| קוד | תיאור |
|---|---|
5051 | tag_id חסר |
5052 | התגית לא קיימת |
5053 / 5054 | המחיקה נכשלה |
view_tag_by_id
פרטי תגית לפי מזהה.
Endpoint: /api/?service=view_tag_by_id
פרמטרים
| פרמטר | סוג | חובה | תיאור |
|---|---|---|---|
tag_id | int | כן | מזהה התגית. |
format | string | לא | json / xml. |
קודי שגיאה
| קוד | תיאור |
|---|---|
5091 | tag_id חסר |
5092 | אין תוצאות |
view_tag_by_name
פרטי תגית לפי שם. אם tag_name ריק – מחזיר את כל התגיות. שירות זה זמין גם תחת השם view_tags (alias).
Endpoint: /api/?service=view_tag_by_name או /api/?service=view_tags
פרמטרים
| פרמטר | סוג | חובה | תיאור |
|---|---|---|---|
tag_name | string | לא | שם התגית (חובה ב-view_tag_by_name; ב-view_tags ניתן להשמיט כדי לקבל את הכול). |
format | string | לא | json / xml. |
קודי שגיאה
| קוד | תיאור |
|---|---|
5081 | tag_name חסר ב-view_tag_by_name |
5082 | אין תוצאות |
view_tags_by_maskyoo
החזרת רשימת התגיות בהן מספר מסקיו נתון חבר.
Endpoint: /api/?service=view_tags_by_maskyoo
פרמטרים
| פרמטר | סוג | חובה | תיאור |
|---|---|---|---|
maskyoo | string | כן | המספר. |
format | string | לא | json / xml. |
קודי שגיאה
| קוד | תיאור |
|---|---|
50811 | maskyoo חסר / קצר מ-4 |
50821 | אין תוצאות |
view_maskyoo_members_by_tag_id
רשימת מספרי המסקיו הפעילים החברים בתגית.
Endpoint: /api/?service=view_maskyoo_members_by_tag_id
פרמטרים
| פרמטר | סוג | חובה | תיאור |
|---|---|---|---|
tag_id | int | כן | מזהה התגית. |
format | string | לא | json / xml. |
קודי שגיאה
| קוד | תיאור |
|---|---|
50911 | tag_id חסר |
50921 | אין תוצאות |
add_member_to_tag
הוספת מספר מסקיו לתגית.
Endpoint: /api/?service=add_member_to_tag
פרמטרים
| פרמטר | סוג | חובה | תיאור |
|---|---|---|---|
tag_id | int | כן | התגית. |
maskyoo | string | כן | המספר להוספה. |
format | string | לא | json / xml. |
קודי שגיאה
| קוד | תיאור |
|---|---|
5041 | חסר tag_id או maskyoo |
5042 | התגית לא קיימת |
5043 | המסקיו לא קיים |
5044 | המסקיו כבר בתגית |
5045 | ההוספה נכשלה |
remove_member_from_tag_id
הסרת מסקיו מתגית לפי מזהה.
Endpoint: /api/?service=remove_member_from_tag_id
פרמטרים
| פרמטר | סוג | חובה | תיאור |
|---|---|---|---|
tag_id | int | כן | התגית. |
maskyoo | string | כן | המספר להסרה. |
format | string | לא | json / xml. |
קודי שגיאה
| קוד | תיאור |
|---|---|
5031 | חסר tag_id או maskyoo |
5032 | המסקיו לא קיים |
5033 | התגית לא קיימת |
5034 | ההסרה נכשלה |
remove_member_from_tag_name
הסרת מסקיו מתגית לפי שם התגית.
Endpoint: /api/?service=remove_member_from_tag_name
פרמטרים
| פרמטר | סוג | חובה | תיאור |
|---|---|---|---|
tag_name | string | כן | שם התגית. |
maskyoo | string | כן | המספר להסרה. |
format | string | לא | json / xml. |
קודי שגיאה
| קוד | תיאור |
|---|---|
5021 | חסר tag_name או maskyoo |
5022 | התגית לא נמצאה |
5023 | המסקיו לא קיים |
5024 | התגית לא קיימת |
5025 | ההסרה נכשלה |
get_members_by_tag_id
רשימת חברי התגית עם פרטי המסקיו: תיאור, סטטוס פעילות, יעדי חיוג, שעות עבודה, שדות פרטיים, הודעות, אימייל ועוד.
Endpoint: /api/?service=get_members_by_tag_id
פרמטרים
| פרמטר | סוג | חובה | תיאור |
|---|---|---|---|
tag_id | int | כן | התגית. |
format | string | לא | json / xml. |
קודי שגיאה
| קוד | תיאור |
|---|---|
5001 | tag_id חסר |
5002 | אין תוצאות |
get_members_by_tag_name
כמו get_members_by_tag_id אבל על פי שם תגית.
Endpoint: /api/?service=get_members_by_tag_name
פרמטרים
| פרמטר | סוג | חובה | תיאור |
|---|---|---|---|
tag_name | string | כן | שם התגית. |
format | string | לא | json / xml. |
קודי שגיאה
| קוד | תיאור |
|---|---|
5011 | tag_name חסר |
5012 | התגית לא נמצאה |
5013 | אין תוצאות |
השפעות על המערכת
תגיות הן מנגנון הקיבוץ המרכזי של מספרי מסקיו:
- ממשק ניהול תגיות — יצירה/עדכון/מחיקה ושיוך מסקיו דרך ה‑API נראים מיידית במסך ניהול התגי ות
- דוחות — דוחות המסוננים לפי תגית (דוח תגיות, דוח שיחות, דוח התראות) משקפים את השינוי מיד
- אוטומציה — כללי אוטומציה עם פילטר תגית חלים מיד על המסקיו שמתווספים/מוסרים מהתגית
- תגית אישית למשתמש — יצירת משתמש יוצרת אוטומטית תגית בשם
#<email>; מחיקתה תפגע בשיוך ההרשאות - ייחודיות — שם תגית חייב להיות ייחודי בחשבון; ניסיון ליצור שם קיים מחזיר
5072