איך משתמשים במשתנים

כל משתנה משובץ בעזרת סוגריים מסולסלים כפולים, למשל {{ numbers.caller.friendly }}. ברגע שהאירוע קורה, אקסטרה מחליפה את הסימון בערך האמיתי מאותה שיחה או פגישה, ושולחת אותו אל היעד שהגדרתם.

1

בוחרים אירוע

סוג האירוע קובע אילו משתנים זמינים לכם. לכל אירוע חבילת נתונים משלו.

2

משבצים את המשתנה

גוררים או מקלידים את הסימון {{ ... }} לתוך כתובת ה-URL, הכותרות או גוף הבקשה.

3

מקבלים את הערך

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

המשתנים המסומנים כ-object או array מכילים מבנה נתונים שלם (למשל אובייקט ההקלטה או התמלול המלא) - שבצו אותם בגוף הבקשה (Body) ללא מירכאות, לא בתוך כתובת ה-URL. משתנה המסומן ערך גדול עלול להיות ארוך מאוד (כמו תמלול מלא) ולכן גם הוא מיועד לגוף הבקשה בלבד.

סוגי הערכים

ליד כל משתנה מופיע סוג הערך שהוא מחזיר:

  • string מלל
  • number מספר
  • boolean כן/לא
  • object אובייקט
  • array מערך

מספר וירטואלי

תחילת שיחה מספר וירטואלי

משתנה סוג תיאור
{{ id }} string מזהה ייחודי של השיחה באקסטרה.
{{ event }} string האירוע שעליו הוובהוק מדווח
{{ type }} string סטטוס \ סוג השיחה: נכנסת נענתה, יוצאת לא נענתה וכו'
{{ own_type }} string מזהה השירות באקסטרה: מספר וירטואלי, נתב וירטואלי, קו סלולרי
{{ starred }} boolean האם השיחה מסומנת בכוכב?
{{ ivr_dialed }} string מספר שהוקש בנתב הוירטואלי
{{ time.timezone }} string אזור זמן
{{ time.gmt_offset }} string ההפרש מ-GMT
{{ time.start }} string הזמן שבו התחילה השיחה בפורמט רגיל.
{{ numbers.own.friendly }} string מספר הקו שלכם באקסטרה, שממנו הוצאתם שיחה או אליו קיבלתם שיחה.
{{ numbers.own.e164 }} string מספר הקו שלכם באקסטרה בפורמט בינלאומי
{{ numbers.caller.friendly }} string מספר הטלפון של יוזם השיחה בפורמט ידידותי. ריק אם המספר חסום
{{ numbers.caller.e164 }} string מספר הטלפון של יוזם השיחה בפורמט בינלאומי
{{ numbers.destination.e164 }} string מספר הטלפון של מקבל השיחה בפורמט בינלאומי.
{{ numbers.destination.friendly }} string מספר הטלפון של מקבל השיחה בפועל בפורמט ידידותי. לרוב יהיה זהה ל-own_number אבל במקרה של "עקוב אחריי" או בניתוב בנתב הוירטואלי, יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ contact }} object איש הקשר של המתקשר או השולח, כשהמספר שמור באחד מספרי אנשי הקשר בחשבון: {id, name, book: {id, name}, url}. null כשלא נמצא איש קשר. בגוף JSON - בלי מרכאות.
{{ contact.name }} string שם איש הקשר של המתקשר או השולח, כפי שהוא שמור בספר אנשי הקשר. ריק כשלא נמצא איש קשר.

סיום שיחה מספר וירטואלי כולל הקלטה

