פעולות — בלוקי ה‑THEN
פעולה היא שלב שעושה משהו: שולח הודעה, מעדכן שיחה, כותב ל‑CRM שלכם, קורא ל‑API חיצוני, שולח אימייל, או ממיר ערך עבור הבלוק הבא.
הפעולות נושאות את התג הטורקיז THEN. אתם מוסיפים אותן מבורר הבלוקים: גררו מחבר מכל בלוק ושחררו אותו על קנבס ריק.
הרשימה המלאה
| פעולה | קבוצה | מה היא עושה |
|---|---|---|
| מענה בהודעה | שיחות | שולחת הודעה ללקוח, ויכולה להשהות את התהליך עד שהוא ישיב. |
| הערה פרטית | שיחות | מוסיפה הערה פנימית שהלקוח לעולם אינו רואה. |
| שינוי שיחה | שיחות | מוסרת לאדם, לצוות או לתור ההמתנה; מתייגת, קובעת עדיפות, מסמנת כטופל, משנה שם ומגדירה מאפייני שיחה. |
| סיום סשן | שיחות | משחררת את השיחה מסטודיו, ואופציונלית מסמנת אותה כטופלה. |
| המתנה | זרימה | משהה את המסלול הזה ל‑1–15 שניות. |
| שמירה כמשתנה | זרימה | שומרת ערך לצמיתות תחת var.* עבור הרצות עתידיות. |
| עדכון איש קשר | CRM | כותבת לשדות ברשומת איש הקשר. |
| הוספה, עדכון או מחיקה של רשומה | CRM | כותבת רשומה של כל אובייקט — לקוח, איש קשר, הזמנה, כל דבר. |
| בקשת HTTP | חיצוני | קוראת ל‑API חיצוני, ואופציונלית לוכדת את התגובה. |
| שליחת אימייל | חיצוני | שולחת אימייל מתיבה או מהשולח המערכתי של Teloring. |
| קוד | כלים | מריצה טרנספורמציית JavaScript קטנה בסביבה מבודדת. |
| תאריך ושעה | כלים | מקבלת, מעצבת, מוסיפה, מחסירה, משווה, מחלצת או מעגלת תאריכים. |
| שליחת התראת Teloring | כלים | מתריעה לנציגים בתוך Teloring — פעמון, צליל, אימייל ודחיפה בדפדפן. |
| השמעת צליל | קול | משמיעה הקלטה למתקשר. |
| המתנה / השהיה | קול | משהה את השיחה לרגע קצר. |
| תפריט IVR | קול | משמיעה תפריט ומנתבת לפי ספרה במקלדת. |
| העברה לנציג | קול | מצלצלת לנציג בדפדפן ומגשרת את השיחה. |
| העברה לטלפון חיצוני | קול | מעבירה את השיחה למספר חיצוני. |
| ניתוק | קול | מסיימת את השיחה. |
בלוקי הסתעפות — תנאי If/Else, שעות פעילות, זמינות נציגים — נושאים את תג הענבר IF ומתועדים בתנאים.
דברים שנכונים לכל פעולה
- שדות טקסט מקבלים משתנים. הקלידו
{{או גררו משתנה ממדור המשתנים הזמינים. ראו משתנים. - פלטים הופכים למשתנים. כל מה שפעולה מפיקה זמין לכל בלוק שאחריה.
- התפצלות מריצה הכול. אם מפעולה יוצאים שלושה מחברים, כל שלושת המסלולים רצים.
- פעולה שנכשלת עוצרת את המסלול שלה בלבד, לא את כל התהליך — הסתעפויות אחרות ממשיכות.
מענה בהודעה
שולחת הודעה ללקוח בשיחה, בדיוק כאילו נציג הקליד אותה. היא יוצאת בערוץ שבו השיחה מתנהלת — WhatsApp, אימייל, SMS, טלגרם, צ׳אט באתר וכן הלאה.
זה גם הבלוק שהופך תהליך לשיחה: הפעילו את המתנה לתשובת הלקוח והתהליך יושהה עד שהלקוח ישיב.
תהליכי הודעות בלבד.
מאפיינים
| מאפיין | מה הוא עושה | ברירת מחדל |
|---|---|---|
| מזהה השיחה | לאיזו שיחה לשלוח. השאירו את ברירת המחדל כדי להשיב בשיחה שהפעילה את התהליך. | {{conversation.id}} |
| הודעה (חובה) | הטקסט לשליחה. השתמשו במשתנים להתאמה אישית. | ריק |
| המתנה לתשובת הלקוח | משהה את המסלול הזה עד שהלקוח משיב. התשובה שלו הופכת ל‑{{message.content}} החדש וזמינה גם כ‑{{client_reply.content}}. | כבוי |
| פסק זמן להמתנה (דקות) | כמה זמן להמתין לפני ויתור. 0 פירושו ללא פסק זמן — התהליך ממשיך להמתין. בכל מקרה Teloring מחזיקה תהליך ממתין עד 30 יום. מופיע רק כשההמתנה מופעלת. | 0 |
פלטים
| משתנה | מכיל |
|---|---|
{{reply.message_id}} | ההודעה שנשלחה |
{{reply.conversation_id}} | לאן היא נשלחה |
{{reply.sent_at}} | מתי |
{{reply.status}} | סטטוס השליחה |
{{client_reply.content}} | מה הלקוח השיב (כשיש המתנה) |
{{client_reply.content_type}} | סוג התשובה — button / list כשהלקוח לחץ על כפתור או בחר שורה ברשימת WhatsApp |
{{client_reply.reply_id}} | המזהה של הכפתור או של שורת הרשימה שהלקוח בחר (ריק כשהלקוח הקליד) |
{{client_reply.message_id}} · {{client_reply.received_at}} | הודעת התשובה וחותמת הזמן |
איך ההמתנה מתנהגת
- כל עוד התהליך ממתין, השיחה נשארת בתור בוט סטודיו.
- תשובת הלקוח נצרכת על ידי התהליך הממתין — היא אינה מתחילה הרצה שנייה של אותו תהליך.
- לאחר ההמתנה, אפשר לבדוק את התשובה גם עם
{{message.content}}וגם עם{{client_reply.content}}; שניהם מכילים את אותו טקסט. - אם תנאי שאחרי המתנה אינו תואם לאף הסתעפות ואין הסתעפות ELSE, התהליך ממשיך להמתין באותו תנאי ומעריך אותו מחדש בהודעה הבאה של הלקוח. הוסיפו הסתעפות ELSE, או בלוק סיום סשן, כדי שלקוח לעולם לא ייתקע בתוך התהליך.
- אם פסק הזמן פג, ההרצה מסתיימת בסטטוס
timed_out.
שאלו שאלה אחת בכל מענה בהודעה. שתי שאלות בהודעה אחת מקבלות תשובה אחת, ולתנאי שלכם אין מה להתאים בצורה נקייה.
הערה פרטית
מוסיפה הערה פנימית לשיחה. היא מופיעה בציר הזמן של השיחה עבור הנציגים ולעולם אינה נשלחת ללקוח, בשום ערוץ.
מאפיינים
| מאפיין | מה הוא עושה | ברירת מחדל |
|---|---|---|
| מזהה השיחה | איזו שיחה מקבלת את ההערה. | {{conversation.id}} |
| הערה פרטית | טקסט ההערה. משתנים נתמכים. | ריק |
פלטים
| משתנה | מכיל |
|---|---|
{{private_note.message_id}} | ההערה |
{{private_note.conversation_id}} | לאן היא נוספה |
{{private_note.created_at}} · {{private_note.status}} | מתי, ומה התוצאה |
שימושים טובים: לתעד מה בוט אסף לפני המסירה, להדביק סטטוס הזמנה שנמשך מ‑API, או להשאיר את הסיבה להסלמת שיחה.
שינוי שיחה
מעדכנת את השיחה — והכי חשוב, זה המקום שבו אתם מוסרים אותה לאדם: לנציג ספציפי, לצוות שלם או לתור ההמתנה.
מאפיינים
| מאפיין | אפשרויות | מה הוא עושה |
|---|---|---|
| מזהה השיחה | טקסט / משתנה | איזו שיחה לעדכן. ברירת המחדל היא {{conversation.id}}. |
| שיוך סוכן AI / נציג אנושי | מופעל / כבוי | מוסר את השיחה לסוכן — AI או נציג אנושי — לצוות, או לתור ההמתנה. סטודיו מפסיק להחזיק בה, כך שההודעה הבאה מהלקוח מגיעה לסוכן ולא חזרה לתהליך. |
| מסירה אל | תור ההמתנה (הנציג הפנוי הבא) · נציג ספציפי · צוות | מופיע כשהשיוך מופעל. |
| נציג | בוחר נציגים | מופיע כשמוסרים לנציג ספציפי. גם סוכני AI מופיעים ברשימה, מסומנים ב־· AI. |
| צוות | בוחר צוותים | מופיע כשמוסרים לצוות. הסימן ⚡ מציין צוות שמשייך אוטומטית לחבר מחובר; המספר בסוגריים הוא כמות הנציגים בו. |
| מצב תוויות | הוספת תוויות · החלפת תוויות · הסרת תוויות | איך התוויות שלמטה מוחלות. |
| תוויות | תווית אחת בכל שורה | התוויות להוספה, לקביעה או להסרה. |
| עדיפות | ללא שינוי · נמוכה · בינונית · גבוהה · דחופה | קובע את עדיפות השיחה. |
| סטטוס | ללא שינוי · פתוחה · ממתינה · טופלה | קובע את סטטוס השיחה. |
| דגל | ללא שינוי · ללא · חשוב · למעקב | קובע את דגל השיחה. |
| נושא | טקסט / משתנה | משנה את שם השיחה. |
| מאפייני שיחה | בוחר מאפיינים + ערך | מגדיר את מאפייני השיחה של החשבון שלכם בשיחה הזו. בחרו את המאפיין, הקלידו את הערך — משתנים מותרים. ראו למטה. |
פלטים
| משתנה | מכיל |
|---|---|
{{conversation.status}} | תוצאת העדכון |
{{conversation.updated_fields}} | אילו שדות השתנו |
{{conversation.handover}} | queue, agent, team או ריק |
{{conversation.handover_agent_id}} | הנציג שאליו נמסרה — במסירה לצוות, החבר ששויך אוטומטית, או ריק אם היא ממתינה בתור |
{{conversation.handover_team_id}} | הצוות שאליו נמסרה |
{{conversation.handover_team_name}} | שם הצוות הזה |
{{conversation.custom_attributes}} | כל מאפייני השיחה, כאובייקט אחד |
{{conversation.custom_attributes.<api_id>}} | מאפיין בודד — למשל {{conversation.custom_attributes.reason_for_contact}} |
הגדרת מאפייני שיחה
מאפייני שיחה הם השדות של החשבון שלכם על שיחה — סיבת הפנייה, תוצאה, מספר הזמנה. הם נמצאים בבלוק הזה ולא בבלוק נפרד, כי הם שדות של השיחה בדיוק כמו עדיפות ונושא.
לחצו הוספת שדה תחת מאפייני שיחה, בחרו מאפיין ותנו לו ערך. הערך מקבל משתנים, כך שתהליך יכול לסווג שיחה לפי מה שהוא כבר יודע:
| התהליך | מגדיר |
|---|---|
| תפריט שואל "במה מדובר?" | סיבת הפנייה = הכפתור שהלקוח לחץ |
| טופס פותח את השיחה | מספר הזמנה = {{answers.order_number}} |
| בקשת HTTP מאתרת את הלקוח | רמת החשבון = {{http.json.tier}} |
| הבוט מסמן את השיחה כטופלה בעצמו | תוצאה = נפתר על ידי הבוט |
| כלל | התנהגות |
|---|---|
| הערכים מאומתים | ערך שאינו אחת מהאפשרויות ברשימה נפתחת מכשיל את הבלוק, כך שתהליך לעולם לא יכתוב משהו שפאנל הנציג יסרב להציג. |
| מאפיינים שנמחקו מדולגים | מאפיין שהוסר מההגדרות אחרי שהתהליך נבנה נדחה, והבלוק ממשיך לרוץ. |
| מאפיינים אחרים נשמרים | הגדרת מאפיין אחד לעולם אינה מנקה את השאר. |
| בחירה מרובה | הפרידו ערכים בפסיקים או בשורות חדשות. |
הבלוק מפיק את הערכים החדשים, כך שכל בלוק שאחריו — ובראשם בקשת HTTP — רואה את מה שנכתב זה עתה. המאפיינים זמינים גם מהטריגר, בלי הבלוק הזה, בהודעה נכנסת, בשיחה נכנסת ובשינוי בשיחה. ראו משתנים.
להבין א ת שיוך סוכן AI / נציג אנושי
| הגדרה | מה קורה |
|---|---|
| כבויה | רק התוויות, העדיפות, הסטטוס, הדגל והנושא משתנים. סטודיו ממשיך להחזיק בשיחה והודעות מאוחרות יותר עדיין מריצות את התהליך. |
| מופעלת ← נציג ספציפי | השיחה משויכת לאותו נציג ויוצאת מתור בוט סטודיו. אם השיחה הייתה בצוות שהנציג אינו חבר בו, הצוות מנוקה. |
| מופעלת ← נציג ספציפי, והנציג הוא סוכן AI | סוכן ה־AI מקבל את השיחה ומתחיל להשיב: נפתחת שיחת AI, נשלחת הודעת הפתיחה שלו, והוא מגיב למה שהלקוח כבר כתב. השיחה עוברת לתור סוכן AI ולא לתור של אדם. אם ה־AI אינו יכול לקבל אותה — הסוכן מושבת, הפרופיל שלו אינו מתיר את תיבת הדואר הזו, או שהשיחה כבר טופלה — הבלוק נכשל והשיחה נשארת בדיוק כפי שהייתה. |
| מופעלת ← צוות | הצוות מקבל בעלות. אם הצוות משייך אוטומטית לנציג מחובר, אחד מחבריו המחוברים מקבל אותה מיד (סוכן AI בצוות נחשב מחובר, והוא מקבל את השיחה כמו בשורה שמעל); אחרת היא ממתינה בתור ורק חברי הצוות הזה יכולים למשוך אותה עם קבלת הבא בתור. שיחה שטופלה נפתחת מחדש תחילה. |
| מופעלת ← תור ההמתנה | השיחה מוסרת מכל שיוך ונשלחת לתור ממתינות בתור עבור מי שיתפנה הבא. שיחה שטופלה נפתחת מחדש תחילה, כי שיחה שטופלה אינה יכולה להמתין בתור. |
בכל מקרה, המסירה נשארת בתוקף: הודעות מאוחרות יותר בשיחה הזו לא יימשכו בחזרה לתהליך הזה — ולא לשום תהליך חי אחר. המסירה מנוקה אוטומטית כשהשיחה מסומנת כטופלה, כששיחה משויכת לנציג ספציפי, או כשתהליך מריץ סיום סשן.
- בחרו את הצוות. אם מסירה אל מוגדר לצוות אך לא נבחר צוות, המסירה נופלת חזרה לתור ההמתנה הרגיל. העורך מסמן את הבלוק בזמן העריכה.
- מחיקת צוות שוברת את הבלוק. אם הצוות שנבחר נמחק בהמשך, הבלוק נכשל בזמן ריצה במקום להחנות את השיחה בצוות שכבר אינו קיים. סקרו את התהליכים החיים שלכם אחרי מחיקת צוות.
לכל תהליך שמדבר עם לקוחות צריך להיות מסלול לאדם. חברו הסתעפות של "אני רוצה לדבר עם מישהו", או הסתעפות גיבוי, לבלוק שינוי שיחה עם שיוך סוכן AI / נציג אנושי מופעל.
סיום סשן
מסיימת את מעורבות סטודיו בשיחה. ההודעה הבאה מאותו לקוח מתחילה התאמת טריגרים מאפס, כאילו התהליך מעולם לא רץ.
מאפיינים
| מאפיין | מה הוא עושה | ברירת מחדל |
|---|---|---|
| מזהה השיחה | איזו שיחה לשחרר. | {{conversation.id}} |
| לסמן גם את השיחה כטופלה? | מסמנת גם את השיחה כטופלה. | כבוי |
פלטים
| משתנה | מכיל |
|---|---|
{{session.status}} | תוצאה |
{{session.conversation_id}} | השיחה |
{{session.resolved}} | האם היא גם סומנה כטופלה |
סיום סשן מול שיוך סוכן AI / נציג אנושי
| השתמשו ב | מתי |
|---|---|
| סיום סשן | הבוט סיים את תפקידו. אף אחד מסוים לא צריך לפעול, וההודעה הבאה צריכה להיות מסוגלת להתחיל תהליך שוב. |
| שינוי שיחה ← שיוך סוכן AI / נציג אנושי | סוכן (אנושי או AI) או צוות צריכים לקחת את השיחה הזו עכשיו. |
המ תנה
משהה את המסלול הזה בתהליך למספר שניות לפני ההמשך. השתמשו בה כדי לפזר הודעות, כך שבוט יישמע פחות רובוטי.
תהליכי הודעות בלבד. תהליכי קול משתמשים בהמתנה / השהיה.
מאפיינים
| מאפיין | מה הוא עושה | ברירת מחדל |
|---|---|---|
| משך ההמתנה (שניות) | בין שנייה אחת ל‑15 שניות. | 3 |
פלטים
| משתנה | מכיל |
|---|---|
{{wait.seconds}} | כמה זמן הוא המתין |
ההמתנה מעכבת רק את ההסתעפות שהיא יושבת ע ליה. אם הטריגר מזין גם הסתעפות אחרת, ההסתעפות ההיא רצה מיד — היא אינה ממתינה בתור אחרי ההמתנה.
שמירה כמשתנה
שומרת ערך לצמיתות, כך שהרצות מאוחרות יותר של אותו תהליך יוכלו לקרוא אותו בחזרה. משתנים רגילים חיים רק להרצה אחת; משתנה שמור שורד אותה.
מאפיינים
| מאפיין | מה הוא עושה | ברירת מחדל |
|---|---|---|
| מפתח המשתנה | השם שתחתיו לשמור. תמיד בתוך מרחב השמות var.. מפתחות דינמיים מותרים, למשל var.{{contact.phone}}.address. | var.my_value |
| ערך | מה לשמור. משתנים נתמכים. | {{message.content}} |
| סוג הערך | טקסט · מספר · בוליאני · JSON | טקסט |
| דריסת משתנה קיים | האם מותר להחליף ערך קיים באותו מפתח. | מופעל |
פלטים
| משתנה | מכיל |
|---|---|
{{saved_variable.key}} | המפתח המנורמל שנכתב |
{{saved_variable.value}} | הערך השמור |
{{saved_variable.status}} | תוצאה |
איך משתנים שמורים עובדים
- הם לכל תהליך בנפרד. לשני תהליכים יכול להיות
var.counterמשלהם בלי התנגשות. - הם נטענים לכל הרצה של אותו תהליך, כך ש‑
{{var.my_value}}זמין כבר מהבלוק הראשון. - המפתחות נאלצים לתוך מרחב השמות
var., כך שערך שמור לעולם אינו יכול לדרוס משתנה של מערכת, של איש קשר, של שיחה או של הודעה. - תווים לא נתמכים במפתח הופכים לקווים תחתונים.
- סקרו ומחקו אותם ב**⚙ הגדרות התהליך ← משתנים שמורים**.
שימושים טובים: לזכור העדפה של לקוח לפי מספר טלפון, לשמור את המזהה האחרון שסונכרן ממערכת חיצונית, או להחזיק מונה מצטבר.
עדכון איש קשר
כותבת לשדות ברשומת איש הקשר — האדם, לא החברה.
מאפיינים
| מאפיין | מה הוא עושה | ברירת מחדל |
|---|---|---|
| מזהה איש הקשר | איזה איש קשר לעדכן. | {{contact.id}} |
| שדות לעדכון | שורות של שדה ← ערך. שם השדה הוא רשימה נפתחת של שדות איש הקשר שהחשבון שלכם באמת הגדיר בעורך השדות. שדה שכבר בשימוש בשורה אחת נעלם מהרשימות האחרות. הערכים תומכים במשתנים. | ריק |
פלטים
| משתנה | מכיל |
|---|---|
{{contact.status}} | תוצאה |
{{contact.updated_fields}} | אילו שדות נכתבו |
שדות מערכת מוגנים אינם ניתנים לכתיבה על ידי תהליך. אם שדה שאתם מצפים לו חסר ברשימה, הוסיפו אותו קודם לאובייקט אנשי הקשר בבונה האובייקטים. עדכון איש קשר הוא קיצור דרך לאיש הקשר של השיחה; עדכון רשומה עושה את אותו הדבר לכל אובייקט.
הוספה, עדכון או מחיקה של רשומה
שלושה בלוקים שכותבים לכל אובייקט תחת אובייקטים — לקוח, איש קשר, הזמנה, קריאת שירות, כל דבר שהחשבון שלכם הגדיר.
מאפיינים
| מאפיין | אפשרויות | מה הוא עושה |
|---|---|---|
| אובייקט (חובה) | רשימה נפתחת של אובייקטי החשבון | לאיזה אובייקט הרשומה שייכת. רשימת השדות שלמטה נגזרת מהבחירה הזו. שיחות טלפון ומסמכים נכתבים על ידי המערכת ואינם מוצעים. |
| מזהה הרשומה (עדכון, מחיקה) | טקסט / משתנה | איזו רשומה. בדרך כלל {{record.id}} מטריגר שינוי באובייקט, או {{new_record.id}} מהוספת רשומה קודמת. חייב להיות רשומה אחת בדיוק. |
| שדות (הוספה, עדכון) | שורות של שדה ← ערך | השדות הניתנים לכתיבה של האובייקט. הערכים תומכים במשתנים; רשומה מקושרת מקבלת מזהה רשומה (או כמה, מופרדים בפסיקים); תיבת סימון מקבלת yes / no; רשימה נפתחת מקבלת אחת מהאפשרויות שלה בדיוק כפי שנכתבה. |
הערכים מאומתים על ידי מנוע האובייקטים לפני שנכתב משהו — שדות חובה, אפשרויות, ערכים ייחודיים, קישורים לרשומות שבאמת קיימות בחשבון — כך שערך שגוי מכשיל את הבלוק במקום להשחית את הרשומה. משתנה שלא נפתר מדולג (מופיע ב‑skipped_fields), ולא נכתב כ‑{{…}}. לוקאפים, מונים ומספור אוטומטי מתמלאים על ידי המנוע. לקוחות ורשומות של האובייקטים שלכם נספרים ב מגבלות התוכנית.
פלטים
| משתנה | מכיל |
|---|---|
{{new_record.id}} · {{new_record.label}} · {{new_record.url}} | הוספת רשומה — הרשומה החדשה |
{{new_record.<field>}} | כל שדה של הרשומה שנשמרה, כולל לוקאפים ומספור אוטומטי |
{{new_record.status}} · {{new_record.skipped_fields}} | created, או למה לא; שדות שלא נשמרו |
{{updated_record.id}} · {{updated_record.updated_fields}} · {{updated_record.skipped_fields}} · {{updated_record.status}} | עדכון רשומה |
{{deleted_record.id}} · {{deleted_record.status}} | מחיקת רשומה — deleted, not_found, או in_use כשרשומות אחרות עדיין מקושרות אליה |
כל כתיבה מופיעה ביומן השינויים של הרשומה עם המקור סטודיו, מרעננת לוקאפים ומונים, ומפעילה את טריגר שינוי באובייקט של תהליכים אחרים (לא את הטריגר של התהליך הזה עצמו, אלא אם הוא ביקש זאת).
הרצת בדיקה מאמתת את הערכים ופותרת את המשתנים אבל לא כותבת כלום; הבלוק מדווח status = validated.
בקשת HTTP
שולחת נתונים למערכת חיצונית, או מושכת נתונים ממנה. זהו הגשר הכללי בין Teloring לשאר המערכות שלכם.
מאפיינים
| מאפיין | אפשרויות | מה הוא עושה |
|---|---|---|
| שיטה | GET · POST · PUT · PATCH · DELETE · COPY · HEAD · OPTIONS | שיטת ה‑HTTP. |
| כתובת (חובה) | טקסט / משתנה | הכתובת המלאה. משתנים נתמכים, למשל https://api.example.com/orders/{{contact.id}}. |
| כותרות הבקשה | ש ורות מפתח/ערך | כל כותרת שתצטרכו. Content-Type, Cache-Control, User-Agent ו‑Accept מוצעות כערכים מוכנים. הערכים תומכים במשתנים. |
| סוג הגוף | ללא · JSON · Form data | מה לשלוח בגוף הבקשה. |
| גוף JSON | אזור טקסט | מופיע עבור JSON. חייב להיות JSON תקין. |
| שדות טופס | שורות מפתח/ערך | מופיע עבור Form data. הערכים תומכים במשתנים. |
| פסק זמן לבקשה (שניות) | 1–60 | כמה זמן להמתין לשרת. |
| לכידת התגובה לפעולות הבאות | מופעל / כבוי | ראו למטה. |
לכידת התגובה — מופעל או כבוי?
| הגדרה | התנהגות | השתמשו כאשר |
|---|---|---|
| כבוי | שגר ושכח. הבקשה נכנסת לתור ונשלחת ברקע; התהליך ממשיך מיד. | אתם מיידעים מערכת חיצונית ואינכם זקוקים לתשובתה. |
| מופעל | התהליך ממתין לתגובה וחושף אותה כמשתנים. | אתם זקוקים לתשובה — סטטוס הזמנה, מחיר, מזהה לקוח. |
פלטים
| משתנה | מכיל |
|---|---|
{{http.status}} | סטטוס השליחה |
{{http.task_id}} | מזהה משימת הרקע, כשהלכידה כבויה |
{{http.status_code}} | קוד סטטוס HTTP, למשל 200 |
{{http.ok}} | true עבור תגובת 2xx |
{{http.content_type}} | סוג התוכן של התגובה |
{{http.body}} | גוף התגובה הגולמי |
{{http.json}} | התגובה מפוענחת כ‑JSON |
{{http.headers}} | כותרות התגובה |
{{http.error}} | השגיאה, אם הקריאה נכשלה |
כאשר התגובה היא אובייקט JSON, השדות שלה משוטחים גם למשתנים נפרדים — {{http.json.order_id}}, {{http.json.customer.name}} וכן הלאה.
משתנים בתוך גוף JSON
סטודיו מודע לטיפוסים כשהוא ממלא גוף JSON:
- משתנה שממלא ערך שלם — כתוב חשוף (
"answers": {{answers.list}}) או כמחרוזת שלמה במרכאות ("answers": "{{answers.list}}") — שומר על טיפוס ה‑JSON האמיתי שלו. מערכים נשארים מערכים, מספרים נשארים מספרים, אובייקטים נשארים אובייקטים. - משתנה בתוך מחרוזת ארוכה יותר (
"greeting": "שלום {{contact.name}}!") מוחלף כטקסט, עם מרכאות ותווים מיוחדים שעברו בריחה בטוחה. - משתנה שאין לו ערך נשאר כפי שהוא.
העורך מאמת את ה‑JSON תוך כדי ההקלדה. JSON לא תקין צובע את התיבה באדום ומוסיף תג אזהרה על הבלוק; אפשר להמשיך לערוך, אבל תקנו לפני הפרסום.
אבטחה
סטודיו קורא רק לכתובות ציבוריות ב‑http:// וב‑https://. כתובות localhost, רשתות פרטיות, loopback, link-local וכתובות מטא‑דאטה של ספקי ענן חסומות, כך שתהליך לעולם אינו יכול לשמש כדי להגיע לתוך התשתית.
שליחת אימייל
שולחת אימייל. זו שליחה נקייה — היא אינה יוצרת שיחה, איש קשר או הודעה בציר הזמן של תיבה כלשהי, כך שאפשר לשלוח אימייל למנהל, לספק או לכתובת פנימית בלי לזהם תיבה.
מאפיינים
| מאפיין | אפשרויות | מה הוא עושה |
|---|---|---|
| שליחה מ | אחת מתיבות האימייל שלי · השולח המערכתי של Teloring | ממי האימייל מגיע. |
| תיבת אימייל | רשימה נפתחת של תיבות אימייל מחוברות | מופיעה עבור אפשרות התיבה. כל תיבת אימייל מחוברת יכולה לשלוח — גם תיבות שיחות וגם תיבות לשליחה בלבד. |
| שולח מערכתי | הודעה לקריאה בלבד | מופיעה עבור אפשרות המערכת, ומציגה את הכתובת שתשמש. |
| אל (חובה) | טקסט / משתנה | כתובת אחת או יותר. ברירת המחדל היא {{contact.email}}. |
| CC · BCC · כתובת למענה | טקסט / משתנה | אופציונלי. |
| נושא (חובה) | טקסט / משתנה | שורת הנושא. |
| פורמט הגוף | טקסט רגיל · HTML | איך הגוף נכתב. |
| גוף (חובה) | אזור טקסט | תוכן האימייל. משתנים נתמכים. |
| כותרות מותאמות | שורות מפתח/ערך | כותרות ט כניות אופציונליות. X-Teloring-Flow, X-Campaign, X-Priority ו‑List-Unsubscribe מוצעות כערכים מוכנים. |
פלטים
| משתנה | מכיל |
|---|---|
{{email.status}} | sent, failed או test |
{{email.message_id}} | ההודעה שנשלחה |
{{email.from}} · {{email.to}} · {{email.subject}} | מה נשלח, ולמי |
{{email.provider}} | איזה שירות מסר אותו |
{{email.error}} | השגיאה, אם נכשל |
נמענים ומגבלות
- השדות אל, CC, BCC וכתובת למענה מקבלים כמה כתובות מופרדות בפסיקים, בנקודה‑פסיק או בשורות חדשות, ומזהים את התבנית
Name <address@example.com>. - כל כתובת מאומתת וכפילויות מוסרות. לכל היותר 25 נמענים בסך הכול.
- לכל היותר 10 כותרות מותאמות. כותרות מיעון ושרשור (From, To, Cc, Bcc, Reply-To, Subject, Message-ID, Content-Type, …) נקבעות בשדות שלמעלה ואינן ניתנות לדריסה כאן.
- בכל פורמט גוף שתבחרו, נשלחים גם חלק טקסט וגם חלק HTML, כך שהאימייל מוצג נכון בכל מקום.
תשובות לשולח המערכתי של Teloring אינן חוזרות אל Teloring. אם אתם רוצים לקבל תשובות, שלחו מאחת מהתיבות שלכם או הגדירו כתובת למענה.
הרצת בדיקה מזהה את השולח ומאמתת הכול, אך אינה שולחת דבר. הבלוק מדווח email.status = test.
קוד
מריצה טרנספורמציית JavaScript קטנה ומחזירה ערך לבלוקים שאחריה. השתמשו בה לדברים ששדה טקסט אינו יכול לעשות: ניקוי מספר טלפון, פיצול שם, עיצוב מחדש של מזהה, בחירת פריט אחד מתוך רשימה.
מאפיינים
| מאפיין | מה הוא עושה |
|---|---|
| קוד JavaScript (חובה) | הקוד להרצה. הוא חייב להחזיר ערך באמצעות return. |
בלוקים חדשים מתחילים עם דוגמה עובדת:
const phone = "{{contact.phone}}";
const cleanNumber = phone.replace(/^\+/, '');
return cleanNumber;
קריאת משתנים
שתי דרכים, שתיהן תקינ ות:
// 1 — מוחלף לפני הרצת הקוד
const name = "{{contact.name}}";
// 2 — נקרא מאובייקט המשתנים הקפוא
const phone = variables["contact.phone"];
פלטים
| משתנה | מכיל |
|---|---|
{{code.status}} | תוצאה |
{{code.result}} | הערך שהוחזר, עם שמירה על הטיפוס שלו |
{{code.result_text}} | הערך שהוחזר כטקסט |
{{code.error}} | השגיאה, אם הקוד נכשל |
מה הסביבה המבודדת מתירה
בלוק הקוד רץ בבידוד, עם תקרת זיכרון ומגבלת זמן קצרה. הוא נועד לעיבוד נתונים בלבד:
| מותר | חסום |
|---|---|
| פעולות על מחרוזות, מספרים, מערכים, אובייקטים, תאריכים וביטויים רגולריים | fetch, XMLHttpRequest, WebSocket — אין רשת |
אובייקט ה‑variables וכל {{variable}} שתחליפו | require, import, process — אין מודולים, אין סביבה |
| החזרת כל ערך שניתן להמרה ל‑JSON | eval, Function, WebAssembly |
קוד ש אינו מחזיר ערך מכשיל את הבלוק בכוונה, כך שהתהליך לעולם לא ימשיך עם נתונים חסרים. כדי לקרוא לשירות חיצוני, השתמשו בבקשת HTTP.
תאריך ושעה
מחשבת ומעצבת תאריכים. כל פעולה מודעת לאזור זמן.
מאפיינים
| מאפיין | אפשרויות | מה הוא עושה |
|---|---|---|
| פעולה | קבלת התאריך/השעה הנוכחיים · הוספת זמן · החסרת זמן · עיצוב תאריך · חילוץ חלק · זמן בין תאריכים · עיגול תאריך | מה לחשב. |
| תאריך קלט | טקסט / משתנה | התאריך לעבוד עליו, בפורמט ISO. השאירו ריק עבור "עכשיו". |
| תאריך שני | טקסט / משתנה | התאריך השני. מופיע עבור זמן בין תאריכים. |
| כמות | מספר | כמה להוסיף או להחסיר. מופיע עבור הוספה והחסרה. |
| יחידה | שניות · דקות · שעות · ימים · שבועות | היחידה עבור הכמות. |
| חלק | תאריך · שעה · שנה · חודש · יום · שעה · דקה · יום בשבוע | איזה חלק לחלץ. מופיע עבור חילוץ חלק. |
| פורמט | טקסט | תבנית הפלט, למשל %Y-%m-%d %H:%M:%S. מופיע עבור עיצוב תאריך. |
| אזור זמן | טקסט | אזור הזמן שבו החישוב מתבצע. ברירת המחדל היא Asia/Jerusalem. |
פלטים
| משתנה | מכיל |
|---|---|
{{datetime.status}} | תוצאה |
{{datetime.result}} | הערך המחושב |
{{datetime.result_text}} | הערך כטקסט |
{{datetime.date}} · {{datetime.time}} | חלק התאריך וחלק השעה |
{{datetime.timestamp}} | חותמת זמן Unix |
שימושים טובים: לחשב תאריך מעקב בעוד שלושה ימים, לעצב חותמת זמן להודעה ללקוח, או למדוד כמה זמן שיחה פתוחה לפני שמחליטים להסלים.
שליחת התראת Teloring
מתריעה לנציגים בתוך Teloring — פעמון ההתראות, צליל, אימייל ודחיפה בדפדפן. השתמשו בה לכל דבר ששני סוגי ההתראות המובנים אינם מכסים: ליד חדש, סף באנליטיקס, SLA שעומד להיפרץ, הגשת טופס, לקוח VIP שכותב.
זהו החצי הגמיש של ההתראות. עמוד הפרופיל מגיע עם שני סוגים מוכנים ("שיחה שויכה אליי" ו"הגיעה הודעה חדשה"), כך שנציג שלעולם אינו פותח את סטודיו עדיין מקבל משהו שימושי. כל מה שמעבר לכך נבנה כאן.
הבלוק הזה קובע את הטקסט ואת הנמענים. הוא לעולם אינו קובע איך ההתראה מגיעה אליהם — זה נשאר אצל כל נציג, בפרופיל שלו.
נציג שהפעיל רק את הפעמון מקבל רשומה בפעמון. עמית שנמצא באותה התראה והפעיל את כל ארבע השיטות מקבל צליל, אימייל, דחיפה וגם רשומה בפעמון. נציג שההתראות שלו כבויות — או שהתראות סטודיו שלו כבויות — אינו מקבל דבר, והתהליך ממשיך כרגיל.
מאפיינים
| מאפיין | אפשרויות | מה הוא עושה |
|---|---|---|
| שליחה אל (חובה) | נציגים ספציפיים · הנציג המשויך לשיחה הזו · כל חברי צוות | מי מקבל התראה. |
| נציגים | רשימת סימון של נציגים | מופיעה עבור נציגים ספציפיים. נציגים אנושיים בלבד — לנציג AI אין תיבה לקבלת התראות. |
| צוות | רשימה נפתחת של צוותים | מופיעה עבור כל חברי צוות. כל חבר מקבל התראה. |
| מזהה השיחה | טקסט / משתנה | מופיע עבור הנציג המשויך לשיחה הזו. ברירת המחדל היא {{conversation.id}}. |
| הודעה (חובה) | אזור טקסט | הטקסט שהנציגים רואים. משתנים נתמכים — איש קשר חדש {{contact.name}} נוצר! |
| פרטים נוספים | אזור טקסט | שורה שנייה אופציונלית, שמוצגת ברשימת הפעמון, באימייל ובדחיפה בדפדפן. |
| לחיצה על ההתראה פותחת | את השיחה מהתהליך הזה · כלום — טקסט בלבד · עמוד ספציפי ב‑Teloring | לאן ההתראה מקשרת. |
| עמוד ב‑Teloring | טקסט / משתנה | מופיע עבור אפשרות העמוד הספציפי. נתיב בתוך Teloring, כמו /dashboard/customers. |
פלטים
| משתנה | מכיל |
|---|---|
{{notification.status}} | sent, no_recipients, test_mode או failed |
{{notification.recipients}} | לכמה נציגים ההתראה כוונה |
{{notification.delivered}} | כמה באמת קיבלו משהו, אחרי שההגדרות האישיות שלהם הוחלו |
{{notification.message}} | הטקסט הסופי, עם משתנים שפוענחו |
{{notification.error}} | השגיאה, אם נכשל |
recipients ו‑delivered הם בדרך כלל המספרים שאתם צריכים בזמן איתור תקלות. recipients: 3, delivered: 0 פירושו שהתהליך מצא שלושה נציגים ולאף אחד מהם לא היו התראות סטודיו מופעלות.
להבין את "שליחה אל"
| אפשרות | מתורגמת ל | כשאף אחד אינו תואם |
|---|---|---|
| נציגים ספציפיים | בדיוק הנציגים שסימנתם. | הבלוק מדווח no_recipients. |
| הנציג המשויך לשיחה הזו | מי שמחזיק כרגע בשיחה. | לשיחה ללא שיוך אין בעלים, ולכן הבלוק מסתיים עם no_recipients. זו אינה שגיאה — התהליך ממשיך. |
| כל חברי צוות | כל חבר בצוות שנבחר, ברגע שהבלוק רץ. | צוות ריק או שנמחק מדווח no_recipients. |
מגבלות ובטיחות
- קישורים חיצוניים בלתי אפשריים. שדה עמוד ב‑Teloring מקבל רק נתיב בתוך Teloring. כתובת מלאה נזרקת, כך שהתראה לעולם אינה יכולה להפוך לקישור לאתר חיצוני.
- שדה הודעה נחתך ל‑160 תווים ופרטים נוספים ל‑600.
- הטקסט מוצג כטקסט רגיל בכל מקום שבו הוא מופיע, כולל בתוך האימייל.
- שדה הודעה ריק מכשיל את הבלוק. כמו בכל מקום בסטודיו, משתנה שלא ניתן לפענח נשאר גלוי (
{{contact.name}}) במקום להתרוקן בשקט, כדי שתוכלו לזהות את הטעות. - אותה התראה אינה יכולה להגיע לאותו נציג פעמיים בתוך 60 שניות.
הרצת בדיקה מזהה את הנמענים ואת הטקסט ומאמתת הכול, אך אינה מתריעה לאיש. הבלוק מדווח notification.status = test_mode. בדיקת תהליך לעולם אינה מצלצלת לנציגים אמיתיים.
דוגמה — יידוע צוות המכירות על ליד חדש
- טריגר: שינוי באובייקט ← לקוחות, נוצר
- תנאי: If/Else ←
{{record.lifecycle_stage}}שווה ל‑lead - ואז: שליחת התראת Teloring
- שליחה אל: כל חברי צוות ← מכירות
- הודעה:
ליד חדש: {{record.name}} - פרטים נוספים:
טלפון {{record.phone}} · מקור {{record.source}} - לחיצה על ההתראה פותחת: עמוד ספציפי ב‑Teloring ←
{{record.url}}
כל חבר בצוות המכירות שהפעיל התראות סטודיו מקבל התרעה, כל אחד בשיטות שהוא בחר.
הבא
- תנאים — בלוקי ה‑IF — לשלוח את התהליך למסלול הנכון.
- משתנים — מדריך המשתנים המלא.
- מתכוני תהליכים — הפעולות האלה בתוך תהליכים שלמים.