חדש בממשק ה־API: שליטה חיה בקמפיינים, הודעות מותאמות אישית וסטטוס ברמת מספרים!
-
ב"ה
חדש בממשק ה־API: שליטה חיה בקמפיינים, הודעות מותאמות אישית וסטטוס ברמת מספרים!
עדכון API - יכולות חדשות למפתחים
שמחים לעדכן שמהיום ממשק ה־API של ניהול קמפיינים עבר שדרוג משמעותי.
הוספנו יכולות מתקדמות שיאפשרו לכם שליטה גמישה, חכמה ודינמית על הקמפיינים - עוד לפני שיש ממשק GUI תואם.
1. הפעלת קמפיינים - יותר גמישות, יותר שליטה
הפקודה RunCampaign תומכת כעת ב:
חיוג לרשימות מותאמות אישית בפורמט JSON עם מידע נלווה לכל מספר (name,text,moreinfo).- קמפיינים מבוססי TTS עם הקראה אישית לפי מספר.
- קמפיינים משולבים עם SMS - הודעות SMS לניידים רגילים, וחיוג קולי לניידים כשרים.
- שליחת הודעת TTS כללית באמצעות
ttsMessage- מחליף את קובץ הקול בתבנית.
2. סטטוס קמפיין - עכשיו גם ברמת רשומות
הפקודה GetCampaignStatus תומכת כעת בפרמטרים:
entries=...- לקבלת סטטוס מפורט על המספרים המחויגים לפי סוג (pending,done,bridged,failedועוד).range=from:to- להגבלת מספר התוצאות המוחזרות.- לכל מספר מוצג: סטטוס, משך, תוצאה, ניסיונות קודמים (
redials) ועוד.
ניתן כעת לראות תיעוד של כל ניסיון חיוג שבוצע, כולל זמן התחלה, האם חובר, וכמה זמן נמשך.
סטטוס הקמפיין זמין לצפייה גם לאחר סיום הקמפיין ולמעשה מכיל מידע מפורט יותר מקובץ ה-html שחוזר בקריאת DownloadCampaignReport.
3. ניהול קמפיין בזמן אמת
הפקודה CampaignAction פוצלה לשני תחומים:
א. פעולות כלליות על הקמפיין:
פעולה תיאור stopעצירת הקמפיין מיידית setPaused=1/0השהיית הקמפיין / חידושו setMaxActiveChannelsשינוי כמות שיחות פעילות setMaxBridgedChannelsשינוי כמות שיחות מחוברות ב. פעולות לפי מספרים (
add,block,hangup) :- הוספה של מספרים חדשים תוך כדי ריצה.
- חסימת מספרים - לא יבוצעו ניסיונות חיוג נוספים.
- ניתוק מיידי של שיחות פעילות.
ניתן לשלוח את המספרים בפורמט:
0501234567:0527654321או:
{ "0501234567": "טקסט אישי" }והמערכת תחזיר:
"data": [ { "phone": "0501234567", "action": "add" } ]
למי זה רלוונטי?
כל מפתח המשתמש בממשק API לניהול קמפיינים - יוכל מעתה:
- להפעיל קמפיינים עם שליטה מלאה על תוכן אישי
- לעקוב אחר סטטוס מדויק ברמת המספר
- לשלוט בקמפיין רץ ללא צורך לעצור אותו
- להגיב בזמן אמת לאירועים תוך כדי הרצה (למשל חסימה או ניתוק)
התיעוד המעודכן זמין כעת בשרשור המתאים.
נשמח לשמוע פידבקים - וגם לשמוע אילו יכולות נוספות תרצו לראות!צוות ימות המשיח
️
-
-
@eliyahu
ממש כל האפשרויות שצריך שם, עצירת קמפיין או הסרת מספר מרשימת החיוגים ועוד
פשוט מטורף!! -
@eliyahu למה moreinfo מיועד? הערה פנימית לדיבוג וכדומה?
לגבי blocked כדאי שיהיה API לבדוק את זה גם בלי לשלוח בפועל שיחה גם אם המספר לא חסום (בדומה לשל אל תתקשר אליי אבל לחסימות של ימות עצמם) -
@צדיק-תמים כתב בחדש בממשק ה־API: שליטה חיה בקמפיינים, הודעות מותאמות אישית וסטטוס ברמת מספרים!:
למה moreinfo מיועד? הערה פנימית לדיבוג וכדומה?
מתוך התיעוד:
שימו לב! במידה והקמפיין נשלח למספרי הטלפון שבתבנית (קרי, לא שלחתם פרמטר phones) אזי הטקסט להשמעה יהיה מה שמופיע על המספר בשדה moreinfo.
-
@צדיק-תמים
עדיין לא מספיק ברור
מדוע יש מצבים שמופיע גם moreinfo וגם text
@eliyahu