משתנה סוג תיאור
{{ id }} string מזהה ייחודי של השיחה באקסטרה.
{{ event }} string האירוע שעליו הוובהוק מדווח
{{ type }} string סטטוס \ סוג השיחה: נכנסת נענתה, יוצאת לא נענתה וכו'
{{ own_type }} string מזהה השירות באקסטרה: מספר וירטואלי, נתב וירטואלי, קו סלולרי
{{ starred }} boolean האם השיחה מסומנת בכוכב?
{{ ivr_dialed }} string מספר שהוקש בנתב הוירטואלי
{{ time.timezone }} string אזור זמן
{{ time.gmt_offset }} string ההפרש מ-GMT
{{ time.start }} string הזמן שבו התחילה השיחה בפורמט רגיל.
{{ numbers.own.friendly }} string מספר הקו שלכם באקסטרה, שממנו הוצאתם שיחה או אליו קיבלתם שיחה.
{{ numbers.own.e164 }} string מספר הקו שלכם באקסטרה בפורמט בינלאומי
{{ numbers.caller.friendly }} string מספר הטלפון של יוזם השיחה בפורמט ידידותי. ריק אם המספר חסום
{{ numbers.caller.e164 }} string מספר הטלפון של יוזם השיחה בפורמט בינלאומי
{{ numbers.destination.e164 }} string מספר הטלפון של מקבל השיחה בפורמט בינלאומי.
{{ numbers.destination.friendly }} string מספר הטלפון של מקבל השיחה בפועל בפורמט ידידותי. לרוב יהיה זהה ל-own_number אבל במקרה של "עקוב אחריי" או בניתוב בנתב הוירטואלי, יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ contact }} object איש הקשר של המתקשר או השולח, כשהמספר שמור באחד מספרי אנשי הקשר בחשבון: {id, name, book: {id, name}, url}. null כשלא נמצא איש קשר. בגוף JSON - בלי מרכאות.
{{ contact.name }} string שם איש הקשר של המתקשר או השולח, כפי שהוא שמור בספר אנשי הקשר. ריק כשלא נמצא איש קשר.
{{ duration }} number משך השיחה בשניות.
{{ recording }} object אובייקט ההקלטה - קישור לקובץ (url) ותוקף בדקות (ttl). נוצר רק כשמוגדר "קישור להקלטת השיחה" בהגדרות הפעולה.
{{ time.end }} string הזמן שבו הסתיימה השיחה בפורמט רגיל.
{{ out_of_hours }} boolean האם השיחה התקבלה מחוץ לשעות הפעילות שהוגדרו למספר?
{{ out_of_hours.behaviour }} string מה נעשה עם השיחה מחוץ לשעות הפעילות: forwarded (הועברה למספר החלופי) או announcement (הושמעה למתקשר הודעה והשיחה נותקה). ריק כשהשיחה התקבלה בשעות הפעילות.
{{ out_of_hours.caption }} string תיאור מילולי של מה שקרה לשיחה מחוץ לשעות הפעילות, מוכן לשליחה בהודעה. ריק כשהשיחה התקבלה בשעות הפעילות.

קבלת SMS מספר וירטואלי

משתנה סוג תיאור
{{ id }} string מזהה ייחודי של המסרון באקסטרה
{{ event }} string האירוע שעליו הוובהוק מדווח
{{ received_at }} string הזמן שבו התקבל המסרון (פורמט YYYY-MM-DD HH:MM)
{{ to }} string המספר שלכם באקסטרה שאליו נשלח המסרון, בפורמט בינלאומי
{{ from }} string השולח: מספר טלפון בפורמט בינלאומי, או שם השולח (כמו ExtraMobile) אם נשלח עם שם
{{ body }} string תוכן המסרון
{{ contact }} object איש הקשר של המתקשר או השולח, כשהמספר שמור באחד מספרי אנשי הקשר בחשבון: {id, name, book: {id, name}, url}. null כשלא נמצא איש קשר. בגוף JSON - בלי מרכאות.
{{ contact.name }} string שם איש הקשר של המתקשר או השולח, כפי שהוא שמור בספר אנשי הקשר. ריק כשלא נמצא איש קשר.

סיום עיבוד AI מספר וירטואלי כולל הקלטה בקרוב

משתנה סוג תיאור
{{ id }} string מזהה ייחודי של השיחה באקסטרה.
{{ event }} string האירוע שעליו הוובהוק מדווח
{{ type }} string סטטוס \ סוג השיחה: נכנסת נענתה, יוצאת לא נענתה וכו'
{{ own_type }} string מזהה השירות באקסטרה: מספר וירטואלי, נתב וירטואלי, קו סלולרי
{{ starred }} boolean האם השיחה מסומנת בכוכב?
{{ ivr_dialed }} string מספר שהוקש בנתב הוירטואלי
{{ time.timezone }} string אזור זמן
{{ time.gmt_offset }} string ההפרש מ-GMT
{{ time.start }} string הזמן שבו התחילה השיחה בפורמט רגיל.
{{ numbers.own.friendly }} string מספר הקו שלכם באקסטרה, שממנו הוצאתם שיחה או אליו קיבלתם שיחה.
{{ numbers.own.e164 }} string מספר הקו שלכם באקסטרה בפורמט בינלאומי
{{ numbers.caller.friendly }} string מספר הטלפון של יוזם השיחה בפורמט ידידותי. ריק אם המספר חסום
{{ numbers.caller.e164 }} string מספר הטלפון של יוזם השיחה בפורמט בינלאומי
{{ numbers.destination.e164 }} string מספר הטלפון של מקבל השיחה בפורמט בינלאומי.
{{ numbers.destination.friendly }} string מספר הטלפון של מקבל השיחה בפועל בפורמט ידידותי. לרוב יהיה זהה ל-own_number אבל במקרה של "עקוב אחריי" או בניתוב בנתב הוירטואלי, יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ contact }} object איש הקשר של המתקשר או השולח, כשהמספר שמור באחד מספרי אנשי הקשר בחשבון: {id, name, book: {id, name}, url}. null כשלא נמצא איש קשר. בגוף JSON - בלי מרכאות.
{{ contact.name }} string שם איש הקשר של המתקשר או השולח, כפי שהוא שמור בספר אנשי הקשר. ריק כשלא נמצא איש קשר.
{{ duration }} number משך השיחה בשניות.
{{ recording }} object אובייקט ההקלטה - קישור לקובץ (url) ותוקף בדקות (ttl). נוצר רק כשמוגדר "קישור להקלטת השיחה" בהגדרות הפעולה.
{{ time.end }} string הזמן שבו הסתיימה השיחה בפורמט רגיל.
{{ AI.status }} string סטטוס עיבוד ה-AI.
{{ AI.summary.gist }} string תקציר קצר של השיחה שנוצר ע"י AI.
{{ AI.summary.body }} string סיכום מפורט של השיחה.
{{ AI.summary.next_steps }} array משימות להמשך טיפול שחולצו מהשיחה (מערך JSON).
{{ AI.transcription.text }} string התמלול המלא של השיחה כטקסט - שורה לכל דובר. ערך גדול - לגוף הבקשה בלבד
{{ AI.transcription.json }} object התמלול המלא כאובייקט JSON - דוברים ומקטעים עם חותמות זמן. לשיבוץ בגוף Webhook ללא מירכאות. ערך גדול - לגוף הבקשה בלבד
{{ AI.custom.* }} string שדות מותאמים אישית (GenieAI Autopilot) - לפי המזהה שהגדרתם, למשל AI.custom.sentiment.

