אם גם אתה לא יודע API (כמוני...), כדאי לך לקרוא את זה!! מדריך פשוט וקל מה בכל זאת תוכלו להוציא מהAPI של ימות המשיח (ולא רק...), דברים מדהימים!

[צבי ד"צ]

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

נתחיל קודם בפקודות מהדפדפן, בהמשך נראה גם איך אפשר לעשות את כל מה שיש באתר הניהול - דרך הטלפון.
זה אולי נשמע לא כל כך נצרך, אבל האמת שעם קצת יצירתיות והתרגלות, אפשר לעשות עם זה כ50% ממה שהמתכנתים פה עושים! (מנסיון) זה אולי בצורה קצת יותר מורכבת, עם קצת 'קומבינות', אבל התוצאה אותו דבר.

אז כמו שאמרנו, נתחיל בפקודות מהדפדפן, איך יוצרים פקודות מהדפדפן? ממש פשוט וקל!

אני יקדים הקדמה קצרצרה, מי שזה מסבך אותו יכול לדלג עליה.
לימות המשיח יש שני דברים בAPI, אחד, היכולת לתקשר עם המערכת בAPI, דהיינו לשלוח לשרת של ימות המשיח פקודות, וזה משנה מה שצריך במערכת, כגון פקודה להעתקת קובץ או למחיקת קובץ וכדו' ואז כל אחד יכול להכין אתר ניהול שפשוט שולח פקודות לשרת של ימות המשיח, והדבר השני הוא, שהמערכת מתקשרת עם שרת חיצוני, ולזה עושים שלוחת API, שבה שולחים הוראות לשרת חיצוני והמערכת פועלת לפי התגובות שלו.
אנחנו כרגע נעסוק באפשרות הראשונה, של שליחת פקודות לשרת של ימות המשיח בכדי לנהל את הקו, ואת זה נעשה ישירות מהדפדפן.
עד כאן ההקדמה שכתבתי מקודם שאפשר לדלג אותה
עכשיו לגופו של עניין, בכדי לעשות פקודה מהדפדפן צריך לפתוח קודם בכתובת של השרת של ימות שלשם אנו רוצים לתת את הפקודה, לכן נתחיל כל פקודה כך:

https://www.call2all.co.il/ym/api/

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

CreateTemplate

אז נוסיף את זה לקישור הקודם.

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

token

ואז שמים "="
דהיינו מהו הטוקן, ואז צריך למלאות את הפרמטר, דהיינו את מספר המערכת והסיסמה, כותבים את זה ככה 0773333333:1234, דהיינו מספר מערכת נקודותיים סיסמה.

עכשיו אנו צריכים למלאות פרמטר נוסף, "שם הקמפיין"
אז נוסיף את הסימן הזה & ואז נכתוב את שם הפרמטר הנוסף כפי שמופיע שם בתיעוד

description

ושוב, שווה (=) ואת שם הקמפיין

וזהו, בזה סיימנו את הפקודה, ואנחנו יכולים להריץ אותה בדפדפן!
זה אמור להיראות כך

https://www.call2all.co.il/ym/api/CreateTemplate?token=0773333333:1234&description=שם הקמפיין

עריכה:
שימו לב לכמה הערות, כאשר צריך לציין נתיב, צריך להתחיל את זה ב ivr2 ונקודותיים ואח"כ זה השלוחה ראשית ומשם ממשיכים עם /
הערה נוספת, "מזהה הקמפיין" בפעולות ברשימת תפוצה, לא הכוונה למספר של הרשימה, אלא למזהה שלה, ניתן לראות כאן כמה דרכים לראות את המספר, מאד פשוט.

עד כאן לפקודות מהדפדפן (או משרת וכדו')

---

כעת נראה איך אפשר לעשות את כל זה גם כשלוחה דרך הטלפון
פשוט מאד, כפי שהבאנו למעלה (בהקדמה שהיה אפשר לדלג...), שחוץ מהאפשרות לשלוח פקודה לשרת של ימות, ישנה גם אפשרות לעשות שלוחה של מודול API ששולח פקודות ומתקשר עם שרתים חיצוניים, אז באותה מידה אפשר גם בשלוחה כזו לשלוח פקודה לשרת של ימות המשיח...
אז פשוט נגדיר את השלוחה דבר ראשון כמודל API

type=api

לאחר מכן נכתוב בשורה הבאה

api_link=

ולאחר השוה את הכתובת לשליחת הפניה, דהיינו השרת של ימות, עם הפקודה הרצויה
זה יראה כך: (שימו לב שזה נמצא כאן יחד ההתחלה של השורה שהבאתי מקודם, שזה לא יהיה כפול ראה דוגמא מהמשך השירשור)

api_link=https://www.call2all.co.il/ym/api/CreateTemplate

לאחר מכן צריך לכתוב בשורות הבאות את ה'פרמטרים', לזה צריך לכל פרמטר שורה שמתחילה כך

api_add_0=

ולאחר השוה את שם הפרמטר=את הפרמטר עצמו.
גם בכל פרמטר נוסף צריך לכתוב את המספר הבא בתחילת השורה (בדוגמא מקודם כתוב 0, בפרמטר הבא צריך שזה יהי' 1)
ובדוגמא שלנו זה יראה כך

api_add_0=token=0773333333:1234
api_add_1=description=שם הקמפיין

וזה ההגדרה לאן יועבר בסיום

api_end_goto=/

צריך להשתיק את הודעה M1607 "אין מענה משרת API"

עד כאן זה איך לעשות את זה כשלוחה דרך הטלפון

---

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

עריכה:
יש את זה גם כהגדרה מובנית במודול, מפורט בשירשור המודול בכותרת קבלת נתונים מהמשתמש יישר כח ל @דוד_מלך_ישראל שהביא את זה בהמשך השירשור כאן

---

עריכה:

הוספתי מדריך איך לעשות פקודות שיפעלו לפי זמנים קבועים באוטומציה מלאה, גם בלי שאתם מחוברים למחשב!

כנסו כאן

---

הוספה:

תוכנה להפעלת פקודות מרובות

---

יישר כח עצום וקרדיט גדול לכל החברים היקרים שעזרו לי בעבר, ומהם למדתי את כל זה ועוד יותר!

ניתן לראות כאן דוגמאות לפקודות מהדפדפן, זה יכול אולי לעזור למי שלא לגמרי הבין את המדריך.

כמובן שאשמח מאד להערות והארות.

[מבצע]

@צבי-ד-צ אני מנסה לעשות צינתוק חינמי מה חסר?
https://www.call2all.co.il/ym/api/RunTzintuk?token=XXXXXX:XXX&tzl:admins

תודה!

[מוטי לוין]

@מבצע לא שמת פרמטר phones

https://www.call2all.co.il/ym/api/RunTzintuk?token=XXXXXX:XXX&phones=tzl:admins

[דוד_מלך_ישראל]

@צבי-ד-צ יפה מאד!

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

אפשר גם להגדיר בשלוחה api_000=שם הפרמטר (והגדרות נוספות לפי הצורך), ולהעלות קובץ שאלה.

[ivrפון]

@צבי-ד-צ מדריך מעולה!
לא רואה תיקונים

[צבי ד"צ]

הוספתי מדריך איך לעשות את הפקודות שיפעלו לפי זמנים קבועים

[שאק]

@צבי-ד-צ ניסיתי לעשות שיוכלו למחוק כל המספרים מרשימת התפוצה דרך הטלפון ולא בוצע (מספר הרשימה לקחתי כנדרש מהאתר החדש) אשמח לעזרה, תודה!!!

[צבי ד"צ]

@שאק תביא את ההגדרות ששמת בשלוחה

[סתם שמרל]

@צבי-ד-צ אלוף! איך אני עושה פקודה מהדפדפן להורדת קובץ ApprovalAll.ymgr משלוחה 1?

[שאק]

סליחה, שכחתי להביא תוכן קובץ ההגדרות

type=api
api_link=api_link=https://www.call2all.co.il/ym/api/ClearTemplateEntries
api_add_0=token=0790000000:123123
api_add_1=templateId=1234567
api_end_goto=/

[צבי ד"צ]

@סתם-שמרל דבר ראשון תנסה לבד עם המדריך...
אבל דווקא לזה יש לי משהו מוכן,

https://www.call2all.co.il/ym/api/RenderYMGRFile?token=07960******:123456&wath=ivr2:/1/ApprovalAll.ymgr&convertType=html&notLoadLang=0

תחליף את המספר מערכת וסיסמה

[צבי ד"צ]

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

[שאק]

@צבי-ד-צ תודה רבה, עובד מעולה!!!

[סתם שמרל]

@צבי-ד-צ אלוף!! ניסיתי לבד ולא הצלחתי. תודה רבה!
יש אפשרות לעשות שלוחה בטלפון שתשלח את הקובץ הזה למייל?

[צבי ד"צ]

@סתם-שמרל כתב באם גם אתה לא יודע API (כמוני...), כדאי לך לקרוא את זה!! מדריך פשוט וקל מה בכל זאת תוכלו להוציא מהAPI של ימות המשיח (ולא רק...), דברים מדהימים!:

ניסיתי לבד ולא הצלחתי

רק בתור המלצה, תנסה לעבור על הקישור שנתתי לך - ולראות את התיעוד, תוכל להחכים מכך!
כמו כן תוכל לראות כמה דברים שאתה יכול לשנות, כגון איזה סוג קובץ ירד.

@סתם-שמרל כתב באם גם אתה לא יודע API (כמוני...), כדאי לך לקרוא את זה!! מדריך פשוט וקל מה בכל זאת תוכלו להוציא מהAPI של ימות המשיח (ולא רק...), דברים מדהימים!:

יש אפשרות לעשות שלוחה בטלפון שתשלח את הקובץ הזה למייל?

נראה לי שלא, אבל אולי המומחים כאן ידעו.

[סתם שמרל]

@צבי-ד-צ עברתי. לא הבנתי למה משמש הפרמטר האחרון notLoadLang=0
גם בלעדיו הכל עובד מעולה

[צבי ד"צ]

@סתם-שמרל לכאורה אתה צודק, תראה בתיעוד מדובר רק בתירגום...

[צבי ד"צ]

פוסט זה נמחק!

[סתם שמרל]

@צבי-ד-צ אני מנסה לעשות צינתוק חינמי וזה לא מצליח. כתבתי כך:

https://www.call2all.co.il/ym/api/RunTzintuktoken?03***:*****&phones=tzl:1

[מוטי לוין]

@סתם-שמרל

https://www.call2all.co.il/ym/api/RunTzintuk?token=0773137770:1234&phones=tzl:X