למען לא אהיה ללעג וקלס, אבקש שמי שכן יודע 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=/
מומלץ מאד כששעושים את זה דרך הטלפון להוסיף את ההגדרה הזו
api_hangup_send=no
כדי שלא ישלח שוב קריאה בניתוק השיחה (עיין בשרשור של המודל)
צריך להשתיק את הודעה M1607 "אין מענה משרת API" (מכיוון שהמערכת לא יודעת לקרוא את התגובה הזו, אז בכל מקרה היא עונה אין מענה אף שיש מענה)
עד כאן זה איך לעשות את זה כשלוחה דרך הטלפון
אם רוצים לעשות דרך הטלפון, אבל שיוכלו לבחור את מספר המערכת לדוגמא, שעליה יחול כל הנ"ל, או לשנות דברים נוספים, כגון שרוצים להפעיל צינתוקים ממערכת אחרת, אבל לבחור קודם לאיזה רשימת צינתוקים, לזה כדאי להשתמש במדריך שכתבתי על שינוי הגדרות דרך הטלפון ובשני הרעיונות לשלוחה שהבאתי שם
עריכה:
יש את זה גם כהגדרה מובנית במודול, מפורט בשירשור המודול בכותרת קבלת נתונים מהמשתמש יישר כח ל @דוד_מלך_ישראל שהביא את זה בהמשך השירשור כאן
*שימו לב לדבר חשוב: אני מקווה שכל הקוראים הבינו את זה, אבל למי שלא, אני ידגיש: שליחת הפקודות לא באמת חייבת להיות מדפדפן, אלא יכולה להיות גם מהדפדפן, אבל כמובן שאפשר גם לשלוח קריאות מקוד בשרת/תוכנה וכדו' וזה הצורה הרגילה (וכמו שאפשר לשלוח קריאות מהמערכת...)
עריכה:
הוספתי מדריך איך לעשות פקודות שיפעלו לפי זמנים קבועים באוטומציה מלאה, גם בלי שאתם מחוברים למחשב!
כנסו כאן
הוספה:
תוכנה להפעלת פקודות מרובות
יישר כח עצום וקרדיט גדול לכל החברים היקרים שעזרו לי בעבר, ומהם למדתי את כל זה ועוד יותר!
ניתן לראות כאן דוגמאות לפקודות מהדפדפן, זה יכול אולי לעזור למי שלא לגמרי הבין את המדריך.
כמובן שאשמח מאד להערות והארות.