נתב שיחות וירטואלי (IVR)

תחילת שיחה נתב שיחות וירטואלי (IVR)

משתנה סוג תיאור
{{ id }} string מזהה ייחודי של השיחה באקסטרה.
{{ event }} string האירוע שעליו הוובהוק מדווח
{{ type }} string סטטוס \ סוג השיחה: נכנסת נענתה, יוצאת לא נענתה וכו'
{{ own_type }} string מזהה השירות באקסטרה: מספר וירטואלי, נתב וירטואלי, קו סלולרי
{{ starred }} boolean האם השיחה מסומנת בכוכב?
{{ ivr_dialed }} string מספר שהוקש בנתב הוירטואלי
{{ time.timezone }} string אזור זמן
{{ time.gmt_offset }} string ההפרש מ-GMT
{{ time.start }} string הזמן שבו התחילה השיחה בפורמט רגיל.
{{ numbers.own.friendly }} string מספר הקו שלכם באקסטרה, שממנו הוצאתם שיחה או אליו קיבלתם שיחה.
{{ numbers.own.e164 }} string מספר הקו שלכם באקסטרה בפורמט בינלאומי
{{ numbers.caller.friendly }} string מספר הטלפון של יוזם השיחה בפורמט ידידותי. ריק אם המספר חסום
{{ numbers.caller.e164 }} string מספר הטלפון של יוזם השיחה בפורמט בינלאומי
{{ numbers.destination.e164 }} string מספר הטלפון של מקבל השיחה בפורמט בינלאומי.
{{ numbers.destination.friendly }} string מספר הטלפון של מקבל השיחה בפועל בפורמט ידידותי. לרוב יהיה זהה ל-own_number אבל במקרה של "עקוב אחריי" או בניתוב בנתב הוירטואלי, יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ contact }} object איש הקשר של המתקשר או השולח, כשהמספר שמור באחד מספרי אנשי הקשר בחשבון: {id, name, book: {id, name}, url}. null כשלא נמצא איש קשר. בגוף JSON - בלי מרכאות.
{{ contact.name }} string שם איש הקשר של המתקשר או השולח, כפי שהוא שמור בספר אנשי הקשר. ריק כשלא נמצא איש קשר.

סיום שיחה נתב שיחות וירטואלי (IVR) כולל הקלטה

