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

כל משתנה משובץ בעזרת סוגריים מסולסלים כפולים, למשל {{ 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 אבל במקרה של "עקוב אחריי" או בניתוב בנתב הוירטואלי, יחזיק את המספר שאליו השיחה חוברה בפועל.

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

משתנה סוג תיאור
{{ 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 אבל במקרה של "עקוב אחריי" או בניתוב בנתב הוירטואלי, יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ 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 תוכן המסרון

סיום עיבוד 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 אבל במקרה של "עקוב אחריי" או בניתוב בנתב הוירטואלי, יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ 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 אבל במקרה של "עקוב אחריי" או בניתוב בנתב הוירטואלי, יחזיק את המספר שאליו השיחה חוברה בפועל.

סיום שיחה נתב שיחות וירטואלי (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 אבל במקרה של "עקוב אחריי" או בניתוב בנתב הוירטואלי, יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ 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 תוכן המסרון

סיום עיבוד 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 אבל במקרה של "עקוב אחריי" או בניתוב בנתב הוירטואלי, יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ 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 אבל במקרה של "עקוב אחריי", יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ 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 אבל במקרה של "עקוב אחריי", יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ 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 אבל במקרה של "עקוב אחריי", יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ 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 אבל במקרה של "עקוב אחריי", יחזיק את המספר שאליו השיחה חוברה בפועל.
{{ 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: מתי להירשם לאירוע במקום לדגום, ומה עדיף לא לשמור אצלכם.