משתנה סוג תיאור
{{ id }} string מזהה ייחודי של השיחה באקסטרה.
{{ event }} string האירוע שעליו הוובהוק מדווח
{{ type }} string סטטוס \ סוג השיחה: נכנסת נענתה, יוצאת לא נענתה וכו'
{{ own_type }} string מזהה השירות באקסטרה: מספר וירטואלי, נתב וירטואלי, קו סלולרי
{{ starred }} boolean האם השיחה מסומנת בכוכב?
{{ ivr_dialed }} string מספר שהוקש בנתב הוירטואלי
{{ time.timezone }} string אזור זמן
{{ time.gmt_offset }} string ההפרש מ-GMT
{{ time.start }} string הזמן שבו התחילה השיחה בפורמט רגיל.
{{ numbers.own.friendly }} string מספר הקו שלכם באקסטרה, שממנו הוצאתם שיחה או אליו קיבלתם שיחה.
{{ numbers.own.e164 }} string מספר הקו שלכם באקסטרה בפורמט בינלאומי
{{ numbers.caller.friendly }} string מספר הטלפון של יוזם השיחה בפורמט ידידותי. ריק אם המספר חסום
{{ numbers.caller.e164 }} string מספר הטלפון של יוזם השיחה בפורמט בינלאומי
{{ numbers.destination.e164 }} string מספר הטלפון של מקבל השיחה בפורמט בינלאומי.
{{ numbers.destination.friendly }} string מספר הטלפון של מקבל השיחה בפועל בפורמט ידידותי. לרוב יהיה זהה ל-own_number אבל במקרה של "עקוב אחריי" או בניתוב בנתב הוירטואלי, יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ contact }} object איש הקשר של המתקשר או השולח, כשהמספר שמור באחד מספרי אנשי הקשר בחשבון: {id, name, book: {id, name}, url}. null כשלא נמצא איש קשר. בגוף JSON - בלי מרכאות.
{{ contact.name }} string שם איש הקשר של המתקשר או השולח, כפי שהוא שמור בספר אנשי הקשר. ריק כשלא נמצא איש קשר.
{{ duration }} number משך השיחה בשניות.
{{ recording }} object אובייקט ההקלטה - קישור לקובץ (url) ותוקף בדקות (ttl). נוצר רק כשמוגדר "קישור להקלטת השיחה" בהגדרות הפעולה.
{{ time.end }} string הזמן שבו הסתיימה השיחה בפורמט רגיל.
{{ out_of_hours }} boolean האם השיחה התקבלה מחוץ לשעות הפעילות שהוגדרו למספר?
{{ out_of_hours.behaviour }} string מה נעשה עם השיחה מחוץ לשעות הפעילות: forwarded (הועברה למספר החלופי) או announcement (הושמעה למתקשר הודעה והשיחה נותקה). ריק כשהשיחה התקבלה בשעות הפעילות.
{{ out_of_hours.caption }} string תיאור מילולי של מה שקרה לשיחה מחוץ לשעות הפעילות, מוכן לשליחה בהודעה. ריק כשהשיחה התקבלה בשעות הפעילות.

קבלת SMS נתב שיחות וירטואלי (IVR)

משתנה סוג תיאור
{{ id }} string מזהה ייחודי של המסרון באקסטרה
{{ event }} string האירוע שעליו הוובהוק מדווח
{{ received_at }} string הזמן שבו התקבל המסרון (פורמט YYYY-MM-DD HH:MM)
{{ to }} string המספר שלכם באקסטרה שאליו נשלח המסרון, בפורמט בינלאומי
{{ from }} string השולח: מספר טלפון בפורמט בינלאומי, או שם השולח (כמו ExtraMobile) אם נשלח עם שם
{{ body }} string תוכן המסרון
{{ contact }} object איש הקשר של המתקשר או השולח, כשהמספר שמור באחד מספרי אנשי הקשר בחשבון: {id, name, book: {id, name}, url}. null כשלא נמצא איש קשר. בגוף JSON - בלי מרכאות.
{{ contact.name }} string שם איש הקשר של המתקשר או השולח, כפי שהוא שמור בספר אנשי הקשר. ריק כשלא נמצא איש קשר.

סיום עיבוד AI נתב שיחות וירטואלי (IVR) כולל הקלטה בקרוב

משתנה סוג תיאור
{{ id }} string מזהה ייחודי של השיחה באקסטרה.
{{ event }} string האירוע שעליו הוובהוק מדווח
{{ type }} string סטטוס \ סוג השיחה: נכנסת נענתה, יוצאת לא נענתה וכו'
{{ own_type }} string מזהה השירות באקסטרה: מספר וירטואלי, נתב וירטואלי, קו סלולרי
{{ starred }} boolean האם השיחה מסומנת בכוכב?
{{ ivr_dialed }} string מספר שהוקש בנתב הוירטואלי
{{ time.timezone }} string אזור זמן
{{ time.gmt_offset }} string ההפרש מ-GMT
{{ time.start }} string הזמן שבו התחילה השיחה בפורמט רגיל.
{{ numbers.own.friendly }} string מספר הקו שלכם באקסטרה, שממנו הוצאתם שיחה או אליו קיבלתם שיחה.
{{ numbers.own.e164 }} string מספר הקו שלכם באקסטרה בפורמט בינלאומי
{{ numbers.caller.friendly }} string מספר הטלפון של יוזם השיחה בפורמט ידידותי. ריק אם המספר חסום
{{ numbers.caller.e164 }} string מספר הטלפון של יוזם השיחה בפורמט בינלאומי
{{ numbers.destination.e164 }} string מספר הטלפון של מקבל השיחה בפורמט בינלאומי.
{{ numbers.destination.friendly }} string מספר הטלפון של מקבל השיחה בפועל בפורמט ידידותי. לרוב יהיה זהה ל-own_number אבל במקרה של "עקוב אחריי" או בניתוב בנתב הוירטואלי, יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ contact }} object איש הקשר של המתקשר או השולח, כשהמספר שמור באחד מספרי אנשי הקשר בחשבון: {id, name, book: {id, name}, url}. null כשלא נמצא איש קשר. בגוף JSON - בלי מרכאות.
{{ contact.name }} string שם איש הקשר של המתקשר או השולח, כפי שהוא שמור בספר אנשי הקשר. ריק כשלא נמצא איש קשר.
{{ duration }} number משך השיחה בשניות.
{{ recording }} object אובייקט ההקלטה - קישור לקובץ (url) ותוקף בדקות (ttl). נוצר רק כשמוגדר "קישור להקלטת השיחה" בהגדרות הפעולה.
{{ time.end }} string הזמן שבו הסתיימה השיחה בפורמט רגיל.
{{ AI.status }} string סטטוס עיבוד ה-AI.
{{ AI.summary.gist }} string תקציר קצר של השיחה שנוצר ע"י AI.
{{ AI.summary.body }} string סיכום מפורט של השיחה.
{{ AI.summary.next_steps }} array משימות להמשך טיפול שחולצו מהשיחה (מערך JSON).
{{ AI.transcription.text }} string התמלול המלא של השיחה כטקסט - שורה לכל דובר. ערך גדול - לגוף הבקשה בלבד
{{ AI.transcription.json }} object התמלול המלא כאובייקט JSON - דוברים ומקטעים עם חותמות זמן. לשיבוץ בגוף Webhook ללא מירכאות. ערך גדול - לגוף הבקשה בלבד
{{ AI.custom.* }} string שדות מותאמים אישית (GenieAI Autopilot) - לפי המזהה שהגדרתם, למשל AI.custom.sentiment.

קו סלולר

סיום שיחה קו סלולר כולל הקלטה

משתנה סוג תיאור
{{ id }} string מזהה ייחודי של השיחה באקסטרה.
{{ event }} string האירוע שעליו הוובהוק מדווח
{{ type }} string סטטוס \ סוג השיחה: נכנסת נענתה, יוצאת לא נענתה וכו'
{{ own_type }} string מזהה השירות באקסטרה: מספר וירטואלי, נתב וירטואלי, קו סלולרי
{{ starred }} boolean האם השיחה מסומנת בכוכב?
{{ time.timezone }} string אזור זמן
{{ time.gmt_offset }} string ההפרש מ-GMT
{{ time.start }} string הזמן שבו התחילה השיחה בפורמט רגיל.
{{ numbers.own.friendly }} string מספר הקו שלכם באקסטרה, שממנו הוצאתם שיחה או אליו קיבלתם שיחה.
{{ numbers.own.e164 }} string מספר הקו שלכם באקסטרה בפורמט בינלאומי
{{ numbers.caller.friendly }} string מספר הטלפון של יוזם השיחה בפורמט ידידותי. ריק אם המספר חסום
{{ numbers.caller.e164 }} string מספר הטלפון של יוזם השיחה בפורמט בינלאומי
{{ numbers.destination.e164 }} string מספר הטלפון של מקבל השיחה בפורמט בינלאומי.
{{ numbers.destination.friendly }} string מספר הטלפון של מקבל השיחה בפועל בפורמט ידידותי. לרוב יהיה זהה ל-own_number אבל במקרה של "עקוב אחריי", יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ contact }} object איש הקשר של המתקשר או השולח, כשהמספר שמור באחד מספרי אנשי הקשר בחשבון: {id, name, book: {id, name}, url}. null כשלא נמצא איש קשר. בגוף JSON - בלי מרכאות.
{{ contact.name }} string שם איש הקשר של המתקשר או השולח, כפי שהוא שמור בספר אנשי הקשר. ריק כשלא נמצא איש קשר.
{{ duration }} number משך השיחה בשניות.
{{ recording }} object אובייקט ההקלטה - קישור לקובץ (url) ותוקף בדקות (ttl). נוצר רק כשמוגדר "קישור להקלטת השיחה" בהגדרות הפעולה.
{{ time.end }} string הזמן שבו הסתיימה השיחה בפורמט רגיל.

סיום עיבוד AI קו סלולר כולל הקלטה בקרוב

משתנה סוג תיאור
{{ id }} string מזהה ייחודי של השיחה באקסטרה.
{{ event }} string האירוע שעליו הוובהוק מדווח
{{ type }} string סטטוס \ סוג השיחה: נכנסת נענתה, יוצאת לא נענתה וכו'
{{ own_type }} string מזהה השירות באקסטרה: מספר וירטואלי, נתב וירטואלי, קו סלולרי
{{ starred }} boolean האם השיחה מסומנת בכוכב?
{{ time.timezone }} string אזור זמן
{{ time.gmt_offset }} string ההפרש מ-GMT
{{ time.start }} string הזמן שבו התחילה השיחה בפורמט רגיל.
{{ numbers.own.friendly }} string מספר הקו שלכם באקסטרה, שממנו הוצאתם שיחה או אליו קיבלתם שיחה.
{{ numbers.own.e164 }} string מספר הקו שלכם באקסטרה בפורמט בינלאומי
{{ numbers.caller.friendly }} string מספר הטלפון של יוזם השיחה בפורמט ידידותי. ריק אם המספר חסום
{{ numbers.caller.e164 }} string מספר הטלפון של יוזם השיחה בפורמט בינלאומי
{{ numbers.destination.e164 }} string מספר הטלפון של מקבל השיחה בפורמט בינלאומי.
{{ numbers.destination.friendly }} string מספר הטלפון של מקבל השיחה בפועל בפורמט ידידותי. לרוב יהיה זהה ל-own_number אבל במקרה של "עקוב אחריי", יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ contact }} object איש הקשר של המתקשר או השולח, כשהמספר שמור באחד מספרי אנשי הקשר בחשבון: {id, name, book: {id, name}, url}. null כשלא נמצא איש קשר. בגוף JSON - בלי מרכאות.
{{ contact.name }} string שם איש הקשר של המתקשר או השולח, כפי שהוא שמור בספר אנשי הקשר. ריק כשלא נמצא איש קשר.
{{ duration }} number משך השיחה בשניות.
{{ recording }} object אובייקט ההקלטה - קישור לקובץ (url) ותוקף בדקות (ttl). נוצר רק כשמוגדר "קישור להקלטת השיחה" בהגדרות הפעולה.
{{ time.end }} string הזמן שבו הסתיימה השיחה בפורמט רגיל.
{{ AI.status }} string סטטוס עיבוד ה-AI.
{{ AI.summary.gist }} string תקציר קצר של השיחה שנוצר ע"י AI.
{{ AI.summary.body }} string סיכום מפורט של השיחה.
{{ AI.summary.next_steps }} array משימות להמשך טיפול שחולצו מהשיחה (מערך JSON).
{{ AI.transcription.text }} string התמלול המלא של השיחה כטקסט - שורה לכל דובר. ערך גדול - לגוף הבקשה בלבד
{{ AI.transcription.json }} object התמלול המלא כאובייקט JSON - דוברים ומקטעים עם חותמות זמן. לשיבוץ בגוף Webhook ללא מירכאות. ערך גדול - לגוף הבקשה בלבד
{{ AI.custom.* }} string שדות מותאמים אישית (GenieAI Autopilot) - לפי המזהה שהגדרתם, למשל AI.custom.sentiment.

שלוחת סופטפון

סיום שיחה שלוחת סופטפון כולל הקלטה

משתנה סוג תיאור
{{ id }} string מזהה ייחודי של השיחה באקסטרה.
{{ event }} string האירוע שעליו הוובהוק מדווח
{{ type }} string סטטוס \ סוג השיחה: נכנסת נענתה, יוצאת לא נענתה וכו'
{{ own_type }} string מזהה השירות באקסטרה: מספר וירטואלי, נתב וירטואלי, קו סלולרי
{{ starred }} boolean האם השיחה מסומנת בכוכב?
{{ time.timezone }} string אזור זמן
{{ time.gmt_offset }} string ההפרש מ-GMT
{{ time.start }} string הזמן שבו התחילה השיחה בפורמט רגיל.
{{ numbers.own.friendly }} string מספר הקו שלכם באקסטרה, שממנו הוצאתם שיחה או אליו קיבלתם שיחה.
{{ numbers.own.e164 }} string מספר הקו שלכם באקסטרה בפורמט בינלאומי
{{ numbers.caller.friendly }} string מספר הטלפון של יוזם השיחה בפורמט ידידותי. ריק אם המספר חסום
{{ numbers.caller.e164 }} string מספר הטלפון של יוזם השיחה בפורמט בינלאומי
{{ numbers.destination.e164 }} string מספר הטלפון של מקבל השיחה בפורמט בינלאומי.
{{ numbers.destination.friendly }} string מספר הטלפון של מקבל השיחה בפועל בפורמט ידידותי. לרוב יהיה זהה ל-own_number אבל במקרה של "עקוב אחריי", יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ contact }} object איש הקשר של המתקשר או השולח, כשהמספר שמור באחד מספרי אנשי הקשר בחשבון: {id, name, book: {id, name}, url}. null כשלא נמצא איש קשר. בגוף JSON - בלי מרכאות.
{{ contact.name }} string שם איש הקשר של המתקשר או השולח, כפי שהוא שמור בספר אנשי הקשר. ריק כשלא נמצא איש קשר.
{{ duration }} number משך השיחה בשניות.
{{ recording }} object אובייקט ההקלטה - קישור לקובץ (url) ותוקף בדקות (ttl). נוצר רק כשמוגדר "קישור להקלטת השיחה" בהגדרות הפעולה.
{{ time.end }} string הזמן שבו הסתיימה השיחה בפורמט רגיל.

סיום עיבוד AI שלוחת סופטפון כולל הקלטה בקרוב

משתנה סוג תיאור
{{ id }} string מזהה ייחודי של השיחה באקסטרה.
{{ event }} string האירוע שעליו הוובהוק מדווח
{{ type }} string סטטוס \ סוג השיחה: נכנסת נענתה, יוצאת לא נענתה וכו'
{{ own_type }} string מזהה השירות באקסטרה: מספר וירטואלי, נתב וירטואלי, קו סלולרי
{{ starred }} boolean האם השיחה מסומנת בכוכב?
{{ time.timezone }} string אזור זמן
{{ time.gmt_offset }} string ההפרש מ-GMT
{{ time.start }} string הזמן שבו התחילה השיחה בפורמט רגיל.
{{ numbers.own.friendly }} string מספר הקו שלכם באקסטרה, שממנו הוצאתם שיחה או אליו קיבלתם שיחה.
{{ numbers.own.e164 }} string מספר הקו שלכם באקסטרה בפורמט בינלאומי
{{ numbers.caller.friendly }} string מספר הטלפון של יוזם השיחה בפורמט ידידותי. ריק אם המספר חסום
{{ numbers.caller.e164 }} string מספר הטלפון של יוזם השיחה בפורמט בינלאומי
{{ numbers.destination.e164 }} string מספר הטלפון של מקבל השיחה בפורמט בינלאומי.
{{ numbers.destination.friendly }} string מספר הטלפון של מקבל השיחה בפועל בפורמט ידידותי. לרוב יהיה זהה ל-own_number אבל במקרה של "עקוב אחריי", יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ contact }} object איש הקשר של המתקשר או השולח, כשהמספר שמור באחד מספרי אנשי הקשר בחשבון: {id, name, book: {id, name}, url}. null כשלא נמצא איש קשר. בגוף JSON - בלי מרכאות.
{{ contact.name }} string שם איש הקשר של המתקשר או השולח, כפי שהוא שמור בספר אנשי הקשר. ריק כשלא נמצא איש קשר.
{{ duration }} number משך השיחה בשניות.
{{ recording }} object אובייקט ההקלטה - קישור לקובץ (url) ותוקף בדקות (ttl). נוצר רק כשמוגדר "קישור להקלטת השיחה" בהגדרות הפעולה.
{{ time.end }} string הזמן שבו הסתיימה השיחה בפורמט רגיל.
{{ AI.status }} string סטטוס עיבוד ה-AI.
{{ AI.summary.gist }} string תקציר קצר של השיחה שנוצר ע"י AI.
{{ AI.summary.body }} string סיכום מפורט של השיחה.
{{ AI.summary.next_steps }} array משימות להמשך טיפול שחולצו מהשיחה (מערך JSON).
{{ AI.transcription.text }} string התמלול המלא של השיחה כטקסט - שורה לכל דובר. ערך גדול - לגוף הבקשה בלבד
{{ AI.transcription.json }} object התמלול המלא כאובייקט JSON - דוברים ומקטעים עם חותמות זמן. לשיבוץ בגוף Webhook ללא מירכאות. ערך גדול - לגוף הבקשה בלבד
{{ AI.custom.* }} string שדות מותאמים אישית (GenieAI Autopilot) - לפי המזהה שהגדרתם, למשל AI.custom.sentiment.

יומן פגישות (When)

פגישה נקבעה יומן פגישות (When)

משתנה סוג תיאור
{{ event }} string האירוע שעליו הדיווח (WhenMeetingScheduled / WhenMeetingCancelled)
{{ booking.id }} string מזהה ייחודי של הפגישה באקסטרה
{{ type.slug }} string כתובת היומן (ה-slug בקישור הציבורי)
{{ type.title }} string כותרת היומן
{{ time.date }} string תאריך הפגישה (DD/MM/YYYY)
{{ time.start }} string שעת תחילת הפגישה (HH:MM)
{{ time.end }} string שעת סיום הפגישה (HH:MM)
{{ time.start_iso }} string מועד תחילת הפגישה בפורמט ISO 8601 (למערכות)
{{ time.end_iso }} string מועד סיום הפגישה בפורמט ISO 8601 (למערכות)
{{ duration_minutes }} number אורך הפגישה בדקות
{{ day_name }} string שם היום בעברית (יום שלישי)
{{ booker.name }} string השם שהזין קובע הפגישה
{{ booker.phone }} string הטלפון של קובע הפגישה בפורמט בינלאומי
{{ booker.phone_friendly }} string הטלפון של קובע הפגישה בפורמט ידידותי
{{ booker.email }} string המייל של קובע הפגישה
{{ answers }} string התשובות לשאלות היומן, שורה לכל שאלה (שאלה: תשובה)
{{ __answers_json }} string התשובות לשאלות היומן כ-JSON (למערכות)
{{ location.type }} string אופן הפגישה (שיחה טלפונית / שיחת וידאו / פגישה פרונטלית)
{{ location.note }} string ההערה על אופן הפגישה (קישור לשיחה / כתובת)
{{ cancel_url }} string קישור הביטול שנשלח לקובע הפגישה

פגישה בוטלה יומן פגישות (When)

משתנה סוג תיאור
{{ event }} string האירוע שעליו הדיווח (WhenMeetingScheduled / WhenMeetingCancelled)
{{ booking.id }} string מזהה ייחודי של הפגישה באקסטרה
{{ type.slug }} string כתובת היומן (ה-slug בקישור הציבורי)
{{ type.title }} string כותרת היומן
{{ time.date }} string תאריך הפגישה (DD/MM/YYYY)
{{ time.start }} string שעת תחילת הפגישה (HH:MM)
{{ time.end }} string שעת סיום הפגישה (HH:MM)
{{ time.start_iso }} string מועד תחילת הפגישה בפורמט ISO 8601 (למערכות)
{{ time.end_iso }} string מועד סיום הפגישה בפורמט ISO 8601 (למערכות)
{{ duration_minutes }} number אורך הפגישה בדקות
{{ day_name }} string שם היום בעברית (יום שלישי)
{{ booker.name }} string השם שהזין קובע הפגישה
{{ booker.phone }} string הטלפון של קובע הפגישה בפורמט בינלאומי
{{ booker.phone_friendly }} string הטלפון של קובע הפגישה בפורמט ידידותי
{{ booker.email }} string המייל של קובע הפגישה
{{ answers }} string התשובות לשאלות היומן, שורה לכל שאלה (שאלה: תשובה)
{{ __answers_json }} string התשובות לשאלות היומן כ-JSON (למערכות)
{{ location.type }} string אופן הפגישה (שיחה טלפונית / שיחת וידאו / פגישה פרונטלית)
{{ location.note }} string ההערה על אופן הפגישה (קישור לשיחה / כתובת)
{{ cancel_url }} string קישור הביטול שנשלח לקובע הפגישה
{{ cancelled_by }} string מי ביטל: booker (קובע הפגישה) / owner (אתם) / system
{{ time.cancelled }} string מועד הביטול

שאלות נפוצות

  • מה זה בעצם "משתנה" באוטומציה?

    כל אירוע מגיע עם נתונים - שם המתקשר, משך השיחה, תוכן ה-SMS ועוד. משתנה הוא סימון בסוגריים מסולסלים, למשל {{ numbers.caller.friendly }}, שאותו אקסטרה מחליפה בערך האמיתי מאותה שיחה או פגישה בכל הפעלה.

  • איך יודעים אילו משתנים זמינים לי?

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

  • איפה משבצים את המשתנים?

    בכל שדה של הפעולה: כתובת ה-URL, הכותרות (Headers) או גוף הבקשה (Body). גוררים או מקלידים את הסימון {{ ... }}, ובכל הפעלה המערכת ממלאת אותו בערך האמיתי מהאירוע.

  • מה ההבדל בין משתנה רגיל למשתנה מסוג object או array?

    משתנה רגיל מחזיר ערך פשוט (טקסט, מספר, כן/לא). משתנה מסוג object או array מחזיר מבנה נתונים שלם, כמו אובייקט ההקלטה או התמלול המלא. את אלה משבצים בגוף הבקשה (Body) ללא מירכאות, ולא בתוך כתובת ה-URL.

  • למה חלק מהמשתנים לא מופיעים אצלי?

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

  • מה קורה אם משתנה ריק בשיחה מסוימת?

    המערכת משבצת ערך ריק במקומו. למשל, שיחה ממספר חסום תשאיר את {{ numbers.caller.friendly }} ריק - אבל האוטומציה עצמה תמשיך לרוץ כרגיל ותישלח ליעד.

מוכנים לבנות אוטומציה?

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

לפני שאתם בונים, כדאי לקרוא איך עובדים נכון מול ה-API: מתי להירשם לאירוע במקום לדגום, ומה עדיף לא לשמור אצלכם.