# התיעוד המלא של Teloring נוצר בתאריך: 2026-08-20T20:57:04.472Z התיעוד הקנוני: https://docs.teloring.com/he/docs/ אינדקס התיעוד: https://docs.teloring.com/he/llms.txt > קובץ זה נוצר אוטומטית מכל מקורות התיעוד הציבוריים של Docusaurus בזמן בניית הגרסה לייצור. אין לערוך אותו ידנית. --- # מדריכי המשתמש של Teloring מקור: https://docs.teloring.com/he/docs/ Markdown: https://docs.teloring.com/he/markdown/docs/index.md מדור: סקירה כללית עודכן לאחרונה: 2026-08-20T20:49:57.000Z Teloring היא פלטפורמת תקשורת אומני‑ערוצית עם לקוחות ומערכת CRM. היא מרכזת שיחות, רשומות לקוח, נציגים, כלי AI, אוטומציה, קבצים ודוחות בסביבת עבודה אחת, כך שצוותים יכולים לנהל את התקשורת עם הלקוחות בלי לקפוץ בין ערוצים. המדריכים האלה נכתבו עבור משתמשים יומיומיים בפלטפורמה, מנהלי צוותים ומנהלי חשבון. הם מתמקדים באופן השימוש במוצר. תיעוד ה‑API יתפרסם בהמשך. ## למי המדריכים האלה מיועדים | תפקיד | התחילו כאן | תחומים עיקריים | | --- | --- | --- | | נציגים | [סיור בסביבת העבודה](./getting-started/workspace-tour.md) | שיחות, תורים, פאנל הלקוח, תגובות מהירות, פרופיל | | מנהלי צוותים | [טבעת הערוצים — תיבות](./product/ring/overview.md) | תורי שיחות, שיוכים, CRM, אנליטיקס, סטודיו | | מנהלי חשבון | [רשימת המשימות לכניסה הראשונה](./getting-started/first-login.md) | טבעת הערוצים, [נציגים אנושיים ונציגי AI](./product/agents.md), הגדרות, מאגר ידע, יומן לוגים, חיובים | ## מה רואים אחרי הכניסה לאחר ההתחברות, רוב המשתמשים מגיעים לסביבת העבודה של Teloring. סרגל הצד הוא הניווט הראשי. הכותרת העליונה מכילה פעולות של סביבת העבודה — החלפת שפה, בקרת ערכת נושא, מחווני חשבון וגישה לפרופיל. אזור התוכן המרכזי משתנה בהתאם לעמוד שנבחר. אלו המדורים המרכזיים: | מדור | למה הוא משמש | | --- | --- | | לוח בקרה | סקירה מהירה של שיחות פתוחות, שיחות ממתינות, שיחות שטופלו, נציגים מחוברים ופעילות אחרונה. | | שיחות | סביבת העבודה המרכזית של הנציג — קריאה, מענה, שיוך, תיוג, קביעת עדיפות וסימון שיחות כטופלו. | | לקוחות | אזור ה‑CRM: פרופילי לקוח, שלבי מחזור חיים, אנשי קשר מקושרים, היסטוריית מסע, שיחות, שיחות טלפון, מסמכים ואובייקטים מותאמים. | | טבעת הערוצים | אזור ההגדרה של התיבות והערוצים. כאן מנהלי החשבון מחברים WhatsApp, אימייל, SMS, טלגרם, LINE, צ׳אט באתר, שיחות טלפון, TikTok Messenger ותיבות Meta. | | עולם AI ומאגר ידע | הגדרת יכולות ה‑AI וחומרי המקור שמשמשים את ה‑AI Copilot ואת התשובות מבוססות RAG. | | טפסים | בונה הטפסים לאיסוף מידע מובנה מלקוחות, פרסום קישורי טפסים, סקירת הגשות והפעלת תהליכי סטודיו. | | סטודיו | בונה האוטומציות הוויזואלי — טריגרים, תנאים, מענים, בקשות HTTP, עדכוני CRM ופעולות נוספות. | | תגובות מהירות | קטעי הודעה לשימוש חוזר שנציגים יכולים לשלב בזמן מענה ללקוחות. | | אנליטיקס | דוחות ולוחות בקרה למדידת שיחות, נציגים וביצועים תפעוליים. | | הגדרות, נציגים, יומן לוגים וחיובים | ניהול: הגדרת החשבון, [ניהול הצוות האנושי וצוות ה‑AI](./product/agents.md), בקרת אבטחה, שימוש וקרדיטים. | | תפקידים והרשאות | [קביעה למה כל תפקיד רשאי לגשת](./product/roles/overview.md) בסביבת העבודה ובתוך כל תיבה. | :::note התפריט המדויק משתנה לפי **[התפקיד](./product/roles/overview.md)** ולפי היכולות שהמסלול שלכם מפעיל. כל מה שהתפקיד שלכם לא רשאי להגיע אליו פשוט לא מוצג — כך ששני אנשים באותו חשבון עשויים לראות סרגלי צד שונים מאוד. ::: ## סדר קריאה מומלץ 1. [סיור בסביבת העבודה](./getting-started/workspace-tour.md) — להבין את הניווט ואת המסכים המרכזיים. 2. [רשימת המשימות לכניסה הראשונה](./getting-started/first-login.md) — להכין חשבון חדש לשימוש אמיתי. 3. [טבעת הערוצים — תיבות](./product/ring/overview.md) — לחבר את הערוצים שבהם הלקוחות ישתמשו. 4. [שיחות](./getting-started/conversations.md) — ללמוד את שגרת העבודה של הנציג. 5. [CRM ולקוחות](./product/crm.md) — לארגן רשומות לקוח והיסטוריה. 6. [מאפייני שיחה](./product/conversation-attributes.md) — לתעד למה כל שיחה התרחשה ואיך היא הסתיימה, כדי שאפשר יהיה להפיק על כך דוחות. 7. [נציגים ונציגי AI](./product/agents.md) — להזמין אנשים ולהגדיר פרופילי שיחה אוטונומיים. 8. [בונה הטפסים](./product/forms.md) — לאסוף מידע מובנה מלקוחות. 9. [סטודיו](./product/studio.md) — לבצע אוטומציה למסעות לקוח נפוצים. 10. [אנליטיקס](./product/analytics.md) — לבנות לוחות בקרה ודוחות מהנתונים שלכם. --- # סיור בסביבת העבודה מקור: https://docs.teloring.com/he/docs/getting-started/workspace-tour Markdown: https://docs.teloring.com/he/markdown/docs/getting-started/workspace-tour.md מדור: צעדים ראשונים עודכן לאחרונה: 2026-08-20T20:49:57.000Z סביבת העבודה של Teloring בנויה סביב רעיון אחד: כל ערוץ תקשורת עם לקוחות צריך להיות מטופל ממקום אחד, בזמן שההקשר של ה‑CRM והאוטומציה נשאר קרוב לשיחה. ## המבנה הראשי למערכת שלושה אזורים מרכזיים: | אזור | מה נמצא בו | | --- | --- | | סרגל הצד | הניווט הראשי: לוח בקרה, שיחות, לקוחות, טבעת הערוצים, כלי AI, סטודיו, אנליטיקס ועמודי ניהול. | | הכותרת העליונה | פקדים ברמת החשבון: שפה, ערכת נושא, מחווני קרדיט, התראות וגישה לפרופיל. | | תוכן העמוד | סביבת העבודה הפעילה — שולחן השיחות, רשימת הלקוחות, קנבס הסטודיו או עמוד הגדרת התיבה. | ![מבט כללי על סביבת העבודה של Teloring](pathname:///img/screenshots/he/getting-started/workspace-overview.png) ## לוח הבקרה לוח הבקרה מספק תמונת מצב תפעולית מהירה לפני שנציג ניגש לשולחן השיחות. אפשר לראות בו: | כרטיס או פאנל | משמעות | | --- | --- | | שיחות פתוחות | שיחות שפתוחות כרגע ומשויכות אליכם או גלויות לתפקיד שלכם. | | ממתינות בתור | שיחות שממתינות לנציג שייקח אותן. | | טופלו היום | שיחות שנסגרו במהלך היום הנוכחי. | | נציגים מחוברים | נוכחות מקוונת עדכנית משירות הזמן־אמת. | | שיחות אחרונות | נקודת כניסה מהירה לפעילות הלקוחות האחרונה. | לחיצה על כרטיס בלוח הבקרה פותחת את תור השיחות הרלוונטי. ![מבט כללי על לוח הבקרה של Teloring](pathname:///img/screenshots/he/getting-started/dashboard-overview.png) ## מדורי סרגל הצד סרגל הצד מקובץ לפי סוג העבודה. | מדור בסרגל הצד | עמודים | | --- | --- | | סביבת עבודה | לוח בקרה, שיחות, לקוחות | | טבעת הערוצים | הגדרת ערוצים ותיבות | | כלים | עולם AI, הישגים, מאגר ידע, מחסן קבצים, חתימת מסמכים, סטודיו, תגובות מהירות | | אנליטיקס | לוחות בקרה ודוחות | | ניהול | הגדרות, נציגים, יומן לוגים, חיובים | אפשר לכווץ את סרגל הצד. Teloring זוכרת את מצב הכיווץ לכל נציג ולכל חשבון בנפרד. ## תורי השיחות תפריט השיחות כולל תורים נפוצים: | תור | מתי להשתמש בו | | --- | --- | | שלי | כשרוצים להמשיך שיחות שמשויכות אליכם. | | ממתינות | כשרוצים לקחת את השיחה הבאה שאינה משויכת. | | צ׳אטבוט | כשרוצים לסקור שיחות שמטופלות כרגע על ידי תהליך בוט. | | נציג AI | כשרוצים לסקור שיחות שבבעלות נציג AI. | | כל הפתוחות | כשרוצים מבט תפעולי רחב על כלל השיחות הפתוחות. | | טופלו | כשרוצים לחפש או לסקור שיחות שהסתיימו. | ## שפה וכיווניות Teloring תומכת באנגלית ובעברית. עמודים בעברית מוצגים בפריסה מימין לשמאל. לכל נציג יכולה להיות שפת ברירת מחדל משלו, ואפשר גם להחליף שפה מהכותרת העליונה של סביבת העבודה. --- # רשימת המשימות לכניסה הראשונה מקור: https://docs.teloring.com/he/docs/getting-started/first-login Markdown: https://docs.teloring.com/he/markdown/docs/getting-started/first-login.md מדור: צעדים ראשונים עודכן לאחרונה: 2026-08-20T20:49:57.000Z השתמשו ברשימה הזו כשחשבון חדש או צוות חדש מתחיל לעבוד עם Teloring. ## 1. התחברות פתחו את כתובת המערכת של Teloring שקיבלתם ממנהל החשבון והתחברו עם האימייל והסיסמה שלכם. אם אימות דו‑שלבי מופעל, השלימו את שלב האימות לפני הכניסה לסביבת העבודה. לאחר ההתחברות, ודאו שאתם רואים את שם החשבון הנכון ואת פרופיל הנציג שלכם בתחתית סרגל הצד. ## 2. בדיקת הפרופיל פתחו את הפרופיל שלכם מתחתית סרגל הצד. בדקו: | שדה | למה זה חשוב | | --- | --- | | שם | מוצג בתצוגות פנימיות, ועשוי להופיע גם בהקשרים מול לקוחות בהתאם לערוץ. | | אימייל | משמש להתחברות ולזיהוי החשבון. | | טלפון | משמש בחלק מתהליכי ההתראות והאימות. | | שפה | קובעת את שפת ברירת המחדל של סביבת העבודה שלכם. | | טוקן API אישי | למשתמשים מתקדמים שזקוקים לגישת API הקשורה להרשאות שלהם. | ## 3. אימות התפקיד שלכם **[התפקיד](../product/roles/overview.md)** שלכם קובע אילו עמודים ופעולות זמינים לכם. כל חשבון מגדיר את התפקידים שלו, וכל חשבון חדש מתחיל עם חמישה תפקידים מוכנים: | תפקיד | גישה אופיינית | | --- | --- | | **Owner** | הכול, כולל חיובים והגדרות חשבון. | | **Team Leader** | כל השיחות והתיבות, צוותים, סטודיו, מאגר ידע ואנליטיקס — אך לא חיובים או ניהול נציגים. | | **Marketing** | אנליטיקס, סטודיו, טפסים ולקוחות. עובד עם השיחות שלו, לא עם התורים המשותפים. | | **Agent** | שיחות, לקוחות, פרופיל וכלי התמיכה היומיומיים. | | **Viewer** | צפייה בלבד. אנליטיקס ולקוחות, ללא שיחות. | שם התפקיד שלכם מוצג לצידכם ב**ניהול ← נציגים, צוותים ותפקידים ← נציגים**. אם עמוד חסר בסרגל הצד שלכם, פירוש הדבר שהתפקיד שלכם אינו כולל אותו, או שהיכולת אינה מופעלת בחשבון. פנו למי שמנהל את סביבת העבודה שלכם — הוא יכול להרחיב את התפקיד מ**ניהול ← נציגים, צוותים ותפקידים ← תפקידים והרשאות**. ## 4. חיבור תיבה אחת לפחות מי שמחזיק בהרשאת **טבעת הערוצים ← יצירה** — בדרך כלל Owner — צריך לפתוח את [טבעת הערוצים](../product/ring/overview.md) ולחבר את ערוץ הלקוחות הראשון לפני שהנציגים מתחילים לעבוד. הגדרה ראשונה מומלצת: | הצורך של הצוות | מומלץ להתחיל ב | | --- | --- | | הפעלת תמיכה מהירה | צ׳אט באתר או אימייל | | תמיכה מבוססת WhatsApp | תיבת WhatsApp | | תמיכה ברשתות חברתיות | Messenger, הודעות אינסטגרם, דף פייסבוק או פוסטים באינסטגרם | | תמיכה טלפונית | תיבת שיחות טלפון | | אינטגרציה בהובלת מפתחים | תיבת API | ## 5. הוספת נציגים מנהלי החשבון צריכים לפתוח את עמוד הנציגים ולהוסיף את חברי הצוות שיטפלו בשיחות. עבור כל נציג, ודאו שהאימייל, התפקיד, מצב הפעילות והשפה נכונים. ## 6. הכנת תשובות נפוצות פתחו את התגובות המהירות וצרו קטעי טקסט לשימוש חוזר עבור תשובות נפוצות — שעות פעילות, מדיניות משלוחים, הוראות לקביעת פגישה או נוסח הסלמה. ## 7. אופציונלי: הפעלת AI ומאגר ידע אם החשבון שלכם משתמש ב‑AI Copilot או בתשובות מבוססות RAG, פתחו את עולם AI ואת מאגר הידע. הכינו: | פריט | מטרה | | --- | --- | | מתגי יכולות AI | שולטים באילו יכולות AI זמינות לנציגים. | | מאגרי ידע | מאחסנים חומרי מקור מאושרים לתשובות AI. | | בחירת מאגר ל‑Copilot | מאפשרת לנציגים לבחור את מאגר הידע המתאים לשיחה. | ## 8. אופציונלי: יצירת תהליך סטודיו ראשון פתחו את הסטודיו כשאתם מוכנים להפוך חלק ממסע הלקוח לאוטומטי. התחילו מתהליך קטן, למשל: 1. טריגר של הודעה נכנסת. 2. פעולת מענה בהודעה. 3. תנאי שבודק את תשובת הלקוח. 4. פעולת שיוך שיחה או סיום סשן. פרסמו רק אחרי שבדקתם את התהליך בשיחת הדגמה. --- # שיחות מקור: https://docs.teloring.com/he/docs/getting-started/conversations Markdown: https://docs.teloring.com/he/markdown/docs/getting-started/conversations.md מדור: צעדים ראשונים עודכן לאחרונה: 2026-08-20T20:49:57.000Z השיחות הן סביבת העבודה המרכזית של הנציג. כאן הודעות מתיבות מחוברות הופכות לשולחן שירות לקוחות אחד ומאורגן. ## מבנה מסך השיחה למסך השיחה שלושה אזורי עבודה: | אזור | מה הוא מכיל | | --- | --- | | הפאנל הראשון | חיפוש, שיחה חדשה, קבלת הבא בתור, מיון, מסננים, פעולות מרובות ורשימת השיחות. | | הפאנל המרכזי | השיחה שנבחרה, ההודעות, תצוגת שרשור האימייל כשרלוונטי, ותיבת חיבור התשובה. | | הפאנל הצדדי | שדות איש הקשר, רשומת הלקוח המקושרת, תוויות, הערות והקשר, וכלי AI Copilot. | ![סביבת העבודה של השיחות ב‑Teloring](pathname:///img/screenshots/he/getting-started/conversation-layout.png) ## סרגל הצד של השיחה סרגל הצד שומר את הקשר הלקוח צמוד לשיחה החיה. הנציגים יכולים לענות מהר יותר, כי אין צורך לעזוב את עמוד השיחה כדי לבדוק פרטי קשר בסיסיים, היסטוריית לקוח, שיחות קודמות או סיוע AI. סרגל הצד מחולק למדורים: | מדור | מה הוא מציג | פעולות נפוצות | | --- | --- | --- | | פרטי איש קשר | האדם הספציפי שבשיחה: שם, טלפון, אימייל, חברה, סטטוס ושדות מותאמים של איש הקשר. | עריכת פרטי איש הקשר ושמירת עדכונים ישירות מתוך השיחה. | | לקוחות | לקוח ה‑CRM המקושר לשיחה הזו. בדרך כלל זו החברה, החשבון, משק הבית או רשומת הלקוח המרכזית שמאחורי איש הקשר. | צפייה בלקוח המקושר, שינוי הקישור, חיפוש לקוח קיים או יצירת לקוח חדש מתוך השיחה. | | שיחות קודמות | שיחות נוספות המקושרות לאותו איש קשר או לקוח. | סקירת ההיסטוריה לפני המענה, פתיחת שיחות ישנות והבנה אם מדובר בנושא חדש או בהמשך. | | מאפייני שיחה | שדות מותאמים שהחשבון שלכם הגדיר עבור שיחה — למשל סיבת הפנייה, תוצאה או מספר הזמנה. | תיעוד במה עסקה השיחה ואיך היא הסתיימה, ואז שמירה. מוצג רק כאשר החשבון הגדיר מאפיינים. | | AI Copilot | סיוע AI לשיחה הנוכחית. | שאילת שאלות, שימוש במאגר ידע נבחר, סקירת הערות AI ושילוב תשובות AI מועילות בתיבת חיבור התשובה כשמתאים. | ![סרגל הצד של השיחה ב‑Teloring](pathname:///img/screenshots/he/getting-started/conversation-right-sidebar.png) ### פרטי איש קשר מדור פרטי איש הקשר עוסק באדם ששלח את ההודעה. הוא שימושי כשאותו לקוח פונה אליכם דרך כמה אנשים, או כשאדם אחד פונה מכמה ערוצים. השתמשו בו כדי לבדוק או לעדכן: | שדה | דוגמה | | --- | --- | | שם | שם האדם כפי שהנציגים אמורים לראות אותו. | | טלפון | מספר הטלפון של איש הקשר. | | אימייל | כתובת האימייל של איש הקשר. | | חברה | שם הארגון או העסק המקושר לאדם. | | סטטוס | סטטוס איש הקשר שבו הצוות שלכם משתמש. | | שדות מותאמים | כל שדה נוסף שהחשבון שלכם משתמש בו עבור אנשי קשר. | כשנציג משנה שדה של איש קשר, המידע המעודכן נשמר לשיחות עתידיות עם אותו איש קשר. ### לקוחות מדור הלקוחות מקשר את השיחה ל‑CRM. זה חשוב, כי ללקוח אחד יכולים להיות אנשי קשר רבים, שיחות רבות, שיחות טלפון, מסמכים ורשומות מותאמות. אם כבר מקושר לקוח, נציגים יכולים לפתוח את פרופיל הלקוח מסרגל הצד. אם השיחה עדיין לא מקושרת, הנציגים יכולים לחפש לקוח קיים או ליצור אחד חדש מתוך השיחה. השתמשו בקישור לקוח כאשר: | מצב | מה לעשות | | --- | --- | | איש הקשר שייך ללקוח קיים | קשרו את השיחה או את איש הקשר ללקוח הזה. | | איש הקשר הוא עסק או לקוח חדש | צרו לקוח חדש מתוך השיחה. | | השיחה קושרה ללקוח שגוי | שנו את הלקוח המקושר. | | אתם צריכים את היסטוריית הלקוח המלאה | פתחו את פרופיל הלקוח. | ### שיחות קודמות מדור השיחות הקודמות עוזר לנציגים להבין את ההיסטוריה לפני שהם משיבים. הוא שימושי במיוחד כשלקוח חוזר דרך ערוץ אחר, או כשנציג חדש מקבל לידיו נושא קיים. השתמשו בו כדי לענות על שאלות כמו: | שאלה | למה זה חשוב | | --- | --- | | האם הלקוח הזה פנה אלינו בעבר? | מונע שאלות חוזרות ומשפר רציפות. | | האם הנושא הקודם נפתר? | עוזר להימנע מפתיחה מחדש של בעיות ישנות בלי הקשר. | | באיזה ערוץ הוא השתמש קודם? | עוזר להבין את העדפת הלקוח ואת ההיסטוריה. | | איזה נציג טיפל בפנייה הקודמת? | מקל על מעקב ועל הסלמה. | ### מאפייני שיחה מאפייני שיחה הם שדות מותאמים ששייכים ל**שיחה הזו**, ולא לאדם. החשבון שלכם מעצב אותם פעם אחת — בדרך כלל *סיבת הפנייה*, *תוצאה* או *מספר הזמנה* — והנציגים ממלאים אותם תוך כדי עבודה. ההבדל מפרטי איש הקשר משמעותי: | | פרטי איש קשר | מאפייני שיחה | | --- | --- | --- | | מתארים | את האדם | את השיחה הזו בלבד | | בשיחה הבאה עם אותו אדם | נשמרים אותם ערכים | מתחילים ריקים | | מתאימים ל | טלפון, אימייל, חברה, מחלקה | למה הוא פנה היום, מה עשיתם, איזו הזמנה | מלאו את השדות ולחצו **שמירה**. הערכים נשארים עם השיחה הזו ומלווים אותה גם לארכיון השיחות שטופלו, שם הם הופכים לקריאה בלבד. מכיוון שהתשובות מובנות, אלו השדות שתפיקו עליהם דוחות בהמשך — *"על מה אנשים פונים אלינו, וכמה זמן לוקח כל סוג פנייה?"*. ראו [מאפייני שיחה](../product/conversation-attributes.md) למדריך המלא, כולל איך לעצב אותם ואיך [סטודיו](../product/studio.md) יכול למלא אותם אוטומטית. :::note המדור מופיע רק כאשר החשבון שלכם הגדיר מאפיינים ו[התפקיד](../product/roles/system-permissions.md#workspace) שלכם מתיר זאת. עם **צפייה** אך ללא **עדכון**, השדות גלויים אך נעולים. ::: ### AI Copilot ה‑AI Copilot נועד לתמוך בנציג, לא להחליף אותו. נציגים יכולים לשאול את ה‑Copilot שאלות על השיחה, להשתמש במאגר ידע נבחר או לסקור תובנות שנוצרו על ידי AI. בהתאם ליכולות ה‑AI המופעלות, ה‑Copilot יכול לסייע ב: | תרחיש שימוש | איך זה עוזר | | --- | --- | | סיכום הקשר | נותן סקירה מהירה של שיחות ארוכות. | | ניסוח תשובות | מציע נוסח שנציגים יכולים להשתמש בו או לערוך לפני השליחה. | | תשובות ממאגר הידע | מחפש בתוכן מאושר במאגר הידע ומחזיר תשובה המבוססת על המקור הזה. | | תובנות על השיחה | מציג פריטים כמו דחיפות, תוויות, סיכון נטישה, הזדמנות מכירה או נושא שזוהה, כאשר היכולת מופעלת. | | סיוע לשוני | עוזר לנסח מחדש או לתרגם תשובות, כאשר יכולות החשבון מאפשרות זאת. | על הנציגים לבדוק תשובות AI לפני שליחתן ללקוחות, במיוחד כשהתשובה כוללת מידע על מחירים, מידע משפטי, חיובים, רפואה, נושאים טכניים או מידע רגיש מבחינת מדיניות. ## מציאת השיחה הנכונה השתמשו בקישורי התורים בסרגל הצד כדי לבחור את רשימת העבודה: | תור | מתאים ל | | --- | --- | | שלי | שיחות המשויכות אליכם. | | ממתינות | שיחות ללא שיוך שממתינות לטיפול. | | צ׳אטבוט | שיחות שמטופלות כרגע במצב בוט של סטודיו. | | נציג AI | שיחות שמטופלות כרגע על ידי נציג AI. | | בהמתנה | שיחות שהוחנו עד למועד שנבחר. ראו [בהמתנה](../product/on-hold.md). | | כל הפתוחות | שיחות פתוחות בכל החשבון. | | טופלו | שיחות סגורות וסקירה היסטורית. | בתוך תור, השתמשו בחיפוש, במיון ובמסננים כדי לצמצם את הרשימה לפי סוג ערוץ, שם תיבה, תוויות, **נציג משויך**, **צוות משויך**, עדיפות, דגל וטווח זמן. מסנן **הנציג המשויך** כולל צ׳יפ **ללא שיוך** מפורש, ומסנן **הצוות המשויך** כולל צ׳יפ **ללא צוות**, כדי שתוכלו לבודד עבודה שאיש עדיין לא לקח או ניתב. שני המסננים מאפשרים בחירה מרובה. :::note אין תור נפרד ל"צוות" שיחה ששויכה לצוות אך עדיין לא לאדם נשארת ב**ממתינות**. כדי לראות רק את החלק של הצוות שלכם בתור, סננו את **ממתינות** לפי **צוות משויך**. ראו [צוותים](../product/teams.md). ::: ### קבלת השיחה הבאה **קבלת הבא בתור** מוציאה את ההחלטה מהידיים שלכם: Teloring בוחרת את השיחה שעליכם לטפל בה עכשיו, לפי **עדיפות תחילה**, ואז **הוותיקה ביותר** מבין השיחות בעלות עדיפות זהה. אם החשבון שלכם משתמש ב[צוותים](../product/teams.md), המערכת מציעה רק שיחות שמותר לכם לקחת — כאלה **ללא צוות**, או כאלה עם צוות **שאתם חברים בו**. שיחה השייכת לצוות אחר נשארת לצוות ההוא. כשכל השיחות הממתינות שייכות לצוותים אחרים, תראו את ההודעה *אין שיחות שממתינות בתור לצוותים שלכם*. ## פעולות מהירות בלחיצה ימנית בתורי שיחות פתוחות, נציגים יכולים ללחוץ לחיצה ימנית על שיחה ברשימה כדי לפתוח פעולות מהירות. זה שימושי כשצריך לארגן עבודה בלי לפתוח קודם את השיחה. הפעולות המהירות יכולות לכלול: | פעולה | השתמשו בה כדי | | --- | --- | | סימון כנקרא / לא נקרא | לשלוט בשאלה אם השיחה מוצגת כדורשת תשומת לב. | | סימון כטופל | לסגור את השיחה כשהעבודה הושלמה. | | שיוך | לשייך את השיחה לעצמכם, לנציג אחר, לנציג AI כשזמין, או להחזיר אותה לתור. | | שיוך צוות | לנתב את השיחה ל[צוות](../product/teams.md) שלם, או לנקות את הצוות. מוצג רק כאשר בחשבון מוגדרים צוותים. | | עדיפות | לשנות את העדיפות לנמוכה, בינונית, גבוהה או דחופה. | | הוספת תווית | להוסיף או להסיר תוויות שיחה. | | נעיצה / ביטול נעיצה | לשמור שיחות חשובות בראש הרשימה. | | דגל | להוסיף דגל צבעוני למעקב ויזואלי מהיר. | | הצגת הלקוח | לפתוח את פרופיל הלקוח המקושר, כשהשיחה מקושרת ללקוח. | הפעולות המהירות מעדכנות את אותם שדות שיחה כמו הפקדים בתוך השיחה. למשל, שינוי עדיפות מתפריט הלחיצה הימנית זהה לשינוי עדיפות בסרגל העליון של השיחה. ![פעולות מהירות בלחיצה ימנית על שיחה ב‑Teloring](pathname:///img/screenshots/he/getting-started/conversation-right-click-menu.png) :::note פעולות הלחיצה הימנית זמינות ברשימות של שיחות פתוחות. תצוגות של שיחות שטופלו משמשות בעיקר לסקירה ולהיסטוריה. ::: ## טיפול בשיחה שגרת עבודה רגילה של נציג נראית כך: 1. פתחו תור. 2. בחרו שיחה. 3. סקרו את ההודעות האחרונות ואת הקשר הלקוח. 4. שייכו את השיחה במידת הצורך. 5. קבעו עדיפות, דגל או תוויות כשזה מועיל. 6. השיבו ללקוח או הוסיפו הערה פנימית. 7. השתמשו בתגובות מהירות או ב‑AI Copilot כשמתאים. 8. מלאו את [מאפייני השיחה](../product/conversation-attributes.md) שהצוות שלכם משתמש בהם, כמו סיבה ותוצאה. 9. סמנו את השיחה כטופלה כשהנושא הושלם — או העבירו אותה [להמתנה](../product/on-hold.md) כשאתם ממתינים למועד, למשלוח או לשיחה חוזרת. ## שיוך, עדיפות, תוויות ודגלים השתמשו בסרגל העליון של השיחה שנבחרה כדי לשמור על סדר בעבודה. | פקד | השתמשו בו כדי | | --- | --- | | נציג משויך | להעביר בעלות לעצמכם או לנציג אחר. | | צוות משויך | לנתב את השיחה ל[צוות](../product/teams.md) במקום לאדם בודד. הסימן `⚡` מציין צוות שמשייך אוטומטית לחבר מחובר. מוסתר כאשר אין צוותים בחשבון. | | עדיפות | לסמן דחיפות: נמוכה, בינונית, גבוהה או דחופה. | | דגל | להוסיף סימון ויזואלי למעקב או לטיפול מיוחד. | | תוויות | לקבץ שיחות לפי נושא, מחלקה, קמפיין או סוג בעיה. | | בהמתנה | להחנות את השיחה עד למועד שנבחר. היא יוצאת מהתורים הפעילים שלכם וחוזרת מעצמה — כשהזמן חולף, או ברגע שהלקוח משיב. ראו [בהמתנה](../product/on-hold.md). | | סימון כטופל | לסגור את השיחה כשאין צורך בפעולה נוספת. | Teloring שומרת על עקביות בין הנציג לצוות. שיוך נציג ש**אינו** בצוות של השיחה מנקה את הצוות, והעברת שיחה לצוות שהבעלים הנוכחי אינו חבר בו מנקה את הנציג. **החזרה לתור** שומרת על הצוות, כך שאותו צוות שומר על זכות הקדימה. הכללים המלאים: [צוותים](../product/teams.md#teams-and-the-agent-field-together). ## פעולות מרובות כשכמה שיחות זקוקות לאותו עדכון, בחרו שיחות מהרשימה והשתמשו בסרגל הפעולות המרובות כדי לשייך, לתייג, לסמן כנקרא או לא נקרא, או לסמן אותן כטופלו. :::warning פעולות מרובות משפיעות על כל שיחה שנבחרה. לפני ההפעלה, ודאו את מספר הפריטים שנבחרו ואת הקשר הסינון. ::: --- # מילון המונחים של Teloring מקור: https://docs.teloring.com/he/docs/glossary Markdown: https://docs.teloring.com/he/markdown/docs/glossary.md מדור: מילון מונחים עודכן לאחרונה: 2026-08-20T20:49:57.000Z השתמשו במילון הזה כשמונח של Teloring אינו מוכר לכם, או כשמוצר אחר משתמש בשם שונה לאותו רעיון. לצד כל מונח מופיע גם השם באנגלית, כפי שהוא מופיע בממשק כשהוא מוגדר לאנגלית. המונחים מסודרים לפי סדר הא"ב האנגלי, זהה למילון האנגלי, כדי שקל יהיה לעבור בין שתי הגרסאות. ## חשבון (Account) {#account} סביבת עבודה של עסק ב‑Teloring. הנציגים, התיבות, אנשי הקשר, הלקוחות, השיחות, תהליכי הסטודיו, הקבצים, הדוחות וההגדרות שלו מבודדים לחלוטין מכל חשבון אחר. **מכונה גם:** חשבון עסקי, חשבון לקוח, דייר (tenant), סביבת עבודה. ## נציג (Agent) {#agent} אדם שמתחבר ל‑Teloring כדי לטפל בשיחות ולעבוד בסביבת העבודה. לכל נציג יש בדיוק [תפקיד](#role) אחד שקובע למה הוא רשאי לגשת, לצד הגדרות אישיות, והוא יכול להשתייך ל[צוות](#team) אחד או יותר. **מכונה גם:** נציג אנושי, חבר צוות, נציג תמיכה, מפעיל. **לא זהה ל:** [נציג AI](#ai-agent). ## נציג AI (AI Agent) {#ai-agent} פרופיל AI אוטונומי שהוגדר להשתתף בשיחות עם לקוחות באמצעות הוראות, ידע, כללי איסוף נתונים והתנהגות מסירה לנציג אנושי. נציג AI יכול להיות חבר ב[צוות](#team) ונחשב כזמין תמיד לצורך שיוך אוטומטי בצוות, אך אינו נספר כנוכחות אנושית. **מכונה גם:** נציג וירטואלי, סוכן AI, נציג אוטונומי. **לא זהה ל:** AI Copilot, שמסייע לנציג אנושי מחובר. ## AI Copilot {#ai-copilot} העוזר שפועל בתוך השיחה ומסייע לנציג אנושי להבין הקשר, לחפש במאגרי ידע נבחרים ולהכין תשובות. **מכונה גם:** עוזר נציג, קופיילוט שיחה. ## AI Studio {#ai-studio} היכולת של Teloring שמאפשרת לאדם ליצור [תהליך](#flow) ב‑[סטודיו](#studio) על ידי מענה על שאלות בשפה חופשית, במקום לצייר אותו על הקנבס. היכולת מופעלת לכל חשבון בנפרד ב[עולם AI](#ai-world), והמראיין שלה הוא [Hermes](#hermes). **מכונה גם:** בונה תהליכים חכם, בונה אוטומציות AI, יצירת תהליך בעזרת AI. ## עולם AI (AI World) {#ai-world} עמוד הבקרה ברמת החשבון להפעלה או כיבוי של יכולות ה‑AI של Teloring. **מכונה גם:** הגדרות AI, בקרת יכולות AI. ## בלוק (Block) {#block} שלב אחד על קנבס של תהליך בסטודיו. בלוק הוא טריגר (**WHEN**), פעולה (**THEN**), תנאי (**IF**) או הערה שמוצגת בעורך בלבד. **מכונה גם:** צומת, שלב בתהליך, שלב אוטומציה. ## ערוץ (Channel) {#channel} טכנולוגיית התקשורת שבה משתמשת תיבה — למשל WhatsApp, אימייל, שיחות טלפון, SMS, טלגרם או צ׳אט באתר. בשימוש יומיומי ב‑Teloring המונחים *ערוץ* ו*תיבה* מופיעים לעיתים יחד, אבל הערוץ הוא הסוג והתיבה היא החיבור המוגדר בפועל. **מכונה גם:** ערוץ תקשורת, מקור. ## איש קשר (Contact) {#contact} אדם או כתובת שמתקשרים עם העסק. לאיש קשר יכולים להיות שדות כמו שם, מספר טלפון, כתובת אימייל, חברה, סטטוס וערכים מותאמים. **מכונה גם:** משתמש קצה, מתכתב, ליד. **לא זהה ל:** [לקוח](#customer), שיכול לקבץ כמה אנשי קשר ורשומות עסקיות קשורות. ## שיחה (Conversation) {#conversation} השרשור המשותף או רשומת השיחה שבהם נציגים מטפלים בתקשורת עם לקוח מתוך תיבה. שיחה מכילה הודעות או פרטי שיחת טלפון, לצד שיוך, סטטוס, תוויות, עדיפות, איש קשר והקשר לקוח. **מכונה גם:** פנייה, קריאה, שרשור, צ׳אט, אינטראקציה. ## מאפיין שיחה (Conversation attribute) {#conversation-attribute} שדה מותאם שהחשבון מגדיר, ששייך ל**[שיחה](#conversation) אחת** ולא ל[איש הקשר](#contact) או ל[לקוח](#customer) — למשל סיבת הפנייה, תוצאה או מספר הזמנה. החשבון מגדיר מערך אחד של מאפיינים ב**הגדרות ← מאפייני שיחה**; נציגים ממלאים ערכים מסרגל הצד של השיחה, [סטודיו](#studio) יכול להגדיר אותם אוטומטית, והם ניתנים לדיווח באנליטיקס. שיחה חדשה עם אותו אדם תמיד מתחילה עם מערך ריק. **מכונה גם:** שדה מותאם לשיחה, קוד סיכום, שדה סיכום, מטא‑דאטה של שיחה, שדה פנייה, קוד תוצאה, disposition, wrap-up code. **לא זהה ל:** שדה של איש קשר או לקוח, שמתאר אדם או עסק ונשמר לאורך כל השיחות; או תווית שיחה, שהיא תגית חופשית ולא שדה בעל שם, סוג וערכים מותרים. ## לקוח (Customer) {#customer} רשומת הקשר המרכזית ב‑CRM. לקוח יכול לייצג חברה, ארגון, משק בית, חשבון או אדם, ויכול לקשר כמה אנשי קשר, שיחות, שיחות טלפון, מסמכים ורשומות של אובייקטים מותאמים. **מכונה גם:** לקוח CRM, ארגון, רשומת חשבון. ## מחסן קבצים (Files Warehouse) {#files-warehouse} המצאי ברמת החשבון של קבצים שנרשמו על ידי יכולות נתמכות ב‑Teloring, כולל קבצים מצורפים, הקלטות, מסמכים חתומים והקלטות קול של סטודיו. **מכונה גם:** מצאי קבצים, קטלוג אחסון. ## תהליך (Flow) {#flow} אוטומציה אחת בסטודיו, הבנויה מבלוקים מחוברים. לתהליך יש קנבס טיוטה, ולאחר פרסום — גרסה חיה נפרדת. **מכונה גם:** זרימת עבודה, אוטומציה, workflow. ## טופס (Form) {#form} עמוד ציבורי ומובנה לאיסוף נתונים, שנוצר בבונה הטפסים. הגשה יכולה להזין נתוני CRM ולהפעיל תהליך בסטודיו. **מכונה גם:** טופס פנייה, סקר, שאלון. ## תיבה עתידית (Future inbox) {#future-inbox} שורה בלשונית **הרשאות ערוצים** של [תפקיד](#role), שמספקת את יכולות ברירת המחדל לכל [תיבה](#inbox) שתחובר מכאן והלאה — וגם לכל תיבה קיימת שלא הוגדרה בתפקיד הזה במפורש, שמוצגת עם תג **בירושה**. המשמעות היא שחיבור ערוץ חדש לעולם לא מחייב לעבור מחדש על כל התפקידים. שינוי הערכים של התיבה העתידית מעדכן גם את כל התיבות שיורשות ממנה באותו תפקיד. **מכונה גם:** הרשאות ברירת מחדל לתיבה, ברירות מחדל לתיבות, הרשאות בירושה. ## Hermes {#hermes} בונה התהליכים החכם שבתוך [סטודיו](#studio). Hermes מראיין את המשתמש שאלה אחת בכל פעם, ואז מציב על הקנבס טיוטת תהליך שלמה — בלוקים, הגדרות וחיבורים. בניית התהליך מסיימת את השיחה; מכאן והלאה עורכים את התהליך ידנית. דורש ש‑[AI Studio](#ai-studio) יהיה מופעל. **מכונה גם:** בונה התהליכים החכם, עוזר ה‑AI של סטודיו. **לא זהה ל:** [נציג AI](#ai-agent), שמדבר עם לקוחות, או [AI Copilot](#ai-copilot), שמסייע לנציג בתוך שיחה. ## תיבה (Inbox) {#inbox} חיבור תקשורת מוגדר אחד עם לקוחות — למשל מספר WhatsApp מסוים, תיבת אימייל, מספר טלפון, בוט טלגרם או וידג'ט צ׳אט באתר. שיחות מגיעות דרך תיבות. **מכונה גם:** ערוץ מחובר, מקור תקשורת. **ניווט ב‑Teloring:** התיבות מנוהלות ב[טבעת הערוצים](#ring). ## מאגר ידע (Knowledge Base) {#knowledge-base} אוסף מבודד לחשבון של קבצים ואתרים שהועלו, ש‑Teloring מעבדת לצורך תשובות AI מבוססות מקור. **מכונה גם:** KB, מאגר ידע RAG, ספריית AI פרטית. ## בהמתנה (On Hold) {#on-hold} סטטוס [שיחה](#conversation) ברמה העליונה, לצד פתוחה וטופלה, שמחנה שיחה עד למועד שנבחר. שיחה בהמתנה יוצאת מכל התורים הפעילים וממוני לוח הבקרה של הבעלים שלה, שומרת על הנציג המשויך אליה, וחוזרת אוטומטית כשהמועד חולף **או** ברגע שהלקוח משיב — לפי המוקדם מביניהם. המועדים מחושבים לפי אזור הזמן העסקי של החשבון. **מכונה גם:** נודניק, השהיה, דחייה, חניה, הזכר לי מאוחר יותר, מעקב בהמשך, snooze. **לא זהה ל:** **טופל** (השיחה הסתיימה) או **החזרה לתור** (השיחה מאבדת את הבעלים שלה וחוזרת לתור ההמתנה). **ניווט ב‑Teloring:** כפתור **בהמתנה** בסרגל העליון של שיחה, והתור **שיחות ← בהמתנה**. ראו [בהמתנה](./product/on-hold.md). ## קישור הפעלה (Onboarding link) {#onboarding-link} הקישור החד‑פעמי ש‑Teloring מנפיקה כאשר נוצרת [תיבת WhatsApp](./product/ring/whatsapp.md), בתבנית `https://onboarding.direct/xxxxxxxx`. פתיחתו מאשרת את המספר מול Meta — בחירת תיק עסקי, יצירת [חשבון WhatsApp Business](#whatsapp-business-account-waba) ומתן גישת התכתבות. עד להשלמתו התיבה נשארת במצב **ממתין להפעלה** ואינה יכולה לשלוח או לקבל. Teloring מציגה את הקישור בשלושה מקומות: השלב האחרון באשף ההגדרה, רשימת WhatsApp בטבעת הערוצים, ולשונית **הפעלה** של התיבה. **מכונה גם:** הפעלה מול Meta, onboarding של WhatsApp, Embedded Signup, קישור onboarding.direct, קישור הפעלה. **לא זהה ל:** **קוד האימות** ב‑SMS או בשיחת טלפון ש‑Teloring משתמשת בו כדי לוודא שהמספר בשליטתכם, שמתרחש מוקדם יותר ובתוך Teloring. **ניווט ב‑Teloring:** **טבעת הערוצים ← WhatsApp**, או לשונית **הפעלה** של התיבה. ראו [השלמת הפעלת WhatsApp מול Meta](./product/ring/whatsapp/onboarding.md). ## התראה (Notification) {#notification} התרעה אישית לנציג על משהו שקרה ב‑Teloring. כל נציג בוחר **על מה** לקבל עדכון (שיחה ששויכה אליו, הודעה חדשה מלקוח, או התראת [סטודיו](#studio)) ו**איך** היא תגיע אליו (צליל, אימייל, דחיפה בדפדפן או [פעמון ההתראות](#notification-bell)). כל אפשרות כבויה עד שהנציג מפעיל אותה, והבחירות של נציג אחד לעולם אינן משפיעות על נציג אחר. **מכונה גם:** התרעה, התראת נציג, התראה אישית. **לא זהה ל:** הודעה יוצאת ללקוח, או הערה פנימית בשיחה. **ניווט ב‑Teloring:** **הפרופיל שלי ← התראות**. ראו [התראות](./product/notifications.md). ## פעמון ההתראות (Notification bell) {#notification-bell} סמל הפעמון בסרגל העליון של Teloring. הוא מציג תג שסופר את ההתראות שהגיעו מאז הפעם האחרונה שהנציג פתח אותו, ומציג את 100 האחרונות. פתיחת הרשימה מסמנת הכול כנקרא אך אינה מוחקת דבר. **מכונה גם:** תפריט הפעמון, מרכז התרעות, מרכז התראות. ## התראת דחיפה (Push notification) {#push-notification} התראה שמוצגת על ידי מערכת ההפעלה, גם כאשר Teloring פתוחה בלשונית ברקע או כשיישום אחר פתוח בחזית. זו אחת מארבע שיטות המסירה של התראות, ויש לאשר אותה פעם אחת בכל דפדפן ובכל מכשיר. **מכונה גם:** דחיפה בדפדפן, web push, התראת שולחן עבודה. **לא זהה ל:** דחיפה מאפליקציית מובייל — Teloring שולחת דחיפות דרך הדפדפן. ## תפקיד (Role) {#role} חבילת הרשאות בעלת שם בחשבון Teloring. תפקיד קובע לאילו יכולות נציג רשאי לגשת (עם הפעולות **צפייה**, **יצירה**, **עדכון** ו**מחיקה**) ומה מותר לו לעשות בתוך כל [תיבה](#inbox). לכל נציג יש בדיוק תפקיד אחד, ועריכת תפקיד משנה מיד את הגישה של כל מי שמשויך אליו. כל חשבון מגדיר את התפקידים שלו. חמישה נוצרים יחד עם החשבון — Owner,‏ Team Leader,‏ Marketing,‏ Agent ו‑Viewer — וכולם, למעט **Owner**, ניתנים לשינוי שם, לשינוי היקף או למחיקה. **מכונה גם:** פרופיל הרשאות, קבוצת הרשאות, רמת גישה, תפקיד משתמש, פרופיל אבטחה. **לא זהה ל:** [צוות](#team), שמשפיע על ניתוב שיחות ואינו מעניק גישה כלל; או **מחלקה** של נציג, שהיא תווית טקסט חופשי לתצוגה בלבד. ## טבעת הערוצים (Ring) {#ring} המודל הוויזואלי ואזור הניווט של Teloring לתיבות מחוברות. **טבעת הערוצים** היא המקום שבו חשבון מוסיף ומנהל חיבורי תקשורת. **מכונה גם:** מרכז התיבות, מרכז הערוצים, תיבות מחוברות. **לא זהה ל:** צלצול טלפון, תור נציגים או תהליך בסטודיו. ## סטודיו {#studio} בונה האוטומציות הוויזואלי של Teloring. סטודיו מריץ תהליכים הבנויים מטריגרים, פעולות, תנאים, משתנים וחיבורים. בסרגל הצד הוא מופיע כ**סטודיו**. **מכונה גם:** בונה אוטומציות, בונה תהליכים, בונה זרימות עבודה. ## צוות (Team) {#team} קבוצת נציגים בעלת שם ברמת החשבון — למשל *מכירות* או *תמיכה*. אפשר לשייך שיחה לצוות במקום לאדם בודד. צוות יכול לשייך אוטומטית לחבר מחובר אקראי, והוא מגביל אילו שיחות ממתינות נציג יכול למשוך באמצעות **קבלת הבא בתור**. גם נציגים אנושיים וגם [נציגי AI](#ai-agent) יכולים להיות חברים, ונציג יכול להשתייך לכמה צוותים. **מכונה גם:** קבוצת נציגים, תור, קבוצת מיומנות, קבוצת ניתוב. **לא זהה ל:** **מחלקה** של נציג, שהיא תווית טקסט חופשי ללא השפעה על ניתוב; או [תפקיד](#role) — חברות בצוות אינה מעניקה זכויות גישה כלל. ## משתנה (Variable) {#variable} מציין מקום בסטודיו הנכתב בסוגריים מסולסלים כפולים, למשל `{{contact.name}}`. בזמן ריצה, סטודיו מחליף אותו בנתונים שהופקו על ידי הטריגר, בלוק קודם או ערך `var.*` שנשמר. **מכונה גם:** משתנה תבנית, ערך בתהליך, מציין מקום, placeholder. ## תצוגה (View) {#view} טבלה שמורה, הניתנת לסינון ולמיון, מעל לקוחות או רשומות של אובייקטים ב‑CRM. תצוגות קוראות נתוני חשבון חיים בלי לשנות את הרשומות עצמן. **מכונה גם:** טבלה שמורה, תצוגת CRM, רשימה מסוננת. ## חשבון WhatsApp Business (WABA) {#whatsapp-business-account-waba} החשבון אצל Meta שמחזיק מספר טלפון עסקי אחד או יותר ב‑WhatsApp, נוצר במהלך תהליך [קישור ההפעלה](#onboarding-link) ובבעלות **התיק העסקי** שלכם (המכולה של Meta לנכסים העסקיים של חברה, המכונה גם חשבון Business Manager). Meta מצמידה ל‑WABA את שם התצוגה, מגבלות ההתכתבות ותבניות ההודעות — ולכן חלק מהערכים האלה הם לקריאה בלבד ב‑Teloring וניתנים לשינוי רק אצל Meta. **מכונה גם:** WABA, חשבון WhatsApp Business, חשבון WhatsApp של Meta. **לא זהה ל:** **אפליקציית WhatsApp Business** (אפליקציית הטלפון לעסקים קטנים), או [תיבה](#inbox) ב‑Teloring (החיבור ש‑Teloring מגדירה מעל ה‑WABA). --- # טבעת הערוצים — סקירת התיבות מקור: https://docs.teloring.com/he/docs/product/ring/overview Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/overview.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z **טבעת הערוצים** היא המקום שבו אתם מחברים ומנהלים כל ערוץ שהלקוחות שלכם משתמשים בו כדי להגיע אליכם. כל ערוץ שאתם מחברים הופך ל**תיבה**, וכל תיבה מזינה את אותה סביבת עבודה של [שיחות](../../getting-started/conversations.md) — כך ש‑WhatsApp, אימייל, צ׳אט באתר, שיחת טלפון ותגובה באינסטגרם נוחתים כולם במקום אחד ומטופלים באותו אופן. העמוד נקרא **טבעת הערוצים** (בסרגל הצד ובכתובת `/dashboard/ring`). הסלוגן שלו מסכם זאת היטב: *טבעת אחת, אינסוף אפשרויות.* :::info **תיבה** ו**ערוץ** הם אותו דבר ב‑Teloring — קו תקשורת מחובר אחד (למשל מספר WhatsApp אחד, תיבת דואר אחת או וידג'ט אחד באתר). המדריך הזה משתמש ב"תיבה" עבור הקו המחובר וב"סוג ערוץ" עבור סוג הקו (WhatsApp, אימייל, SMS וכן הלאה). ::: ## עובדות מרכזיות | עובדה | משמעות | | --- | --- | | מקום אחד לכל ערוץ | חברו WhatsApp, אימייל, SMS, Messenger, פייסבוק, אינסטגרם, טלגרם, LINE, צ׳אט באתר, שיחות טלפון, TikTok ו‑API למפתחים — הכול מעמוד אחד. | | סוג ערוץ אחד, תיבות רבות | אפשר לחבר כמה תיבות מאותו סוג (למשל שני מספרי WhatsApp או שלוש תיבות דואר). כל אחת היא תיבה נפרדת עם שם משלה. | | הכול מנותב לשיחות | כל הודעה נכנסת, תגובה או שיחת טלפון יוצרת או מעדכנת שיחה. הנציגים לעולם לא צריכים לצאת מ‑Teloring כדי להשיב. | | מנוהל בהרשאות | הוספה, הגדרה והסרה של תיבות דורשות **טבעת הערוצים ← יצירה / עדכון / מחיקה**. עבודה *בתוך* תיבה מנוהלת בקבוצת הרשאות נפרדת לכל תיבה, ולכן נציג בקו הראשון בדרך כלל עונה בכל התיבות בלי שתהיה לו כלל גישה לטבעת הערוצים. ראו [תפקידים והרשאות](../roles/overview.md). | | מבודד לחשבון | תיבה שייכת לחשבון אחד (עסק אחד). היא לעולם אינה גלויה לחשבון אחר. | | בטוח להסרה | מחיקת תיבה עוצרת הודעות חדשות בקו הזה, אך **שומרת** את כל השיחות וההיסטוריה הקיימות. | ## סוגי התיבות הנתמכים לכל סוג ערוץ יש עמוד מדריך משלו. הקליקו כדי לראות את שלבי החיבור, המסכים וההגדרות הייחודיים לאותו ערוץ. | תיבה | למה היא משמשת | מדריך | | --- | --- | --- | | WhatsApp | תמיכה ומכירות במספר WhatsApp Business. | [WhatsApp](./whatsapp.md) · [הפעלה מול Meta](./whatsapp/onboarding.md) | | אימייל | תיבת דואר משותפת לצוות (בניהול Teloring, ‏Microsoft 365, ‏Gmail או כל כתובת IMAP/SMTP). | [אימייל](./email.md) | | SMS | שיחות דו‑כיווניות בהודעות טקסט. | [SMS](./sms.md) | | Messenger | הודעות פרטיות שנשלחות לדף הפייסבוק שלכם. | [Messenger](./messenger.md) | | דף פייסבוק | תגובות ופעילות על הפוסטים בדף הפייסבוק שלכם. | [דף פייסבוק](./facebook-page.md) | | הודעות אינסטגרם | הודעות ישירות מחשבון האינסטגרם שלכם. | [הודעות אינסטגרם](./instagram-dm.md) | | פוסטים באינסטגרם | תגובות על הפוסטים שלכם באינסטגרם. | [פוסטים באינסטגרם](./instagram-posts.md) | | טלגרם | שיחות דרך בוט טלגרם. | [טלגרם](./telegram.md) | | LINE | שיחות דרך חשבון LINE רשמי. | [LINE](./line.md) | | צ׳אט באתר | וידג'ט צ׳אט שאתם משבצים באתר שלכם. | [צ׳אט באתר](./live-chat.md) | | שיחות טלפון | מספר טלפון עם סופטפון בדפדפן לניהול שיחות. | [שיחות טלפון](./voice.md) | | TikTok Messenger | הודעות ישירות מ‑TikTok. | [TikTok Messenger](./tiktok.md) | | API | תיבת מפתחים לדחיפת הודעות מכל מערכת מותאמת. | [API](./api.md) | ## עמוד טבעת הערוצים פתחו את **טבעת הערוצים** מסרגל הצד. במקום רשימה פשוטה, Teloring מציירת את הערוצים שלכם כ**טבעת** — מעגל המחולק לקשת צבעונית אחת לכל סוג ערוץ, עם סמל הערוץ על כל קשת וסמל Teloring במרכז. ![עמוד טבעת הערוצים](pathname:///img/screenshots/he/product/ring/overview/my-ring.png) | רכיב | מה הוא מספר לכם | | --- | --- | | קשת צבעונית + סמל | סוג ערוץ המוצג בצבע המותג שלו פירושו שלפחות תיבה אחת מהסוג הזה מחוברת. | | קשת אפורה + סמל דהוי | לסוג הערוץ הזה עדיין אין תיבה מחוברת — הוא זמין להוספה. | | תיאור בריחוף | ריחוף מעל קשת או סמל מציג את שם הערוץ וכמה תיבות חיברתם (למשל *"יש לכם 2 תיבות מחוברות"* או *"אין עדיין תיבות מחוברות"*). | | הסמל המרכזי | הלוגו של Teloring והסלוגן *טבעת אחת — אינסוף אפשרויות*. | לחצו על כל קשת או סמל כדי לפתוח את **החלון** של אותו ערוץ. ### חלון הערוץ חלון הערוץ מציג כל תיבה שכבר יש לכם מהסוג הזה, ומאפשר להוסיף עוד אחת. ![חלון ערוץ המציג תיבות מחוברות](pathname:///img/screenshots/he/product/ring/overview/channel-modal.png) | פריט | משמעות | | --- | --- | | שורות תיבה | כל תיבה מחוברת מהסוג הזה, עם ה**שם** שלה, ה**מזהה** שלה ותאריך היצירה. | | תג סטטוס | עבור ערוצים שמדווחים על מצב חיבור (כמו WhatsApp), תג מציג אם התיבה פעילה, ממתינה, בקבלה בלבד וכן הלאה — ראו [סטטוסים של תיבה](#inbox-statuses). | | עריכה (עיפרון) | פותח את עמוד ההגדרות של אותה תיבה. | | כפתור הוספה | **הוספה לטבעת** (כשאין תיבות מחוברות) או **הוספת ערוץ נוסף** (כשכבר קיימת אחת או יותר) — מתחיל את תהליך ההגדרה עבור סוג הערוץ הזה. | ## חיבור תיבה השלבים המדויקים תלויים בערוץ — חלקם דורשים התחברות לספק, מספר טלפון או טוקן — אבל המבנה תמיד זהה: 1. פתחו את **טבעת הערוצים**. 2. לחצו על סוג הערוץ שאתם רוצים (הקשת או הסמל שלו). 3. בחלון, לחצו על **הוספה**. 4. עקבו אחר תהליך ההגדרה של הערוץ (תנו שם לתיבה והזינו או אשרו את פרטי החיבור). 5. השלימו כל שלב בצד הספק (התחברות לפייסבוק או ל‑Microsoft, אימות מספר WhatsApp, הדבקת כתובת Webhook וכן הלאה). 6. ודאו שהתיבה מופיעה כמחוברת על הטבעת. 7. שלחו **הודעת בדיקה** לקו החדש וּודאו שנוצרת שיחה ב[שיחות](../../getting-started/conversations.md). :::note ההגדרה שונה מערוץ לערוץ. ‏WhatsApp מריץ אשף אימות שלב אחר שלב, אפשרויות ה‑OAuth של Meta ושל האימייל פותחות התחברות אצל הספק, טלגרם ו‑LINE מבקשים טוקן של בוט, צ׳אט באתר מייצר קטע קוד להטמעה, שיחות טלפון מקצות מספר טלפון, ו‑API מייצר נקודת קצה. כל עמוד מדריך מלווה את התהליך שלו. ::: ## מה משותף לכל תיבה עד כמה שהערוצים שונים זה מזה, לכל תיבה יש אותו גרעין: | מאפיין | פירוט | | --- | --- | | שם | תווית שאתם בוחרים (למשל *תמיכה WhatsApp* או *תיבת מכירות*). הנציגים מסננים ומזהים שיחות לפיה, אז כדאי שתהיה ברורה. אפשר לשנות שם של תיבה בכל עת מעמוד העריכה שלה. | | מצב פעילות | האם התיבה חיה. חלק מהערוצים (כמו WhatsApp) קובעים זאת אוטומטית ברגע שהספק מאשר את החיבור. | | מזהה תיבה | מספר סידורי קצר (1, 2, 3, …) ייחודי בתוך החשבון שלכם. הוא מופיע בחלון ובכתובת של עמוד העריכה. | | הגדרות | אפשרויות ייחודיות לערוץ, המוצגות כלשוניות בעמוד העריכה (למשל פרופיל ותבניות של WhatsApp, או לשונית המראה של הצ׳אט באתר). | | אזור מסוכן | כל עמוד עריכה של תיבה מסתיים ב**אזור מסוכן** למחיקת התיבה. | ### עמוד עריכת התיבה לחצו על ה**עיפרון** של תיבה (או השתמשו בשורה שלה בחלון) כדי לפתוח את עמוד העריכה בכתובת `/dashboard/ring/{id}/edit`. העמוד מציג לשוניות המותאמות לסוג הערוץ. רוב הערוצים נפתחים בהגדרות הראשיות שלהם; הלשוניות מתוארות בעמוד המדריך של כל ערוץ. ### סטטוסים של תיבה {#inbox-statuses} ערוצים פשוטים הם מחוברים או לא. ערוצים שתלויים בספק חיצוני מדווחים סטטוס מפורט יותר, שמוצג כתג בחלון הערוץ. ‏WhatsApp משתמש בסט המלא: | סטטוס | משמעות | | --- | --- | | **ממתין להפעלה** | התיבה קיימת ב‑Teloring, אך הגדרת הספק (למשל ההפעלה מול Meta) לא הושלמה. עדיין לא שולחת ולא מקבלת. | | **ממתין לאישור** | ההגדרה הושלמה; ממתינים לאישור הקו מצד הספק. | | **קבלה בלבד** | התיבה יכולה לקבל הודעות אך עדיין לא לשלוח. | | **פעיל** | חי לגמרי — שולח ומקבל. | | **שגיאה** | משהו השתבש בחיבור. פנו לתמיכה. | | **נמחק** | חשבון הספק של הקו הזה הוסר. | ### מחיקת תיבה (אזור מסוכן) כל עמוד עריכה מסתיים ב**אזור מסוכן**. המחיקה קשה בכוונה, כדי שלא תקרה בטעות: 1. לחצו על **מחיקת הערוץ הזה**. 2. אשרו את האזהרה הראשונה. 3. הקלידו את **שם** התיבה במדויק לאישור. אם הוא לא תואם, שום דבר לא קורה. :::warning מחיקת תיבה היא לצמיתות ואינה ניתנת לביטול. לא תוכלו עוד לשלוח או לקבל הודעות בקו הזה. **השיחות הקיימות נשארות במערכת** — הן אינן נמחקות — אבל התיבה מוסרת סופית. המחיקה דורשת **טבעת הערוצים ← מחיקה**. ::: ## אחרי שהתיבה מחוברת ברגע שתיבה חיה, פעילות לקוחות חדשה זורמת ישירות אל תוך המוצר: - **שיחות נוצרות אוטומטית.** הודעה נכנסת, תגובה או שיחת טלפון מאתרות או יוצרות את איש הקשר, ואז פותחות שיחה חדשה או ממשיכות שיחה פתוחה קיימת של הלקוח. מדיה נשמרת ב‑Teloring. ראו [שיחות](../../getting-started/conversations.md). - **הנציגים עובדים בכל ערוץ באותו אופן.** מענה, שיוך, תיוג, קביעת עדיפות, סימון כטופל וקישור השיחה ל[לקוח ב‑CRM](../crm.md) — בלי קשר לערוץ שממנו היא הגיעה. - **סינון לפי תיבה.** בכל תור שיחות, הנציגים יכולים לסנן לפי סוג ערוץ ולפי שם תיבה, כך שצוות יכול להתמקד בקו אחד בלבד. - **אוטומציות מגיבות לאירועי תיבה.** תהליך ב‑[סטודיו](../studio.md) יכול להיות מופעל בהודעה נכנסת כדי להשיב אוטומטית, להריץ בוט, לשייך את השיחה או לעדכן שדות לקוח. - **ה‑AI מסייע בכל תיבה.** ה‑AI Copilot (ובמקומות שהופעל, גם נציג AI) פועל על הודעות נכנסות כדי לסכם, להציע תשובות ולענות מתוך מאגר הידע שלכם. ## טיפים למנהלי חשבון | טיפ | למה זה עוזר | | --- | --- | | השתמשו בשמות תיבה ברורים | הנציגים מסננים שיחות לפי שם התיבה ורואים מיד מאיפה הגיעה ההודעה. | | חברו ערוץ אחד בכל פעם | קל יותר לוודא ניתוב ולבדוק תשובות לפני שמוסיפים את הקו הבא. | | תמיד שלחו הודעת בדיקה | כל תיבה חדשה צריכה להיבדק בהודעה נכנסת אמיתית לפני שהנציגים מסתמכים עליה. | | שמרו את פרטי ההתחברות לספקים אצל מעטים | טוקנים רגישים וחשבונות ספק (Meta,‏ Microsoft,‏ WhatsApp) צריכים להישאר אצל הקבוצה הקטנה שמחזיקה **טבעת הערוצים ← עדכון**. | | הוסיפו כמה תיבות לאותו סוג כשזה מתאים | מספרים או תיבות דואר נפרדות (מכירות מול תמיכה) שומרות על תורים נקיים ועל דיווח משמעותי. | --- # השלמת הפעלת WhatsApp מול Meta מקור: https://docs.teloring.com/he/docs/product/ring/whatsapp/onboarding Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/whatsapp/onboarding.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z יצירת תיבת WhatsApp ב‑Teloring עושה **שני** דברים: היא שומרת עבורכם את מספר הטלפון, והיא מנפיקה לכם **קישור הפעלה** חד‑פעמי. הקישור הוא המקום שבו אתם מחברים את המספר הזה ל‑Meta — החברה שמאחורי WhatsApp — וזהו השלב שאנשים עוצרים באמצעו לעיתים קרובות. עד להשלמת הקישור, התיבה קיימת ב‑Teloring אך **אינה יכולה לשלוח או לקבל דבר**. היא מוצגת כ**ממתין להפעלה**, ו‑Teloring ממשיכה להציע לכם את הקישור עד לסיום. התהליך כולו אורך בערך **5 עד 10 דקות** ואינו דורש ידע טכני. העמוד הזה עובר על כל מסך שתראו. :::info למה בכלל Meta מעורבת WhatsApp היא פלטפורמה של Meta, ורק Meta יכולה לאשר למספר עסקי לשלוח הודעות דרכה. ‏Teloring אינה יכולה לעשות זאת בשמכם — ‏Meta דורשת שבעל העסק יאשר את החיבור בזמן שהוא מחובר לחשבון הפייסבוק שלו. האישור הזה הוא בדיוק מה שקישור ההפעלה אוסף. ::: ## איפה למצוא את קישור ההפעלה {#where-to-find-your-onboarding-link} אותו קישור זמין בשלושה מקומות, כדי שלעולם לא תצטרכו לחפש אותו: | איפה | מתי רואים אותו | | --- | --- | | **אשף ההגדרה, שלב 4** | מיד לאחר יצירת התיבה — המסך "תיבת WhatsApp נוצרה!" מציג את הקישור וכפתור **פתיחת ההפעלה מול Meta ↗**. | | **טבעת הערוצים ← WhatsApp** | לחצו על סמל WhatsApp בטבעת. כל תיבות ה‑WhatsApp מופיעות ברשימה; תיבה שממתינה נושאת הודעת ⚠️ עם הכפתור **פתיחת ההפעלה מול Meta ↗**. | | **עמוד עריכת התיבה ← לשונית הפעלה** | פתחו את התיבה (סמל העיפרון) ועברו ללשונית **הפעלה**. הכפתור נמצא שם עד להשלמת ההפעלה. | הקישור נראה כך: `https://onboarding.direct/xxxxxxxx`. הוא **ייחודי למספר שלכם** — אל תשתמשו שוב בקישור של תיבה אחרת, והתייחסו אליו כאל מידע פרטי. :::tip אפשר לשלוח את הקישור למי שמנהל את חשבונות הפייסבוק והחשבונות העסקיים של החברה — הוא אינו זקוק להתחברות ל‑Teloring כדי לפתוח אותו. הוא כן צריך להיות מחובר לחשבון הפייסבוק הנכון. ::: ## לפני שמתחילים | מה נדרש | למה | | --- | --- | | הרשאת תיבה ב‑Teloring | הגעה לקישור דורשת **טבעת הערוצים ← צפייה**; עמוד העריכה דורש **טבעת הערוצים ← עדכון**. ראו [תפקידים והרשאות](../../roles/overview.md). | | חשבון פייסבוק אישי קיים | ‏Meta דורשת אותו כדי לאשר את החיבור. חשבון פייסבוק **חדש לגמרי** לא יאושר ל‑Business Manager — השתמשו בחשבון ותיק. | | פרטי העסק שלכם | שם עסקי משפטי או מסחרי, אתר אינטרנט ומדינה. | | אישור חלונות קופצים בדפדפן | התהליך של Meta נפתח בחלון קופץ. אם שום דבר לא קורה בלחיצה, בדרך כלל חוסם החלונות הקופצים אשם. | :::warning סיימו את התהליך ברצף אחד השתמשו בדפדפן במחשב שולחני והשלימו את כל השלבים בסשן אחד. סגירת החלון הקופץ באמצע התהליך מחייבת התחלה מחדש של הקישור מההתחלה. שום דבר לא נשבר — אבל גם שום דבר לא נשמר. ::: ## שלב 1 — פתיחת הקישור והתחלה {#step-1--open-the-link-and-start} פתיחת הקישור מביאה אתכם לעמוד ההפעלה של המספר שלכם. ![עמוד הפתיחה של ההפעלה עם כפתור ההתחלה](pathname:///img/screenshots/he/product/ring/whatsapp/onboarding/welcome.png) לחצו **לחצו כדי להתחיל**. חלון ההתחברות של Meta נפתח מעל העמוד. השאירו את העמוד הזה פתוח ברקע. הוא ממתין לדיווח מ‑Meta, וזה המקום שבו תראו את האישור הסופי ב[שלב 7](#step-7--wait-for-the-confirmation-in-teloring). ## שלב 2 — המשך עם חשבון הפייסבוק שלכם Meta שואלת אם להמשיך עם החשבון שאליו אתם מחוברים כרגע. ![מסך Facebook Login for Business המבקש להמשיך עם החשבון המחובר](pathname:///img/screenshots/he/product/ring/whatsapp/onboarding/meta-start.png) לחצו **המשך בתור \[השם שלכם\]**. :::caution בדקו קודם את השם זה הרגע לוודא שאתם בחשבון הפייסבוק הנכון — זה שמחזיק (או אמור להחזיק) את הנכסים העסקיים של החברה שלכם. אם השם המוצג שגוי, לחצו **התחברות לחשבון אחר** לפני שתמשיכו. חיבור החשבון הלא נכון הוא הטעות הנפוצה ביותר כאן, וביטול שלה בהמשך מחייב מעבר דרך Meta Business Manager. ::: ## שלב 3 — אישור החיבור Meta מסבירה מה התהליך עושה ומפרטת מה תוכלו לעשות לאחר החיבור. ![מסך החיבור החלק של Meta עם כפתור ההמשך](pathname:///img/screenshots/he/product/ring/whatsapp/onboarding/meta-first-connection.png) קראו את התנאים בתחתית — תנאי ה‑Marketing Messages API for WhatsApp, תנאי Meta Business Tools, תנאי האחסון של Meta ל‑Cloud API ותנאי Meta ל‑WhatsApp Business — ואז לחצו **המשך**. ## שלב 4 — בחירה או יצירה של התיק העסקי **תיק עסקי** (Meta קוראת לו גם חשבון Business Manager) הוא המכולה שמחזיקה את הנכסים העסקיים של החברה שלכם אצל Meta. ![מסך מילוי פרטי העסק של Meta עם הרשימה הנפתחת של התיק העסקי](pathname:///img/screenshots/he/product/ring/whatsapp/onboarding/meta-business-select.png) | שדה | מה לעשות | | --- | --- | | **תיק עסקי** | בחרו את התיק הקיים שלכם מהרשימה הנפתחת. אם לעסק שלכם אין תיק, בחרו באפשרות ליצור אחד — ‏Meta תבנה אותו כאן. | | **שם העסק** | השם המשפטי או המסחרי של העסק שלכם. | | **אתר או עמוד פרופיל של העסק** | האתר שלכם, או דף הפייסבוק שלכם אם אין לכם אתר. | | **מדינה** | המדינה שבה העסק רשום. | | **הפעלת תובנות לעסק** | אנליטיקה אופציונלית של Meta. השאירו לפי העדפתכם — זה אינו משפיע על התיבה ב‑Teloring. | לחצו **הבא**. :::note תמיד עדיף לבחור תיק עסקי קיים מאשר ליצור תיק שני. עסקים שיוצרים בטעות תיק כפול מוצאים את עצמם עם נכסי WhatsApp מפוצלים בין שני מקומות, מה שמקשה על אימות בהמשך. ::: ## שלב 5 — יצירת חשבון WhatsApp Business עכשיו אתם יוצרים את חשבון ה‑WhatsApp Business (**WABA**) שיחזיק את המספר שלכם. ![מסך יצירה או בחירה של חשבון WhatsApp Business ב‑Meta](pathname:///img/screenshots/he/product/ring/whatsapp/onboarding/meta-new-waba.png) | שדה | מה לעשות | | --- | --- | | **בחירת חשבון WhatsApp Business** | בחרו **יצירת חשבון WhatsApp Business** מהרשימה הנפתחת — זו הבחירה הרגילה. בחרו חשבון קיים רק אם לעסק שלכם כבר יש WABA שאליו אתם מתכוונים להוסיף את המספר הזה. | | **שם חשבון WhatsApp Business** | שם פנימי לחשבון. הלקוחות שלכם אינם רואים אותו. | | **אזור זמן** | אזור הזמן העסקי שלכם — למשל `(GMT+03:00) Asia/Jerusalem`. ‏Meta משתמשת בו למדדי התכתבות ולמגבלות יומיות, אז הגדירו אותו נכון. | לחצו **הבא**. ## שלב 6 — סקירה ואישור הגישה Meta מסכמת את ההרשאות שהיא עומדת להעניק, כדי שהמספר שלכם יוכל באמת לשלוח ולקבל דרך Teloring. ![מסך סקירת בקשת הגישה של Meta עם כפתור האישור](pathname:///img/screenshots/he/product/ring/whatsapp/onboarding/meta-confirm.png) הרשימה כוללת ניהול העסק שלכם, ניהול חשבונות ה‑WhatsApp שלכם, גישה לשיחות ב‑WhatsApp ורישום אירועי הודעות בחזרה ל‑Meta. כל ארבע ההרשאות נדרשות — בלעדיהן ההודעות אינן יכולות להגיע לתיבה שלכם. לחצו **אישור**. לאחר מכן Meta מאשרת שאתם מחוברים: ![מסך "אתם מוכנים להתכתב עם אנשים ב‑WhatsApp" עם כפתור הסיום](pathname:///img/screenshots/he/product/ring/whatsapp/onboarding/meta-final.png) המסך הזה גם מיידע אתכם על נפח ההתכתבות ההתחלתי שלכם: **לפחות 2,000 שיחות ביוזמת העסק** בכל חלון מתגלגל של 24 שעות, לאחר שבדיקת שם התצוגה תסתיים, ו**שיחות ללא הגבלה ביוזמת הלקוח**. ‏Meta בודקת את העסק שלכם מול מדיניות המסחר שלה ופונה אליכם (בתוך כ‑24 שעות) רק אם יש בעיה. לחצו **סיום** וחלון Meta ייסגר. ## שלב 7 — המתנה לאישור ב‑Teloring {#step-7--wait-for-the-confirmation-in-teloring} חזרו לעמוד ההפעלה שהשארתם פתוח. הוא מסיים מעצמו — אין צורך בפעולה — ומאשר שהמספר מחובר. ![עמוד ההפעלה מציג את אישור ההצלחה](pathname:///img/screenshots/he/product/ring/whatsapp/onboarding/onboarding-success.png) ברגע שאתם רואים את האישור הזה, החלק שלכם בעבודה הסתיים. אפשר לסגור את העמוד. ## מה קורה אחר כך Meta ופלטפורמת WhatsApp משלימות עכשיו ברקע את הקצאת המספר. :::info המתינו עד שעה בדרך כלל אפשר להשתמש במספר תוך דקות, אבל זה יכול לקחת **עד שעה** עד שהוא פעיל במלואו. זה אוטומטי — שום דבר לא תקוע ושום דבר לא ממתין לכם. **אין צורך לפתוח פניית תמיכה במהלך השעה הזו.** אם התיבה עדיין אינה פעילה לאחר שעה, פנו לתמיכה. ::: בזמן שהדברים מתייצבים, סטטוס התיבה ב‑Teloring מתקדם מעצמו: | סטטוס | משמעות | | --- | --- | | **ממתין להפעלה** | הקישור לא הושלם. חזרו ל[שלב 1](#step-1--open-the-link-and-start). | | **ממתין לאישור** | ההפעלה הושלמה; ‏Meta עדיין מאשרת את המספר. | | **קבלה בלבד** | הודעות נכנסות מגיעות; השליחה עדיין אינה מופעלת. | | **פעיל** | חי לגמרי — שולח ומקבל. | אינכם צריכים לרענן או להריץ שוב דבר. כשהסטטוס מגיע ל**פעיל**, הלשוניות **פרופיל** ו**תבניות** נפתחות בעמוד עריכת התיבה והנציגים יכולים לשלוח הודעות ללקוחות. ראו [WhatsApp](../whatsapp.md) למה להגדיר בהמשך, ו[שיחות](../../../getting-started/conversations.md) לטיפול היומיומי. :::note ההודעה היוצאת הראשונה שלכם עדיין דורשת תבנית גם בתיבה פעילה, אפשר לשלוח הודעות בטקסט חופשי רק בתוך חלון 24 השעות שנפתח כשלקוח שולח לכם הודעה. כדי לפתוח שיחה בעצמכם, אתם זקוקים ל**תבנית** מאושרת — ראו [לשונית התבניות](../whatsapp.md#templates-tab). ::: ## פתרון תקלות | תסמין | מה לעשות | | --- | --- | | **לחיצה על "לחצו כדי להתחיל" לא עושה כלום** | חוסם חלונות קופצים עוצר את חלון Meta. אפשרו חלונות קופצים לעמוד ההפעלה ולחצו שוב. | | **מוצג חשבון פייסבוק שגוי** | לחצו **התחברות לחשבון אחר** במסך "המשך בתור" לפני שתמשיכו. | | **"חשבונות חדשים לא יאושרו ל‑Business Manager"** | חשבון הפייסבוק חדש מדי. השתמשו בחשבון פייסבוק אישי ותיק של מישהו מהעסק. | | **סגרתם את החלון באמצע התהליך** | פתחו מחדש את אותו קישור הפעלה מכל אחד מ[שלושת המקומות](#where-to-find-your-onboarding-link) והתחילו שוב. התקדמות חלקית אינה נשמרת, והתחלה מחדש בטוחה. | | **עמוד Teloring לא מציג את תיבת ההצלחה** | ודאו שלחצתם **סיום** במסך האחרון של Meta. אם כן, פתחו מחדש את הקישור — חיבור שהושלם מזוהה מיד. | | **עדיין "ממתין להפעלה" אחרי הסיום** | תנו לזה עד שעה, ואז פתחו מחדש את התיבה. אם דבר לא השתנה, פנו לתמיכה עם שם התיבה והמספר. | | **אתם לא מוצאים את הקישור** | הוא נמצא בכל שלושת המקומות שפורטו [למעלה](#where-to-find-your-onboarding-link). אם אף אחד מהם אינו מציג אותו, ייתכן שהתיבה כבר הופעלה — בדקו את תג הסטטוס שלה. | ## קשור - [WhatsApp](../whatsapp.md) — יצירת התיבה, פרופיל עסקי, תבניות ומגבלות הערוץ - [טבעת הערוצים — תיבות](../overview.md) — איך תיבות פועלות בכל הערוצים - [תפקידים והרשאות](../../roles/overview.md) — מי רשאי ליצור ולהגדיר תיבה --- # WhatsApp מקור: https://docs.teloring.com/he/docs/product/ring/whatsapp Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/whatsapp.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z תיבת **WhatsApp** מחברת מספר WhatsApp Business ל‑Teloring. כל הודעה שלקוח שולח למספר הזה הופכת לשיחה בתיבה המשותפת, והנציגים משיבים מאותו מקום שבו הם מטפלים בכל ערוץ אחר. ‏WhatsApp תומך גם ביכולות עשירות ייחודיות לערוץ: פרופיל עסקי מנוהל, **תבניות** הודעה מאושרות מראש לפנייה ללקוחות מחוץ לחלון 24 השעות, מדיה ואישורי מסירה וקריאה. :::info WhatsApp Business פועל על הפלטפורמה הרשמית של Meta. חיבור תיבה כולל אימות מספר טלפון והשלמת תהליך ההפעלה של Meta — ‏Teloring מלווה אתכם בשניהם. אין צורך בהגדרה טכנית או בכתיבת קוד. ::: ## דרישות מקדימות | מה נדרש | למה | | --- | --- | | הרשאת תיבה | הוספה או אימות של מספר דורשים **טבעת הערוצים ← יצירה**; הגדרת התיבה דורשת **טבעת הערוצים ← עדכון**. ראו [תפקידים והרשאות](../roles/overview.md). | | מספר טלפון | מספר שבבעלותכם (שאינו פעיל כבר באפליקציית WhatsApp או WhatsApp Business), חשבון WhatsApp Business App קיים, או מספר שכבר עובד מול ה‑API של WhatsApp Business. | | גישה למספר הזה | כדי לקבל קוד אימות ב‑SMS או בשיחת טלפון (במסלול "הבאת מספר משלכם"). | | שם עסקי ושם תצוגה | שם התצוגה הוא מה שהלקוחות רואים ב‑WhatsApp. | | אישור Meta | לאחר יצירת התיבה, על Meta להשלים את ההפעלה ולאשר את המספר לפני שאפשר לשלוח ממנו. | ## חיבור תיבת WhatsApp פתחו את **טבעת הערוצים**, לחצו על סמל **WhatsApp** ובחרו **הוספה**. ייפתח אשף בן ארבעה שלבים. ### שלב 1 — שם וסוג מספר ![הגדרת WhatsApp — שלב 1](pathname:///img/screenshots/he/product/ring/whatsapp/wizard-step1.png) | שדה | מה להזין | | --- | --- | | **שם הערוץ** | השם הפנימי של התיבה הזו (למשל *תמיכה WhatsApp*). הנציגים רואים אותו בשיחות. | | **סוג המספר** | בחרו אחד משלושת הכרטיסים שלהלן. | | סוג מספר | מתי להשתמש | | --- | --- | | 📱 **הבאת מספר משלכם** | כשאתם רוצים לאמת מספר טלפון שבבעלותכם ולהשתמש בו כקו העסקי שלכם ב‑WhatsApp. | | 💼 **WhatsApp Business App** | כשכבר יש לכם חשבון WhatsApp Business App, שתחברו במהלך ההפעלה מול Meta. | | 🔗 **חיבור מספק קיים** | כשהמספר כבר מחובר ל‑API של WhatsApp ויש לכם את מספר השליחה ומפתח ה‑API שלו. | לחצו **הבא ←**. המסלול *הבאת מספר משלכם* עובר לשלב 2; המסלול *WhatsApp Business App* מדלג ישירות לשלב 3; המסלול *חיבור מספק קיים* עובר למסך יחיד משלו ([להלן](#connect-existing-api-account)). ### שלב 2 — אימות המספר (הבאת מספר משלכם) תראו את המספרים שכבר אימתתם. בחרו אחד, או לחצו **+ הוספת מספר חדש** כדי לאמת מספר חדש. ![הגדרת WhatsApp — אימות מספר](pathname:///img/screenshots/he/product/ring/whatsapp/wizard-verify.png) תת‑התהליך של האימות מבקש: | שדה | פירוט | | --- | --- | | **מספר טלפון** | הזינו עם קידומת המדינה, ללא רווחים או מקפים (למשל `972501234567`). | | **שיטת אימות** | 📩 **SMS** או 📞 **שיחת טלפון**. | | **שפת הקוד** | שפת הודעת הקוד — אנגלית, עברית, ערבית, רוסית, ספרדית, סינית, הינדי, תאית או צרפתית. | לחצו **שליחת קוד**, הקלידו את **הקוד בן 6 הספרות** שקיבלתם בתיבות ולחצו **אימות**. אם הקוד לא הגיע, השתמשו ב**שליחה חוזרת ב‑SMS** או ב**שליחה חוזרת בשיחה**. :::note Meta מאפשרת עד **2 ניסיונות אימות למספר**. ודאו שאתם מסוגלים לקבל את הקוד לפני השליחה. ::: ### שלב 3 — פרטי העסק | שדה | מה להזין | | --- | --- | | **שם העסק** | השם המשפטי או העסקי של החברה שלכם. | | **שם תצוגה** | השם שהלקוחות רואים ב‑WhatsApp (למשל *תמיכה — החברה שלי*). | לחצו **יצירת תיבת WhatsApp**. ### שלב 4 — השלמת ההפעלה מול Meta התיבה נוצרה אך עדיין אינה חיה. לחצו **פתיחת ההפעלה מול Meta ↗** כדי לסיים את ההגדרה מול Meta (או העתיקו את הקישור ופתחו אותו מאוחר יותר). כאשר Meta מאשרת את המספר, התיבה הופכת ל**פעילה** ויכולה לשלוח ולקבל. ![הגדרת WhatsApp — התיבה נוצרה](pathname:///img/screenshots/he/product/ring/whatsapp/wizard-done.png) :::tip זהו השלב שבו אנשים נתקעים ההפעלה מתבצעת בצד של Meta, בחלון קופץ, לאורך שישה מסכים. המדריך **[השלמת הפעלת WhatsApp מול Meta](whatsapp/onboarding.md)** עובר על כל אחד מהם עם צילומי מסך, ומסביר מה קורה בשעה שאחרי הסיום. ::: ### חיבור חשבון שכבר עובד מול ה‑API של WhatsApp {#connect-existing-api-account} אם המספר כבר פעיל מול ה‑API של WhatsApp Business — הוא הוגדר לפני שעברתם ל‑Teloring, או שהוא עובד היום דרך מערכת אחרת — אין מה לאמת ואין תהליך הפעלה של Meta להשלים. בחרו **🔗 חיבור מספק קיים** בשלב 1 והזינו את שני הפרטים שקיבלתם מספק הוואטסאפ שלכם: | שדה | מה להזין | | --- | --- | | **מספר השליחה ("From")** | המספר שממנו נשלחות ההודעות, עם קידומת המדינה וללא רווחים או מקפים (למשל `972501234567`). | | **מפתח API** | מפתח ה‑API שהונפק למספר הזה. הוא נשמר בשרתים שלנו, לא מוצג שוב ולא נשלח לדפדפן שלכם. | לחצו **חיבור התיבה**. ‏Teloring בודקת את הצמד מול הספק, מכוונת את ה‑Webhook של ההודעות הנכנסות לחשבון שלכם, והתיבה הופכת מיד ל**פעילה** — הודעות, תבניות והפרופיל העסקי עובדים מאותו רגע. :::caution ההודעות הנכנסות של המספר עוברות ל‑Teloring רישום ה‑Webhook מחליף את הכתובת שאליה הספק שלח עד כה. אם מערכת אחרת עדיין מטפלת במספר הזה, היא מפסיקה לקבל הודעות מרגע החיבור. חברו את התיבה כשאתם מוכנים לעבור. ::: אם הפרטים נדחו, בדקו שאין שגיאת הקלדה במספר (ספרות בלבד, עם קידומת מדינה) וודאו שמפתח ה‑API שייך בדיוק לאותו מספר שליחה. מספר שכבר מחובר לתיבה אחרת יידחה — לכל מספר יכול להיות Webhook פעיל אחד בלבד. ## סטטוס התיבה תיבת WhatsApp עוברת בין המצבים האלה, שמוצגים כתג בחלון הערוץ: | סטטוס | משמעות | | --- | --- | | **ממתין להפעלה** | נוצרה ב‑Teloring; ההפעלה מול Meta טרם הושלמה. לא שולחת ולא מקבלת. | | **ממתין לאישור** | ההפעלה הושלמה; ממתינים לאישור המספר מצד Meta. | | **קבלה בלבד** | יכולה לקבל הודעות אך עדיין לא לשלוח. | | **פעיל** | חי לגמרי — שולח ומקבל. | | **שגיאה** | משהו השתבש. פנו לתמיכה. | | **נמחק** | חשבון ה‑WhatsApp של המספר הזה הוסר. | כל עוד התיבה ממתינה, עמוד העריכה שלה מציג לשונית **הפעלה** עם הכפתור **פתיחת ההפעלה מול Meta ↗**, כדי שתוכלו לסיים את ההגדרה בכל עת. ראו [השלמת הפעלת WhatsApp מול Meta](whatsapp/onboarding.md) למדריך המלא. לאחר סיום ההפעלה, המתינו **עד שעה** עד שהמספר יהיה פעיל במלואו. ההמתנה הזו אוטומטית — אין צורך בפניית תמיכה, אלא אם התיבה עדיין אינה פעילה לאחר שעה. ## עמוד העריכה של WhatsApp פתחו את התיבה מטבעת הערוצים (סמל העיפרון) כדי להגיע לעמוד העריכה שלה. יש בו ארבע לשוניות. הלשוניות **פרופיל** ו**תבניות** נפתחות ברגע שהתיבה פעילה (או בקבלה בלבד); לפני כן תגיעו ללשונית **הפעלה**. ### לשונית פרופיל ניהול הפרופיל העסקי שהלקוחות רואים ב‑WhatsApp. ![עריכת WhatsApp — לשונית פרופיל](pathname:///img/screenshots/he/product/ring/whatsapp/edit-profile.png) | שדה | הערות | | --- | --- | | **תמונת פרופיל** | העלו JPEG או PNG, עד 5 MB. השתמשו בתמונה מרובעת. | | **אודות** | שורה קצרה הגלויה לאנשי הקשר שלכם (עד 139 תווים). אינה יכולה להישאר ריקה. | | **כתובת** | עד 256 תווים. | | **אימייל** | כתובת אימייל ליצירת קשר עם העסק. | | **אתר אינטרנט** | חייב להתחיל ב‑`http://` או ב‑`https://`. | | **סוג העסק** | אחת מהקטגוריות של Meta (רכב, יופי, חינוך, פיננסים, רפואה, קמעונאות, מסעדנות וכן הלאה). | | **תיאור** | תיאור ארוך יותר, עד 256 תווים. | | **שם תצוגה** | לקריאה בלבד. ניתן לשינוי רק ב‑Meta Business Manager. | | **מגבלה יומית** | לקריאה בלבד. מגבלת ההתכתבות של Meta עבור המספר. | סרגל נתונים מציג את מספר השיחות החודש, את המגבלה היומית ואת סטטוס ה**אימות** של המספר (מאומת, לא מאומת, בבדיקה וכן הלאה). ### לשונית תבניות {#templates-tab} **תבניות הודעה** של WhatsApp הן פורמטים כתובים מראש ש‑Meta בודקת ומאשרת. אתם זקוקים לתבנית כדי לשלוח הודעה ללקוח **מחוץ** לחלון 24 השעות (ראו [יכולות ומגבלות](#capabilities-and-limits)). ![עריכת WhatsApp — תבניות](pathname:///img/screenshots/he/product/ring/whatsapp/edit-templates.png) הרשימה מציגה כל תבנית עם תג סטטוס (**מאושרת / ממתינה / נדחתה**), קטגוריה (שירותית / שיווקית / אימות), שפה והתוכן שלה. אפשר לחפש, לסנן לפי סטטוס, **לשכפל** תבנית או **למחוק** אותה. :::warning לא ניתן לערוך תבנית לאחר שהוגשה, ולא ניתן לעשות שימוש חוזר בשם של תבנית שנמחקה למשך **30 יום**. ::: **יצירת תבנית** מתבצעת באשף בן שלושה שלבים (הגדרה ← תוכן ← סקירה), שמציג תצוגה מקדימה חיה של WhatsApp תוך כדי הבנייה: | שלב | מה מגדירים | | --- | --- | | **הגדרה** | שפה; סוג התבנית (**רגילה**, **אימות** או **חתימת מסמך**); ושם התבנית (אותיות אנגליות קטנות, ספרות וקווים תחתונים; לפחות 5 תווים; ייחודי). | | **תוכן** | עבור תבנית רגילה: סוג הכותרת (טקסט, או טקסט עם תמונה / וידאו / מסמך), ה**גוף** (עד 1024 תווים, עם המשתנים `{{1}}`–`{{10}}`), **כותרת תחתונה** אופציונלית (עד 60 תווים, ללא אימוג'י), ועד 10 **כפתורים** (תגובות מהירות, קישור לאתר, כפתור חיוג או קוד קופון). | | **סקירה** | תקציר, ואז **הגשה לבדיקה**. ‏Meta בודקת את התבנית לפני שניתן להשתמש בה. | :::note תבניות **נוצרות** כאן אך **נשלחות** מתוך שיחה. שליחת תבנית צורכת קרדיטים מהחשבון לפי הקטגוריה שלה; החיוב מוחזר אוטומטית אם השליחה נכשלת. ::: ### לשונית הגדרות התיבה | שדה | הערות | | --- | --- | | **שם הערוץ** | ניתן לעריכה — שינוי שם התיבה. | | **סוג הערוץ** | לקריאה בלבד (WhatsApp). | | **מספר טלפון** | לקריאה בלבד — המספר המחובר. | | **סטטוס** | לקריאה בלבד — תווית הסטטוס הנוכחית. | בתיבה פעילה מופיע גם הכפתור **🔄 רישום מחדש של ה‑Webhook**. הוא מבקש מספק הוואטסאפ שלכם לשלוח את ההודעות הנכנסות ל‑Teloring מחדש — השתמשו בו אם התיבה הפסיקה לפתע לקבל הודעות בגלל שמערכת אחרת כיוונה את המספר למקום אחר. אפשר ללחוץ עליו בכל עת, והוא לא משנה שום דבר אחר בתיבה. #### מחיקת תיבת WhatsApp **אזור הסכנה** בתחתית הלשונית הזו מוחק את התיבה. הפעולה דורשת **טבעת הערוצים ← מחיקה** ומבקשת אישור פעמיים: חלון אזהרה, ואחריו הקלדה מדויקת של שם התיבה. :::danger הפעולה מוחקת גם את חשבון הוואטסאפ של המספר מחיקת התיבה מורה לספק למחוק את חשבון הוואטסאפ שמאחורי המספר — זו הדרך היחידה לשחרר מספר לאחר שהוא עבר הפעלה מול ה‑API של WhatsApp. המספר יפסיק לשלוח ולקבל, ושימוש חוזר בו מחייב תהליך הפעלה מהתחלה. שיחות קיימות נשארות ב‑Teloring; רק התיבה וחשבון הוואטסאפ נמחקים. ::: ### לשונית הפעלה מציגה אם ההפעלה מול Meta הושלמה. בזמן ההמתנה היא מציעה את הכפתור **פתיחת ההפעלה מול Meta ↗** וקישור **קראו את התיעוד** למדריך המלא; לאחר הסיום היא מאשרת שהתיבה פעילה ומוכנה. ראו [השלמת הפעלת WhatsApp מול Meta](whatsapp/onboarding.md). ## יכולות ומגבלות {#capabilities-and-limits} | יכולת | פירוט | | --- | --- | | שליחת טקסט | טקסט חופשי עם עיצוב WhatsApp (`*מודגש*`, `_נטוי_`, `~קו חוצה~`) ומעברי שורה. | | שליחת מדיה | תמונות, וידאו, אודיו ומסמכים, עם כיתוב אופציונלי. | | קבלה | טקסט, תמונות, אודיו, וידאו, הודעות קוליות, מסמכים, מיקום (מוצג כקישור למפה), אנשי קשר, ריאקציות וסטיקרים. מדיה נכנסת נשמרת ב‑Teloring (עד 25 MB). | | אישורי מסירה וקריאה | הודעות יוצאות מציגות סטטוס נשלח, נמסר ונקרא. | | מענה להודעה | גם טקסט וגם מדיה יכולים לצטט הודעה קודמת ספציפית. | ### חלון 24 השעות (הודעות סשן מול הודעות תבנית) WhatsApp מתיר תשובות בטקסט חופשי רק בתוך **חלון שירות לקוחות בן 24 שעות**, שנפתח מחדש בכל פעם שהלקוח שולח לכם הודעה. | סוג הודעה | מתי זה עובד | | --- | --- | | **הודעת סשן** (טקסט חופשי או מדיה) | רק בתוך 24 שעות מההודעה האחרונה של הלקוח. | | **הודעת תבנית** | בכל זמן — כך פונים ללקוח אחרי שחלון 24 השעות נסגר, או פותחים שיחה חדשה. התבניות חייבות להיות מאושרות מראש על ידי Meta. | Teloring מציגה בשיחה את הזמן שנותר בסשן, כך שהנציגים יודעים מתי נדרשת תבנית. ### מגבלות נוספות - את **שם התצוגה** ניתן לשנות רק ב‑Meta Business Manager, לא ב‑Teloring. - שמות התבניות חייבים להיות ייחודיים, לא ניתנים לעריכה לאחר ההגשה, ושם שנמחק שמור למשך 30 יום. - עריכת פרופיל וניהול תבניות דורשים שהתיבה תהיה **פעילה** או ב**קבלה בלבד**. - תמונות פרופיל חייבות להיות JPEG או PNG, מרובעות, עד 5 MB. ## איך הודעות WhatsApp הופכות לשיחות כשלקוח שולח הודעה למספר שלכם: 1. Teloring מאתרת את איש הקשר לפי מספר הטלפון, או יוצרת איש קשר חדש (ורשומת לקוח) אם זו הפעם הראשונה. 2. היא ממשיכה את השיחה הפתוחה הקיימת של הלקוח בתיבה הזו, או פותחת שיחה חדשה. 3. ההודעה — וכל מדיה שצורפה — נשמרת, והשיחה מתעדכנת עם תצוגה מקדימה ומונה הודעות שלא נקראו. 4. עדכוני זמן אמת, אוטומציות [סטודיו](../studio.md) ו‑AI Copilot מופעלים כולם, כך שהשיחה מוכנה לנציג באופן מיידי. מכאן, הנציגים משיבים, משייכים, מתייגים, קובעים עדיפות, מסמנים כטופל ומקשרים את השיחה ל[לקוח ב‑CRM](../crm.md) — ראו [שיחות](../../getting-started/conversations.md). --- # אימייל מקור: https://docs.teloring.com/he/docs/product/ring/email Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/email.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z תיבת **אימייל** הופכת כתובת דואר אלקטרוני ל**תיבה משותפת לצוות**. דואר נכנס משורשר לשיחות, כך שהנציגים משיבים מתוך Teloring במקום מתוכנת דואר אישית, והתשובות יוצאות מאותה כתובת ונשארות מחוברות לאותה שיחה. HTML עשיר, קבצים מצורפים, CC/BCC, מענה / מענה לכולם / העברה וחתימות — כולם פועלים כפי שהייתם מצפים מתוכנת דואר מלאה. אפשר לחבר אימייל בארבע דרכים. כולן חולקות את אותה תצוגת שיחה, אותה תיבת חיבור ואותו שרשור — רק *האופן שבו דואר נשלח ומתקבל* שונה. ## בחירת סוג חיבור פתחו את **טבעת הערוצים**, לחצו על סמל **אימייל**, בחרו **הוספה** ובחרו סוג חיבור. ![אימייל — בחירת סוג חיבור](pathname:///img/screenshots/he/product/ring/email/connection-picker.png) | סוג | מה זה | מאמץ ההגדרה | מתאים ביותר ל | | --- | --- | --- | --- | | **Teloring Email** ⭐ *מומלץ* | תיבת דואר בניהול מלא של Teloring — ללא צורך בשרת דואר. | הנמוך ביותר | צוותים שרוצים את ההתחלה המהירה ביותר, או כתובת ממותגת בדומיין שלהם. | | **Microsoft Outlook** | חיבור תיבת Outlook או Microsoft 365 באמצעות התחברות ל‑Microsoft. | נמוך (התחברות אחת) | משתמשי Microsoft 365 / Outlook. | | **Gmail** | חיבור תיבת Gmail או Google Workspace באמצעות סיסמת אפליקציה. | בינוני | משתמשי Gmail / Google Workspace. | | **IMAP / SMTP** | חיבור כל ספק באמצעות פרטי שרת דואר סטנדרטיים. | הגבוה ביותר (ידני) | כל ספק אחר (Yahoo, תיבה של חברת אחסון, שרת מותאם). | ### שיחות מול שליחה בלבד לכל תיבת אימייל יש **ייעוד**, שנבחר מיד אחרי סוג החיבור: | ייעוד | התנהגות | | --- | --- | | **שיחות** | מקבלת ומשיבה לדואר של לקוחות בתור שיחות. זו ברירת המחדל. | | **שליחה בלבד** | משמשת לדואר אוטומטי, לקמפיינים ולתהליכי [סטודיו](../studio.md). **לא נוצרות שיחות** — דואר נכנס מתעלמים ממנו. | :::note לאחר שלתיבה בייעוד "שיחות" יש שיחות אמיתיות, הייעוד שלה ננעל ולא ניתן להחליף אותו ל"שליחה בלבד". ::: ## תהליך החיבור לפי סוג ### Teloring Email (מנוהל) לאפשרות המומלצת שלושה מצבים: | מצב | מה מקבלים | נדרש DNS? | | --- | --- | --- | | **הגדרה אפס** | כתובת כמו `support@yourname.teloring.com`. עובדת מיד. | לא | | **העברת דואר** | שמירה על הספק הנוכחי שלכם והעברת דואר נכנס לכתובת Teloring פרטית. | לא | | **דומיין משלכם** | שליחה וקבלה בתת‑דומיין שלכם (למשל `support.yourcompany.com`) עם המיתוג שלכם. | כן | - **הגדרה אפס** — בחרו קידומת (כמו `support`) ותת‑דומיין (`yourname`), ו‑Teloring בודקת זמינות בזמן אמת (✅ זמין / ❌ לא זמין). הוסיפו שם תצוגה וצרו את התיבה. היא פעילה מיד. - **העברת דואר** — לאחר יצירת התיבה, Teloring מייצרת כתובת העברה פרטית. הוסיפו כלל העברה אצל הספק הנוכחי שלכם ששולח אליה דואר. (שדה "הכתובת המקורית" האופציונלי הוא רק הערה עבור הנציגים שלכם.) - **דומיין משלכם (BYOD)** — הזינו **תת‑דומיין** (דומיינים ראשיים אינם מותרים) ושם תצוגה. ‏Teloring מציגה שתי רשומות DNS להוספה — רשומת **DKIM** (מאשרת ל‑Teloring לשלוח דואר חתום עבור הדומיין שלכם) ורשומת **Return-Path** (למעקב אחר החזרות) — לצד כתובת פרטית להעברת דואר נכנס. הוסיפו את הרשומות ולחצו **אימות DNS עכשיו**. התיבה הופכת לפעילה ברגע שהאימות עובר. ![Teloring Email — בחירת מצב](pathname:///img/screenshots/he/product/ring/email/teloring-modes.png) ### Microsoft Outlook (התחברות) 1. תנו שם לתיבה ולחצו **המשך עם Microsoft**. 2. נפתח חלון התחברות של Microsoft. התחברו וסקרו את ההרשאות ש‑Teloring מבקשת (קריאה ושליחה של דואר בשמכם). 3. אשרו. החלון נסגר והתיבה נוצרת — ללא צורך בהגדרות שרת. ![חלון האישור של Microsoft](pathname:///img/screenshots/he/product/ring/email/microsoft-consent.png) אם החיבור פג בשלב כלשהו, עמוד העריכה של התיבה מציג כפתור **הרשאה מחדש** להתחברות נוספת. ### Gmail (סיסמת אפליקציה) Gmail מתחבר באמצעות **סיסמת אפליקציה** של Google (לא סיסמת ה‑Gmail הרגילה שלכם). :::warning Google דורשת ש**אימות דו‑שלבי** יהיה **מופעל** לפני שאפשר ליצור סיסמת אפליקציה. מסך ההגדרה מקשר אתכם ישירות לעמודי האימות הדו‑שלבי וסיסמאות האפליקציה של Google. ::: 1. הפעילו אימות דו‑שלבי בחשבון Google שלכם. 2. צרו סיסמת אפליקציה בשם *Teloring* בעמוד סיסמאות האפליקציה של Google (קוד בן 16 תווים). 3. ב‑Teloring, הזינו את שם התיבה, את כתובת ה‑Gmail שלכם, שם תצוגה, והדביקו את סיסמת האפליקציה. 4. לחצו **בדיקת חיבור**, ואז **שמירה וחיבור** לאחר שהבדיקה עוברת. ![Gmail — הגדרת סיסמת אפליקציה](pathname:///img/screenshots/he/product/ring/email/gmail-setup.png) ### IMAP / SMTP (כל ספק) הזינו את פרטי שרת הדואר של הספק שלכם: | קבוצה | שדות | | --- | --- | | **כללי** | שם התיבה, כתובת האימייל (כתובת ה‑From), שם תצוגה. | | **IMAP (נכנס)** | שרת, פורט (בדרך כלל `993`), אבטחה (SSL/TLS, ‏STARTTLS או ללא), שם משתמש, סיסמה. | | **SMTP (יוצא)** | שרת, פורט (בדרך כלל `587`), אבטחה, שם משתמש, סיסמה. תיבת סימון **שימוש באותם פרטי גישה כמו IMAP** חוסכת הקלדה חוזרת. | ![טופס IMAP / SMTP](pathname:///img/screenshots/he/product/ring/email/imap-form.png) לחצו **בדיקת חיבור** — ‏IMAP ו‑SMTP נבדקים בנפרד וכל אחד מציג תוצאה של ✅ או ❌. הכפתור **שמירה וחיבור** נפתח לאחר שהבדיקה עוברת. :::note תיבות IMAP ו‑Gmail **אינן** מייבאות דואר ישן. רק הודעות שמגיעות **אחרי** החיבור זורמות אל Teloring. ::: בסיום ההגדרה, המסך **תיבת האימייל מוכנה!** מאשר את הכתובת (ובמצב BYOD, מציג את רשומות ה‑DNS ואת כתובת ההעברה). ## עמוד העריכה של האימייל עמוד העריכה שומר על מעט הגדרות: | שדה | ניתן לעריכה? | | --- | --- | | **שם הערוץ** | ✅ | | **שם תצוגה** | ✅ | | **סוג החיבור** | לקריאה בלבד (Teloring Email,‏ Microsoft,‏ Gmail או IMAP/SMTP). | | **כתובת אימייל** | לקריאה בלבד. | | **סטטוס** | לקריאה בלבד — ✅ פעיל, ⏳ ממתין לאימות, או ❌ מצב שגיאה. | כאן מופיעים גם פאנלים ייחודיים לסוג: - **העברה של Teloring** — כתובת ההעברה להעתקה. - **BYOD של Teloring** — רשומות ה‑DNS‏ (DKIM ו‑Return-Path) וכפתור **אימות DNS עכשיו**. - **Microsoft** — כפתור **הרשאה מחדש** לצד פרטי מנוי, סנכרון וטוקן. **חתימה** ו**כתובת למענה** מוגדרות לכל תיבה בנפרד ומשולבות אוטומטית בתשובות. ## יכולות ומגבלות | יכולת | פירוט | | --- | --- | | HTML עשיר | עיצוב מלא — גופנים, צבעים, רשימות, טבלאות, קישורים ותמונות מוטמעות — בעורך עשיר. | | קבצים מצורפים | נשלחים ומתקבלים, עד **25 MB** לקובץ ו‑25 MB בסך הכול להודעה. | | CC / BCC | נתמכים במלואם בתיבת החיבור. | | מענה / מענה לכולם / העברה | לכל הודעה, עם הנמענים הנכונים ותוכן מצוטט. | | שליחה מהכתובת שלכם | התשובות יוצאות מכתובת התיבה (או, במצב העברה, מהכתובת המקורית המאומתת). | | שרשור | תשובות מתחברות לשיחה הנכונה באמצעות כותרות דואר סטנדרטיות. | | חתימה | מוגדרת לכל תיבה ומתווספת אוטומטית. | | DNS / SPF / DKIM | רק **דומיין משלכם** דורש DNS (רשומת DKIM ורשומת Return-Path). הגדרה אפס, העברה, Gmail,‏ Microsoft ו‑IMAP אינם דורשים כלום. | | מסירה בזמן אמת | ‏Microsoft ו‑Teloring Email דוחפים דואר חדש מיד; ‏Gmail ו‑IMAP בודקים דואר חדש בערך פעם בדקה. | | שרשורים שטופלו | שיחה שטופלה לעולם אינה נפתחת מחדש — אימייל חדש פותח שיחה חדשה. | ## איך דואר נכנס הופך לשיחות 1. הדואר מגיע (נדחף עבור Microsoft/Teloring, נשלף עבור Gmail/IMAP) ו‑Teloring מנתבת אותו לתיבה הנכונה. 2. ‏Teloring משרשרת אותו: תשובה מתחברת לשיחה הקיימת שלה באמצעות כותרות הדואר; כל דבר חדש פותח שיחה חדשה. 3. השולח הופך (או מותאם) לאיש קשר, ההודעה נשמרת עם הקבצים המצורפים והתמונות המוטמעות, והשיחה מסומנת כלא נקראה. 4. עדכוני זמן אמת, טריגרים של [סטודיו](../studio.md) ו‑AI Copilot מופעלים על התוכן החדש (היסטוריה מצוטטת אינה נלקחת בחשבון). לאחר מכן הנציגים משיבים, משייכים, מתייגים ומקשרים את השיחה ל[לקוח ב‑CRM](../crm.md) — ראו [שיחות](../../getting-started/conversations.md). --- # SMS מקור: https://docs.teloring.com/he/docs/product/ring/sms Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/sms.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z תיבת **SMS** מטפלת בשיחות דו‑כיווניות בהודעות טקסט. ‏Teloring היא **אגנוסטית לספק** — היא אינה כובלת אתכם לספק SMS אחד. במקום זאת, אתם מחברים את הספק או שער ה‑SMS שלכם: הודעות נכנסות מגיעות לכתובת Webhook של Teloring שאתם מדביקים בלוח הבקרה של הספק, והודעות יוצאות נשלחות באמצעות בקשת HTTP שאתם מגדירים כך שתתאים ל‑API השליחה של הספק. כך SMS עובד כמעט עם כל ספק או שער פרטי שמדבר HTTP. :::info SMS הוא **טקסט בלבד** — ללא תמונות, קבצים או MMS. ההגדרה דורשת מעט יותר עבודה משאר הערוצים, כי אתם מחברים ספק משלכם, אבל האשף לוכד הודעה נכנסת אמיתית ועוזר לכם למפות את השדות שלה אוטומטית. ::: ## דרישות מקדימות | מה נדרש | למה | | --- | --- | | הרשאת תיבה | הוספת תיבת SMS דורשת **טבעת הערוצים ← יצירה**; הגדרתה דורשת **טבעת הערוצים ← עדכון**. ראו [תפקידים והרשאות](../roles/overview.md). | | ספק SMS או שער | עליו לתמוך בהעברת הודעות נכנסות לכתובת Webhook, ו/או בקבלת קריאת HTTP לשליחת הודעות. | | פרטי ה‑API של השליחה אצל הספק | כתובת נקודת הקצה, שיטת HTTP, אימות ומבנה גוף הבקשה. | | מספר טלפון או מזהה שולח | לצורכי מידע — נשמר על התיבה ומשמש כערך ה"מאת" בהודעות יוצאות. | ## חיבור תיבת SMS פתחו את **טבעת הערוצים**, לחצו על **SMS** ובחרו **הוספה**. לאשף ארבעה שלבים: **בסיס ← נכנס ← יוצא ← סיום**. ### שלב 1 — בסיס ![הגדרת SMS — בסיס](pathname:///img/screenshots/he/product/ring/sms/setup-basics.png) | שדה | מה להזין | | --- | --- | | **שם התיבה** | שם כמו *SMS ראשי* או *SMS תמיכה*. | | **מספר טלפון / מזהה שולח** | אופציונלי. המספר או מזהה השולח של התיבה הזו (משמש כערך ה"מאת"). | | **כיוון התקשורת** | **דו‑כיווני** (שליחה וקבלה), **נכנס בלבד** (קבלה) או **יוצא בלבד** (שליחה). | לחצו **יצירת התיבה והמשך**. תיבות בכיוון יוצא בלבד מדלגות לשלב 3. ### שלב 2 — נכנס (קבלה) Teloring מספקת לכם **כתובת Webhook** ייחודית. העתיקו אותה והדביקו אותה בהגדרות ה‑Webhook או ה‑Callback של ספק ה‑SMS שלכם. ![הגדרת SMS — מיפוי נכנס](pathname:///img/screenshots/he/product/ring/sms/setup-inbound.png) לאחר מכן שלחו SMS בדיקה למספר שלכם. כאשר הספק מעביר אותה, היא מופיעה תחת **דגימות שנלכדו** (העמוד בודק זאת אוטומטית). ברגע שדגימה מגיעה, מפו את השדות שלה לשדות של Teloring: | שדה | נדרש? | | --- | --- | | **טלפון השולח** | כן | | **טקסט ההודעה** | כן | | **נמען** | אופציונלי | | **מזהה הודעה** | אופציונלי (מאפשר זיהוי כפילויות) | | **חותמת זמן** | אופציונלי | לחצו **זיהוי אוטומטי של שדות** כדי ש‑Teloring תנחש את המיפוי מהדגימה, ואז תקנו לפי הצורך. **שמירת המיפוי והמשך** מפעילה את הכיוון הנכנס לאחר שהשולח וההודעה ממופים. ### שלב 3 — יוצא (שליחה) הגדירו את בקשת ה‑HTTP ש‑Teloring משתמשת בה כדי לשלוח הודעות דרך ה‑API של הספק שלכם: | מדור | הגדרות | | --- | --- | | **נקודת קצה של ה‑API** | **כתובת** השליחה, **שיטת HTTP** (POST / PUT / GET) ו**סוג התוכן** (JSON / Form / XML / טקסט רגיל). | | **אימות** | **ללא**, **Basic Auth**, **Bearer Token**, **כותרת מותאמת** או **פרמטר בשאילתה**. | | **פרטי גישה** | שמרו כאן סודות (מפתחות API, טוקנים) והפנו אליהם באמצעות `{{credentials.name}}` בכתובת, בכותרות או בגוף. | | **תבנית גוף הבקשה** | הגוף שהספק שלכם מצפה לו, באמצעות מצייני המקום `{{to}}`, `{{from}}`, `{{message}}` ו‑`{{credentials.*}}`. | | **טיפול בתגובה** | טווח סטטוסי ההצלחה (ברירת מחדל 200–299) ונתיב אופציונלי לקריאת מזהה ההודעה של הספק מתוך התגובה. | השתמשו ב**בדיקת שליחה** כדי לשלוח הודעה אמיתית למספר שתבחרו ולוודא שזה עובד — פאנל התוצאה מציג הצלחה או כישלון, את מזהה ההודעה שחולץ ואת התגובה הגולמית. לאחר מכן לחצו **שמירה וסיום**. ![הגדרת SMS — יוצא](pathname:///img/screenshots/he/product/ring/sms/setup-outbound.png) ### שלב 4 — סיום המסך **תיבת SMS מוכנה!** מאשר שהתיבה נוצרה והוגדרה. ## עמוד העריכה של SMS תיבת ה‑SMS מציגה פאנל מידע עם: - **שם הערוץ** (ניתן לעריכה) וסוג הערוץ. - **כתובת ה‑Webhook** (לקריאה בלבד) להדבקה אצל הספק שלכם. - **כיוון**, **מזהה** (מספר או מזהה שולח), **מצב נכנס**, **מצב יוצא**, והאם **AI Copilot** מופעל. - **אזור מסוכן** למחיקת התיבה. ## יכולות ומגבלות | יכולת | פירוט | | --- | --- | | טקסט דו‑כיווני | שליחה וקבלה של טקסט רגיל (בהתאם לכיוון שבחרתם). | | כל ספק | עובד עם כל ספק שיכול לשלוח ל‑Webhook ו/או לקבל בקשת שליחה ב‑HTTP. | | ללא מדיה | תמונות, קבצים ו‑MMS אינם נתמכים. | | הגנה מפני כפילויות | מיפוי שדה מזהה הודעה מאפשר ל‑Teloring להתעלם ממסירות כפולות. | | קבלה אמינה | ‏Teloring מקבלת את ה‑Webhook של הספק בפורמטים נפוצים (JSON,‏ form,‏ XML או גולמי) ותמיד מאשרת אותו, כדי שהספק לא ינסה שוב. | | AI Copilot | עובד ב‑SMS כמו בכל ערוץ אחר. | ## איך SMS נכנס הופך לשיחות 1. הספק שלכם שולח את ההודעה הנכנסת לכתובת ה‑Webhook של התיבה. 2. ‏Teloring מפעילה את מיפוי השדות שלכם כדי לקרוא את השולח ואת ההודעה. 3. היא מתאימה את השולח לאיש קשר לפי טלפון (או יוצרת אחד), ואז ממשיכה את השיחה הפתוחה שלו בתיבה הזו או פותחת חדשה. 4. ההודעה נשמרת, השיחה מתעדכנת, ומופעלים עדכוני זמן אמת, טריגרים של [סטודיו](../studio.md) ו‑AI Copilot. שיחה שטופלה לעולם אינה נפתחת מחדש — הודעה מאוחרת יותר מאותו אדם פותחת שיחה חדשה. ראו [שיחות](../../getting-started/conversations.md). --- # טלגרם מקור: https://docs.teloring.com/he/docs/product/ring/telegram Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/telegram.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z תיבת **טלגרם** מחברת **בוט** טלגרם ל‑Teloring. הלקוחות שולחים הודעות לבוט שלכם, וההודעות האלה הופכות לשיחות בתיבה המשותפת; הנציגים משיבים דרך הבוט. החיבור מהיר — אתם יוצרים בוט בטלגרם, מדביקים את הטוקן שלו, ו‑Teloring מחברת את כל השאר אוטומטית. ## דרישות מקדימות | מה נדרש | למה | | --- | --- | | הרשאת תיבה | חיבור בוט טלגרם דורש **טבעת הערוצים ← יצירה**. ראו [תפקידים והרשאות](../roles/overview.md). | | בוט טלגרם | צרו אחד בטלגרם באמצעות **‎@BotFather** והעתיקו את טוקן ה‑API שלו. | **איך משיגים טוקן לבוט:** 1. פתחו את טלגרם וחפשו את **‎@BotFather**. 2. שלחו את הפקודה **‎/newbot**. 3. בחרו שם ושם משתמש לבוט שלכם. 4. העתיקו את טוקן ה‑API ש‑BotFather נותן לכם (הוא נראה כך: `123456789:ABCdefGHIjklMNOpqrSTUvwxYZ`). :::note כל בוט טלגרם יכול להיות מחובר לחשבון Teloring אחד בלבד. ::: ## חיבור תיבת טלגרם פתחו את **טבעת הערוצים**, לחצו על **טלגרם** ובחרו **הוספה**. לאשף שלושה שלבים: **טוקן הבוט ← אימות ← חיבור**. ### שלב 1 — הזנת טוקן הבוט ![הגדרת טלגרם — טוקן הבוט](pathname:///img/screenshots/he/product/ring/telegram/setup-token.png) | שדה | מה להזין | | --- | --- | | **שם הערוץ** | שם כמו *בוט תמיכה*. | | **טוקן הבוט** | הטוקן מ‑BotFather. | לחצו **אימות הטוקן**. ‏Teloring בודקת את הטוקן מול טלגרם ומציגה כרטיס תצוגה מקדימה עם שם הבוט, **שם המשתמש שלו** והמזהה. אם השארתם את שם הערוץ ריק, הוא יתמלא בשם הבוט. ![הגדרת טלגרם — בוט מאומת](pathname:///img/screenshots/he/product/ring/telegram/setup-verified.png) ### שלבים 2–3 — חיבור לחצו **חיבור הבוט**. ‏Teloring רושמת את ה‑Webhook של הבוט אוטומטית — **אינכם מדביקים שום כתובת בשום מקום** — מגדירה את הפקודה `/start` ושומרת את החיבור באופן מאובטח. המסך **בוט הטלגרם חובר!** מאשר שהוא חי, עם כפתור **ניהול הבוט** שפותח את עמוד העריכה. ## עמוד העריכה של טלגרם ![עמוד העריכה של טלגרם](pathname:///img/screenshots/he/product/ring/telegram/edit-page.png) | מדור | מה הוא מציג | | --- | --- | | **פרופיל הבוט** | תמונת הבוט, השם ושם המשתמש. | | **מידע** | מזהה הבוט, מזהה הערוץ, סטטוס ומצב ה‑Webhook (פעיל / לא פעיל). | | **הגדרות** | **שם הערוץ** הניתן לעריכה (שמירה מחילה אותו). אפשר גם להחליף כאן את טוקן הבוט, פעולה שמאמתת ורושמת מחדש את ה‑Webhook. | | **ערוצים וקבוצות שהתגלו** | ערוצים וקבוצות בטלגרם שהבוט שלכם חבר בהם. הוסיפו את הבוט כמנהל בערוץ כדי לגלות אותו, ואז לחצו **רענון**. מוצגים כותרת כל ערוץ, מספר החברים והאם הוא מוכן לשידור (מה שדורש קבוצת דיון מקושרת). | | **אזור מסוכן** | **ניתוק הבוט** — מסיר את ה‑Webhook ומנתק את הבוט. השיחות הקיימות נשמרות; לא יגיעו הודעות חדשות. | ## יכולות ומגבלות | יכולת | פירוט | | --- | --- | | התכתבות דו‑כיוונית | קבלה ומענה להודעות ישירות עם הבוט. | | שליחת מדיה | טקסט, תמונות, וידאו, אודיו, הודעות קוליות, מסמכים, אנימציות, סטיקרים, הודעות וידאו, מיקומים ואנשי קשר. | | הודעות ארוכות | טקסט מעל 4,096 תווים מפוצל אוטומטית לכמה הודעות. | | חיווי הקלדה | מוצג ללקוח בזמן שנציג משיב. | | ערוצים וקבוצות | הבוט יכול לשדר לערוץ טלגרם שיש לו קבוצת דיון מקושרת, ותגובות על הפוסטים האלה הופכות לשיחות. | | הודעות ישירות ביוזמת הנציג | נציגים יכולים לפתוח הודעה ישירה למשתמש טלגרם שהבוט יכול להגיע אליו. | ## איך הודעות טלגרם הופכות לשיחות 1. לקוח שולח הודעה לבוט שלכם (או מגיב בקבוצת דיון מקושרת). 2. ‏Teloring מתאימה את האדם לאיש קשר לפי מזהה הטלגרם שלו, או יוצרת אחד. 3. היא ממשיכה את השיחה הפתוחה שלו בתיבה הזו, או פותחת חדשה, ושומרת את ההודעה. 4. מופעלים עדכוני זמן אמת, טריגרים של [סטודיו](../studio.md) ו‑AI Copilot. שיחה שטופלה לעולם אינה נפתחת מחדש — הודעה מאוחרת יותר פותחת שיחה חדשה. ראו [שיחות](../../getting-started/conversations.md). --- # LINE מקור: https://docs.teloring.com/he/docs/product/ring/line Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/line.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z תיבת **LINE** מחברת **חשבון LINE רשמי** ל‑Teloring. הודעות שאנשים שולחים לחשבון הרשמי שלכם הופכות לשיחות בתיבה המשותפת, והנציגים משיבים דרך LINE. אתם מחברים אותה בעזרת שני פרטי גישה מ‑LINE Developers Console, ואז מדביקים כתובת Webhook בחזרה באותה קונסולה. ## דרישות מקדימות | מה נדרש | למה | | --- | --- | | הרשאת תיבה | חיבור חשבון LINE רשמי דורש **טבעת הערוצים ← יצירה**. ראו [תפקידים והרשאות](../roles/overview.md). | | חשבון LINE רשמי עם ערוץ Messaging API | נוצר ב‑LINE Developers Console. | | ה‑Channel Secret ו‑Channel Access Token | משמשים לאימות ולאבטחת החיבור. | **איך משיגים את פרטי הגישה של LINE:** 1. היכנסו ל‑LINE Developers Console‏ (developers.line.biz). 2. צרו Provider (או בחרו אחד קיים). 3. צרו ערוץ **Messaging API**. 4. העתיקו את ה‑**Channel Secret** מ‑**Basic Settings** (קוד בן 32 תווים). 5. הנפיקו **Channel Access Token** מהלשונית **Messaging API**. :::note כל חשבון LINE רשמי יכול להיות מחובר לחשבון Teloring אחד בלבד. ::: ## חיבור תיבת LINE פתחו את **טבעת הערוצים**, לחצו על **LINE** ובחרו **הוספה**. לאשף שלושה שלבים: **פרטי גישה ← Webhook ← סיום**. ### שלב 1 — הזנת פרטי הגישה ![הגדרת LINE — פרטי גישה](pathname:///img/screenshots/he/product/ring/line/setup-credentials.png) | שדה | מה להזין | | --- | --- | | **שם הערוץ** | שם כמו *תמיכה LINE*. | | **Channel Secret** | הסוד בן 32 התווים מ‑Basic Settings. | | **Channel Access Token** | הטוקן ארוך הטווח מהלשונית Messaging API. | לחצו **חיבור**. ‏Teloring מאמתת את פרטי הגישה ומציגה כרטיס תצוגה מקדימה של הבוט (שם התצוגה והתמונה של החשבון הרשמי). ### שלב 2 — הגדרת ה‑Webhook Teloring מציגה **כתובת Webhook**. העתיקו אותה והדביקו אותה ב‑LINE Developers Console: 1. פתחו את הערוץ שלכם ב‑LINE Developers Console. 2. עברו ללשונית **Messaging API**. 3. הדביקו את כתובת ה‑Webhook ולחצו **Verify**. 4. הפעילו את המתג **Use webhook**. ![הגדרת LINE — Webhook](pathname:///img/screenshots/he/product/ring/line/setup-webhook.png) לחצו **סיום ההגדרה**. המסך **ערוץ LINE חובר!** מאשר שהתיבה חיה. ## ניהול התיבה פתחו את התיבה מטבעת הערוצים כדי לשנות את שמה, לעדכן את פרטי הגישה או **לנתק** אותה. ניתוק עוצר הודעות חדשות אך שומר את השיחות הקיימות. ## יכולות ומגבלות | יכולת | פירוט | | --- | --- | | התכתבות דו‑כיוונית | קבלה ומענה להודעות עם החשבון הרשמי שלכם. | | שליחת מדיה | טקסט, תמונות, וידאו, אודיו ומיקום. מסמכים נשלחים כהודעת טקסט עם קישור להורדה (ל‑LINE אין סוג קובץ מובנה). | | הודעות ארוכות | טקסט מעל 5,000 תווים מפוצל לכמה הודעות. | | הודעות ישירות ביוזמת הנציג | נציגים יכולים לשלוח הודעה למשתמש שהוסיף את החשבון הרשמי שלכם. | ### חלון המענה ומכסת ההודעות LINE מבחינה בין הודעות **מענה** (reply) לבין הודעות **דחיפה** (push), וזה משפיע על המכסה החודשית שלכם: - כל הודעה נכנסת מספקת **טוקן מענה** קצר‑מועד (תקף כ‑5 דקות, לשימוש חד‑פעמי). כל עוד הוא תקף, Teloring משיבה בערוץ ה**מענה** החינמי. - לאחר שהטוקן פג (או עבור הודעות ביוזמת נציג), Teloring משתמשת בהודעות **דחיפה**, שנספרות במכסת ההודעות החודשית של החשבון הרשמי שלכם. אם לקוח חסם את החשבון הרשמי שלכם או הסיר אותו, לא ניתן למסור הודעת דחיפה ו‑Teloring מדווחת על כך. ## איך הודעות LINE הופכות לשיחות 1. ‏LINE שולחת את ההודעה הנכנסת לכתובת ה‑Webhook שלכם (Teloring מאמתת את החתימה של כל מסירה). 2. ‏Teloring מתאימה את האדם לאיש קשר לפי מזהה המשתמש שלו ב‑LINE (ומושכת את פרופיל ה‑LINE שלו כשאפשר), או יוצרת אחד. 3. היא ממשיכה את השיחה הפתוחה שלו בתיבה הזו או פותחת חדשה, שומרת את ההודעה ושומרת את טוקן המענה למענה חינמי ומהיר. 4. מופעלים עדכוני זמן אמת, טריגרים של [סטודיו](../studio.md) ו‑AI Copilot. שיחה שטופלה לעולם אינה נפתחת מחדש. ראו [שיחות](../../getting-started/conversations.md). --- # צ׳אט באתר מקור: https://docs.teloring.com/he/docs/product/ring/live-chat Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/live-chat.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z תיבת **צ׳אט באתר** היא וידג'ט צ׳אט שאתם משבצים באתר שלכם. מבקרים לוחצים על בועה צפה כדי לפתוח פאנל צ׳אט ולשלוח הודעה לצוות שלכם; ההודעות האלה מגיעות ל‑Teloring כשיחות, והנציגים משיבים מאותה תיבה שבה הם משתמשים לכל ערוץ אחר. אתם מעצבים איך הווידג'ט נראה ומתנהג, ואז מדביקים שורת קוד אחת באתר — מעבר לכך אין צורך במפתח. ## דרישות מקדימות | מה נדרש | למה | | --- | --- | | הרשאת תיבה | יצירת תיבת צ׳אט באתר דורשת **טבעת הערוצים ← יצירה**; שינוי ההגדרות שלה דורש **טבעת הערוצים ← עדכון**. ראו [תפקידים והרשאות](../roles/overview.md). | | גישה ל‑HTML של האתר שלכם | כדי להדביק את קטע ההטמעה לפני תג הסגירה ``. | ## יצירת תיבת צ׳אט באתר פתחו את **טבעת הערוצים**, לחצו על **צ׳אט באתר** ובחרו **הוספה**. עמוד ההגדרה כולל טופס בצד אחד ו**תצוגה מקדימה חיה של הווידג'ט** בצד השני, שמתעדכנת תוך כדי העריכה. ![הגדרת הצ׳אט באתר עם תצוגה מקדימה חיה](pathname:///img/screenshots/he/product/ring/live-chat/setup.png) | שדה | מה להזין | | --- | --- | | **שם הערוץ** | שם פנימי אופציונלי (ברירת המחדל היא שם האתר). | | **שם האתר** | חובה — מוצג בווידג'ט. | | **דומיין האתר** | אופציונלי — הדומיין של האתר שלכם. | | **צבע הווידג'ט** | הצבע הראשי של הבועה והכותרת (ברירת מחדל: טורקיז). | | **כותרת ברכה / שורת משנה** | הברכה שמוצגת בראש הפאנל. | | **טקסט הכפתור** | התווית על בועת הצ׳אט (ברירת מחדל: *דברו איתנו*). | | **גודל הבועה** | קוטר הבועה בפיקסלים (40–120). | | **טקסט תחתון** | טקסט בתחתית הווידג'ט. | | **הצגת הודעת ברכה** / **הצגת סטטוס נציגים מחוברים** | מתגים לברכה ולחיווי החי של נציגים מחוברים. | | **מיקום הווידג'ט** | המרחק מהקצה ומהתחתית, בפיקסלים. | | **טופס טרום‑שיחה** | איסוף אופציונלי של שם, אימייל וטלפון של המבקר לפני תחילת הצ׳אט (אפשר להציג כל שדה ולסמן אותו כחובה). | לחצו **יצירת תיבת צ׳אט באתר**. ‏Teloring שומרת את התיבה ופותחת את עמוד העריכה שלה, שבו נמצא קוד ההטמעה. ## עמוד העריכה של הצ׳אט באתר בעמוד העריכה שש לשוניות, עם התצוגה המקדימה החיה לצידן. ### הגדרות שם האתר, דומיין האתר ושם הערוץ — לצד שתי העלאות תמונה ייחודיות ללשונית הזו: | העלאה | הערות | | --- | --- | | **תמונת האתר** | מוצגת בכותרת הווידג'ט. תמונה מרובעת, עד 2 MB. | | **תמונת סמל הצ׳אט** | סמל בועה מותאם (מומלץ 64×64, עד 2 MB). | ### מראה כל אפשרויות העיצוב (צבע, גודל בועה, כותרות, טקסט כפתור, טקסט תחתון, מיקום ושני המתגים), לצד שני שדות שקיימים רק בעריכה: | שדה | משמש ל | | --- | --- | | **הודעת סיום טיפול** | מוצגת אחרי ששיחה סומנה כטופלה. | | **טקסט כפתור שיחה חדשה** | התווית על הכפתור שפותח שיחה חדשה. | ![צ׳אט באתר — לשונית מראה](pathname:///img/screenshots/he/product/ring/live-chat/edit-appearance.png) ### טופס טרום‑שיחה הפעילו טופס קצר שמוצג לפני ההודעה הראשונה, ובחרו אילו מהשדות **שם**, **אימייל** ו**טלפון** לבקש ואילו מהם חובה, לצד הודעת ברכה. ### ערוצים נוספים הציגו בתוך הווידג'ט קישורים לערוצים האחרים שלכם, כדי שמבקר יוכל להגיע אליכם במקום אחר. בחרו ערוץ (WhatsApp,‏ Messenger, אימייל, SMS, טלפון, טלגרם, אינסטגרם, TikTok,‏ X או LinkedIn) ותנו לכל אחד תווית, קישור או מספר והסבר קצר. ### קוד **קטע ההטמעה** להתקנת הווידג'ט: ```html ``` הוסיפו אותו ל‑HTML של האתר שלכם, ממש לפני תג הסגירה ``, והעתיקו אותו באמצעות **העתקת הקוד**. מסופק גם קטע **פתיחה מאולצת של הווידג'ט**, אם אתם רוצים לפתוח את הצ׳אט מכפתור בעמוד שלכם. ![צ׳אט באתר — לשונית קוד](pathname:///img/screenshots/he/product/ring/live-chat/edit-code.png) ### אזור מסוכן מחיקת התיבה. השיחות הקיימות נשמרות; הווידג'ט מפסיק לעבוד לאחר ההסרה. ## מה המבקר רואה הווידג'ט נטען בשכבה מבודדת, כך שהוא לעולם אינו מתנגש בעיצוב האתר שלכם. מבקר: - רואה את הבועה הצפה בפינה; לחיצה עליה פותחת את פאנל הצ׳אט עם הכותרת, שורת המשנה וחיווי חי של *"N נציגים מחוברים"*. - ממלא את טופס טרום‑השיחה (אם הופעל), ואז שולח הודעה לצוות שלכם. - מקבל תשובות בזמן אמת, עם אישורי קריאה (✓ נשלח, ✓✓ נקרא) וצליל התראה כשהפאנל ממוזער. - שומר על השיחה שלו גם בין רענוני עמוד ולשוניות דפדפן. - לאחר שהשיחה מסומנת כטופלה, רואה את **הודעת סיום הטיפול** שלכם וכפתור לפתיחת צ׳אט חדש — שיחות שטופלו לעולם אינן נפתחות מחדש בשקט. ## איך הודעות מהצ׳אט באתר הופכות לשיחות 1. מבקר שולח הודעה מהווידג'ט (יחד עם כל פרט שמסר בטופס טרום‑השיחה). 2. ‏Teloring יוצרת או מתאימה את איש הקשר ופותחת שיחה בתיבה הזו. 3. הנציגים משיבים מ‑Teloring; המבקר רואה את התשובות בשידור חי בווידג'ט. ראו [שיחות](../../getting-started/conversations.md). --- # Messenger מקור: https://docs.teloring.com/he/docs/product/ring/messenger Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/messenger.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z תיבת **Messenger** מביאה ל‑Teloring הודעות פרטיות שנשלחות ל**דף הפייסבוק** שלכם. כשמישהו שולח הודעה לדף שלכם בפייסבוק, היא הופכת לשיחה בתיבה המשותפת, והנציגים משיבים בשם הדף — מאותו מקום שבו הם מטפלים בכל ערוץ אחר. :::info Messenger, [דף פייסבוק](./facebook-page.md), [הודעות אינסטגרם](./instagram-dm.md) ו[פוסטים באינסטגרם](./instagram-posts.md) הם ארבע תיבות **Meta**. כל אחת מהן מחוברת **בנפרד** כתיבה עצמאית, אבל כולן משתמשות בהתחברות אחת לפייסבוק ובאותו דף או חשבון אינסטגרם. דף אחד יכול להפעיל כמה מהתיבות האלה בו‑זמנית. ::: ## דרישות מקדימות {#prerequisites} | מה נדרש | למה | | --- | --- | | הרשאת תיבה | חיבור תיבת Meta דורש **טבעת הערוצים ← יצירה**. ראו [תפקידים והרשאות](../roles/overview.md). | | דף פייסבוק | עליכם להיות מנהלים של הדף שאת ההודעות שלו אתם רוצים לטפל. | | התחברות לפייסבוק | אתם מאשרים ל‑Teloring במהלך ההגדרה באמצעות **המשך עם Facebook**. | :::note אם ההגדרה לא מוצאת דפים, פייסבוק תודיע לכם שעליכם להיות **מנהלים של דף אחד לפחות**. ::: ## חיבור תיבת Messenger פתחו את **טבעת הערוצים**, לחצו על סמל **פייסבוק מסנג׳ר** ובחרו **הוספה**. הגדרת Meta נפתחת עם סרגל בן שלושה שלבים: **חיבור ← בחירת דפים ← סיום**. 1. **חיבור** — לחצו **המשך עם Facebook**. נפתח חלון התחברות של פייסבוק; התחברו ואשרו את ההרשאות המבוקשות. החיבור של Teloring ל‑Meta הוא חיבור **תיק עסקי** ש**לעולם אינו פג**, כך שלא תצטרכו להתחבר מחדש מדי פעם. 2. **בחירת הדפים שלכם** — בחרו את דף הפייסבוק **האחד** לחיבור (דפים שכבר מחוברים לחשבון אחר מוצגים כלא זמינים). הצ׳יפ מאשר שאתם מחברים את תיבת ה‑**Messenger** של אותו דף. 3. **סיום** — המסך **הדפים חוברו!** מאשר שהתיבה חיה. לחצו **מעבר לטבעת הערוצים**. ![הגדרת Meta — המשך עם Facebook](pathname:///img/screenshots/he/product/ring/messenger/setup-connect.png) ![הגדרת Meta — בחירת הדף שלכם](pathname:///img/screenshots/he/product/ring/messenger/setup-select-page.png) ## במה התיבה מטפלת - **שיחות פרטיות אחד על אחד** בין אדם לבין דף הפייסבוק שלכם. - **נכנס**: טקסט וקבצים מצורפים (תמונה, וידאו, אודיו, קובץ). מיקום משותף מגיע כקישור למפה. - **אישורי מסירה וקריאה**: הודעות יוצאות מציגות נשלח ← נמסר ← נקרא. - **מענה**: שליחת טקסט או קובץ מצורף אחד בחזרה בשם הדף. ### חלון 24 השעות פייסבוק מתירה לשלוח תשובות בטקסט חופשי רק בתוך **24 שעות** מההודעה האחרונה של הלקוח. נציג אנושי יכול להאריך את החלון ל‑**7 ימים** לצורך מעקב. לאחר מכן, לא תוכלו לשלוח הודעה לאותו אדם עד שהוא ישלח לכם הודעה תחילה. ## עמוד העריכה פתחו את התיבה מטבעת הערוצים כדי לנהל אותה: | רכיב | מה הוא מציג / עושה | | --- | --- | | **כותרת הפרופיל** | תמונת הדף, השם, הקטגוריה וסטטוס החיבור. | | **סוג התיבה** | מציג את סוג התיבה הזו (Messenger). | | **שם הערוץ** | ניתן לעריכה — שינוי שם התיבה. | | **פרטי החיבור** | *תיק עסקי — החיבור הזה לעולם אינו פג.* | | **תקינות הטוקן** | מאשר שהחיבור תקף. | | 🔄 **חיבור מחדש** | מאשר מחדש את החיבור אם יידרש. | | **ניתוק** | מפסיק לקבל הודעות עבור התיבה הזו. השיחות הקיימות נשמרות. | | **אזור מסוכן** | מוחק את התיבה לצמיתות (ומבטל את הרישום שלה מול Meta). השיחות נשארות. | ## איך הודעות Messenger הופכות לשיחות 1. מישהו שולח הודעה לדף הפייסבוק שלכם. 2. ‏Teloring מתאימה אותו לאיש קשר (וממזגת את אותו אדם בין הערוצים שלכם כשאפשר), או יוצרת אחד. 3. היא פותחת או ממשיכה את השיחה שלו בתיבה הזו ושומרת את ההודעה ואת המדיה. 4. מופעלים עדכוני זמן אמת, טריגרים של [סטודיו](../studio.md) ו‑AI Copilot. לאחר מכן הנציגים משיבים, משייכים, מתייגים ומקשרים ל[לקוח ב‑CRM](../crm.md) — ראו [שיחות](../../getting-started/conversations.md). --- # דף פייסבוק מקור: https://docs.teloring.com/he/docs/product/ring/facebook-page Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/facebook-page.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z תיבת **דף פייסבוק** מביאה ל‑Teloring את **התגובות על הפוסטים בדף הפייסבוק שלכם**. שרשור התגובות של כל פוסט הופך לשיחה, כך שהצוות שלכם יכול להשיב לתגובות פומביות בשם הדף — ממש לצד כל ערוץ אחר. אפשר גם לפרסם פוסטים חדשים לדף מתוך Teloring. :::info התיבה הזו מסומנת כ**תגובות בדף** במסכי ההגדרה והעריכה. היא מטפלת בתגובות פומביות — עבור הודעות פרטיות לדף שלכם, השתמשו בתיבת [Messenger](./messenger.md). שתיהן תיבות [Meta](./messenger.md#prerequisites) ויכולות לפעול על אותו דף בו‑זמנית, כשכל אחת מחוברת בנפרד. ::: ## דרישות מקדימות | מה נדרש | למה | | --- | --- | | הרשאת תיבה | חיבור תיבת Meta דורש **טבעת הערוצים ← יצירה**. ראו [תפקידים והרשאות](../roles/overview.md). | | דף פייסבוק | עליכם להיות מנהלים של הדף. | | התחברות לפייסבוק | אתם מאשרים ל‑Teloring במהלך ההגדרה. | ## חיבור תיבת דף פייסבוק פתחו את **טבעת הערוצים**, לחצו על סמל **דף פייסבוק** ובחרו **הוספה**. הגדרת Meta נפתחת עם סרגל בן שלושה שלבים: **חיבור ← בחירת דפים ← סיום**. 1. **חיבור** — לחצו **המשך עם Facebook**, התחברו ואשרו את ההרשאות המבוקשות. החיבור **לעולם אינו פג**. 2. **בחירת הדפים שלכם** — בחרו את הדף **האחד** לחיבור. הצ׳יפ מאשר שאתם מחברים את תיבת **תגובות בדף**. 3. **סיום** — **הדפים חוברו!** מאשר שהיא חיה. לחצו **מעבר לטבעת הערוצים**. ![הגדרת Meta — בחירת הדף שלכם](pathname:///img/screenshots/he/product/ring/facebook-page/setup-select-page.png) ## במה התיבה מטפלת - **שרשורי תגובות פומביים** על הפוסטים בדף שלכם. התגובות של כל פוסט הופכות לשיחה נפרדת. - **הקשר הפוסט**: בפעם הראשונה שמישהו מגיב על פוסט, Teloring מושכת את הטקסט של הפוסט, את התמונה, את הקישור הקבוע, את מספר הלייקים ואת השעה, כדי שלנציג יהיה הקשר מלא. קישור **צפייה בפייסבוק** פותח את המקור. - **מענה**: הנציגים משיבים בפומבי בשם הדף. ‏Teloring מזכירה את המגיב (`@שם`) כדי שפייסבוק תשלח לו התראה. - **ללא חלון התכתבות**: בשונה מהודעות פרטיות, לתשובות על תגובות אין מגבלת 24 שעות. ![שיחת תגובה עם הקשר הפוסט](pathname:///img/screenshots/he/product/ring/facebook-page/conversation-comment.png) ### פרסום פוסט חדש מאזור השיחה אפשר לפרסם פוסט חדש לדף שלכם: | סוג פוסט | הערות | | --- | --- | | **טקסט בלבד** | פוסט טקסט. | | **תמונה בודדת** | תמונה אחת. | | **תמונות מרובות (אלבום)** | עד 10 תמונות. | | **וידאו** | פוסט וידאו. | פרסום פוסט **אינו** יוצר שיחה. אבל כשמישהו מגיב עליו, נפתחת שיחה חדשה אוטומטית כדי שתוכלו להשיב מתוך Teloring. ## עמוד העריכה אותו מבנה כמו שאר תיבות Meta: כותרת פרופיל הדף, אריח **סוג התיבה** (תגובות בדף), **שם ערוץ** הניתן לעריכה, פרטי החיבור *תיק עסקי — לעולם אינו פג*, כרטיס **תקינות טוקן**, כפתורי **חיבור מחדש** / **ניתוק** ו**אזור מסוכן**. ניתוק או מחיקה שומרים את השיחות הקיימות. ## איך תגובות הופכות לשיחות 1. מישהו מגיב על אחד מהפוסטים בדף שלכם. 2. ‏Teloring מתאימה אותו לאיש קשר או יוצרת אחד, ומאתרת (או יוצרת) את השיחה של שרשור התגובות של **אותו פוסט**. 3. בתגובה הראשונה היא מעשירה את השיחה בהקשר של הפוסט. 4. מופעלים עדכוני זמן אמת, טריגרים של [סטודיו](../studio.md) ו‑AI Copilot. הנציגים משיבים בפומבי בשם הדף מתוך [שיחות](../../getting-started/conversations.md). --- # הודעות אינסטגרם מקור: https://docs.teloring.com/he/docs/product/ring/instagram-dm Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/instagram-dm.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z תיבת **הודעות אינסטגרם** מביאה ל‑Teloring **הודעות ישירות** שנשלחות לחשבון האינסטגרם שלכם. כל שיחת אינסטגרם הופכת לשיחה בתיבה המשותפת, והנציגים משיבים בשם חשבון האינסטגרם שלכם — מאותו מקום שבו הם מטפלים בכל ערוץ אחר. :::info הודעות אינסטגרם היא אחת מארבע תיבות [Meta](./messenger.md#prerequisites). היא משתמשת בדף הפייסבוק שאליו מקושר חשבון האינסטגרם שלכם. עבור תגובות על הפוסטים שלכם באינסטגרם, השתמשו ב[פוסטים באינסטגרם](./instagram-posts.md). ::: ## דרישות מקדימות | מה נדרש | למה | | --- | --- | | הרשאת תיבה | חיבור תיבת Meta דורש **טבעת הערוצים ← יצירה**. ראו [תפקידים והרשאות](../roles/overview.md). | | דף פייסבוק שאתם מנהלים | אינסטגרם מתחברת דרך דף הפייסבוק המקושר אליה. | | חשבון אינסטגרם **עסקי או יוצר** **המקושר לדף הזה** | נתוני אינסטגרם מופיעים רק כאשר החשבון הוא חשבון עסקי או יוצר מקושר. | | התחברות לפייסבוק | אתם מאשרים ל‑Teloring במהלך ההגדרה. | ## חיבור תיבת הודעות אינסטגרם פתחו את **טבעת הערוצים**, לחצו על סמל **הודעות אינסטגרם** ובחרו **הוספה**. הגדרת Meta נפתחת עם סרגל בן שלושה שלבים: **חיבור ← בחירת דפים ← סיום**. 1. **חיבור** — לחצו **המשך עם Facebook**, התחברו ואשרו את ההרשאות המבוקשות. החיבור **לעולם אינו פג**. 2. **בחירת הדפים שלכם** — בחרו את דף הפייסבוק שחשבון האינסטגרם המקושר אליו מעניין אתכם. עבור תיבות אינסטגרם, הכרטיס מציג **פרופיל אינסטגרם** מלא — תמונת פרופיל, שם, `@username`, ביוגרפיה ונתוני עוקבים / נעקבים / פוסטים — כדי שתוכלו לוודא שזה החשבון הנכון. הצ׳יפ מאשר שאתם מחברים את תיבת **הודעות אינסטגרם**. 3. **סיום** — **הדפים חוברו!** מאשר שהיא חיה. לחצו **מעבר לטבעת הערוצים**. ![הגדרת Meta — כרטיס פרופיל האינסטגרם](pathname:///img/screenshots/he/product/ring/instagram-dm/setup-select-page.png) ## במה התיבה מטפלת - **הודעות ישירות פרטיות באינסטגרם** לחשבון המקושר שלכם. - **נכנס**: טקסט וקבצים מצורפים (תמונה, וידאו, אודיו, קובץ). - **תשובות לסטוריז**: כשמישהו משיב לסטורי שלכם, Teloring שומרת את תמונת הסטורי (הקישור של אינסטגרם עצמה פג במהירות) ומציגה אותה כהקשר בשיחה. - **אישורי קריאה**: הודעות יוצאות מציגות מתי הן נקראו. - **מענה**: שליחת טקסט או קובץ מצורף אחד. ### חלון 24 השעות אינסטגרם, בדומה ל‑Messenger, מתירה לשלוח תשובות בטקסט חופשי רק בתוך **24 שעות** מההודעה האחרונה של הלקוח, וניתן להאריך זאת ל‑**7 ימים** על ידי נציג אנושי לצורך מעקב. לאחר מכן, לא תוכלו לשלוח הודעה לאותו אדם עד שהוא ישלח לכם הודעה שוב. ## עמוד העריכה אותו מבנה כמו שאר תיבות Meta, עם תוספות של אינסטגרם: | רכיב | מה הוא מציג / עושה | | --- | --- | | **כותרת הפרופיל** | שם הדף והסטטוס, לצד שורת אינסטגרם (📸 @username). | | **כרטיס פרופיל האינסטגרם** | תמונת פרופיל, `@username`, ביוגרפיה ונתוני עוקבים / נעקבים / פוסטים, עם כפתור **רענון פרופיל האינסטגרם**. | | **סוג התיבה** | הודעות אינסטגרם. | | **שם הערוץ** | ניתן לעריכה. | | **פרטי החיבור / תקינות הטוקן** | *תיק עסקי — לעולם אינו פג.* | | **חיבור מחדש / ניתוק / אזור מסוכן** | ניהול או הסרה של התיבה; השיחות נשמרות. | ## איך הודעות אינסטגרם הופכות לשיחות 1. מישהו שולח לחשבון שלכם הודעה ישירה. 2. ‏Teloring מתאימה אותו לאיש קשר או יוצרת אחד. 3. היא פותחת או ממשיכה את השיחה שלו בתיבה הזו ושומרת את ההודעה, המדיה וכל הקשר של סטורי. 4. מופעלים עדכוני זמן אמת, טריגרים של [סטודיו](../studio.md) ו‑AI Copilot. הנציגים משיבים בשם חשבון האינסטגרם שלכם מתוך [שיחות](../../getting-started/conversations.md). --- # פוסטים באינסטגרם מקור: https://docs.teloring.com/he/docs/product/ring/instagram-posts Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/instagram-posts.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z תיבת **פוסטים באינסטגרם** מביאה ל‑Teloring את **התגובות על הפוסטים והרילס שלכם באינסטגרם**. שרשור התגובות של כל פוסט הופך לשיחה, כך שהצוות שלכם יכול להשיב לתגובות פומביות בשם חשבון האינסטגרם שלכם. אפשר גם לפרסם תוכן חדש לאינסטגרם מתוך Teloring. :::info התיבה הזו מסומנת כ**תגובות אינסטגרם** במסכי ההגדרה והעריכה. היא מטפלת בתגובות פומביות — עבור הודעות פרטיות, השתמשו ב[הודעות אינסטגרם](./instagram-dm.md). שתיהן תיבות [Meta](./messenger.md#prerequisites) ופועלות על חשבון האינסטגרם המקושר לדף הפייסבוק שלכם. ::: ## דרישות מקדימות | מה נדרש | למה | | --- | --- | | הרשאת תיבה | חיבור תיבת Meta דורש **טבעת הערוצים ← יצירה**. ראו [תפקידים והרשאות](../roles/overview.md). | | דף פייסבוק שאתם מנהלים | אינסטגרם מתחברת דרך דף הפייסבוק המקושר אליה. | | חשבון אינסטגרם **עסקי או יוצר** המקושר לדף הזה | נדרש כדי שנתוני אינסטגרם יופיעו. | | התחברות לפייסבוק | אתם מאשרים ל‑Teloring במהלך ההגדרה. | ## חיבור תיבת פוסטים באינסטגרם פתחו את **טבעת הערוצים**, לחצו על סמל **פוסטים באינסטגרם** ובחרו **הוספה**. הגדרת Meta נפתחת עם סרגל בן שלושה שלבים: **חיבור ← בחירת דפים ← סיום**. 1. **חיבור** — לחצו **המשך עם Facebook**, התחברו ואשרו את ההרשאות. החיבור **לעולם אינו פג**. 2. **בחירת הדפים שלכם** — בחרו את הדף שחשבון האינסטגרם המקושר אליו מעניין אתכם; פרופיל האינסטגרם שלו (עם נתוני עוקבים) מוצג על הכרטיס. הצ׳יפ מאשר שאתם מחברים את תיבת **תגובות אינסטגרם**. 3. **סיום** — **הדפים חוברו!** מאשר שהיא חיה. לחצו **מעבר לטבעת הערוצים**. ![הגדרת Meta — בחירת חשבון האינסטגרם שלכם](pathname:///img/screenshots/he/product/ring/instagram-posts/setup-select-page.png) ## במה התיבה מטפלת - **שרשורי תגובות פומביים** על הפוסטים והרילס שלכם באינסטגרם. התגובות של כל פוסט הופכות לשיחה נפרדת. - **הקשר הפוסט**: בתגובה הראשונה, Teloring מושכת את הכיתוב של הפוסט, את התמונה, את הקישור הקבוע, את מספר הלייקים ואת השעה. קישור **צפייה באינסטגרם** פותח את המקור. - **מענה**: הנציגים משיבים בפומבי בשם חשבון האינסטגרם שלכם. - **ללא חלון התכתבות**: לתשובות על תגובות אין מגבלת 24 שעות. ### פרסום תוכן חדש מאזור השיחה אפשר לפרסם לאינסטגרם: | סוג | הערות | | --- | --- | | **תמונה בודדת** | תמונה אחת (מתחת ל‑8 MB). | | **ריל (וידאו)** | ריל (מתחת ל‑300 MB). | | **קרוסלה** | 2–10 פריטים. | | **סטורי (תמונה / וידאו)** | סטורי תמונה או וידאו (וידאו מתחת ל‑100 MB). | הכיתובים יכולים להגיע עד 2,200 תווים. הפרסום **אינו** יוצר שיחה, אבל תגובות על הפוסט החדש כן ייצרו. ## עמוד העריכה אותו מבנה כמו שאר תיבות Meta: כותרת הפרופיל עם שורת האינסטגרם, **כרטיס פרופיל האינסטגרם** עם **רענון פרופיל האינסטגרם**, אריח **סוג התיבה** (תגובות אינסטגרם), **שם ערוץ** הניתן לעריכה, פרטי החיבור *תיק עסקי — לעולם אינו פג*, כרטיס **תקינות טוקן**, כפתורי **חיבור מחדש** / **ניתוק** ו**אזור מסוכן**. הסרת התיבה שומרת את השיחות הקיימות. ## איך תגובות הופכות לשיחות 1. מישהו מגיב על אחד מהפוסטים או הרילס שלכם באינסטגרם. 2. ‏Teloring מתאימה אותו לאיש קשר או יוצרת אחד, ומאתרת (או יוצרת) את השיחה של שרשור התגובות של אותו פוסט. 3. בתגובה הראשונה היא מעשירה את השיחה בהקשר של הפוסט. 4. מופעלים עדכוני זמן אמת, טריגרים של [סטודיו](../studio.md) ו‑AI Copilot. הנציגים משיבים בפומבי בשם החשבון שלכם מתוך [שיחות](../../getting-started/conversations.md). --- # שיחות טלפון מקור: https://docs.teloring.com/he/docs/product/ring/voice Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/voice.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z תיבת **שיחות טלפון** היא ערוץ של שיחות קוליות. היא מקצה לחשבון שלכם מספר טלפון, והנציגים עונים ומחייגים מ**סופטפון בדפדפן** — חלון קופץ קטן — במקום מטלפון שולחני. כל שיחה הופכת לרשומת שיחה, כך שהיא יושבת באותה תיבה ועל אותה רשומת לקוח כמו צ׳אטים ומיילים. :::info שיחות טלפון הן **ערוץ קולי, לא ערוץ טקסט**. לשיחות טלפון **אין תיבת מענה** — השיחה היא רשומה של השיחה הטלפונית (עם הערות, הקלטה והיסטוריה). הנציגים מדברים עם הלקוחות דרך הסופטפון. ::: ## דרישות מקדימות ערוץ הקול תלוי בכמה דברים שמוגדרים ברמת החשבון וברמת הנציג (מחוץ לתיבה עצמה): | דרישה | היכן מגדירים | | --- | --- | | **ערוץ קול מופעל בחשבון** | מתג ראשי ברמת החשבון חייב להיות דלוק. אם הוא כבוי, הוספת תיבת קול או ביצוע שיחות מחזירים "ערוץ הקול מושבת בחשבון הזה". | | **מספר טלפון זמין** | מספרי הקול מגיעים ממאגר בניהול Teloring. אתם בוחרים מספר זמין בעת יצירת התיבה. | | **נציגים עם ערוץ קול מופעל** | כל נציג שיטפל בשיחות חייב להיות מופעל לקול (פעולה שמגדירה את פרטי החיוג שלו). קיימת גם פעולת **איפוס פרטי הקול** להחלפת פרטי הגישה של נציג. | | **הרשאת תיבה** | יצירת תיבת קול דורשת **טבעת הערוצים ← יצירה**. הפעלת חיוג בדפדפן עבור אדם מסוים דורשת **נציגים ← עדכון**. ראו [תפקידים והרשאות](../roles/overview.md). | ## יצירת תיבת שיחות טלפון פתחו את **טבעת הערוצים**, לחצו על סמל **שיחת טלפון** ובחרו **הוספה**. ![תיבת שיחות טלפון — בוחר המספר](pathname:///img/screenshots/he/product/ring/voice/setup.png) | שדה | מה לעשות | | --- | --- | | **שם הערוץ** | תנו שם לקו (למשל *הקו הראשי* או *קו התמיכה*). | | **מספר קולי** | בחרו מספר טלפון זמין של Teloring מהרשימה הנפתחת (מוצג בפורמט נוח כמו `+972 73-398-3300`). | לחצו כדי ליצור את התיבה. ‏Teloring מקצה את המספר לחשבון שלכם (שני מנהלים אינם יכולים לתפוס את אותו מספר) והתיבה עולה לאוויר. אם אין מספרים פנויים, תראו את ההודעה *"אין מספרים קוליים זמינים. פנו לתמיכה."* מחיקת התיבה משחררת את המספר שלה בחזרה למאגר. ## מאפייני התיבה לתיבת קול יש המאפיינים האלה, שנקבעים בעת היצירה: | מאפיין | ברירת מחדל | משמעות | | --- | --- | --- | | **סגירה אוטומטית** | מופעל | השיחה נסגרת מעצמה כשהשיחה הטלפונית מסתיימת, כך שהנציגים לא צריכים לסגור ידנית שיחות שהושלמו. (שיחות שלא נענו נשארות פתוחות למעקב.) | | **הקלטה** | כבוי | ברירת המחדל להקלטת שיחות. האם שיחה מסוימת מוקלטת נקבע על ידי תהליך השיחה שלכם ב‑[סטודיו](../studio/voice-flows.md). | | **שעות פעילות** | לוח ברירת המחדל | איזה לוח זמנים לשימוש חוזר (שעות פתיחה/סגירה, אזור זמן, חגים) משמש את תהליך השיחה כדי להחליט איך לנתב שיחות. | | **שלוחות נציגים** | — | אילו נציגים יכולים לקבל שיחות שמועברות מהקו הזה. | :::note התנהגות ערוץ הקול — ברכות, תפריטים, ניתוב לפי שעות פעילות, העברה לנציגים והקלטה — נבנית בתהליך שיחה ב‑[סטודיו](../studio/voice-flows.md) שמחובר למספר, ולא בלשונית הגדרות בתיבה. עמוד העריכה של התיבה מציג את שמה ואפשרות מחיקה; הטיפול היומיומי בשיחות מוגדר בתהליך. ::: ## יכולות | יכולת | פירוט | | --- | --- | | **שיחות נכנסות** | לקוח מחייג למספר שלכם; השיחה עוברת דרך תהליך הסטודיו שלכם ויכולה לצלצל בדפדפן של נציג. | | **שיחות יוצאות** | נציג מחייג מהקו הקולי למספר חיצוני. | | **שיחות פנימיות** | נציגים יכולים להתקשר זה לזה, מדפדפן לדפדפן. | | **סופטפון בדפדפן** | חלון קופץ עם פקדי **השתקה**, **המתנה**, **ניתוק** ו(לשיחות נכנסות) **מענה**. השאירו אותו פתוח לאורך כל השיחה. | | **הקלטת שיחות** | ההקלטות נשמרות ומצורפות לשיחה, ונשלטות לכל שיחה בנפרד על ידי תהליך הסטודיו. | | **AI Copilot** | זמין בשיחות טלפון. | | **מצב שיחה חי** | כרטיס השיחה מתעדכן בזמן אמת בזמן שהשיחה מצלצלת, נענית, מועברת להמתנה ומסתיימת. | ![חלון הסופטפון](pathname:///img/screenshots/he/product/ring/voice/softphone.png) ## איך שיחות טלפון הופכות לרשומות שיחה בשונה מערוצי הודעות, **כל שיחת טלפון היא רשומת שיחה נפרדת** (גם שיחות חוזרות מאותו מספר). - **נכנסת**: כשלקוח מחייג למספר שלכם, Teloring מאתרת את התיבה, מתאימה או יוצרת את איש הקשר (מתקשר לא מוכר הופך לליד), יוצרת את רשומת השיחה ומריצה את תהליך הסטודיו שלכם. **כרטיס שיחה** מצלצל מופיע בתיבת הנציג. - **שיחות שנענו** נסגרות אוטומטית בסיומן (אם הסגירה האוטומטית מופעלת). - **שיחות שלא נענו** נשארות פתוחות ומקבלות הערה פרטית אוטומטית כמו *"שיחה שלא נענתה מ‑050-773-0018 בשעה 14:32."*, כדי שאפשר יהיה לחזור אליהן. - **שיחות יוצאות** יוצרות רשומת שיחה באותו אופן, משויכת לנציג שביצע את השיחה. בכל פרופיל של איש קשר יש מדור קבוע של **שיחות טלפון**, שמפרט את כל רשומות השיחה הקוליות שלו. ראו [שיחות](../../getting-started/conversations.md). --- # TikTok Messenger מקור: https://docs.teloring.com/he/docs/product/ring/tiktok Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/tiktok.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z תיבת **TikTok Messenger** מביאה ל‑Teloring **הודעות ישירות** מחשבון **עסקי** ב‑TikTok. כשמישהו שולח הודעה לעסק שלכם ב‑TikTok — מהפרופיל שלכם, ממודעה או מקישור `tiktok.me` — היא הופכת לשיחה בתיבה המשותפת, והנציגים משיבים מאותו מקום שבו הם מטפלים בכל ערוץ אחר. :::info TikTok Messenger הוא **ערוץ שמתחיל בנכנס**: אינכם יכולים לפתוח שיחה עם משתמש TikTok. שיחה נפתחת רק כשמישהו שולח הודעה לעסק שלכם תחילה. יש לו גם חלון מענה מחמיר (ראו [יכולות ומגבלות](#capabilities-and-limits)). תגובות על פוסטים ו‑TikTok Shop אינם חלק מהתיבה הזו. ::: ## דרישות מקדימות אשף ההגדרה מציג רשימת בדיקה בשם **לפני שמתחברים**: | דרישה | פירוט | | --- | --- | | **חשבון TikTok עסקי** | ההתכתבות פועלת רק עם חשבונות **עסקיים** (לא אישיים או של יוצרים) שיכולת ההתכתבות מופעלת בהם. | | **זמינות אזורית** | ‏TikTok Business Messaging אינו זמין בכל מדינה. אם האזור שלכם אינו נתמך, החיבור נכשל עם הודעת שגיאה ברורה. | | **חלון מענה של 48 שעות** | אפשר להשיב רק בתוך 48 שעות מההודעה האחרונה של הלקוח, ולכל היותר 10 הודעות בכל חלון. הודעה נכנסת חדשה מאפסת את שניהם. | | **נכנס בלבד** | אינכם יכולים לפתוח שיחה — הלקוחות חייבים לפנות אליכם תחילה. | | **הרשאת תיבה** | חיבור התיבה דורש **טבעת הערוצים ← יצירה**. ראו [תפקידים והרשאות](../roles/overview.md). | ## חיבור תיבת TikTok פתחו את **טבעת הערוצים**, לחצו על סמל **TikTok Messenger** ובחרו **הוספה**. ![אשף ההגדרה של TikTok](pathname:///img/screenshots/he/product/ring/tiktok/setup.png) 1. עברו על רשימת הבדיקה **לפני שמתחברים**. 2. לחצו **חיבור TikTok**. נפתח חלון ב‑TikTok, שבו אתם מאשרים ל‑Teloring לקרוא ולשלוח הודעות עבור החשבון העסקי שלכם. 3. כשאתם מאשרים, החלון נסגר ו‑Teloring פותחת את עמוד העריכה של התיבה. אישור מחדש של אותו חשבון TikTok בהמשך מעדכן את התיבה הקיימת במקום ליצור כפילות. :::note אם היכולת עדיין ממתינה לאישור עבור החשבון שלכם, כפתור החיבור מושבת עם הודעה ש‑TikTok Messenger נמצא בשלב בדיקות. ::: ## עמוד העריכה לעמוד העריכה של TikTok שלושה כרטיסים מעל שם התיבה: ### חיבור מציג את סטטוס החיבור עם נקודה צבעונית: | סטטוס | משמעות | | --- | --- | | **מחובר** | התיבה מאושרת ופועלת. | | **ההרשאה פגה — נדרש חיבור מחדש** | אשרו מחדש כדי לשחזר אותה. | | **אינו חשבון עסקי** | העבירו את חשבון ה‑TikTok לחשבון עסקי, ואז התחברו מחדש. | | **האזור אינו נתמך** | התכתבות ב‑TikTok אינה זמינה באזור של החשבון הזה. | | **מנותק** | התיבה נותקה. | כפתור **🔄 חיבור מחדש / אישור מחדש** מריץ שוב את תהליך האישור של TikTok. ![TikTok — חיבור ויכולות](pathname:///img/screenshots/he/product/ring/tiktok/edit-capabilities.png) ### יכולות בדיקה חיה של מה שהחיבור הזה באמת יכול לעשות, עם ✅ / ❌ לכל פריט: | יכולת | משמעות | | --- | --- | | **החשבון מחובר** | ‏Teloring יכולה להגיע לחשבון ה‑TikTok העסקי. | | **קבלת הודעות נכנסות** | הודעות ישירות נכנסות נמסרות. | | **שליחת תשובות דרך ה‑API** | האם Teloring יכולה לשלוח תשובות (TikTok מגבילה שליחה לחשבונות עסקיים). | | **סנכרון / רשימת שיחות** | האם Teloring יכולה למשוך רשימת שיחות מ‑TikTok. | | **מסירת Webhook רשומה** | מסירת ההודעות הנכנסות מוגדרת. | :::tip הפאנל הזה הוא התמונה המדויקת של החשבון הספציפי שלכם — למשל, חשבון אישי עדיין יכול **לקבל** הודעות אך לא **לשלוח** תשובות, עד שיוסב לחשבון עסקי. ::: ### בונה קישורי tiktok.me צרו קישורי `tiktok.me` הניתנים למעקב. הוסיפו **תווית מעקב (ref)** — כמו `instagram_bio` — ו‑Teloring בונה קישור כמו `https://tiktok.me/@yourname?ref=instagram_bio`. כשמישהו פותח את הקישור הזה ושולח לכם הודעה, ה‑ref מופיע בשיחה, כך שתוכלו לראות איזה מקור (ביו באינסטגרם, חתימת אימייל, מודעה וכן הלאה) מייצר שיחות. טבלת **ביצועי הקישורים** מציגה כמה שיחות כל ref הפיק. :::note שם המשתמש שלכם ב‑TikTok מופיע כאן לאחר שההודעה הראשונה מלקוח מגיעה; רק אז אפשר לבנות קישורים. ::: ## יכולות ומגבלות {#capabilities-and-limits} | יכולת | פירוט | | --- | --- | | תשובות טקסט | עד 6,000 תווים; אפשר לצטט הודעת טקסט של לקוח בתשובה. | | חיווי הקלדה וקריאה | מוצגים ללקוח בזמן שהנציגים מקלידים ופותחים את השיחה. | | שליחת תמונות | ‏JPG או PNG, עד 3 MB. הודעה יכולה להיות **או** טקסט **או** תמונה, לא שניהם. תמיכת התמונות משתנה בין שווקים. | | קבלה | טקסט, תמונות, וידאו, פוסטים משותפים, אימוג'י, סטיקרים, ריאקציות וכרטיסי תבנית. | | **חלון 48 שעות / 10 הודעות** | אפשר להשיב במשך 48 שעות מההודעה האחרונה של הלקוח, עד 10 הודעות. הודעה נכנסת חדשה מאפסת גם את הטיימר וגם את המונה. תיבת החיבור מציגה את הזמן והמכסה שנותרו, וכרזות מסבירות מתי החלון פג או המגבלה הושגה. | | נכנס בלבד | אין כפתור "שיחה חדשה" — הלקוחות חייבים לפנות אליכם תחילה. | ## איך הודעות TikTok הופכות לשיחות 1. לקוח שולח הודעה לעסק שלכם ב‑TikTok (או מגיע דרך מודעה או קישור `tiktok.me`). 2. ‏Teloring מתאימה אותו לאיש קשר או יוצרת אחד, ופותחת או ממשיכה את השיחה שלו בתיבה הזו. 3. אם הוא הגיע ממודעה או מקישור, השיחה מציגה את המקור (ואת ה‑`ref`). 4. מופעלים עדכוני זמן אמת, טריגרים של [סטודיו](../studio.md) ו‑AI Copilot. שיחה שטופלה לעולם אינה נפתחת מחדש — הודעה מאוחרת יותר פותחת שיחה חדשה. ראו [שיחות](../../getting-started/conversations.md). --- # API מקור: https://docs.teloring.com/he/docs/product/ring/api Markdown: https://docs.teloring.com/he/markdown/docs/product/ring/api.md מדור: טבעת הערוצים — תיבות עודכן לאחרונה: 2026-08-20T20:49:57.000Z תיבת **API** היא תיבת מפתחים לדחיפת הודעות אל Teloring מכל מערכת מותאמת — האפליקציה שלכם, פלטפורמה ותיקה, או ערוץ ש‑Teloring אינה תומכת בו באופן מובנה. אתם יוצרים את התיבה, מקבלים נקודת קצה ושולחים אליה הודעות ב‑POST. כל הודעה הופכת לשיחה בדיוק כמו בכל ערוץ אחר, כך שהאינטגרציה המותאמת שלכם נוחתת באותה תיבה משותפת שהנציגים כבר משתמשים בה. ## דרישות מקדימות | מה נדרש | למה | | --- | --- | | הרשאת תיבה | יצירת תיבה דורשת **טבעת הערוצים ← יצירה**. ראו [תפקידים והרשאות](../roles/overview.md). | | טוקן API אישי | הבקשות מאומתות באמצעות הטוקן האישי של נציג (נוצר בפרופיל שלכם). | | מערכת שיכולה לשלוח בקשות HTTP | כדי לשלוח הודעות ב‑POST לנקודת הקצה. | ## יצירת תיבת API פתחו את **טבעת הערוצים**, לחצו על סמל **API** ובחרו **הוספה**. ![הגדרת תיבת API](pathname:///img/screenshots/he/product/ring/api/setup.png) | שדה | מה להזין | | --- | --- | | **שם הערוץ** | שם כמו *תיבת ה‑API שלי*. | | **סוג הערוץ** | לקריאה בלבד (API). | | **כתובת Webhook (להודעות יוצאות)** | אופציונלי. אם תספקו אותה, Teloring תשלח ב‑POST הודעות **יוצאות** (תשובות של נציגים) לכתובת הזו, כדי שהמערכת שלכם תוכל למסור אותן. השאירו ריק אם אתם רק דוחפים הודעות פנימה. | לחצו **יצירת ערוץ**. מסך ההצלחה (ועמוד העריכה של התיבה) מציג את הפרטים שאתם צריכים לאינטגרציה. ## שליחת הודעות פנימה לאחר היצירה אתם מקבלים: - **מזהה הערוץ שלכם** — המזהה המספרי של התיבה. - **נקודת קצה** — הכתובת שאליה שולחים הודעות ב‑POST, בתבנית `.../accounts/{account}/channels/{channel}/incoming`. - **דוגמת cURL** ו**דוגמת Python** — קוד מוכן לשימוש שאפשר להעתיק. ![תיבת API — קוד לדוגמה](pathname:///img/screenshots/he/product/ring/api/sample-code.png) אמתו כל בקשה עם הטוקן האישי שלכם בכותרת `X-API-Key`. גוף ההודעה מקבל: | שדה | משמעות | | --- | --- | | `message` | טקסט ההודעה (חובה). | | `contact_id` | איש קשר קיים שאליו לצרף (אופציונלי). | | `contact_name`, `contact_phone`, `contact_email`, `contact_picture` | פרטים המשמשים להתאמה או ליצירה של איש הקשר כאשר לא סופק `contact_id`. | | `file_url` | קובץ מצורף אופציונלי. | | `contact_attributes` | שדות מותאמים להגדרה על איש הקשר. | Teloring מאתרת או יוצרת את איש הקשר, מאתרת או יוצרת שיחה פתוחה, שומרת את ההודעה ומחזירה את ה‑`contact_id`, ה‑`conversation_id` וה‑`message_id` שנוצרו. :::tip עמודי ההגדרה והעריכה כוללים את פורמט הבקשה המדויק עבור התיבה שלכם. העתיקו את דוגמת ה‑**cURL** או ה‑**Python** כדי להתחיל במהירות. ::: ## עמוד העריכה של ה‑API עמוד העריכה מאפשר לשנות את שם התיבה, להגדיר או לשנות את **כתובת ה‑Webhook** היוצאת ולעיין בקוד הדוגמה. **אזור מסוכן** מוחק את התיבה (השיחות הקיימות נשמרות). ## הודעות יוצאות (אופציונלי) אם הגדרתם **כתובת Webhook**, תשובות של נציגים בתיבה הזו נשלחות אליה ב‑POST, כדי שהמערכת שלכם תמסור אותן ללקוח. כך תיבת ה‑API הופכת לדו‑כיוונית מלאה עבור ערוץ מותאם. ## איך הודעות API הופכות לשיחות 1. המערכת שלכם שולחת הודעה ב‑POST לנקודת הקצה `incoming` של התיבה, עם ה‑`X-API-Key` שלכם. 2. ‏Teloring מתאימה או יוצרת את איש הקשר, פותחת או ממשיכה שיחה ושומרת את ההודעה. 3. מופעלים עדכוני זמן אמת, טריגרים של [סטודיו](../studio.md) ו‑AI Copilot, והנציגים משיבים מתוך [שיחות](../../getting-started/conversations.md) כרגיל. --- # בניית תהליך בעזרת AI‏ (Hermes) מקור: https://docs.teloring.com/he/docs/product/studio/ai-flow-builder Markdown: https://docs.teloring.com/he/markdown/docs/product/studio/ai-flow-builder.md מדור: Studio עודכן לאחרונה: 2026-08-20T20:49:57.000Z **Hermes** הוא בונה התהליכים החכם שבתוך סטודיו. במקום לגרור בלוקים לקנבס, אתם מתארים במילים שלכם מה אתם רוצים. ‏Hermes שואל כמה שאלות המשך, וכשיש לו כל מה שהוא צריך הוא בונה עבורכם את התהליך כולו — הבלוקים, ההגדרות שלהם והחיבורים ביניהם. התוצאה היא תהליך סטודיו רגיל. שום דבר בו אינו נעול או מיוחד: אתם פותחים אותו ב[עורך הקנבס](../studio.md#the-editor), משנים כל מה שתרצו ומפרסמים בעצמכם. ![בונה התהליכים Hermes באמצע ריאיון](pathname:///img/screenshots/he/product/studio/ai/ai-builder-chat.png) ## מתי להשתמש בו | השתמשו ב‑Hermes כאשר | בנו בעצמכם כאשר | | --- | --- | | אתם יודעים מה אתם רוצים שיקרה אבל לא באילו בלוקים להשתמש | אתם כבר מכירים את הבלוקים ורק רוצים להציב אותם | | אתם חדשים בסטודיו ורוצים דוגמה עובדת ללמוד ממנה | אתם מבצעים עריכה קטנה בתהליך קיים | | אתם רוצים טיוטה ראשונה במהירות, ואז לשפר ידנית | התהליך תלוי בקובץ שיש להעלות או בתבנית WhatsApp שעליכם לבחור בעצמכם | | בתהליך שלכם יש כמה הסתעפויות ואתם רוצים שהחיווט ייעשה עבורכם | אתם מעתיקים מבנה של תהליך קיים | :::tip Hermes הוא נקודת התחלה, לא תחליף לעורך. רוב הצוותים נותנים ל‑Hermes לבנות את השלד, ואז משקיעים שתי דקות בליטוש ניסוח התשובות על הקנבס. ::: ## לפני שמתחילים | דרישה | פירוט | | --- | --- | | **AI Studio חייב להיות מופעל** | מישהו עם **עולם AI ← עדכון** מפעיל את המתג **AI Studio** ב[עולם AI](../ai-world.md). עד אז אפשרות ה‑AI בסטודיו גלויה אך אינה ניתנת לבחירה. | | **מי יכול להשתמש בזה** | כל נציג מחובר עם **סטודיו ← יצירה**. ראו [תפקידים והרשאות](../roles/overview.md). | | **התיבות שלכם צריכות להתקיים קודם** | ‏Hermes מציע את התיבות, הצוותים, הנציגים, לוחות הזמנים ואובייקטי ה‑CRM האמיתיים שלכם, בשמם. אם התיבה שאתם רוצים להפוך לאוטומטית עדיין אינה מחוברת, חברו אותה קודם — ראו [טבעת הערוצים](../ring/overview.md). | | **שפה** | ‏Hermes כותב לכם בשפת הממשק של Teloring שלכם (אנגלית או עברית), וכותב את טקסט ההודעות ללקוח בתוך הבלוקים באותה שפה. | :::note אם הכרטיס **בנייה בעזרת AI** אפור עם ההודעה *"הפעילו את AI Studio כדי להשתמש בזה"*, בקשו ממנהל החשבון להפעיל את **AI Studio** בעולם AI. נציגים אינם יכולים לשנות מתגי AI בעצמם. ::: ## פתיחת תהליך עם AI 1. פתחו את **סטודיו** מסרגל הצד ולחצו **תהליך חדש**. 2. תנו לתהליך **שם**, ורצוי גם **תיאור** קצר. ‏Hermes קורא את שניהם — `WhatsApp — ניתוב למכירות או לתמיכה` מספר לו הרבה יותר מ‑`תהליך 4`. 3. תחת **איך תרצו לבנות אותו?**, בחרו אחד משני הכרטיסים. **אף אחד אינו נבחר מראש**, והכפתור נשאר מושבת עד שתבחרו. 4. לחצו **התחלה עם AI**. ![דיאלוג התהליך החדש עם שני כרטיסי מצב הבנייה](pathname:///img/screenshots/he/product/studio/ai/new-flow-choose-mode.png) | כרטיס | מה קורה | | --- | --- | | **אבנה בעצמי** | התהליך נוצר ועורך הקנבס נפתח, בדיוק כמו תמיד. | | **בנייה בעזרת AI** | התהליך נוצר וצ׳אט Hermes נפתח. תווית הכפתור משתנה ל**התחלה עם AI**. | :::info התהליך נוצר כ**טיוטה בשני המקרים, לפני שהשיחה מתחילה**. אם תנטשו את הריאיון באמצע, לא איבדתם דבר — נשארת לכם טיוטה ריקה רגילה שאפשר לפתוח בעורך או למחוק. ::: ## מסך Hermes לעמוד שלושה חלקים: השיחה במרכז, סרגל התקדמות בצד, וכותרת עם שתי פעולות יציאה. ![חלקי המסך של Hermes](pathname:///img/screenshots/he/product/studio/ai/ai-builder-anatomy.png) ### כותרת | רכיב | מה זה | | --- | --- | | **←** | חזרה לרשימת התהליכים בסטודיו. | | **AI Studio · Hermes** | הכותרת המשנית, עם שם התהליך מתחתיה. | | **התחלה מחדש** | זורק את השיחה הזו ומתחיל ריאיון חדש לאותו תהליך. תתבקשו לאשר, כי כל מה ש‑Hermes אסף יאבד. | | **שמירה ויציאה** | יוצא מהשיחה. שום דבר לא אובד — כל תשובה כבר נשמרה. אתם חוזרים לרשימת התהליכים. | אף אחד מכפתורי הכותרת אינו בונה דבר. יש בדיוק **פעולת בנייה אחת** בעמוד, והיא נמצאת בפאנל שמעל תיבת ההודעה. ### השיחה Hermes נפתח באותה ברכה בכל פעם: > שלום, אני Hermes — בונה התהליכים של AI Studio. ספרו לי בקצרה מה תרצו לבנות? ענו בשפה חופשית. אין תחביר, אין שמות בלוקים ללמוד, ואין צורך לדעת איך סטודיו עובד: > *"אני רוצה שלקוחות שכותבים לנו ב‑WhatsApp יבחרו מכירות או תמיכה, ויגיעו לצוות הנכון."* מכאן, **כל שאלה תלויה בתשובה הקודמת שלכם**. אין שאלון קבוע. אם אמרתם "מחלקות", Hermes ישאל אילו מחלקות; אם אמרתם "עגלות נטושות", הוא ישאל משהו אחר לגמרי. תוך כדי כך הוא שואל על הדברים שקובעים אילו בלוקים הוא צריך — איזו תיבה, מי מטפל במה, מה הלקוח צריך לראות, מה קורה בכל הסתעפות, מה קורה כשאף אחד לא עונה, ומתי האוטומציה צריכה להיפסק. | רכיב | מה זה | | --- | --- | | **בועת Hermes** | שאלה, אישור קצר, או הסיכום הסופי. | | **הבועה שלכם** | התשובה שלכם. | | **חושב…** | ‏Hermes מגבש את השאלה הבאה ומצייר מחדש את התהליך. זה לוקח כמה שניות. | | **תיבת ההודעה** | הקלידו את תשובתכם. **Enter** שולח; **Shift + Enter** פותח שורה חדשה. עד 2,000 תווים לתשובה. | :::tip ענו בפירוט אמיתי. *"מכירות ותמיכה"* בסדר, אבל *"מכירות ותמיכה — מחוץ לשעות הפעילות כולם הולכים לתמיכה"* חוסך ל‑Hermes שתי שאלות ומביא לכם תהליך טוב יותר. ::: ### סרגל ההתקדמות הסרגל בצד מציג מה Hermes הבין עד כה, כדי שתוכלו לתפוס אי‑הבנה מוקדם ולא בסוף. | מדור | מה הוא מציג | | --- | --- | | **התקדמות** | אחוז וסרגל — ההערכה של Hermes עצמו לגבי מידת ההתקדמות בריאיון. זהו מדד מנחה, לא ספירה לאחור. | | **מה Hermes הבין** | כל החלטה שנאספה עד כה, שורה לכל אחת. הרשימה הזו **נכתבת מחדש במלואה אחרי כל תשובה**, כך שהיא תמיד משקפת את העיצוב הנוכחי. קראו אותה. אם שורה שגויה, אמרו זאת בהודעה הבאה שלכם. | | **בלוקים עד כה** | כמה בלוקים התהליך מכיל כרגע. ‏Hermes מצייר מחדש את התהליך כולו אחרי כל תשובה, ולכן המספר הזה יכול לעלות **או לרדת**. | | **דורש את תשומת ליבכם** | דברים שתצטרכו להשלים ידנית אחרי שהתהליך ייבנה — ראו [אזהרות](#warnings). מופיע רק כשיש מה לומר. | :::note "בלוקים עד כה" הוא מונה, לא תצוגה מקדימה. את התהליך עצמו תראו על הקנבס אחרי שתבנו אותו. ::: ## עצירה והמשך מאוחר יותר הריאיון נשמר **אחרי כל תשובה בודדת**. אפשר לסגור את הלשונית בכל שאלה — באמצע משפט, באמצע הסתעפות, בסוף היום — ושום דבר לא יאבד. כדי להמשיך: 1. פתחו את **סטודיו**. 2. בכרטיס התהליך מופיע תג **⚡ המשך עם AI**. 3. לחצו על הכרטיס. השיחה נפתחת מחדש עם התמליל המלא, סרגל ההתקדמות וכל מה ש‑Hermes הבין. ![כרטיס תהליך עם ריאיון AI שלא הושלם](pathname:///img/screenshots/he/product/studio/ai/flow-card-continue.png) | היכן לוחצים | לאן מגיעים | | --- | --- | | הכרטיס עצמו, כל עוד מוצג **המשך עם AI** | חזרה לשיחה עם Hermes | | כפתור **✏️ עריכה** בכרטיס | עורך הקנבס, בכל עת | | הכרטיס עצמו, לאחר שהתהליך נבנה | עורך הקנבס, כמו בכל תהליך אחר | :::warning אם תפתחו את העורך באמצע הריאיון ותוסיפו בלוקים ידנית, Hermes יסרב לבנות מעל העבודה שלכם בהמשך — ראו [Hermes לא ידרוס את העריכות שלכם](#hermes-will-not-overwrite-your-edits). סיימו קודם את הריאיון, ואז ערכו. ::: ## בניית התהליך כאשר ל‑Hermes יש כל מה שהוא צריך, הוא אומר זאת ופאנל מופיע מעל תיבת ההודעה. ![פאנל הבנייה, עם האזהרה החד‑כיוונית](pathname:///img/screenshots/he/product/studio/ai/build-panel.png) | רכיב | מה הוא עושה | | --- | --- | | **התהליך שלכם מוכן לבנייה** | לצד מספר הבלוקים שממתינים להצבה. | | ההערה בענבר | *"זהו השלב האחרון: הבלוקים עוברים לקנבס והשיחה הזו נסגרת. כל דבר שתרצו ש‑Hermes ישנה, בקשו עכשיו."* | | **המשך שיפור** | מחזיר את הסמן לתיבת ההודעה. השתמשו בזה כדי לבקש שינוי לפני שאתם מתחייבים. | | **בנה את התהליך** | פותח את דיאלוג האישור. | ### בקשו שינויים קודם עד שתלחצו **בנה את התהליך**, שום דבר לא נכתב לקנבס ואפשר להמשיך לדבר. ‏Hermes מצייר מחדש את התהליך כולו אחרי כל תשובה, ולכן שינויים זולים: > *"הוסף הודעה לפני התפריט שאומרת שאנחנו פתוחים מ‑9 עד 5."* > > *"אם אף אחד לא בוחר מחלקה, שלח לתמיכה במקום לשאול שוב."* > > *"תקצר את הברכה."* ### האישור **בנה את התהליך** פותח דיאלוג שמפרט את שלוש ההשלכות, כי שתיים מהן חד‑כיווניות: ![דיאלוג אישור הבנייה](pathname:///img/screenshots/he/product/studio/ai/build-confirm-modal.png) | | מה זה אומר | | --- | --- | | ✅ **הבלוקים נוצרים ומחווטים עבורכם** | אפשר להזיז, לערוך, להוסיף או למחוק כל אחד מהם אחר כך. שום דבר אינו נעול. | | ✅ **התהליך נשאר טיוטה** | שום דבר אינו רץ עד ש**אתם** מפרסמים אותו מהעורך. אף לקוח אינו מושפע מלחיצה על "בנה". | | ⚠️ **זה מסיים את השיחה עם Hermes** | לא תוכלו לבקש גרסה נוספת של התהליך הזה אחר כך. מכאן והלאה אתם עורכים אותו ידנית. | לחצו **כן, בנה אותו** וסטודיו יציב את הבלוקים ויפתח את עורך הקנבס. לחצו **המשך שיפור** כדי לחזור לשיחה. ### למה הבנייה סופית ברגע שהבלוקים על הקנבס, הם שלכם. אילו Hermes היה יכול לבנות מחדש את התהליך בהמשך, הוא היה צריך להחליף כל מה ששיניתם בינתיים — ולכן במקום זאת השיחה נסגרת והעורך משתלט. תיבת ההודעה מושבתת ומציגה *"התהליך נבנה — המשיכו בעורך."* אם אתם רוצים שה‑AI יבנה תהליך אחר, צרו **תהליך חדש** והתחילו ריאיון חדש. ## אחרי ש‑Hermes בונה אתם נוחתים ב[עורך הקנבס](../studio.md#the-editor) הרגיל, עם התהליך פרוש מלמעלה למטה. ![תהליך שנבנה על ידי Hermes, על הקנבס](pathname:///img/screenshots/he/product/studio/ai/built-flow-canvas.png) הצעדים הבאים שלכם הם הצעדים הרגילים בסטודיו: 1. **קראו את הבלוקים.** לחצו על כל אחד ובדקו את ההגדרות שלו בפאנל הצדדי. ‏Hermes כותב טקסט הודעות אמיתי — התאימו אותו לשפה של המותג שלכם. 2. **נקו כל תג אזהרה.** כל מה ש‑Hermes לא הצליח למלא (הקלטה קולית שיש להעלות, תבנית WhatsApp) מציג תג ⚠ על הבלוק. ראו [אזהרות על בלוק](../studio.md#warnings-on-a-block). 3. **הרצת בדיקה.** עברו על הטיוטה עם נתוני דוגמה — שום דבר אינו מגיע ללקוחות אמיתיים. ראו [הרצת בדיקה](./publishing.md#test-run). 4. **פרסמו.** התהליך עולה לאוויר רק כשאתם לוחצים **פרסום**. ראו [פרסום](./publishing.md#publishing). :::info תהליך ש‑Hermes בנה הוא תהליך רגיל לחלוטין. היסטוריית גרסאות, השהיה וחידוש, הרצת בדיקה, משתנים שמורים ומחיקה — כולם עובדים בדיוק כמו בתהליך שציירתם ידנית. ::: ## מה Hermes יודע שני דברים, ושניהם מגיעים מהחשבון החי שלכם ולא מספריית תבניות גנרית. זו הסיבה ש‑Hermes שואל *"תמיכה או מכירות?"* בשמות התיבות האמיתיים שלכם, ושהבלוקים שהוא מייצר כבר מצביעים על הדברים הנכונים. | Hermes יודע | ולכן הוא יכול | | --- | --- | | כל בלוק בסטודיו — טריגרים, פעולות ותנאים, עם כל ההגדרות האמיתיות שלהם | לבחור את הבלוק הנכון ולמלא את המאפיינים שלו, כולל כללי הסתעפות ופורטי פלט | | את ה**תיבות** שלכם, לפי שם וסוג ערוץ | לשאול איזו תיבה, ולכתוב את התיבה האמיתית בטריגר | | את ה**נציגים** שלכם (ומי מהם נציגי AI) | לנתב לאדם מסוים, ולהימנע משליחת "המתן לנציג אנושי" לנציג AI | | את ה**צוותים** שלכם | למסור שיחה למכירות או לתמיכה לפי שם | | את ה**תוויות**, ה**טפסים** ולוחות **שעות הפעילות** שלכם | לתייג שיחות, להאזין לטופס הנכון ולהסתעף לפי שעות פתיחה | | את **אובייקטי ה‑CRM** שלכם והשדות שלהם | ליצור או לעדכן עסקה, קריאת שירות או משימה עם מפתחות השדות הנכונים | | את **התראות האנליטיקס** שלכם | להתחיל תהליך כשאחד מהספים שלכם נחצה | Hermes רואה רק את **החשבון שלכם**. הוא לעולם אינו רואה תיבות, שיחות, אנשי קשר או תהליכים של עסק אחר. ### מה Hermes אינו יכול לעשות | בלתי אפשרי | מה לעשות במקום | | --- | --- | | להעלות קובץ עבורכם — הקלטה קולית (WAV) או מדיה לתבנית WhatsApp | ‏Hermes בונה את הבלוק ומודיע לכם; אתם מצרפים את הקובץ בעורך | | לבחור תבנית WhatsApp | בחרו את התבנית המאושרת על הבלוק בעורך | | לפרסם את התהליך | אתם מפרסמים, תמיד | | לערוך תהליך שכבר יש בו בלוקים | התחילו תהליך חדש, או ערכו את הקיים ידנית | | להשתמש בתיבה, בצוות או באובייקט שלא יצרתם | צרו אותם קודם, ואז התחילו את הריאיון | ## אזהרות {#warnings} **דורש את תשומת ליבכם** בסרגל הצד מפרט כל דבר ש‑Hermes רוצה שתדעו לפני שהתהליך יוכל לעבוד. כדאי לקרוא את אותם פריטים שוב אחרי שהתהליך נבנה. | אזהרה | משמעות | מה לעשות | | --- | --- | --- | | *"…אינו אחד מהמשאבים של החשבון הזה"* | ‏Hermes התייחס לתיבה, לצוות, לנציג או לאובייקט שאינו קיים | פתחו את הבלוק על הקנבס ובחרו את הנכון מהרשימה הנפתחת | | *"…הוסרה בחירה שאינה קיימת בחשבון הזה"* | אותו דבר, עבור שדה בחירה מרובה כמו מסנן תיבות | סמנו את התיבות הנכונות על הבלוק | | *"…אינו מחובר לשום דבר ולא ירוץ"* | לבלוק אין שום דבר שמצביע אליו | חברו אותו מבלוק קודם, או מחקו אותו | | *"…להסתעפות '…' לא מחובר דבר"* | הסתעפות של תנאי או של IVR מובילה לשום מקום | חברו אותה, או קבלו את זה שהמסלול הזה פשוט מסתיים | | *"…אינו יכול לשמש בתהליך … והוסר"* | בלוק קול נחת בתהליך הודעות, או להפך | בדרך כלל כלום — ‏Hermes כבר הסיר אותו. ודאו שהתהליך עדיין עושה מה שביקשתם | | *"העלו את ה… בעורך"* | בלוק זקוק לקובץ שרק אתם יכולים לספק | פתחו את הבלוק והעלו אותו | :::note האזהרות אינן מונעות מכם לבנות. הן הרשימה הקצרה של דברים לסיים ידנית. ::: ## Hermes לא ידרוס את העריכות שלכם {#hermes-will-not-overwrite-your-edits} סטודיו מגן על עבודה שאדם עשה: | מצב | מה קורה | | --- | --- | | אתם מתחילים ריאיון על תהליך שכבר יש בו בלוקים | נדחה: *"בתהליך הזה כבר יש בלוקים. צרו תהליך חדש כדי לבנות אחד בעזרת AI."* | | אתם עורכים את הקנבס ידנית באמצע ריאיון, ואז לוחצים **בנה את התהליך** | נדחה, עם הודעה שמפנה אתכם לעורך. העריכות שלכם נשארות ללא שינוי | | אתם לוחצים **בנה את התהליך** על טיוטה שלא נגעו בה | הבלוקים מוצבים | ## מגבלות ועבודה נכונה | מגבלה | ערך | | --- | --- | | אורך תשובה אחת | 2,000 תווים | | בלוקים בתהליך ש‑Hermes בונה | עד 60 | | חיבורים בתהליך ש‑Hermes בונה | עד 120 | | שאלות בריאיון אחד | עד 60 (ריאיון רגיל הוא 6–15) | | הודעות לכל חשבון | מוגבל בקצב — אם הגעתם למגבלה, המתינו דקה והמשיכו. שום דבר לא אובד | :::tip עבודה נכונה - **תנו לתהליך שם טוב לפני שאתם מתחילים.** ‏Hermes קורא את השם ואת התיאור כרמז הראשון שלו. - **קראו את "מה Hermes הבין" תוך כדי.** תיקון אי‑הבנה בשאלה השלישית זול הרבה יותר מאשר בסוף. - **אמרו מה צריך לקרות כשדברים משתבשים** — אף אחד לא עונה, הלקוח משיב במשהו לא צפוי, השעה 2 בלילה. ‏Hermes ישאל, אבל אתם מכירים את העסק שלכם טוב יותר. - **בקשו שינויים לפני שאתם בונים**, לא אחרי. אחרי הבנייה, השינויים הם באחריותכם על הקנבס. - **תמיד הריצו בדיקה לפני פרסום**, בדיוק כמו בתהליך שנבנה ידנית. ::: ## שאלות נפוצות **האם התהליך עולה לאוויר אוטומטית?** לא. ‏Hermes תמיד מייצר **טיוטה**. שום דבר אינו רץ עד שתלחצו **פרסום** בעורך. **אפשר לערוך תהליך ש‑Hermes בנה?** כן — לחלוטין. הזיזו, נסחו מחדש, חוו מחדש, הוסיפו ומחקו כל דבר. זהו תהליך סטודיו רגיל. **אפשר לבקש מ‑Hermes לשנות תהליך שהוא כבר בנה?** לא. הבנייה סוגרת את השיחה. ערכו אותו על הקנבס, או צרו תהליך חדש והריצו ריאיון חדש. **מה קורה אם אני סוגר את הלשונית באמצע?** שום דבר לא אובד. כל תשובה נשמרת תוך כדי. פתחו את התהליך מחדש מרשימת סטודיו — מופיע עליו **⚡ המשך עם AI**. **באיזו שפה Hermes מדבר?** בשפת הממשק שלכם ב‑Teloring. הוא גם כותב את הטקסט ללקוח בתוך הבלוקים באותה שפה. אפשר לשכתב כל חלק ממנו אחר כך. **האם Hermes רואה נתונים של עסקים אחרים?** לא. הוא קורא רק את התיבות, הצוותים, הנציגים, התוויות, הטפסים, לוחות הזמנים ואובייקטי ה‑CRM של החשבון שלכם. תהליכים ושיחות מבודדים לחשבון. **האם Hermes יכול לבנות תהליכי קול (טלפון)?** כן. אמרו לו שהאוטומציה מתחילה בשיחת טלפון והוא יבנה [תהליך קול](./voice-flows.md) עם תפריטי IVR והעברות. הוא אינו יכול להקליט עבורכם את ההודעות הקוליות — העלו אותן בעורך. **לא קרה כלום כשלחצתי "בנייה בעזרת AI".** הכרטיס מושבת אלא אם **AI Studio** מופעל ב[עולם AI](../ai-world.md). כרטיס אפור מציג *"הפעילו את AI Studio כדי להשתמש בזה"* עם קישור לעמוד. **השיחה אומרת שהגיעה למגבלה.** ריאיון מוגבל ל‑60 שאלות, ולכל חשבון יש הגבלת קצב הודעות לטווח קצר. ההתקדמות שלכם נשמרת בכל מקרה — המתינו רגע והמשיכו, או פתחו את התהליך בעורך וסיימו אותו ידנית. ## לאן ממשיכים | עמוד | במה הוא עוסק | | --- | --- | | [סקירת סטודיו](../studio.md) | הקנבס, הבלוקים, הפורטים ואיך תהליך רץ | | [טריגרים — בלוקי ה‑WHEN](./triggers.md) | כל טריגר ש‑Hermes יכול לבחור בו | | [פעולות — בלוקי ה‑THEN](./actions.md) | כל פעולה, המאפיינים שלה והפלטים שלה | | [תנאים — בלוקי ה‑IF](./conditions.md) | איך ההסתעפויות ש‑Hermes מחווט באמת מחליטות | | [בדיקה, פרסום וגרסאות](./publishing.md) | מה לעשות עם התהליך ש‑Hermes בנה | | [עולם AI](../ai-world.md) | הפעלת AI Studio, וכל שאר מתגי ה‑AI | | [מתכוני תהליכים](./examples.md) | דוגמאות שנבנו ידנית, שימושיות לבדיקת העבודה של Hermes | --- # טריגרים — בלוקי ה‑WHEN מקור: https://docs.teloring.com/he/docs/product/studio/triggers Markdown: https://docs.teloring.com/he/markdown/docs/product/studio/triggers.md מדור: Studio עודכן לאחרונה: 2026-08-20T20:49:57.000Z **טריגר** הוא נקודת הכניסה של תהליך. הוא עונה על שאלה אחת: *מה צריך לקרות כדי שהתהליך הזה ירוץ?* הטריגרים נושאים את התג האלמוגי **WHEN**, יושבים במדור **טריגרים** בפאנל הצדדי, והם הבלוקים היחידים שאתם גוררים ישירות לקנבס. כל תהליך זקוק לפחות לאחד — תהליך ללא טריגר אי אפשר לפרסם. ![לוח הטריגרים של סטודיו](pathname:///img/screenshots/he/product/studio/trigger-palette.png) ## הרשימה המלאה | טריגר | מופעל כאשר | סוג התהליך | | --- | --- | --- | | [הודעה נכנסת](#incoming-message) | לקוח שולח הודעה לתיבה שנבחרה | הודעות | | [שיחה נכנסת](#incoming-call) | שיחת טלפון מגיעה לתיבת קול | **קול** | | [מילוי טופס](#form-filled) | מישהו מגיש טופס של Teloring | הודעות | | [שינוי בשיחה](#conversation-changed) | שיחה נפתחת, מסומנת כטופלה, משויכת לנציג או לצוות, מתויגת, מקבלת דגל, עדיפות או איתות AI | הודעות | | [טריגר לקוח](#customer-trigger) | לקוח ב‑CRM נוצר או נערך | הודעות | | [טריגר רשומת לקוח](#customer-record-trigger) | רשומת איש קשר או רשומת אובייקט ב‑CRM נוצרת, נערכת או נמחקת | הודעות | | [שינוי סטטוס נציג](#agent-status-changes) | נציג מתחבר או מתנתק מ‑Teloring | הודעות | | [לוח זמנים חוזר](#recurring-schedule) | מרווח זמן קבוע חולף (כל N דקות / שעות / ימים) | הודעות | | [זמן מתוזמן](#scheduled-time) | יום ושעה שבועיים מגיעים | הודעות | | [Webhook נכנס](#incoming-webhook) | מערכת חיצונית קוראת לכתובת ה‑Webhook הייחודית שלכם | הודעות | | [התראת אנליטיקס](#analytics-alert) | מדד בדוח חוצה סף שהגדרתם באנליטיקס | הודעות | ## כללים שחלים על כל טריגר - **רק תהליכים חיים מופעלים.** תהליך בטיוטה או מושהה לעולם אינו רץ על אירועים אמיתיים. השתמשו ב**הרצת בדיקה** בזמן הבנייה. - **כמה תהליכים יכולים להתאים לאירוע אחד.** אם שלושה תהליכים חיים מופעלים כולם על הודעות WhatsApp נכנסות, שלושתם ירוצו. - **לתהליך אחד יכולים להיות כמה טריגרים.** ‏סטודיו מריץ את צומת הטריגר שההגדרות שלו תואמות לאירוע — ולא פשוט את הטריגר הראשון בתהליך. כך אפשר להחזיק נקודות כניסה ייעודיות לכל ערוץ זו לצד זו באותו תהליך. - **מסנן ריק פירושו "הכול".** טריגר של הודעה נכנסת ללא תיבות שנבחרו מאזין לכל התיבות. - **כשלים בטריגר לעולם אינם שוברים את Teloring.** אם תהליך נכשל, ההודעה, השיחה או הגשת הטופס עדיין נמסרות ונשמרות כרגיל. --- ## הודעה נכנסת {#incoming-message} מופעל כאשר **הודעה חדשה מגיעה מלקוח** באחת מהתיבות שתבחרו. זהו הטריגר שמאחורי מענים אוטומטיים, צ׳אטבוטים, שאלות סינון, ניתוב לפי מילות מפתח והודעות מחוץ לשעות הפעילות. ### מאפיינים | מאפיין | מה הוא עושה | ברירת מחדל | | --- | --- | --- | | **תיבות** | סמנו את התיבות שהתהליך צריך להאזין להן. השאירו את כל התיבות לא מסומנות כדי להאזין ל**כל** התיבות. | כל התיבות | ![הגדרת טריגר הודעה נכנסת](pathname:///img/screenshots/he/product/studio/trigger-incoming-message.png) ### מתי הוא *אינו* מופעל | מצב | למה | | --- | --- | | נציג אנושי משויך לשיחה | הנציג מחזיק בשיחה; ‏סטודיו אינו מתערב. | | תהליך כבר מסר את השיחה לאדם | אותה סיבה — המסירה נשארת בתוקף עד שהשיחה מסומנת כטופלה או שתהליך מריץ **סיום סשן**. | | ההודעה יוצאת | רק הודעות נכנסות מלקוחות נספרות. | | ההודעה היא התשובה שתהליך מושהה המתין לה | היא נצרכת על ידי אותו תהליך במקום להתחיל הרצה חדשה. | ### משתנים שהוא מפיק | משתנה | מכיל | | --- | --- | | `{{message.content}}` | טקסט ההודעה | | `{{message.content_type}}` | `text`, `image`, `audio` וכן הלאה | | `{{message.id}}` | מזהה ההודעה | | `{{message.direction}}` | כיוון ההודעה | | `{{message.created_at}}` | מתי היא הגיעה | | `{{conversation.id}}` | מזהה השיחה | | `{{conversation.status}}` | סטטוס השיחה | | `{{conversation.channel_id}}` · `{{conversation.channel_type}}` | איזו תיבה ואיזה סוג ערוץ | | `{{conversation.assigned_agent_id}}` | הנציג המשויך, אם יש | | `{{conversation.custom_attributes.*}}` | [מאפייני השיחה](../conversation-attributes.md) של החשבון שלכם, כפי שכבר מולאו בשיחה הזו | | `{{contact.id}}` · `{{contact.name}}` · `{{contact.phone}}` · `{{contact.email}}` · `{{contact.company}}` | רשומת איש הקשר של הלקוח | | `{{channel.id}}` · `{{channel.name}}` · `{{channel.type}}` | התיבה שההודעה הגיעה אליה | :::tip עובד באותו אופן בכל תיבת הודעות — WhatsApp, אימייל, SMS, טלגרם, LINE, צ׳אט באתר, Messenger, פייסבוק, אינסטגרם, TikTok וה‑API למפתחים. ::: --- ## שיחה נכנסת {#incoming-call} מופעל כאשר **שיחת טלפון מגיעה** לאחד מהמספרים הקוליים שלכם. זהו הטריגר היחיד שהופך תהליך ל**תהליך קול**, מה שפותח את בלוקי הקול ומסתיר את בלוקי ההודעות. ### מאפיינים | מאפיין | מה הוא עושה | ברירת מחדל | | --- | --- | --- | | **תיבת קול** *(חובה)* | תיבת הקול או ה‑DID שהשיחות שלה מריצות את התהליך. | — | | **הקלטת השיחה** | מקליט כל שיחה שנכנסת לתהליך הזה. ההקלטה מועלית, מצורפת לשיחה כהערה פרטית ונשמרת ברשומת הלקוח ובמחסן הקבצים. | כבוי | :::note ההקלטה נשלטת **רק כאן**, בטריגר. אין פעולה נפרדת של "התחלת הקלטה". ::: ### משתנים שהוא מפיק | משתנה | מכיל | | --- | --- | | `{{call.uuid}}` | מזהה ייחודי של השיחה | | `{{call.caller_id}}` | המספר שמתקשר אליכם | | `{{call.destination}}` | המספר שאליו חייגו (ה‑DID שלכם) | | `{{call.direction}}` · `{{call.timestamp}}` | כיוון וזמן ההגעה | | `{{call.inbox_id}}` | תיבת הקול | | `{{call.contact_id}}` · `{{call.contact_name}}` | איש הקשר שהותאם (מתקשרים לא מוכרים הופכים לליד) | | `{{conversation.id}}` | רשומת השיחה שנוצרה עבור השיחה הטלפונית | | `{{contact.id}}` · `{{contact.name}}` · `{{contact.phone}}` | פרטי איש הקשר | | `{{channel.id}}` · `{{channel.type}}` | תיבת הקול | ראו [תהליכי שיחות קול](./voice-flows.md) למדריך המלא, כולל תפריטי IVR והעברות. --- ## מילוי טופס {#form-filled} מופעל כאשר מישהו **מגיש טופס של Teloring**. השתמשו בו לניתוב לידים, ליידוע צוות, ליצירת רשומות CRM או לפתיחת שיחה מטופס. ### מאפיינים | מאפיין | מה הוא עושה | ברירת מחדל | | --- | --- | --- | | **טופס** | הטופס שיש להאזין לו, או **כל הטפסים**. | כל הטפסים | ### משתנים שהוא מפיק | משתנה | מכיל | | --- | --- | | `{{form.id}}` · `{{form.name}}` · `{{form.version}}` | איזה טופס, ואיזו גרסה שלו | | `{{submission.id}}` | ההגשה | | `{{contact.id}}` | איש הקשר, כאשר הטופס קשור לאחד | | `{{conversation.id}}` | השיחה, כאשר הטופס קשור לאחת | | `{{answers.list}}` | מערך של התשובות הגלויות, כל אחת עם מזהה שדה, תווית, סוג וערך | | `{{answers}}` | התשובות כאובייקט, לפי מזהה השדה | | `{{hiddenValues}}` | ערכי שדות מוסתרים, לפי מזהה השדה המוסתר | | `{{sourceParams}}` | פרמטרים בכתובת שבה נפתח עמוד הטופס | **תשובות מדויקות לפי מזהה שדה.** אם לשדה בטופס יש מזהה השדה `email`, השתמשו ב‑`{{answers.email}}`. אם לשדה מוסתר יש המזהה `campaign_id`, השתמשו ב‑`{{hiddenValues.campaign_id}}`. אם כתובת הטופס הציבורית הייתה `?utm_source=google`, השתמשו ב‑`{{sourceParams.utm_source}}`. :::tip תנו לכל שדה בטופס מזהה שדה קריא לפני שאתם בונים את התהליך — המזהה הוא שם המשתנה. ראו [בונה הטפסים](../forms.md). ::: --- ## שינוי בשיחה {#conversation-changed} מופעל כאשר **משהו בשיחה משתנה**: היא נפתחה או סומנה כטופלה, נציג או [צוות](../teams.md) שויך או הוסר, נוספו תוויות, הדגל או העדיפות השתנו, או ש‑AI זיהה איתות. זהו הטריגר לכללי הסלמה, להתראות SLA, להתראות "הלקוח נשמע לא מרוצה" ולמעקב לאחר סגירת שיחה. ### מאפיינים כל מסנן מוגדר כברירת מחדל ל*כל*. שלבו ביניהם כדי לצמצם בדיוק לשינוי שמעניין אתכם. | מאפיין | אפשרויות | מה הוא עושה | | --- | --- | --- | | **תיבות** | כל התיבות | להגיב רק לשיחות בתיבות האלה. ריק = הכול. | | **שינוי סטטוס** | כל שינוי · שיחה נפתחה · שיחה סומנה כטופלה | לאיזה אירוע סטטוס להגיב. | | **שיוך נציג** | כל נציג · נציג שויך (כלשהו) · נציג הוסר · נציג ספציפי שויך | לאיזה אירוע שיוך להגיב. | | **נציגים ספציפיים** | בוחר נציגים | מופיע כאשר נבחר **נציג ספציפי שויך**. בחרו נציג אחד או יותר. | | **שיוך צוות** | כל צוות · צוות שויך (כלשהו) · צוות הוסר · צוות ספציפי שויך | לאיזה אירוע שיוך [צוות](../teams.md) להגיב. | | **צוותים ספציפיים** | בוחר צוותים | מופיע כאשר נבחר **צוות ספציפי שויך**. בחרו צוות אחד או יותר. | | **תוויות שנוספו** | כל תווית · תוויות ספציפיות | להגיב לכל תווית חדשה, או רק לאלה שתפרטו. | | **תוויות ספציפיות** | תווית אחת בכל שורה | מופיע כאשר נבחר **תוויות ספציפיות**. | | **דגל** | כל דגל · 🔴 אדום · 🟠 כתום · 🟡 צהוב · 🟢 ירוק · 🔵 כחול · 🟣 סגול | להגיב לצבע דגל מסוים. | | **עדיפות** | כל עדיפות · דחוף · גבוה · בינוני · נמוך | להגיב לעדיפות מסוימת. | | **איתותי AI** | כל איתות AI · זיהוי רגש · סיכון נטישה · הזדמנות מכירה | להגיב לאיתות שזוהה על ידי AI בשיחה. | ![הגדרת טריגר שינוי בשיחה](pathname:///img/screenshots/he/product/studio/trigger-conversation-changed.png) ### משתנים שהוא מפיק לצד משתני `contact.*` ו‑`channel.*` הרגילים: | משתנה | מכיל | | --- | --- | | `{{conversation.id}}` · `{{conversation.status}}` · `{{conversation.previous_status}}` | השיחה והסטטוס שלה לפני ואחרי | | `{{conversation.assigned_agent_id}}` · `{{conversation.previous_agent_id}}` | שיוך הנציג לפני ואחרי | | `{{conversation.assigned_team_id}}` · `{{conversation.assigned_team_name}}` · `{{conversation.previous_team_id}}` | שיוך [הצוות](../teams.md) לפני ואחרי, ושם הצוות הנוכחי | | `{{conversation.priority}}` · `{{conversation.previous_priority}}` | עדיפות לפני ואחרי | | `{{conversation.flag}}` · `{{conversation.previous_flag}}` | דגל לפני ואחרי | | `{{conversation.labels}}` · `{{conversation.labels_added}}` | כל התוויות, ורק אלה שנוספו בשינוי הזה | | `{{conversation.customer_emotion}}` · `{{conversation.previous_customer_emotion}}` | ציון הרגש לפני ואחרי | | `{{conversation.custom_attributes.*}}` | [מאפייני השיחה](../conversation-attributes.md) של החשבון שלכם, כפי שהם שמורים כרגע בשיחה | | `{{conversation.channel_id}}` · `{{conversation.channel_type}}` | התיבה | | `{{change.type}}` · `{{change.field}}` | איזה סוג שינוי זה היה, ואיזה שדה השתנה | | `{{ai.signal}}` · `{{ai.message}}` | איתות ה‑AI וההסבר שלו | :::info שיחה חדשה לגמרי מפעילה את הטריגר הזה עם `change.type` = `opened`, **אחרי** שהשיחה קיימת — ולכן תמיד בטוח להשתמש ב‑`{{conversation.id}}` בהמשך. ::: `{{change.type}}` מדווח על שינויי צוות בנפרד משינויי נציג: `team_assigned` ו‑`team_unassigned`, לעומת `assigned` ו‑`unassigned` עבור נציג בודד. כך תהליך יכול להגיב ל"הועבר למכירות" בלי להיות מופעל גם בכל שיוך אישי. :::tip תגובה לנציג שממלא מאפיין שיחה שמירת פאנל [מאפייני השיחה](../conversation-attributes.md) נחשבת לשינוי בשיחה, ולכן הטריגר הזה מופעל. הוסיפו אחריו [תנאי](./conditions.md) על `{{conversation.custom_attributes.outcome}}` כדי לבנות כללים כמו *"כשהתוצאה מוגדרת כהוסלמה, יידע את מנהל המשמרת"*. ::: :::note שני דברים שכדאי לדעת על מסנן הצוות - תהליכים שפורסמו **לפני** שהצוותים היו קיימים ממשיכים לעבוד ללא שינוי — **שיוך צוות** מוגדר כברירת מחדל ל*כל צוות*. - **צוות ספציפי שויך** כאשר **לא נבחר דבר לעולם אינו מופעל.** בחירה ריקה פירושה "אף צוות אינו תואם", לא "כל צוות", כך שטריגר שלא הושלם אינו יכול להיות מופעל על שיוכים שלא ביקשתם. ::: --- ## טריגר לקוח {#customer-trigger} מופעל כאשר **לקוח ב‑CRM** נוצר או נערך. ### מאפיינים | מאפיין | אפשרויות | ברירת מחדל | | --- | --- | --- | | **אירועים** | לקוח נוצר · לקוח נערך | שניהם | ### משתנים שהוא מפיק | משתנה | מכיל | | --- | --- | | `{{customer.id}}` · `{{customer.name}}` · `{{customer.email}}` · `{{customer.phone}}` | הלקוח | | `{{event.type}}` · `{{event.action}}` | מה קרה | | `{{customer.old}}` · `{{customer.new}}` | הרשומה המלאה לפני ואחרי השינוי | --- ## טריגר רשומת לקוח {#customer-record-trigger} מופעל כאשר **רשומה** תחת לקוח נוצרת, נערכת או נמחקת. זה כולל את רשומות אנשי הקשר הקבועות וכל אובייקט CRM מותאם שהחשבון שלכם הפעיל (קריאות שירות, הזמנות, הערות, חוזים — כל מה שהגדרתם). ### מאפיינים | מאפיין | אפשרויות | ברירת מחדל | | --- | --- | --- | | **פעולות** | רשומה נוצרה · רשומה נערכה · רשומה נמחקה | כל השלוש | | **סוגי אובייקט** | מזהה סוג אובייקט אחד בכל שורה. השאירו ריק עבור אנשי קשר **וגם** כל אובייקט מותאם מופעל. | ריק (הכול) | ### משתנים שהוא מפיק | משתנה | מכיל | | --- | --- | | `{{record.id}}` | הרשומה | | `{{record.schema_id}}` | לאיזה סוג אובייקט היא שייכת | | `{{record.old}}` · `{{record.new}}` | הרשומה לפני ואחרי | | `{{customer.id}}` · `{{customer.name}}` · `{{customer.email}}` · `{{customer.phone}}` | הלקוח שמחזיק בה | | `{{event.type}}` · `{{event.action}}` | מה קרה | **משתנים ברמת השדה.** השתמשו ב‑`{{record.}}` עבור שדה ברשומה שהשתנתה, וב‑`{{objects..}}` כשאתם רוצים שדה של אובייקט מסוים — למשל `{{objects.service_calls.subject}}` או `{{objects.notes.content}}`. --- ## שינוי סטטוס נציג {#agent-status-changes} מופעל כאשר **נציג מתחבר או מתנתק מ‑Teloring**. "מחובר" כאן פירושו אותה נקודה ירוקה שאתם רואים בצ׳אט הצוות — סשן חי, ולא סטטוס שהנציג בוחר. ### מאפיינים | מאפיין | אפשרויות | ברירת מחדל | | --- | --- | --- | | **סטטוס** | נציג מתחבר · נציג מתנתק | שניהם | | **נציגים** | בחרו נציגים ספציפיים, או השאירו ריק לכל הנציגים. | כל הנציגים | נציגי AI לעולם אינם נכללים — אין להם סשן. ### משתנים שהוא מפיק | משתנה | מכיל | | --- | --- | | `{{agent.id}}` · `{{agent.name}}` · `{{agent.email}}` | מי | | `{{agent.status}}` · `{{agent.previous_status}}` | הסטטוס החדש והקודם | | `{{agent.changed_at}}` | מתי | **שימושים טובים:** יידוע מנהל כשהנציג האחרון מתנתק, הוספת הערה פרטית כשנציג התורנות מתחבר, או ניתוב מחדש של שיחות ממתינות בהחלפת משמרת. --- ## לוח זמנים חוזר {#recurring-schedule} מריץ את התהליך **שוב ושוב במרווח זמן קבוע** — המקבילה בסטודיו למשימת cron. ### מאפיינים | מאפיין | מה הוא עושה | ברירת מחדל | | --- | --- | --- | | **כל** | כמה יחידות בין הרצות (1–1440). | 1 | | **יחידה** | דקות · שעות · ימים | דקות | | מגבלה | ערך | | --- | --- | | המרווח הקצר ביותר | דקה אחת | | המרווח הארוך ביותר | 24 שעות (ערך ב**ימים** מוגבל ליום אחד) | ### משתנים שהוא מפיק | משתנה | מכיל | | --- | --- | | `{{schedule.triggered_at}}` | מתי ההרצה הזו התחילה | | `{{schedule.interval_seconds}}` | המרווח המוגדר בשניות | :::caution תהליך חוזר רץ בפני עצמו, ללא שיחה מצורפת. בלוקים שברירת המחדל שלהם היא `{{conversation.id}}` נשארים ללא נתונים, אלא אם תספקו מזהה שיחה בעצמכם — בדרך כלל מבקשת HTTP או ממשתנה שמור. ::: --- ## זמן מתוזמן {#scheduled-time} מריץ את התהליך לפי **לוח זמנים שבועי** — שורה אחת או יותר של יום ושעה, לכל אחת אזור זמן משלה. ### מאפיינים | מאפיין | מה הוא עושה | | --- | --- | | **זמנים** | רשימת שורות לוח זמנים. לכל שורה יש **יום בשבוע**, **שעה** ו**דקה** (בפורמט 24 שעות) ו**אזור זמן**. הוסיפו כמה שורות שתצטרכו. | השתמשו בשורה אחת עבור "כל יום שני ב‑09:00", או בשבע שורות עבור "כל יום ב‑08:00". שורות שונות יכולות להשתמש באזורי זמן שונים, מה ששימושי לצוותים הפרוסים בין אזורים. ![הגדרת טריגר זמן מתוזמן](pathname:///img/screenshots/he/product/studio/trigger-scheduled-time.png) ### משתנים שהוא מפיק | משתנה | מכיל | | --- | --- | | `{{schedule.triggered_at}}` | מתי ההרצה הזו התחילה | | `{{schedule.day_of_week}}` · `{{schedule.hour}}` · `{{schedule.minute}}` | השורה שהופעלה | | `{{schedule.timezone}}` | אזור הזמן של אותה שורה | --- ## Webhook נכנס {#incoming-webhook} נותן לתהליך **כתובת ציבורית משלו**. כשמערכת חיצונית קוראת לכתובת הזו, התהליך רץ — כשגוף הבקשה, מחרוזת השאילתה והכותרות זמינים כמשתנים. השתמשו בו כדי להתחיל תהליך מהאתר שלכם, ממערכת החיובים שלכם, ממערכת CRM, מפלטפורמת הזמנות, מ‑Zapier/Make, או מכל שירות שיכול לשלוח בקשת HTTP. ### מאפיינים | מאפיין | מה הוא עושה | ברירת מחדל | | --- | --- | --- | | **כתובת Webhook** | הכתובת הייחודית של הטריגר הזה, מוכנה להעתקה. כל צומת טריגר מקבל כתובת משלו. | נוצרת | | **שיטות מותרות** | אילו שיטות HTTP מתקבלות: GET, POST, PUT, PATCH, DELETE. | POST | | **למידת הבקשה הבאה** | לוכד את הבקשה **הבאה** שתגיע וזוכר את המבנה שלה. | מופעל | | **משתנים שנלמדו** | צ׳יפים לקריאה בלבד שמציגים כל משתנה שסטודיו מצא במטען שנלמד. | ריק | ![הגדרת טריגר Webhook נכנס](pathname:///img/screenshots/he/product/studio/trigger-webhook.png) ### איך מגדירים אחד 1. הוסיפו את הטריגר **Webhook נכנס** והעתיקו את הכתובת שלו. 2. השאירו את **למידת הבקשה הבאה** מופעלת. 3. שלחו בקשה **אמיתית** אחת מהמערכת החיצונית לכתובת הזו — בדיוק את הבקשה שאתם מתכוונים להשתמש בה בייצור. 4. ‏סטודיו לוכד אותה. העורך מתעדכן מעצמו: **למידת הבקשה הבאה** נכבית והצ׳יפים של **משתנים שנלמדו** מופיעים. 5. גררו את המשתנים האלה לבלוקים שאחריו. ### אחרי הלמידה לאחר שפורמט נלמד, סטודיו מקבל רק בקשות שתואמות לו: אותה שיטה, אותו סוג תוכן, אותו סוג גוף, ומפתחות השאילתה והגוף הנדרשים. כל דבר אחר נדחה, מה שמונע מקריאה פגומה או לא קשורה להריץ את התהליך שלכם. כדי לקבל מבנה שונה, הפעילו מחדש את **למידת הבקשה הבאה** ושלחו את הבקשה החדשה. ### משתנים שהוא מפיק | משתנה | מכיל | | --- | --- | | `{{webhook.method}}` | GET,‏ POST, … | | `{{webhook.content_type}}` | סוג התוכן של הבקשה | | `{{webhook.sender_ip}}` · `{{webhook.host}}` · `{{webhook.user_agent}}` | מי קרא, ואיך | | `{{webhook.body}}` | הגוף כולו | | `{{webhook.query}}` | מחרוזת השאילתה כאובייקט | | `{{webhook.headers}}` | הכותרות כאובייקט | בנוסף, משתנה אחד לכל שדה שנמצא במטען שנלמד — למשל `{{webhook.body.order_id}}` או `{{webhook.query.token}}`. :::caution כתובת ה‑Webhook היא ציבורית ובלתי ניתנת לניחוש. התייחסו אליה כאל סיסמה: אל תפרסמו אותה, והחליפו אותה (על ידי מחיקת הטריגר והוספת חדש) אם היא דלפה. ::: --- ## התראת אנליטיקס {#analytics-alert} מופעל כאשר **מדד בדוח חוצה סף** שהגדרתם באנליטיקס — למשל "שיחות פתוחות מעל 50", "זמן מענה ראשון ממוצע מעל 10 דקות" או "CSAT מתחת ל‑4". ### מאפיינים | מאפיין | מה הוא עושה | | --- | --- | | **התראות לניטור** *(חובה)* | סמנו התראה אחת או יותר שיצרתם באנליטיקס. פרסום תהליך **חי** שמפנה אליהן מפעיל את הניטור שלהן. | אם הרשימה ריקה, צרו קודם התראה מתוך דוח ב[אנליטיקס](../analytics.md). ### שני פלטים ![טריגר התראת אנליטיקס עם שני הפלטים מחוברים](pathname:///img/screenshots/he/product/studio/trigger-analytics-alert.png) | פלט | מופעל כאשר | | --- | --- | | **התראה** | המדד חצה את הסף. | | **התאוששות** | המדד חזר לנורמה. חיבור הפלט הזה אופציונלי. | ההתראה מופעלת **פעם אחת בכל חצייה**. כל עוד המדד נשאר מעבר לקו הוא לא יופעל שוב — אתם מקבלים התראה אחת, ואז התאוששות אחת, ולא הודעה בכל דקה. ### משתנים שהוא מפיק | משתנה | מכיל | | --- | --- | | `{{alert.name}}` | שם ההתראה | | `{{alert.report_title}}` · `{{alert.report_type}}` | הדוח שמאחוריה | | `{{alert.current_value}}` · `{{alert.threshold}}` | הערך כעת, והקו שנחצה | | `{{alert.direction}}` | `above` או `below` | | `{{alert.series}}` | איזו סדרה או קטגוריה חצתה, בדוחות מקובצים | | `{{alert.state}}` | `in_alert` או `normal` | | `{{alert.event}}` | `alert` או `recovered` | | `{{alert.crossed_at}}` | מתי הייתה החצייה | | `{{alert.id}}` · `{{alert.report_id}}` · `{{alert.dashboard_id}}` | מזהים, לבניית קישורים | :::caution **מחיקת התראה משביתה את התהליכים שמשתמשים בה.** אם התראה (או הדוח שמאחוריה) נמחקת, כל תהליך שמפנה אליה מקבל תג אזהרה על הכרטיס שלו ומושהה אם היה חי. בחרו התראה אחרת ופרסמו מחדש כדי לנקות זאת. ::: ## הבא - [פעולות — בלוקי ה‑THEN](./actions.md) — מה לעשות אחרי שטריגר מופעל. - [משתנים](./variables.md) — שימוש בכל מה שטריגר הפיק. - [מתכוני תהליכים](./examples.md) — דוגמאות מלאות לכל טריגר. --- # פעולות — בלוקי ה‑THEN מקור: https://docs.teloring.com/he/docs/product/studio/actions Markdown: https://docs.teloring.com/he/markdown/docs/product/studio/actions.md מדור: Studio עודכן לאחרונה: 2026-08-20T20:49:57.000Z **פעולה** היא שלב ש*עושה משהו*: שולח הודעה, מעדכן שיחה, כותב ל‑CRM שלכם, קורא ל‑API חיצוני, שולח אימייל, או ממיר ערך עבור הבלוק הבא. הפעולות נושאות את התג הטורקיז **THEN**. אתם מוסיפים אותן מבורר הבלוקים: גררו מחבר מכל בלוק ושחררו אותו על קנבס ריק. ## הרשימה המלאה | פעולה | קבוצה | מה היא עושה | | --- | --- | --- | | [מענה בהודעה](#reply-message) | שיחות | שולחת הודעה ללקוח, ויכולה להשהות את התהליך עד שהוא ישיב. | | [הערה פרטית](#private-note) | שיחות | מוסיפה הערה פנימית שהלקוח לעולם אינו רואה. | | [שינוי שיחה](#change-conversation) | שיחות | מוסרת לאדם, לצוות או לתור ההמתנה; מתייגת, קובעת עדיפות, מסמנת כטופל, משנה שם ומגדירה מאפייני שיחה. | | [סיום סשן](#end-session) | שיחות | משחררת את השיחה מסטודיו, ואופציונלית מסמנת אותה כטופלה. | | [המתנה](#wait) | זרימה | משהה את המסלול הזה ל‑1–15 שניות. | | [שמירה כמשתנה](#save-as-variable) | זרימה | שומרת ערך לצמיתות תחת `var.*` עבור הרצות עתידיות. | | [עדכון איש קשר](#contact-update) | CRM | כותבת לשדות ברשומת איש הקשר. | | [רשומת לקוח](#customer-record) | CRM | יוצרת או מעדכנת רשומת אובייקט ב‑CRM תחת לקוח. | | [בקשת HTTP](#http-request) | חיצוני | קוראת ל‑API חיצוני, ואופציונלית לוכדת את התגובה. | | [שליחת אימייל](#send-email) | חיצוני | שולחת אימייל מתיבה או מהשולח המערכתי של Teloring. | | [קוד](#code) | כלים | מריצה טרנספורמציית JavaScript קטנה בסביבה מבודדת. | | [תאריך ושעה](#date-and-time) | כלים | מקבלת, מעצבת, מוסיפה, מחסירה, משווה, מחלצת או מעגלת תאריכים. | | [שליחת התראת Teloring](#send-teloring-notification) | כלים | מתריעה לנציגים בתוך Teloring — פעמון, צליל, אימייל ודחיפה בדפדפן. | | [השמעת צליל](./voice-flows.md#play-sound) | קול | משמיעה הקלטה למתקשר. | | [המתנה / השהיה](./voice-flows.md#wait--pause) | קול | משהה את השיחה לרגע קצר. | | [תפריט IVR](./voice-flows.md#ivr-menu) | קול | משמיעה תפריט ומנתבת לפי ספרה במקלדת. | | [העברה לנציג](./voice-flows.md#forward-to-agent) | קול | מצלצלת לנציג בדפדפן ומגשרת את השיחה. | | [העברה לטלפון חיצוני](./voice-flows.md#forward-to-external-phone) | קול | מעבירה את השיחה למספר חיצוני. | | [ניתוק](./voice-flows.md#hang-up) | קול | מסיימת את השיחה. | בלוקי הסתעפות — **תנאי If/Else**, **שעות פעילות**, **זמינות נציגים** — נושאים את תג הענבר **IF** ומתועדים ב[תנאים](./conditions.md). ## דברים שנכונים לכל פעולה - **שדות טקסט מקבלים משתנים.** הקלידו `{{` או גררו משתנה ממדור **המשתנים הזמינים**. ראו [משתנים](./variables.md). - **פלטים הופכים למשתנים.** כל מה שפעולה מפיקה זמין לכל בלוק שאחריה. - **התפצלות מריצה הכול.** אם מפעולה יוצאים שלושה מחברים, כל שלושת המסלולים רצים. - **פעולה שנכשלת עוצרת את המסלול שלה בלבד**, לא את כל התהליך — הסתעפויות אחרות ממשיכות. --- ## מענה בהודעה {#reply-message} שולחת הודעה ללקוח בשיחה, בדיוק כאילו נציג הקליד אותה. היא יוצאת בערוץ שבו השיחה מתנהלת — WhatsApp, אימייל, SMS, טלגרם, צ׳אט באתר וכן הלאה. זה גם הבלוק שהופך תהליך לשיחה: הפעילו את **המתנה לתשובת הלקוח** והתהליך יושהה עד שהלקוח ישיב. *תהליכי הודעות בלבד.* ### מאפיינים | מאפיין | מה הוא עושה | ברירת מחדל | | --- | --- | --- | | **מזהה השיחה** | לאיזו שיחה לשלוח. השאירו את ברירת המחדל כדי להשיב בשיחה שהפעילה את התהליך. | `{{conversation.id}}` | | **הודעה** *(חובה)* | הטקסט לשליחה. השתמשו במשתנים להתאמה אישית. | ריק | | **המתנה לתשובת הלקוח** | משהה את המסלול הזה עד שהלקוח משיב. התשובה שלו הופכת ל‑`{{message.content}}` החדש וזמינה גם כ‑`{{client_reply.content}}`. | כבוי | | **פסק זמן להמתנה (דקות)** | כמה זמן להמתין לפני ויתור. **0 פירושו ללא פסק זמן** — התהליך ממשיך להמתין. בכל מקרה Teloring מחזיקה תהליך ממתין עד 30 יום. מופיע רק כשההמתנה מופעלת. | 0 | ![הגדרת מענה בהודעה](pathname:///img/screenshots/he/product/studio/action-reply-message.png) ### פלטים | משתנה | מכיל | | --- | --- | | `{{reply.message_id}}` | ההודעה שנשלחה | | `{{reply.conversation_id}}` | לאן היא נשלחה | | `{{reply.sent_at}}` | מתי | | `{{reply.status}}` | סטטוס השליחה | | `{{client_reply.content}}` | מה הלקוח השיב (כשיש המתנה) | | `{{client_reply.content_type}}` | סוג התשובה | | `{{client_reply.message_id}}` · `{{client_reply.received_at}}` | הודעת התשובה וחותמת הזמן | ### איך ההמתנה מתנהגת - כל עוד התהליך ממתין, השיחה נשארת בתור **בוט סטודיו**. - תשובת הלקוח נצרכת על ידי התהליך הממתין — היא **אינה** מתחילה הרצה שנייה של אותו תהליך. - לאחר ההמתנה, אפשר לבדוק את התשובה גם עם `{{message.content}}` וגם עם `{{client_reply.content}}`; שניהם מכילים את אותו טקסט. - אם תנאי שאחרי המתנה אינו תואם לאף הסתעפות ואין הסתעפות ELSE, התהליך ממשיך להמתין באותו תנאי ומעריך אותו מחדש בהודעה הבאה של הלקוח. הוסיפו הסתעפות ELSE, או בלוק [סיום סשן](#end-session), כדי שלקוח לעולם לא ייתקע בתוך התהליך. - אם פסק הזמן פג, ההרצה מסתיימת בסטטוס `timed_out`. :::tip שאלו שאלה אחת בכל מענה בהודעה. שתי שאלות בהודעה אחת מקבלות תשובה אחת, ולתנאי שלכם אין מה להתאים בצורה נקייה. ::: --- ## הערה פרטית {#private-note} מוסיפה **הערה פנימית** לשיחה. היא מופיעה בציר הזמן של השיחה עבור הנציגים ולעולם אינה נשלחת ללקוח, בשום ערוץ. ### מאפיינים | מאפיין | מה הוא עושה | ברירת מחדל | | --- | --- | --- | | **מזהה השיחה** | איזו שיחה מקבלת את ההערה. | `{{conversation.id}}` | | **הערה פרטית** | טקסט ההערה. משתנים נתמכים. | ריק | ### פלטים | משתנה | מכיל | | --- | --- | | `{{private_note.message_id}}` | ההערה | | `{{private_note.conversation_id}}` | לאן היא נוספה | | `{{private_note.created_at}}` · `{{private_note.status}}` | מתי, ומה התוצאה | **שימושים טובים:** לתעד מה בוט אסף לפני המסירה, להדביק סטטוס הזמנה שנמשך מ‑API, או להשאיר את הסיבה להסלמת שיחה. --- ## שינוי שיחה {#change-conversation} מעדכנת את השיחה — והכי חשוב, זה המקום שבו אתם **מוסרים אותה לאדם**: לנציג ספציפי, ל[צוות](../teams.md) שלם או לתור ההמתנה. ### מאפיינים | מאפיין | אפשרויות | מה הוא עושה | | --- | --- | --- | | **מזהה השיחה** | טקסט / משתנה | איזו שיחה לעדכן. ברירת המחדל היא `{{conversation.id}}`. | | **התערבות אנושית** | מופעל / כבוי | מוסר את השיחה לאדם. ‏סטודיו מפסיק להחזיק בה, כך שההודעה הבאה מהלקוח מגיעה לנציג ולא חזרה לתהליך. | | **מסירה אל** | תור ההמתנה (הנציג הפנוי הבא) · נציג ספציפי · צוות | מופיע כשההתערבות האנושית מופעלת. | | **נציג** | בוחר נציגים | מופיע כשמוסרים לנציג ספציפי. | | **צוות** | בוחר צוותים | מופיע כשמוסרים ל[צוות](../teams.md). הסימן `⚡` מציין צוות שמשייך אוטומטית לחבר מחובר; המספר בסוגריים הוא כמות הנציגים בו. | | **מצב תוויות** | הוספת תוויות · החלפת תוויות · הסרת תוויות | איך התוויות שלמטה מוחלות. | | **תוויות** | תווית אחת בכל שורה | התוויות להוספה, לקביעה או להסרה. | | **עדיפות** | ללא שינוי · נמוכה · בינונית · גבוהה · דחופה | קובע את עדיפות השיחה. | | **סטטוס** | ללא שינוי · פתוחה · ממתינה · טופלה | קובע את סטטוס השיחה. | | **דגל** | ללא שינוי · ללא · חשוב · למעקב | קובע את דגל השיחה. | | **נושא** | טקסט / משתנה | משנה את שם השיחה. | | **מאפייני שיחה** | בוחר מאפיינים + ערך | מגדיר את [מאפייני השיחה](../conversation-attributes.md) של החשבון שלכם בשיחה הזו. בחרו את המאפיין, הקלידו את הערך — משתנים מותרים. ראו למטה. | ![הגדרת שינוי שיחה](pathname:///img/screenshots/he/product/studio/action-conversation-update.png) ### פלטים | משתנה | מכיל | | --- | --- | | `{{conversation.status}}` | תוצאת העדכון | | `{{conversation.updated_fields}}` | אילו שדות השתנו | | `{{conversation.handover}}` | `queue`,‏ `agent`,‏ `team` או ריק | | `{{conversation.handover_agent_id}}` | הנציג שאליו נמסרה — במסירה לצוות, החבר ששויך אוטומטית, או ריק אם היא ממתינה בתור | | `{{conversation.handover_team_id}}` | [הצוות](../teams.md) שאליו נמסרה | | `{{conversation.handover_team_name}}` | שם הצוות הזה | | `{{conversation.custom_attributes}}` | כל מאפייני השיחה, כאובייקט אחד | | `{{conversation.custom_attributes.}}` | מאפיין בודד — למשל `{{conversation.custom_attributes.reason_for_contact}}` | ### הגדרת מאפייני שיחה {#setting-conversation-attributes} [מאפייני שיחה](../conversation-attributes.md) הם השדות של החשבון שלכם על שיחה — *סיבת הפנייה*, *תוצאה*, *מספר הזמנה*. הם נמצאים בבלוק הזה ולא בבלוק נפרד, כי הם שדות של השיחה בדיוק כמו עדיפות ונושא. לחצו **הוספת שדה** תחת **מאפייני שיחה**, בחרו מאפיין ותנו לו ערך. הערך מקבל משתנים, כך שתהליך יכול לסווג שיחה לפי מה שהוא כבר יודע: | התהליך | מגדיר | | --- | --- | | תפריט שואל "במה מדובר?" | *סיבת הפנייה* = הכפתור שהלקוח לחץ | | טופס פותח את השיחה | *מספר הזמנה* = `{{answers.order_number}}` | | [בקשת HTTP](#http-request) מאתרת את הלקוח | *רמת החשבון* = `{{http.json.tier}}` | | הבוט מסמן את השיחה כטופלה בעצמו | *תוצאה* = `נפתר על ידי הבוט` | | כלל | התנהגות | | --- | --- | | הערכים מאומתים | ערך שאינו אחת מהאפשרויות ברשימה נפתחת **מכשיל את הבלוק**, כך שתהליך לעולם לא יכתוב משהו שפאנל הנציג יסרב להציג. | | מאפיינים שנמחקו מדולגים | מאפיין שהוסר מההגדרות אחרי שהתהליך נבנה נדחה, והבלוק ממשיך לרוץ. | | מאפיינים אחרים נשמרים | הגדרת מאפיין אחד לעולם אינה מנקה את השאר. | | בחירה מרובה | הפרידו ערכים בפסיקים או בשורות חדשות. | הבלוק מפיק את הערכים ה**חדשים**, כך שכל בלוק שאחריו — ובראשם בקשת HTTP — רואה את מה שנכתב זה עתה. המאפיינים זמינים גם מהטריגר, בלי הבלוק הזה, ב**הודעה נכנסת**, ב**שיחה נכנסת** וב**שינוי בשיחה**. ראו [משתנים](./variables.md#conversation-attributes). ### להבין את ההתערבות האנושית | הגדרה | מה קורה | | --- | --- | | **כבויה** | רק התוויות, העדיפות, הסטטוס, הדגל והנושא משתנים. ‏סטודיו ממשיך להחזיק בשיחה והודעות מאוחרות יותר עדיין מריצות את התהליך. | | **מופעלת ← נציג ספציפי** | השיחה משויכת לאותו נציג ויוצאת מתור בוט סטודיו. אם השיחה הייתה בצוות שהנציג אינו חבר בו, הצוות מנוקה. | | **מופעלת ← צוות** | הצוות מקבל בעלות. אם הצוות משייך אוטומטית לנציג מחובר, אחד מחבריו המחוברים מקבל אותה מיד; אחרת היא ממתינה בתור ו**רק חברי הצוות הזה** יכולים למשוך אותה עם **קבלת הבא בתור**. שיחה שטופלה נפתחת מחדש תחילה. | | **מופעלת ← תור ההמתנה** | השיחה מוסרת מכל שיוך ונשלחת לתור **ממתינות בתור** עבור מי שיתפנה הבא. שיחה שטופלה נפתחת מחדש תחילה, כי שיחה שטופלה אינה יכולה להמתין בתור. | בכל מקרה, המסירה **נשארת בתוקף**: הודעות מאוחרות יותר בשיחה הזו לא יימשכו בחזרה לתהליך הזה — ולא לשום תהליך חי אחר. המסירה מנוקה אוטומטית כשהשיחה מסומנת כטופלה, כששיחה משויכת לנציג ספציפי, או כשתהליך מריץ [סיום סשן](#end-session). :::warning שני דברים לבדוק במסירה לצוות - **בחרו את הצוות.** אם **מסירה אל** מוגדר ל**צוות** אך לא נבחר צוות, המסירה נופלת חזרה לתור ההמתנה הרגיל. העורך מסמן את הבלוק בזמן העריכה. - **מחיקת צוות שוברת את הבלוק.** אם הצוות שנבחר נמחק בהמשך, הבלוק **נכשל** בזמן ריצה במקום להחנות את השיחה בצוות שכבר אינו קיים. סקרו את התהליכים החיים שלכם אחרי מחיקת צוות. ::: :::tip לכל תהליך שמדבר עם לקוחות צריך להיות מסלול לאדם. חברו הסתעפות של "אני רוצה לדבר עם מישהו", או הסתעפות גיבוי, לבלוק שינוי שיחה עם **התערבות אנושית** מופעלת. ::: --- ## סיום סשן {#end-session} מסיימת את מעורבות סטודיו בשיחה. ההודעה הבאה מאותו לקוח מתחילה התאמת טריגרים מאפס, כאילו התהליך מעולם לא רץ. ### מאפיינים | מאפיין | מה הוא עושה | ברירת מחדל | | --- | --- | --- | | **מזהה השיחה** | איזו שיחה לשחרר. | `{{conversation.id}}` | | **לסמן גם את השיחה כטופלה?** | מסמנת גם את השיחה כטופלה. | כבוי | ### פלטים | משתנה | מכיל | | --- | --- | | `{{session.status}}` | תוצאה | | `{{session.conversation_id}}` | השיחה | | `{{session.resolved}}` | האם היא גם סומנה כטופלה | ### סיום סשן מול התערבות אנושית | השתמשו ב | מתי | | --- | --- | | **סיום סשן** | הבוט סיים את תפקידו. אף אחד מסוים לא צריך לפעול, וההודעה ה*באה* צריכה להיות מסוגלת להתחיל תהליך שוב. | | **שינוי שיחה ← התערבות אנושית** | אדם או צוות צריכים לקחת את השיחה הזו עכשיו. | --- ## המתנה {#wait} משהה את **המסלול הזה** בתהליך למספר שניות לפני ההמשך. השתמשו בה כדי לפזר הודעות, כך שבוט יישמע פחות רובוטי. *תהליכי הודעות בלבד. תהליכי קול משתמשים ב[המתנה / השהיה](./voice-flows.md#wait--pause).* ### מאפיינים | מאפיין | מה הוא עושה | ברירת מחדל | | --- | --- | --- | | **משך ההמתנה (שניות)** | בין שנייה אחת ל‑15 שניות. | 3 | ### פלטים | משתנה | מכיל | | --- | --- | | `{{wait.seconds}}` | כמה זמן הוא המתין | :::info ההמתנה מעכבת רק את ההסתעפות שהיא יושבת עליה. אם הטריגר מזין גם הסתעפות אחרת, ההסתעפות ההיא רצה מיד — היא אינה ממתינה בתור אחרי ההמתנה. ::: --- ## שמירה כמשתנה {#save-as-variable} שומרת ערך **לצמיתות**, כך שהרצות מאוחרות יותר של אותו תהליך יוכלו לקרוא אותו בחזרה. משתנים רגילים חיים רק להרצה אחת; משתנה שמור שורד אותה. ### מאפיינים | מאפיין | מה הוא עושה | ברירת מחדל | | --- | --- | --- | | **מפתח המשתנה** | השם שתחתיו לשמור. תמיד בתוך מרחב השמות `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-update} כותבת לשדות ברשומת איש הקשר — האדם, לא החברה. ### מאפיינים | מאפיין | מה הוא עושה | ברירת מחדל | | --- | --- | --- | | **מזהה איש הקשר** | איזה איש קשר לעדכן. | `{{contact.id}}` | | **שדות לעדכון** | שורות של שדה ← ערך. שם השדה הוא **רשימה נפתחת של שדות איש הקשר שהחשבון שלכם באמת הגדיר** בעורך השדות. שדה שכבר בשימוש בשורה אחת נעלם מהרשימות האחרות. הערכים תומכים במשתנים. | ריק | ### פלטים | משתנה | מכיל | | --- | --- | | `{{contact.status}}` | תוצאה | | `{{contact.updated_fields}}` | אילו שדות נכתבו | :::note שדות מערכת מוגנים אינם ניתנים לכתיבה על ידי תהליך. אם שדה שאתם מצפים לו חסר ברשימה, הוסיפו אותו קודם ב**עורך השדות** של איש הקשר — ראו [CRM ולקוחות](../crm.md). ::: --- ## רשומת לקוח {#customer-record} יוצרת או מעדכנת **רשומת אובייקט ב‑CRM** תחת לקוח — קריאת שירות, הזמנה, הערה, חוזה, או כל אובייקט אחר שהחשבון שלכם הגדיר. ### מאפיינים | מאפיין | אפשרויות | מה הוא עושה | | --- | --- | --- | | **פעולה** | הוספת רשומה חדשה · עריכת רשומה קיימת | האם ליצור או לעדכן. | | **מזהה הלקוח** | טקסט / משתנה | לאיזה לקוח הרשומה שייכת. ברירת המחדל היא `{{customer.id}}`. | | **סוג האובייקט** *(חובה)* | רשימה נפתחת של אובייקטי ה‑CRM המופעלים בחשבון | איזה אובייקט הרשומה הזו. **רשימת השדות שלמטה נגזרת מהבחירה הזו.** | | **מזהה הרשומה** | טקסט / משתנה | איזו רשומה לערוך. מופיע רק עבור **עריכת רשומה קיימת**. | | **שדות הרשומה** | שורות של שדה ← ערך | הרשימה הנפתחת מציגה את השדות האמיתיים של סוג האובייקט שנבחר. מושבתת עד שנבחר סוג אובייקט. הערכים תומכים במשתנים. | ![הגדרת רשומת לקוח](pathname:///img/screenshots/he/product/studio/action-customer-record.png) ### פלטים | משתנה | מכיל | | --- | --- | | `{{record.status}}` | `created` או `updated` | | `{{record.id}}` | הרשומה | | `{{record.schema_id}}` | סוג האובייקט | | `{{record.customer_id}}` | הלקוח | הערכים מאומתים מול הגדרות השדות של האובייקט לפני שנכתב משהו, כך שערך שגוי מכשיל את הבלוק במקום להשחית את הרשומה. :::tip יצירת רשומה כאן מפעילה את [טריגר רשומת הלקוח](./triggers.md#customer-record-trigger). זה שימושי לשרשור תהליכים — אבל היזהרו מתהליך שמפעיל את עצמו. ::: --- ## בקשת HTTP {#http-request} שולחת נתונים למערכת חיצונית, או מושכת נתונים ממנה. זהו הגשר הכללי בין 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](pathname:///img/screenshots/he/product/studio/action-http-request.png) ### לכידת התגובה — מופעל או כבוי? | הגדרה | התנהגות | השתמשו כאשר | | --- | --- | --- | | **כבוי** | שגר ושכח. הבקשה נכנסת לתור ונשלחת ברקע; התהליך ממשיך מיד. | אתם מיידעים מערכת חיצונית ואינכם זקוקים לתשובתה. | | **מופעל** | התהליך ממתין לתגובה וחושף אותה כמשתנים. | אתם זקוקים לתשובה — סטטוס הזמנה, מחיר, מזהה לקוח. | ### פלטים | משתנה | מכיל | | --- | --- | | `{{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 {#variables-in-a-json-body} סטודיו מודע לטיפוסים כשהוא ממלא גוף JSON: - משתנה שממלא **ערך שלם** — כתוב חשוף (`"answers": {{answers.list}}`) או כמחרוזת שלמה במרכאות (`"answers": "{{answers.list}}"`) — שומר על טיפוס ה‑JSON האמיתי שלו. מערכים נשארים מערכים, מספרים נשארים מספרים, אובייקטים נשארים אובייקטים. - משתנה **בתוך מחרוזת ארוכה יותר** (`"greeting": "שלום {{contact.name}}!"`) מוחלף כטקסט, עם מרכאות ותווים מיוחדים שעברו בריחה בטוחה. - משתנה שאין לו ערך נשאר כפי שהוא. העורך מאמת את ה‑JSON תוך כדי ההקלדה. ‏JSON לא תקין צובע את התיבה באדום ומוסיף תג אזהרה על הבלוק; אפשר להמשיך לערוך, אבל תקנו לפני הפרסום. ### אבטחה סטודיו קורא רק לכתובות **ציבוריות** ב‑`http://` וב‑`https://`. כתובות localhost, רשתות פרטיות, loopback,‏ link-local וכתובות מטא‑דאטה של ספקי ענן חסומות, כך שתהליך לעולם אינו יכול לשמש כדי להגיע לתוך התשתית. --- ## שליחת אימייל {#send-email} שולחת אימייל. זו שליחה נקייה — היא **אינה** יוצרת שיחה, איש קשר או הודעה בציר הזמן של תיבה כלשהי, כך שאפשר לשלוח אימייל למנהל, לספק או לכתובת פנימית בלי לזהם תיבה. ### מאפיינים | מאפיין | אפשרויות | מה הוא עושה | | --- | --- | --- | | **שליחה מ** | אחת מתיבות האימייל שלי · השולח המערכתי של Teloring | ממי האימייל מגיע. | | **תיבת אימייל** | רשימה נפתחת של תיבות אימייל מחוברות | מופיעה עבור אפשרות התיבה. כל תיבת אימייל מחוברת יכולה לשלוח — גם תיבות שיחות וגם תיבות לשליחה בלבד. | | **שולח מערכתי** | הודעה לקריאה בלבד | מופיעה עבור אפשרות המערכת, ומציגה את הכתובת שתשמש. | | **אל** *(חובה)* | טקסט / משתנה | כתובת אחת או יותר. ברירת המחדל היא `{{contact.email}}`. | | **CC** · **BCC** · **כתובת למענה** | טקסט / משתנה | אופציונלי. | | **נושא** *(חובה)* | טקסט / משתנה | שורת הנושא. | | **פורמט הגוף** | טקסט רגיל · HTML | איך הגוף נכתב. | | **גוף** *(חובה)* | אזור טקסט | תוכן האימייל. משתנים נתמכים. | | **כותרות מותאמות** | שורות מפתח/ערך | כותרות טכניות אופציונליות. ‏`X-Teloring-Flow`, ‏`X-Campaign`, ‏`X-Priority` ו‑`List-Unsubscribe` מוצעות כערכים מוכנים. | ![הגדרת שליחת אימייל](pathname:///img/screenshots/he/product/studio/action-send-email.png) ### פלטים | משתנה | מכיל | | --- | --- | | `{{email.status}}` | `sent`,‏ `failed` או `test` | | `{{email.message_id}}` | ההודעה שנשלחה | | `{{email.from}}` · `{{email.to}}` · `{{email.subject}}` | מה נשלח, ולמי | | `{{email.provider}}` | איזה שירות מסר אותו | | `{{email.error}}` | השגיאה, אם נכשל | ### נמענים ומגבלות - השדות **אל**, **CC**, **BCC** ו**כתובת למענה** מקבלים כמה כתובות מופרדות בפסיקים, בנקודה‑פסיק או בשורות חדשות, ומזהים את התבנית `Name `. - כל כתובת מאומתת וכפילויות מוסרות. לכל היותר **25 נמענים** בסך הכול. - לכל היותר **10** כותרות מותאמות. כותרות מיעון ושרשור (From, To, Cc, Bcc, Reply-To, Subject, Message-ID, Content-Type, …) נקבעות בשדות שלמעלה ואינן ניתנות לדריסה כאן. - בכל פורמט גוף שתבחרו, נשלחים גם חלק טקסט וגם חלק HTML, כך שהאימייל מוצג נכון בכל מקום. :::caution תשובות ל**שולח המערכתי של Teloring** אינן חוזרות אל Teloring. אם אתם רוצים לקבל תשובות, שלחו מאחת מהתיבות שלכם או הגדירו **כתובת למענה**. ::: :::note **הרצת בדיקה** מזהה את השולח ומאמתת הכול, אך אינה שולחת דבר. הבלוק מדווח `email.status` = `test`. ::: --- ## קוד {#code} מריצה טרנספורמציית **JavaScript** קטנה ומחזירה ערך לבלוקים שאחריה. השתמשו בה לדברים ששדה טקסט אינו יכול לעשות: ניקוי מספר טלפון, פיצול שם, עיצוב מחדש של מזהה, בחירת פריט אחד מתוך רשימה. ### מאפיינים | מאפיין | מה הוא עושה | | --- | --- | | **קוד JavaScript** *(חובה)* | הקוד להרצה. הוא **חייב** להחזיר ערך באמצעות `return`. | בלוקים חדשים מתחילים עם דוגמה עובדת: ```javascript const phone = "{{contact.phone}}"; const cleanNumber = phone.replace(/^\+/, ''); return cleanNumber; ``` ### קריאת משתנים שתי דרכים, שתיהן תקינות: ```javascript // 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](#http-request). --- ## תאריך ושעה {#date-and-time} מחשבת ומעצבת תאריכים. כל פעולה מודעת לאזור זמן. ### מאפיינים | מאפיין | אפשרויות | מה הוא עושה | | --- | --- | --- | | **פעולה** | קבלת התאריך/השעה הנוכחיים · הוספת זמן · החסרת זמן · עיצוב תאריך · חילוץ חלק · זמן בין תאריכים · עיגול תאריך | מה לחשב. | | **תאריך קלט** | טקסט / משתנה | התאריך לעבוד עליו, בפורמט ISO. **השאירו ריק עבור "עכשיו".** | | **תאריך שני** | טקסט / משתנה | התאריך השני. מופיע עבור **זמן בין תאריכים**. | | **כמות** | מספר | כמה להוסיף או להחסיר. מופיע עבור **הוספה** ו**החסרה**. | | **יחידה** | שניות · דקות · שעות · ימים · שבועות | היחידה עבור הכמות. | | **חלק** | תאריך · שעה · שנה · חודש · יום · שעה · דקה · יום בשבוע | איזה חלק לחלץ. מופיע עבור **חילוץ חלק**. | | **פורמט** | טקסט | תבנית הפלט, למשל `%Y-%m-%d %H:%M:%S`. מופיע עבור **עיצוב תאריך**. | | **אזור זמן** | טקסט | אזור הזמן שבו החישוב מתבצע. ברירת המחדל היא `Asia/Jerusalem`. | ### פלטים | משתנה | מכיל | | --- | --- | | `{{datetime.status}}` | תוצאה | | `{{datetime.result}}` | הערך המחושב | | `{{datetime.result_text}}` | הערך כטקסט | | `{{datetime.date}}` · `{{datetime.time}}` | חלק התאריך וחלק השעה | | `{{datetime.timestamp}}` | חותמת זמן Unix | **שימושים טובים:** לחשב תאריך מעקב בעוד שלושה ימים, לעצב חותמת זמן להודעה ללקוח, או למדוד כמה זמן שיחה פתוחה לפני שמחליטים להסלים. --- ## שליחת התראת Teloring {#send-teloring-notification} מתריעה לנציגים **בתוך Teloring** — פעמון ההתראות, צליל, אימייל ודחיפה בדפדפן. השתמשו בה לכל דבר ששני סוגי ההתראות המובנים אינם מכסים: ליד חדש, סף באנליטיקס, ‏SLA שעומד להיפרץ, הגשת טופס, לקוח VIP שכותב. זהו החצי הגמיש של [ההתראות](../notifications.md). עמוד הפרופיל מגיע עם שני סוגים מוכנים ("שיחה שויכה אליי" ו"הגיעה הודעה חדשה"), כך שנציג שלעולם אינו פותח את סטודיו עדיין מקבל משהו שימושי. כל מה שמעבר לכך נבנה כאן. :::info התהליך בוחר מה ולמי. הנמען בוחר איך. הבלוק הזה קובע את ה**טקסט** ואת ה**נמענים**. הוא לעולם אינו קובע איך ההתראה מגיעה אליהם — זה נשאר אצל כל נציג, בפרופיל שלו. נציג שהפעיל רק את הפעמון מקבל רשומה בפעמון. עמית שנמצא באותה התראה והפעיל את כל ארבע השיטות מקבל צליל, אימייל, דחיפה *וגם* רשומה בפעמון. נציג שההתראות שלו כבויות — או ש**התראות סטודיו** שלו כבויות — אינו מקבל דבר, והתהליך ממשיך כרגיל. ::: ### מאפיינים | מאפיין | אפשרויות | מה הוא עושה | | --- | --- | --- | | **שליחה אל** *(חובה)* | נציגים ספציפיים · הנציג המשויך לשיחה הזו · כל חברי צוות | מי מקבל התראה. | | **נציגים** | רשימת סימון של נציגים | מופיעה עבור *נציגים ספציפיים*. נציגים אנושיים בלבד — לנציג AI אין תיבה לקבלת התראות. | | **צוות** | רשימה נפתחת של צוותים | מופיעה עבור *כל חברי צוות*. כל חבר מקבל התראה. | | **מזהה השיחה** | טקסט / משתנה | מופיע עבור *הנציג המשויך לשיחה הזו*. ברירת המחדל היא `{{conversation.id}}`. | | **הודעה** *(חובה)* | אזור טקסט | הטקסט שהנציגים רואים. משתנים נתמכים — `איש קשר חדש {{contact.name}} נוצר!` | | **פרטים נוספים** | אזור טקסט | שורה שנייה אופציונלית, שמוצגת ברשימת הפעמון, באימייל ובדחיפה בדפדפן. | | **לחיצה על ההתראה פותחת** | את השיחה מהתהליך הזה · כלום — טקסט בלבד · עמוד ספציפי ב‑Teloring | לאן ההתראה מקשרת. | | **עמוד ב‑Teloring** | טקסט / משתנה | מופיע עבור אפשרות העמוד הספציפי. נתיב בתוך Teloring, כמו `/dashboard/customers`. | ![הגדרת שליחת התראת Teloring](pathname:///img/screenshots/he/product/studio/action-notify-agents.png) ### פלטים | משתנה | מכיל | | --- | --- | | `{{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 שניות. :::note **הרצת בדיקה** מזהה את הנמענים ואת הטקסט ומאמתת הכול, אך אינה מתריעה לאיש. הבלוק מדווח `notification.status` = `test_mode`. בדיקת תהליך לעולם אינה מצלצלת לנציגים אמיתיים. ::: ### דוגמה — יידוע צוות המכירות על ליד חדש 1. **טריגר:** שינוי לקוח ← *נוצר* 2. **תנאי:** If/Else ← `{{customer.new.lifecycle_stage}}` שווה ל‑`lead` 3. **ואז:** שליחת התראת Teloring - **שליחה אל:** כל חברי צוות ← *מכירות* - **הודעה:** `ליד חדש: {{customer.new.name}}` - **פרטים נוספים:** `טלפון {{contact.phone}} · מקור {{customer.new.source}}` - **לחיצה על ההתראה פותחת:** עמוד ספציפי ב‑Teloring ← `/dashboard/customers` כל חבר בצוות המכירות שהפעיל **התראות סטודיו** מקבל התרעה, כל אחד בשיטות שהוא בחר. ## הבא - [תנאים — בלוקי ה‑IF](./conditions.md) — לשלוח את התהליך למסלול הנכון. - [משתנים](./variables.md) — מדריך המשתנים המלא. - [מתכוני תהליכים](./examples.md) — הפעולות האלה בתוך תהליכים שלמים. --- # תנאים — בלוקי ה‑IF מקור: https://docs.teloring.com/he/docs/product/studio/conditions Markdown: https://docs.teloring.com/he/markdown/docs/product/studio/conditions.md מדור: Studio עודכן לאחרונה: 2026-08-20T20:49:57.000Z **תנאי** מחליט לאיזה כיוון התהליך ממשיך. הוא נושא את תג הענבר **IF** ויש לו **פורט פלט אחד לכל תוצאה**, כך שאפשר לחבר מסלול שונה לכל אחת. בסטודיו יש שלושה בלוקי תנאי: | בלוק | על מה הוא שואל | פלטים | | --- | --- | --- | | [תנאי If/Else](#condition-ifelse) | האם הערך הזה תואם לכלל שלי? | פורט אחד לכל הסתעפות IF, ובנוסף ELSE אופציונלי | | [שעות פעילות](#business-hours) | האם אנחנו פתוחים עכשיו? | **פתוח** · **סגור** | | [זמינות נציגים](#agent-availability) | האם מישהו מחובר כדי לקחת את זה? | **מחובר** · **מנותק** | שלושתם מופיעים בקבוצת **זרימה** בבורר הבלוקים, ושלושתם עובדים גם בתהליכי הודעות וגם בתהליכי קול. ![תהליך שמסתעף לפי תנאי](pathname:///img/screenshots/he/product/studio/condition-branches-canvas.png) --- ## תנאי If/Else {#condition-ifelse} מנתב את התהליך על ידי השוואת ערך לכלל. כל כלל שתוסיפו הופך לפורט פלט משלו, עם תווית. ### מאפיינים | מאפיין | אפשרויות | מה הוא עושה | | --- | --- | --- | | **מצב התאמה** | ההתאמה הראשונה בלבד · כל ההסתעפויות התואמות | מה לעשות כשיותר מכלל אחד תואם. | | **הסתעפויות IF** | רשימת כללים | כל שורה היא הסתעפות אחת. ראו למטה. | | **הוספת הסתעפות ELSE** | מופעל / כבוי | מוסיף פורט "תופס הכול" עבור כל מה שלא תאם לדבר. | | **תווית ה‑ELSE** | טקסט | השם שמוצג מתחת לפורט ה‑ELSE. ברירת המחדל היא *כל השאר*. | ### מבנה של כלל לכל שורת IF ארבעה חלקים: | חלק | מה שמים בו | | --- | --- | | **תווית ההסתעפות** | שם קצר — `מכירות`, `תמיכה`, `VIP`. הוא הופך לתווית הפורט על הקנבס, אז כדאי שיהיה קריא. | | **ערך / משתנה** | הדבר שנבדק, כתוב כמפתח משתנה פשוט: `message.content`,‏ `client_reply.content`,‏ `http.json.status`. | | **אופרטור** | איך להשוות. ראו את הטבלה למטה. | | **השוואה כ** | טקסט · מספר · בוליאני · משתנה — איך לקרוא את הצד הימני. | | **השוואה מול** | מול מה להשוות: מילה, מספר, `true`, או משתנה אחר. | ![הגדרת תנאי If/Else](pathname:///img/screenshots/he/product/studio/condition-if-else.png) ### אופרטורים | אופרטור | נכון כאשר | הערות | | --- | --- | --- | | **שווה ל** | שני הערכים זהים | | | **אינו שווה ל** | הם שונים | | | **מכיל** | הטקסט מהצד השני מופיע בכל מקום בערך | אינו רגיש לאותיות גדולות/קטנות | | **אינו מכיל** | הוא אינו מופיע | אינו רגיש לאותיות גדולות/קטנות | | **מתחיל ב** | הערך מתחיל בטקסט | אינו רגיש לאותיות גדולות/קטנות | | **מסתיים ב** | הערך מסתיים בטקסט | אינו רגיש לאותיות גדולות/קטנות | | **גדול מ** | שמאל > ימין | מספרים בלבד; ערך שאינו מספרי לעולם אינו תואם | | **גדול או שווה** | שמאל ≥ ימין | מספרים בלבד | | **קטן מ** | שמאל < ימין | מספרים בלבד | | **קטן או שווה** | שמאל ≤ ימין | מספרים בלבד | | **קיים** | הערך קיים ואינו ריק | **השוואה מול** נדחה | | **אינו קיים** | הערך חסר או ריק | **השוואה מול** נדחה | :::tip `מכיל` הוא סוס העבודה לתשובות של לקוחות — אנשים מקלידים "מכירות בבקשה" ו"אני צריך מכירות", לא "מכירות". השתמשו ב‑`שווה ל` רק כשאתם שולטים בערך, למשל קוד תגובת HTTP או ספרה בתפריט IVR. ::: ### מצב התאמה | מצב | התנהגות | | --- | --- | | **ההתאמה הראשונה בלבד** | הכללים נבדקים מלמעלה למטה; הראשון שתואם מנצח ורק ההסתעפות שלו רצה. סדרו את הכללים מהספציפי ביותר לכללי ביותר. | | **כל ההסתעפויות התואמות** | כל כלל שתואם מריץ את ההסתעפות שלו, במקביל. | הסתעפות ה‑**ELSE** רצה רק כשאף כלל IF לא תאם כלל. ### פורטים של הסתעפויות כל כלל IF מוסיף פורט מתחת לבלוק, עם תווית של שם ההסתעפות; ‏ELSE מוסיף פורט נוסף. גררו מחבר מכל פורט למה שאמור לקרות במסלול הזה. פורט שתשאירו לא מחובר פשוט מסיים את המסלול — וזו דרך לגיטימית לחלוטין לומר "אל תעשה כלום במקרה הזה". ### תנאים אחרי המתנה כשתנאי יושב אחרי **מענה בהודעה** עם *המתנה לתשובת הלקוח* מופעלת, הוא נבדק מול תשובת הלקוח. גם `{{message.content}}` וגם `{{client_reply.content}}` מכילים את התשובה הזו. :::caution אם תנאי שאחרי המתנה אינו תואם לדבר **ואין לו הסתעפות ELSE**, התהליך נשאר מוחנה בתנאי ומעריך אותו מחדש בהודעה הבאה של הלקוח. זה שימושי עבור "תמשיך לשאול עד שהוא יבחר אפשרות תקינה", אבל זה אומר שלקוח יכול להיתקע בלולאה לנצח. תמיד תנו לו דרך החוצה: הסתעפות ELSE, מסירה לאדם, או בלוק [סיום סשן](./actions.md#end-session). ::: --- ## שעות פעילות {#business-hours} מנתב את התהליך לפי **לוח זמנים בעל שם** שהגדרתם בהגדרות — שעות פתיחה שבועיות באזור זמן שנבחר, עם לוחות חגים אופציונליים. ### מאפיינים | מאפיין | מה הוא עושה | | --- | --- | | **לוח זמנים** *(חובה)* | בחרו אחד מלוחות שעות הפעילות של החשבון. | ### פלטים | פורט | רץ כאשר | | --- | --- | | **פתוח** | השעה הנוכחית נמצאת בתוך שעות הפתיחה של הלוח. | | **סגור** | היא מחוץ להן, או שהיום הוא חג בלוח שהלוח מתחשב בו. | | משתנה | מכיל | | --- | --- | | `{{business_hours.status}}` | `open` או `closed` | | `{{business_hours.schedule_id}}` | איזה לוח נבדק | | `{{business_hours.timezone}}` | אזור הזמן של הלוח | ### הערות - נעשה שימוש ב**אזור הזמן של הלוח עצמו**, לא של הלקוח ולא של הדפדפן. לצוות בתל אביב ולצוות בלונדון יכול להיות לוח משלהם באותו חשבון. - הלוחות נוצרים ב**הגדרות ← שעות פעילות**. לחשבונות חדשים אין לוחות — צרו את אלה שאתם באמת צריכים. ראו [הגדרות](../settings.md). - אפשר להשתמש באותו לוח בכל מספר של תהליכים. שנו את השעות פעם אחת וכל התהליכים יעקבו. **שימושים טובים:** מענה אוטומטי מחוץ לשעות הפעילות בערוצי הודעות, והסתעפות "אנחנו סגורים, השאירו הודעה" בתהליך טלפוני. --- ## זמינות נציגים {#agent-availability} שואל האם מישהו **מחובר ל‑Teloring כרגע** — אותה נקודה ירוקה שאתם רואים בצ׳אט הצוות. זו בדיקת סשן חי, ולא סטטוס שהנציג קובע. ### מאפיינים | מאפיין | אפשרויות | מה הוא עושה | | --- | --- | --- | | **בדיקה** | נציגים ספציפיים · כל אחד בחשבון | על מי להסתכל. | | **נציגים לבדיקה** *(חובה עבור ספציפיים)* | בוחר נציגים | הנציגים שההסתעפות הזו תלויה בהם. | | **נחשב מחובר כאשר** | לפחות נציג אחד שנבחר מחובר · כל הנציגים שנבחרו מחוברים | כמה מחמירה הבדיקה. מופיע עבור **נציגים ספציפיים**. | ![הגדרת זמינות נציגים](pathname:///img/screenshots/he/product/studio/condition-agent-availability.png) ### פלטים | פורט | רץ כאשר | | --- | --- | | **מחובר** | הבדיקה עברה. | | **מנותק** | הבדיקה לא עברה. | | משתנה | מכיל | | --- | --- | | `{{availability.status}}` | `online` או `offline` | | `{{availability.online_count}}` · `{{availability.offline_count}}` · `{{availability.checked_count}}` | המספרים שמאחורי התשובה | | `{{availability.online_ids}}` · `{{availability.offline_ids}}` | אילו נציגים | | `{{availability.first_online_id}}` · `{{availability.first_online_name}}` | "מישהו שיכול לקחת את זה", בנוחות | ### שני כללים שכדאי להכיר - **בחירה ריקה לעולם אינה "כולם".** אם **בדיקה** מוגדרת ל*נציגים ספציפיים* ולא נבחר אף נציג, התוצאה היא **מנותק** והבלוק מציג אזהרה. זה בכוונה: בלוק שלא הושלם לא צריך להתנהג בשקט כמו *כל אחד בחשבון* ולעבור רק כי עמית לא קשור במקרה מחובר. - **נציגי AI לעולם אינם נחשבים מחוברים.** אין להם סשן, ולכן נציג AI שזמין תמיד אינו יכול לספק הסתעפות של זמינות אנושית. הם גם אינם מופיעים בבוחר. :::tip `{{availability.first_online_name}}` שימושי להודעה כמו `מחברים אתכם אל {{availability.first_online_name}}…` ממש לפני מסירת השיחה. ::: ## הבא - [פעולות — בלוקי ה‑THEN](./actions.md) — מה כל הסתעפות יכולה לעשות. - [משתנים](./variables.md) — מה אפשר לבדוק בכלל. - [מתכוני תהליכים](./examples.md) — הסתעפות בתוך תהליכים שלמים. --- # סטודיו מקור: https://docs.teloring.com/he/docs/product/studio Markdown: https://docs.teloring.com/he/markdown/docs/product/studio.md מדור: Studio עודכן לאחרונה: 2026-08-20T20:49:57.000Z **סטודיו** הוא בונה התהליכים הוויזואלי של Teloring. אתם מציירים תהליך על קנבס — *כשקורה זה, עשה את זה* — ו‑Teloring מריצה אותו אוטומטית, מסביב לשעון, עבור כל שיחה, שיחת טלפון, טופס, לוח זמנים או אירוע חיצוני שתפנו אותו אליו. כמעט כל פעולה שאדם מבצע שוב ושוב ב‑Teloring אפשר להעביר לסטודיו: ברכה להודעת WhatsApp חדשה, שתי שאלות מסננות וניתוב התשובה לצוות הנכון, פתיחת תפריט IVR לשיחות טלפון, דחיפת ליד חדש למערכת CRM חיצונית, שליחת אימייל למנהל כשדוח חוצה סף, או תיוג וסגירה של שיחות לפי לוח זמנים. סטודיו בנוי משלושה סוגי בלוקים: | תג | סוג הבלוק | על איזו שאלה הוא עונה | | --- | --- | --- | | **WHEN** | [טריגר](./studio/triggers.md) | מה מתחיל את התהליך הזה? | | **THEN** | [פעולה](./studio/actions.md) | מה Teloring צריכה לעשות? | | **IF** | [תנאי](./studio/conditions.md) | לאיזה כיוון התהליך צריך להמשיך? | אתם מחברים את הבלוקים בקווים, לוחצים **פרסום**, והתהליך חי. ![עורך התהליכים של סטודיו של Teloring](pathname:///img/screenshots/he/product/studio/flow-editor.png) ## שתי דרכים לבנות תהליך אפשר לבנות כל תהליך ידנית או בעזרת AI. אתם בוחרים בזמן היצירה. | דרך | איך זה עובד | מדריך | | --- | --- | --- | | **אבנה בעצמי** | אתם גוררים בלוקים לקנבס ומגדירים אותם בעצמכם. | העמוד הזה | | **בנייה בעזרת AI** | אתם עונים על ריאיון קצר בשפה חופשית ו‑**Hermes** בונה את התהליך עבורכם. | [בניית תהליך בעזרת AI](./studio/ai-flow-builder.md) | שתי הדרכים מייצרות את אותו דבר: תהליך טיוטה רגיל שאפשר לערוך ולפרסם. בנייה בעזרת AI דורשת את המתג **AI Studio** ב[עולם AI](./ai-world.md). ## עובדות מרכזיות | עובדה | משמעות | | --- | --- | | כל תהליך מתחיל בטריגר | תהליך ללא בלוק **WHEN** לעולם לא יוכל לרוץ ואי אפשר לפרסם אותו. | | טיוטה וגרסה חיה נפרדות | העריכה לעולם אינה נוגעת בגרסה הרצה. רק **פרסום** עושה זאת. | | לתהליך אחד יכולים להיות כמה טריגרים | למשל טריגר אחד של הודעה נכנסת ל‑WhatsApp ואחד לטלגרם, באותו תהליך. רק הטריגר שתואם לאירוע האמיתי רץ. | | בלוקים יכולים להסתעף ולהתפצל | בלוק אחד יכול להזין כמה בלוקים. כל המסלולים המחוברים רצים. | | סטודיו מכבד נציגים אנושיים | אם נציג אנושי מחזיק בשיחה, סטודיו אינו מתערב בה כלל. | | ערכים זורמים קדימה כמשתנים | כל דבר שבלוק קודם הפיק אפשר לשתול בבלוק מאוחר יותר בתור `{{a.variable}}`. | | שני סוגי תהליכים | **תהליכי קול** (שמתחילים בשיחה נכנסת) ו**תהליכי הודעות** (כל השאר). לכל אחד יש בלוקים משלו. | | מבודד לחשבון | תהליכים, משתנים והרצות שייכים לחשבון אחד ולעולם אינם גלויים לחשבון אחר. | | בדקו לפני שאתם מפרסמים | **הרצת בדיקה** מריצה את הטיוטה עם נתוני דוגמה ואינה שולחת דבר ללקוחות אמיתיים. | | AI יכול לבנות את הטיוטה הראשונה | כאשר **AI Studio** מופעל, [Hermes](./studio/ai-flow-builder.md) מראיין אתכם ופורש את התהליך כולו. מה שהוא מייצר הוא טיוטה רגילה שאתם עורכים ומפרסמים בעצמכם. | ## מי משתמש בסטודיו | תפקיד | שימוש אופייני | | --- | --- | | מנהלי חשבון | בונים ומפרסמים תהליכים, מחברים Webhooks ומערכות חיצוניות, מנהלים משתנים שמורים וגרסאות. | | מנהלי צוותים | מעצבים ניתוב, התנהגות לפי שעות פעילות, הסלמה וכללי מעקב. | | נציגים | נהנים מהתוצאות — שיחות מסוננות מראש, תוויות נכונות, תורים משויכים אוטומטית והערות פרטיות עם הקשר. | ## מושגי יסוד ### תהליך **תהליך** הוא אוטומציה אחת: קנבס שמחזיק בלוקים ואת הקווים ביניהם. לתהליכים יש שם, תיאור אופציונלי וסטטוס (**טיוטה**, **חי** או **מושהה**). ### בלוק **בלוק** הוא שלב אחד. לכל בלוק יש: - **תג** — WHEN,‏ THEN או IF — וצבע שתואם לו; - **פורט קלט** בחלק העליון (למעט טריגרים, שמתחילים את התהליך); - **פורט פלט** אחד או יותר בחלק התחתון; - פאנל **הגדרות** בצד שבו קובעים את המאפיינים שלו; - **משתני פלט** שהוא מעביר לכל בלוק שנמצא אחריו. | תג | צבע | משמעות | | --- | --- | --- | | **WHEN** | אלמוגי | טריגר — נקודת הכניסה | | **THEN** | טורקיז | פעולה — עושה משהו | | **IF** | ענבר | תנאי — בוחר מסלול | | **NOTE** | ענבר | פתק — הערה לצוות שלכם, לעולם אינו מורץ | ### חיבור קו מ**פורט הפלט** של בלוק אחד אל **פורט הקלט** של הבלוק הבא. הקו מציג את כיוון התנועה באמצעות זרימה מקווקוות ומונפשת. לבלוקים עם יותר מפלט אחד — תנאי, תפריט IVR, העברה לנציג, התראת אנליטיקס — יש פורט אחד לכל תוצאה, עם תווית מתחתיו. חברו כל תוצאה למה שאמור לקרות אחריה; פורט שתשאירו לא מחובר פשוט מסיים את המסלול הזה. ### תהליכי הודעות מול תהליכי קול ברגע שאתם מניחים טריגר **שיחה נכנסת** על הקנבס, התהליך הופך ל**תהליך קול** וספריית הבלוקים משתנה: | סוג התהליך | מתחיל ב | בלוקים זמינים | | --- | --- | --- | | **תהליך הודעות** | כל טריגר למעט שיחה נכנסת | מענה בהודעה, המתנה, וכל בלוק כללי | | **תהליך קול** | שיחה נכנסת | השמעת צליל, תפריט IVR, המתנה / השהיה, העברה לנציג, העברה לטלפון חיצוני, ניתוק, וכל בלוק כללי | סטודיו מסתיר בלוקים שאינם בתחום מהבורר, מסמן אותם על הקנבס אם תהליך מכיל כזה בכל זאת, ומסרב לפרסם תהליך שמערבב ביניהם. ראו [תהליכי שיחות קול](./studio/voice-flows.md). ## רשימת התהליכים בסטודיו פתחו את **סטודיו** מסרגל הצד כדי לראות את כל התהליכים בחשבון. ![רשימת התהליכים בסטודיו של Teloring](pathname:///img/screenshots/he/product/studio/flow-list.png) | פקד | השתמשו בו כדי | | --- | --- | | **תהליך חדש** | ליצור תהליך. תתבקשו לתת שם, תיאור אופציונלי, ולבחור אם לבנות בעצמכם או בעזרת AI. | | **חיפוש** | לסנן את הרשימה לפי שם התהליך. | | **הכול / טיוטה / חי / מושהה** | לסנן לפי סטטוס. | | **כרטיס תהליך** | לחצו בכל מקום על הכרטיס כדי לפתוח את התהליך. | | **תחתית הכרטיס** | מציגה מתי התהליך נוצר, מתי נערך לאחרונה ומי ערך אותו. | | **תג ⚡ המשך עם AI** | לתהליך יש [ריאיון Hermes](./studio/ai-flow-builder.md) שלא הושלם. לחיצה על הכרטיס פותחת מחדש את השיחה במקום את הקנבס; כפתור **עריכה** עדיין פותח את הקנבס. | | **עריכה / מחיקה** | פעולות שורה. המחיקה עובדת על כל תהליך, כולל תהליך חי — עליכם להקליד את שם התהליך לאישור. ראו [מחיקת תהליך](./studio/publishing.md#deleting-a-flow). | | **תג אזהרה** | מופיע כשתהליך תלוי במשהו שכבר אינו קיים (למשל התראת אנליטיקס שנמחקה). התהליך מושהה אוטומטית עד שתתקנו ותפרסמו מחדש. | ### יצירת התהליך הראשון שלכם 1. לחצו **תהליך חדש**. 2. תנו לו שם ברור וספציפי — `WhatsApp — מענה אוטומטי מחוץ לשעות הפעילות` עדיף על `תהליך 3`. 3. הוסיפו תיאור, כדי שחברי הצוות שלכם יידעו מה הוא עושה. 4. בחרו **איך תרצו לבנות אותו?** — **אבנה בעצמי** או **בנייה בעזרת AI**. אחת מהשתיים היא חובה; הכפתור נשאר מושבת עד שתבחרו. בחירה ב‑AI פותחת את [ריאיון Hermes](./studio/ai-flow-builder.md) במקום את הקנבס. 5. לחצו **יצירת תהליך**. העורך נפתח על קנבס ריק. 6. גררו **טריגר** מהפאנל הצדדי אל הקנבס. 7. גררו מחבר מפורט התחתון של הטריגר ושחררו אותו על קנבס ריק — **בורר הבלוקים** נפתח. 8. בחרו פעולה, הגדירו אותה בפאנל הצדדי, וחזרו על כך. 9. **הרצת בדיקה**, ואז **פרסום**. ![בחירת אופן הבנייה של תהליך חדש](pathname:///img/screenshots/he/product/studio/ai/new-flow-choose-mode.png) ## העורך {#the-editor} ![מבנה העורך של סטודיו](pathname:///img/screenshots/he/product/studio/editor-anatomy.png) ### הסרגל העליון | פקד | מה הוא עושה | | --- | --- | | **←** | חזרה לרשימת התהליכים. | | **שם התהליך** | לחצו כדי לשנות שם. נשמר עם התהליך. | | **תג הסטטוס** | טיוטה, חי או מושהה. | | **מחוון השמירה** | מציג *שומר…*, *נשמר*, *לא נשמר* או *השמירה נכשלה*. | | **הרצת בדיקה** | מריצה את הטיוטה עם נתוני דוגמה. שום דבר אינו מגיע ללקוחות אמיתיים. | | **⚙ הגדרות התהליך** | מתג שמירה אוטומטית, **השהיה / חידוש התהליך**, ורשימת המשתנים השמורים `var.*`. | | **תגית השמירה האוטומטית** | מציגה אם השמירה האוטומטית מופעלת או כבויה. | | **💾 שמירה עכשיו** | שומרת את הטיוטה מיד (`Cmd/Ctrl+S`). | | **פרסום** | הופכת את הטיוטה הנוכחית לגרסה החיה. | ### הפאנל הצדדי — ספריית הבלוקים הפאנל הצדדי מחזיק את שני הדברים שאתם גוררים לקנבס: - **WHEN — טריגרים.** כל טריגר שזמין לחשבון. - **NOTE — כלי עורך.** ה**פתק**. מתחתיהם, סרגל **הגרסה** מציג את מספר הגרסה הנוכחי ואת זמן השמירה האחרון. לחצו עליו כדי לפתוח את [היסטוריית הגרסאות](./studio/publishing.md#version-history). :::tip פעולות ותנאים **אינם** בפאנל הצדדי. אתם מוסיפים אותם מבורר הבלוקים, שנפתח כשגוררים מחבר מבלוק ומשחררים אותו על קנבס ריק. כך כל בלוק חדש כבר מחובר לזה שלפניו. ::: ### הוספת פעולה או תנאי 1. הצביעו על הפורט התחתון של בלוק קיים. 2. גררו קו ושחררו אותו על קנבס ריק. 3. **בורר הבלוקים** נפתח. 4. הקלידו ב**חיפוש בכל הבלוקים…** כדי לחפש בכל הבלוקים בבת אחת לפי שם, תיאור או קבוצה, או עיינו בקבוצות ופתחו אחת כדי לראות את הבלוקים שלה. 5. לחצו על בלוק. הוא נוצר על הקנבס, כבר מחובר. ![בורר הבלוקים של סטודיו](pathname:///img/screenshots/he/product/studio/block-picker.png) הבלוקים מאורגנים בשש קבוצות: | קבוצה | מה יש בה | | --- | --- | | **שיחות** | מענה בהודעה, הערה פרטית, שינוי שיחה, סיום סשן | | **זרימה** | תנאי If/Else, שעות פעילות, זמינות נציגים, המתנה, שמירה כמשתנה | | **CRM** | עדכון איש קשר, רשומת לקוח | | **קול** | השמעת צליל, המתנה / השהיה, תפריט IVR, העברה לנציג, העברה לטלפון חיצוני, ניתוק | | **חיצוני** | בקשת HTTP, שליחת אימייל | | **כלים** | קוד, תאריך ושעה | הבורר מציג תמיד רק בלוקים שחוקיים בתהליך הנוכחי — תהליך הודעות לעולם אינו מציג בלוקי קול, ותהליך קול לעולם אינו מציג מענה בהודעה או המתנה. ### הקנבס | מחווה | תוצאה | | --- | --- | | גרירת קנבס ריק | הזזת התצוגה. | | גלגלת העכבר | הגדלה והקטנה. | | גרירת בלוק | הזזתו. | | לחיצה על בלוק | בחירתו ופתיחת המאפיינים שלו. | | גרירה מפורט פלט אל פורט קלט | חיבור שני בלוקים. | | ריחוף מעל חיבור ולחיצה על **✂** | ניתוק שני הבלוקים. שניהם נשארים על הקנבס. | | לחיצה על חיבור | בחירתו. | בסרגל התחתון יש הגדלה והקטנה, אחוז התצוגה, **התאמה לתצוגה**, **ביטול**, **ביצוע מחדש**, **שכפול הנבחר** ו**מחיקת הנבחר**. **מפה מוקטנת** בפינה מציגה את התהליך כולו ואת המיקום שלכם בתוכו. :::note אי אפשר לחבר שום דבר *אל תוך* טריגר — טריגרים תמיד מתחילים מסלול. גם פתק אי אפשר לחבר לשום דבר. ::: ### פאנל המאפיינים בחרו בלוק כלשהו והפאנל הצדדי יתמלא בהגדרות שלו. ![פאנל המאפיינים של סטודיו](pathname:///img/screenshots/he/product/studio/properties-panel.png) | מדור | מה יש בו | | --- | --- | | **הגדרות** | כל מאפיין של הבלוק שנבחר. שדות מופיעים ונעלמים לפי הבחירות שלכם — למשל **פסק זמן להמתנה** מופיע רק לאחר ש**המתנה לתשובת הלקוח** מופעלת. | | **משתנים זמינים** | כל מה שהבלוקים *שלפני* הבלוק הזה מפיקים, מקובץ לפי מרחב שמות (מערכת, הודעה, שיחה, איש קשר, ערוץ, מענה ועוד). גררו משתנה ישירות לשדה טקסט, או לחצו עליו כדי להעתיק. ראו [משתנים](./studio/variables.md). | | **יומן ההרצה** · *בקרוב* | היסטוריית הרצה לכל בלוק. עדיין אינו זמין — המדור מסומן **בקרוב**, ויומן ריק שם אינו מעיד על כך שהבלוק נכשל. | ### אזהרות על בלוק {#warnings-on-a-block} בלוק מציג **תג אזהרה ⚠** על הקנבס, והסבר בראש פאנל המאפיינים שלו, כאשר סטודיו מזהה שהוא לא יעבוד: | אזהרה | מה זה אומר | | --- | --- | | הבלוק הזה אינו מחובר לשום דבר | שום דבר אינו מצביע אליו, ולכן הוא לעולם לא ירוץ. גררו מחבר מבלוק קודם אל הפורט העליון שלו. | | זהו בלוק קול | הוא נמצא בתהליך הודעות. בלוקי קול עובדים רק בתהליך שמתחיל בשיחה נכנסת. | | הבלוק הזה אינו נתמך בתהליכי קול של שיחה נכנסת | השתמשו במקום זאת בהשמעת צליל, ב‑IVR או בהעברה קולית. | | חסרה בחירה נדרשת | למשל שליחת אימייל בלי תיבה, או רשומת לקוח בלי סוג אובייקט. | | גוף JSON לא תקין | בקשת HTTP שגוף ה‑JSON שלה כבר אינו ניתן לפענוח. | | התראת האנליטיקס שנבחרה כבר אינה קיימת | ההתראה נמחקה באנליטיקס. | אפשר להמשיך לערוך גם כשיש אזהרות על הקנבס, אבל תקנו אותן לפני הפרסום — דיאלוג הפרסום מזכיר לכם, וחלק מהאזהרות חוסמות פרסום לחלוטין. ### פתקים גררו **פתק** מ**כלי עורך** אל הקנבס כדי להשאיר הערה למי שיפתח את התהליך אחריכם: למה קיים הסתעפות מסוימת, למה מערכת חיצונית מצפה, את מי לשאול על כך. לפתקים יש כותרת וגוף, אפשר לשנות את גודלם מהפינה, ואין להם פורטים. הם **לעורך בלבד** — הם לעולם אינם מורצים ואינם חלק מהתהליך שפורסם. ### קיצורי מקלדת | קיצור | פעולה | | --- | --- | | `Cmd/Ctrl + S` | שמירת הטיוטה עכשיו | | `Cmd/Ctrl + Z` | ביטול (עד 50 צעדים) | | `Cmd/Ctrl + Y` | ביצוע מחדש | | `Cmd/Ctrl + D` | שכפול הבלוק הנבחר | | `Delete` | מחיקת הבלוק או החיבור הנבחר | שכפול בלוק מעתיק את הסוג שלו ואת כל ההגדרות שלו, אבל לא את החיבורים — חברו את העותק בעצמכם. ## איך תהליך רץ 1. **אירוע מתרחש** — לקוח שולח לכם הודעה, שיחת טלפון מגיעה, טופס מוגש, ‏Webhook נקרא, לוח זמנים מגיע לזמנו, רשומה משתנה. 2. **סטודיו מחפש תהליכים חיים** שהטריגר שלהם תואם לאירוע. תהליכי טיוטה ותהליכים מושהים נדחים. 3. **צומת הטריגר התואם רץ.** אם בתהליך יש שני טריגרים של הודעה נכנסת — אחד ל‑WhatsApp ואחד לטלגרם — רק זה שההגדרות שלו תואמות לאירוע מתחיל. 4. **התהליך מתקדם** לאורך החיבורים. במקום שבו לבלוק יש כמה קווים יוצאים, **כולם** רצים. במקום שבו תנאי בחר הסתעפות, רק ההסתעפות הזו רצה. 5. **כל בלוק מוסיף את הפלטים שלו למשתני התהליך**, כדי שבלוקים מאוחרים יותר יוכלו להשתמש בהם. 6. **בלוק יכול להשהות את התהליך** — מענה בהודעה שממתין לתשובת הלקוח, או המתנה שסופרת לאחור. שאר התהליך מתחדש מאוחר יותר, בדיוק במקום שבו נעצר. הסתעפויות אחרות ממשיכות לרוץ בינתיים. 7. **ההרצה מסתיימת** כשכל המסלולים הסתיימו. כל הרצה נרשמת כ**הרצה** עם סטטוס: | סטטוס | משמעות | | --- | --- | | `running` | מורצת כרגע. | | `waiting` | מושהית להמתנה לתשובת לקוח או לטיימר. | | `completed` | כל המסלולים הסתיימו. | | `failed` | בלוק החזיר שגיאה. | | `timed_out` | המתנה פגה לפני שהלקוח השיב. | | `cancelled` | ההרצה נעצרה. | ## סטודיו ונציגים אנושיים כשתהליך מתחיל לטפל בשיחה, השיחה עוברת לתור **בוט סטודיו** ומציגה שתהליך מחזיק בה. כך בוטים ואנשים אינם משיבים אחד על השני. | מצב | מה סטודיו עושה | | --- | --- | | לשיחה אין נציג | תהליך תואם יכול לקחת אותה ולרוץ. | | השיחה משויכת לנציג אנושי | ‏סטודיו **מדלג עליה לחלוטין** — ללא טריגרים, ללא תהליכים ממתינים, ללא תשובות. | | תהליך מוסר את השיחה לאדם (**התערבות אנושית**) | ‏סטודיו משחרר את הבעלות. הודעות מאוחרות יותר מגיעות לאדם, ולא חזרה לתהליך. | | השיחה מסומנת כטופלה | סימון המסירה מנוקה, כך שפתיחה מחדש בעתיד יכולה להיות אוטומטית שוב. | | תהליך מריץ **סיום סשן** | ‏סטודיו משחרר את השיחה, וההודעה הבאה מהלקוח מתחילה התאמת טריגרים מאפס. | ראו [שינוי שיחה](./studio/actions.md#change-conversation) ו[סיום סשן](./studio/actions.md#end-session). ## מגבלות | מגבלה | ערך | | --- | --- | | בלוקים בתהליך | 200 | | חיבורים בתהליך | 500 | | גרסאות שמורות לכל תהליך | 50 (האחרונות) | | היסטוריית ביטול | 50 צעדים | | בלוק המתנה | 1–15 שניות | | המתנה / השהיה בקול | 0–30 שניות | | המתנה לתשובת לקוח | עד 30 יום | | מרווח לוח זמנים חוזר | דקה אחת – 24 שעות | | פסק זמן לבקשת HTTP | 1–60 שניות | | נמעני אימייל בכל שליחת אימייל | 25 | | כותרות אימייל מותאמות | 10 | ## לאן ממשיכים | עמוד | במה הוא עוסק | | --- | --- | | [בניית תהליך בעזרת AI‏ (Hermes)](./studio/ai-flow-builder.md) | תארו מה אתם רוצים, ענו על כמה שאלות, ותנו ל‑AI לפרוש את התהליך. | | [טריגרים — בלוקי ה‑WHEN](./studio/triggers.md) | כל טריגר, המאפיינים שלו והמשתנים שהוא מפיק. | | [פעולות — בלוקי ה‑THEN](./studio/actions.md) | כל פעולה, המאפיינים שלה והפלטים שלה. | | [תנאים — בלוקי ה‑IF](./studio/conditions.md) | הסתעפות, אופרטורים, שעות פעילות וזמינות נציגים. | | [משתנים](./studio/variables.md) | מערכת ה‑`{{variable}}` ומדריך המשתנים המלא. | | [תהליכי שיחות קול](./studio/voice-flows.md) | בניית תהליכי טלפון: ברכות, תפריטי IVR, העברות והקלטה. | | [בדיקה, פרסום וגרסאות](./studio/publishing.md) | טיוטה מול חי, בדיקות, פרסום וחזרה לאחור. | | [מתכוני תהליכים](./studio/examples.md) | דוגמאות מלאות ומעובדות שאפשר להעתיק. | | [פתרון תקלות](./studio/troubleshooting.md) | למה תהליך לא הופעל, ואיך לתקן זאת. | --- # משתנים מקור: https://docs.teloring.com/he/docs/product/studio/variables Markdown: https://docs.teloring.com/he/markdown/docs/product/studio/variables.md מדור: Studio עודכן לאחרונה: 2026-08-20T20:49:57.000Z **משתנה** הוא מציין מקום שסטודיו ממלא בזמן שהתהליך רץ. כתבו `{{contact.name}}` בהודעה והלקוח יראה *דנה*. המשתנים הם מה שהופך תהליך לאישי במקום משומר, והם הדרך שבה בלוק אחד מעביר מידע לבלוק הבא. ## התחביר תמיד שני סוגריים מסולסלים סביב מפתח: ```text שלום {{contact.name}}, קיבלנו את ההודעה שלך בנושא {{message.content}}. ``` | כלל | פירוט | | --- | --- | | פורמט | `{{namespace.key}}` — למשל `{{conversation.id}}` | | אותיות | המפתחות באותיות קטנות עם נקודות. | | מפתחות לא מוכרים | נשארים בדיוק כפי שהם, כך שטעות הקלדה מופיעה בפלט במקום להיעלם בשקט. | | היכן הם עובדים | בכל שדה טקסט, אזור טקסט, כתובת, ערך כותרת, גוף JSON, שדה אימייל או אופרנד של תנאי. | ## הוספת משתנה בחרו בלוק ופתחו את **המשתנים הזמינים** בפאנל הצדדי. הוא מציג את כל מה שהבלוקים *שלפני* הבלוק הזה מפיקים, מקובץ לפי מרחב שמות. ![פאנל המשתנים הזמינים](pathname:///img/screenshots/he/product/studio/variables-panel.png) | פעולה | תוצאה | | --- | --- | | גרירת משתנה לתוך שדה | הוא מוכנס בנקודת השחרור. | | לחיצה על משתנה | הוא מועתק, מוכן להדבקה. | | לחיצה על כותרת מרחב שמות | פותחת או מכווצת את הקבוצה. | :::tip הרשימה מודעת למיקום. בלוק בראש התהליך רואה פחות משתנים מבלוק בתחתיתו, כי באמת יש לו פחות חומר לעבוד איתו. אם משתנה שאתם מצפים לו חסר, הבלוק שמפיק אותו אינו נמצא לפני הבלוק שבחרתם. ::: ## מרחבי השמות | מרחב שמות | מגיע מ | דוגמה | | --- | --- | --- | | `system.*` | תמיד זמין | `{{system.timestamp}}` | | `var.*` | [שמירה כמשתנה](./actions.md#save-as-variable) — נשמר בין הרצות | `{{var.last_order_id}}` | | `message.*` | טריגר הודעה נכנסת | `{{message.content}}` | | `conversation.*` | רוב טריגרי ופעולות השיחה | `{{conversation.id}}` | | `conversation.custom_attributes.*` | [מאפייני השיחה](../conversation-attributes.md) של החשבון שלכם | `{{conversation.custom_attributes.outcome}}` | | `contact.*` | טריגרי שיחה והודעה | `{{contact.name}}` | | `channel.*` | טריגרי שיחה והודעה | `{{channel.name}}` | | `customer.*` | טריגרי לקוח | `{{customer.name}}` | | `record.*` · `objects.*` | טריגר רשומת לקוח ופעולת רשומת לקוח | `{{record.id}}` | | `agent.*` | טריגר סטטוס נציג | `{{agent.name}}` | | `call.*` · `voice.*` | טריגר ופעולות קול | `{{call.caller_id}}` | | `form.*` · `answers.*` · `hiddenValues.*` · `sourceParams.*` | טריגר מילוי טופס | `{{answers.email}}` | | `webhook.*` | טריגר Webhook נכנס | `{{webhook.body.order_id}}` | | `schedule.*` | טריגרי לוח זמנים | `{{schedule.triggered_at}}` | | `alert.*` | טריגר התראת אנליטיקס | `{{alert.current_value}}` | | `change.*` · `ai.*` | טריגר שינוי בשיחה | `{{change.type}}` · `{{ai.signal}}` | | `reply.*` · `client_reply.*` | פעולת מענה בהודעה | `{{client_reply.content}}` | | `http.*` | פעולת בקשת HTTP | `{{http.json.status}}` | | `email.*` | פעולת שליחת אימייל | `{{email.status}}` | | `code.*` | פעולת קוד | `{{code.result}}` | | `datetime.*` | פעולת תאריך ושעה | `{{datetime.result}}` | | `condition.*` · `availability.*` · `business_hours.*` | בלוקי תנאי | `{{availability.status}}` | | `session.*` · `saved_variable.*` · `private_note.*` · `wait.*` | הפעולות המתאימות | `{{session.resolved}}` | ## משתני מערכת תמיד נוכחים, בכל תהליך, כבר מהבלוק הראשון. | משתנה | מכיל | | --- | --- | | `{{system.timestamp}}` | הזמן הנוכחי, בפורמט ISO | | `{{system.account_id}}` | מזהה החשבון שלכם | | `{{system.flow_id}}` | התהליך שרץ | | `{{system.execution_id}}` | ההרצה הספציפית הזו | כדאי לכלול את `{{system.execution_id}}` בבקשות HTTP ובכותרות אימייל — זו הדרך המהירה ביותר לקשור רשומה חיצונית בחזרה להרצה מסוימת של סטודיו. ## משתנים שמורים — `var.*` משתנים רגילים חיים בדיוק הרצה אחת. **משתנה שמור** חי לנצח. | מאפיין | התנהגות | | --- | --- | | נוצר על ידי | פעולת [שמירה כמשתנה](./actions.md#save-as-variable) | | היקף | לכל תהליך בנפרד — לשני תהליכים יכול להיות `var.counter` משלהם | | זמינות | נטען ל**כל** הרצה של אותו תהליך, כך שהוא עובד כבר מהבלוק הראשון | | מרחב שמות | נאלץ לתוך `var.`, כך שערך שמור לעולם אינו יכול לדרוס משתנה של מערכת, איש קשר, שיחה או הודעה | | מפתחות דינמיים | מותרים — `var.{{contact.phone}}.address` שומר ערך אחד לכל מספר טלפון | | מנוהל ב | **⚙ הגדרות התהליך ← משתנים שמורים**, שם אפשר לסקור ולמחוק אותם | ## מדריך לפי טריגר אילו משתנים יש לכם תלוי במה שהתחיל את התהליך. הרשימה המלאה של כל טריגר נמצאת בעמוד [טריגרים](./triggers.md); זו הגרסה הקצרה. | טריגר | מה מקבלים | | --- | --- | | הודעה נכנסת | `message.*`,‏ `conversation.*`,‏ `contact.*`,‏ `channel.*` | | שיחה נכנסת | `call.*`,‏ `conversation.*`,‏ `contact.*`,‏ `channel.*` | | מילוי טופס | `form.*`,‏ `submission.id`,‏ `answers.*`,‏ `hiddenValues.*`,‏ `sourceParams.*`,‏ `contact.id`,‏ `conversation.id` | | שינוי בשיחה | `conversation.*` (כולל `previous_*`),‏ `change.*`,‏ `ai.*`,‏ `contact.*`,‏ `channel.*` | | טריגר לקוח | `customer.*` (כולל `customer.old` / `customer.new`),‏ `event.*` | | טריגר רשומת לקוח | `record.*`,‏ `objects.*`,‏ `customer.*`,‏ `event.*` | | שינוי סטטוס נציג | `agent.*` | | לוח זמנים חוזר / זמן מתוזמן | `schedule.*` | | Webhook נכנס | `webhook.*`, ובנוסף משתנה אחד לכל שדה שנלמד | | התראת אנליטיקס | `alert.*` | ### משתנים של אובייקטים ומערכים חלק מהמשתנים מכילים אובייקט או רשימה שלמים, ולא ערך בודד: | משתנה | מבנה | להגיע לתוכו באמצעות | | --- | --- | --- | | `{{http.json}}` | אובייקט התגובה | `{{http.json.order_id}}` | | `{{webhook.body}}` | גוף הבקשה | `{{webhook.body.customer.email}}` | | `{{webhook.query}}` · `{{webhook.headers}}` | אובייקטים | `{{webhook.query.token}}` | | `{{answers}}` | תשובות לפי מזהה שדה | `{{answers.email}}` | | `{{hiddenValues}}` | ערכים מוסתרים לפי מזהה שדה | `{{hiddenValues.campaign_id}}` | | `{{sourceParams}}` | פרמטרים בכתובת | `{{sourceParams.utm_source}}` | | `{{answers.list}}` | מערך של תשובות | העבירו אותו בשלמותו לבקשת HTTP, או עברו עליו בלולאה בבלוק [קוד](./actions.md#code) | | `{{customer.old}}` · `{{customer.new}}` · `{{record.old}}` · `{{record.new}}` | תמונות מצב לפני/אחרי | `{{record.new.status}}` | | `{{conversation.custom_attributes}}` | כל [מאפייני השיחה](../conversation-attributes.md) | `{{conversation.custom_attributes.order_number}}` | המפתחות המדויקים בתוך האובייקטים האלה מגיעים מ**הנתונים שלכם**. ‏`{{answers.email}}` עובד רק אם לשדה בטופס יש מזהה השדה `email`; ‏`{{webhook.body.order_id}}` עובד רק אם המטען באמת מכיל `order_id`. עבור Webhooks, השתמשו ב**למידת הבקשה הבאה** וסטודיו יציג לכם את המפתחות האמיתיים. ## מאפייני שיחה {#conversation-attributes} [מאפייני שיחה](../conversation-attributes.md) הם השדות של החשבון שלכם על שיחה — *סיבת הפנייה*, *תוצאה*, *מספר הזמנה*. כל אחד מהם הופך למשתנה שנקרא על שם ה**מזהה API** שלו: ``` {{conversation.custom_attributes.reason_for_contact}} {{conversation.custom_attributes.order_number}} {{conversation.custom_attributes}} ← המערך כולו, כאובייקט אחד ``` | עובדה | פירוט | | --- | --- | | מאיפה הם מגיעים | הטריגרים **הודעה נכנסת**, **שיחה נכנסת** ו**שינוי בשיחה** טוענים כולם את הערכים הנוכחיים של השיחה, כך שהם זמינים כבר מהבלוק הראשון. | | אחרי שהם נכתבים | בלוק [שינוי שיחה](./actions.md#setting-conversation-attributes) שמגדיר מאפיינים מעדכן את המשתנים האלה, כך שכל בלוק שאחריו קורא את הערכים ה**חדשים**. | | כשלא מולאו מעולם | מתפענחים לערך ריק, במקום להשאיר את ה‑`{{placeholder}}` הגולמי בבקשה שלכם. | | שמות | ה**מזהה API**, לא התווית. שינוי התווית של מאפיין בטוח; שינוי מזהה ה‑API שלו משנה את שם המשתנה. | שלחו את כל המערך למערכת חיצונית בשדה אחד על ידי הצבת `{{conversation.custom_attributes}}` בגוף JSON, או בחרו אחד לצורך חיפוש: ```json { "conversation_id": "{{conversation.id}}", "order": "{{conversation.custom_attributes.order_number}}", "disposition": {{conversation.custom_attributes}} } ``` ## משתנים בגוף JSON {#variables-in-a-json-body} בלוק [בקשת HTTP](./actions.md#http-request) מודע לטיפוסים כשהוא ממלא גוף JSON: ```json { "customer": "{{contact.name}}", "answers": {{answers.list}}, "greeting": "Hi {{contact.name}}!" } ``` | מיקום | תוצאה | | --- | --- | | משתנה שממלא ערך שלם, חשוף או במרכאות מלאות | שומר על טיפוס ה‑JSON האמיתי שלו — מערך נשאר מערך, מספר נשאר מספר | | משתנה בתוך מחרוזת ארוכה יותר | מוחלף כטקסט, עם מרכאות ותווים מיוחדים שעברו בריחה בטוחה | | משתנה שאין לו ערך | נשאר ללא שינוי | ## משתנים בבלוק קוד בתוך בלוק [קוד](./actions.md#code) אפשר להחליף משתנה בתוך המקור, או לקרוא אותו מאובייקט ה‑`variables` הקפוא: ```javascript // מוחלף לפני הרצת הקוד const name = "{{contact.name}}"; // נקרא לפי מפתח — עדיף לערכים שעשויים להכיל מרכאות const phone = variables["contact.phone"]; return name + " / " + phone.replace(/^\+/, ''); ``` ## משתנים בתנאי בכלל של [תנאי If/Else](./conditions.md#condition-ifelse), שדה **ערך / משתנה** מקבל מפתח פשוט **בלי** הסוגריים: | שדה | כתבו | | --- | --- | | ערך / משתנה | `message.content` | | השוואה מול (כ*משתנה*) | `var.expected_answer` | | השוואה מול (כ*טקסט*) | `sales` | ## טיפים מעשיים - **התאימו אישית בזהירות.** ‏`{{contact.name}}` יכול להיות ריק עבור איש קשר חדש לגמרי ב‑WhatsApp. או שתקבלו ברכה מעט חשופה, או שתסתעפו קודם על `contact.name` עם האופרטור **קיים**. - **העתיקו מזהים למערכות שלכם.** ‏`{{conversation.id}}`,‏ `{{contact.id}}` ו‑`{{system.execution_id}}` הם הערכים שכדאי לדחוף למערכת CRM חיצונית, כדי ששני הצדדים יוכלו להצטלב בהמשך. - **השתמשו בפאנל, לא בזיכרון.** גרירת משתנה מ**המשתנים הזמינים** מבטיחה שהמפתח כתוב בדיוק כפי שסביבת הריצה מצפה. - **הדפיסו כדי לבדוק.** אם אתם לא בטוחים מה משתנה מכיל, שתלו [הערה פרטית](./actions.md#private-note) זמנית בהסתעפות שמכילה אותו. ההערה פנימית, כך שהיא לא עולה לכם דבר ומציגה את הערך המפוענח בדיוק כפי שהתהליך ראה אותו. ## הבא - [פעולות](./actions.md) — הפלטים של כל בלוק. - [טריגרים](./triggers.md) — המשתנים של כל טריגר. - [פתרון תקלות](./troubleshooting.md) — מה לעשות כשמשתנה מוצג ריק. --- # תהליכי שיחות קול מקור: https://docs.teloring.com/he/docs/product/studio/voice-flows Markdown: https://docs.teloring.com/he/markdown/docs/product/studio/voice-flows.md מדור: Studio עודכן לאחרונה: 2026-08-20T20:49:57.000Z **תהליך קול** הוא תהליך סטודיו שעונה לטלפון. הוא משמיע את הברכה שלכם, מציע תפריט מקשים, בודק אם אתם פתוחים, מצלצל בדפדפן של נציג, מעביר למספר חיצוני ומנתק — הכול מאותו קנבס שבו אתם משתמשים לתהליכי הודעות. כל מה שמתקשר חווה במספר של Teloring מוגדר כאן. אין מסך נפרד של "הגדרות שיחה": [תיבת הקול](../ring/voice.md) מחזיקה את המספר, והתהליך מחזיק את ההתנהגות. ![תהליך קול על הקנבס](pathname:///img/screenshots/he/product/studio/voice-flow-canvas.png) ## מה הופך תהליך לתהליך קול הניחו טריגר **שיחה נכנסת** על הקנבס והתהליך הופך לתהליך קול. מאותו רגע: - קבוצת **קול** מופיעה בבורר הבלוקים — השמעת צליל, המתנה / השהיה, תפריט IVR, העברה לנציג, העברה לטלפון חיצוני, ניתוק. - **מענה בהודעה** ו**המתנה** נעלמים. לשיחת טלפון אין שרשור הודעות להשיב אליו. - הבלוקים הכלליים נשארים זמינים: תנאים, בקשת HTTP, שליחת אימייל, הערה פרטית, שינוי שיחה, עדכון איש קשר, רשומת לקוח, קוד, תאריך ושעה, שמירה כמשתנה. אם תהליך מסתיים בכל זאת עם בלוק מהצד הלא נכון — הודבק פנימה, או נשאר מעיצוב קודם — הבלוק מקבל תג אזהרה ואי אפשר לפרסם את התהליך עד שתסירו אותו. ## לפני שבונים | שלב | היכן | | --- | --- | | חברו מספר קולי | [טבעת הערוצים ← שיחות טלפון](../ring/voice.md) | | צרו את לוחות שעות הפעילות שלכם | [הגדרות ← שעות פעילות](../settings.md) | | הקליטו את ההודעות שלכם כקובצי WAV | כל כלי אודיו. הפורמט הבטוח הוא 8 kHz מונו PCM. | | תנו לנציגים שלוחה קולית | [נציגים](../agents.md) | :::tip הקליטו כל הודעה לפני שאתם מתחילים לבנות. תהליך קול הוא בעיקר אודיו, והרבה יותר קל לפרוש אותו כשאתם כבר יודעים מה כל הודעה אומרת. ::: --- ## שיחה נכנסת — הטריגר מתחיל את התהליך כשמגיעה שיחה למספר שנבחר. | מאפיין | מה הוא עושה | ברירת מחדל | | --- | --- | --- | | **תיבת קול** *(חובה)* | איזו תיבת קול או DID מריצה את התהליך הזה. | — | | **הקלטת השיחה** | מקליט כל שיחה שנכנסת לתהליך. | כבוי | ### הקלטה ההקלטה נשלטת **רק כאן**. כשהיא מופעלת: - כל השיחה מוקלטת, מהרגע שהיא נכנסת לתהליך. - כשהשיחה מסתיימת, ההקלטה מועלית לאחסון הפרטי של החשבון שלכם. - **הערה פרטית** עם פרטי ההקלטה מתווספת לשיחה. - ההקלטה מצורפת לרשומת הלקוח ומופיעה ב[מחסן הקבצים](../files-warehouse.md). :::caution הקלטת שיחות כרוכה בחובות משפטיות ברוב המדינות — בדרך כלל הודעה בתחילת השיחה. הוסיפו בלוק **השמעת צליל** עם הודעת הקלטה כשלב הראשון בתהליך מוקלט, ובדקו את הכללים החלים עליכם. ::: ### משתנים `{{call.uuid}}`,‏ `{{call.caller_id}}`,‏ `{{call.destination}}`,‏ `{{call.direction}}`,‏ `{{call.timestamp}}`,‏ `{{call.inbox_id}}`,‏ `{{call.contact_id}}`,‏ `{{call.contact_name}}`, ובנוסף `{{conversation.id}}`,‏ `{{contact.*}}` ו‑`{{channel.*}}`. מתקשרים לא מוכרים מותאמים או נוצרים כליד אוטומטית, כך ש‑`{{contact.id}}` תמיד שמיש. --- ## השמעת צליל {#play-sound} משמיעה הקלטה למתקשר, ואז ממשיכה לבלוק הבא. | מאפיין | מה הוא עושה | | --- | --- | | **הקלטת אודיו** *(חובה)* | העלו קובץ WAV, או בחרו אחד שכבר העליתם. | | פלט | מכיל | | --- | --- | | `{{voice.play_sound.file_id}}` | הקובץ שהושמע | ### דרישות האודיו | דרישה | פירוט | | --- | --- | | פורמט | **WAV בלבד.** פורמטים אחרים נדחים בהעלאה. | | קידוד מומלץ | 8 kHz, מונו, PCM | | אחסון | מועלה לאחסון הקבצים הפרטי של החשבון שלכם ומוגש רק למערכת הטלפוניה | חינם — השמעת אודיו אינה צורכת קרדיטים. --- ## המתנה / השהיה {#wait--pause} מוסיפה שקט קצר לפני הבלוק הבא. שימושי בין שתי הודעות, או כדי לתת למתקשר רגע לפני תפריט. | מאפיין | טווח | ברירת מחדל | | --- | --- | --- | | **משך ההמתנה (שניות)** | 0–30 | 2 | | פלט | מכיל | | --- | --- | | `{{wait.seconds}}` | כמה זמן היא השהתה | *תהליכי קול בלבד. תהליכי הודעות משתמשים במקום זאת בבלוק [המתנה](./actions.md#wait).* --- ## תפריט IVR {#ivr-menu} משמיע הודעת תפריט ומנתב את השיחה לפי המקש שהמתקשר לוחץ. זהו הלב של רוב תהליכי הטלפון. ![הגדרת תפריט IVR](pathname:///img/screenshots/he/product/studio/voice-ivr-menu.png) | מאפיין | מה הוא עושה | ברירת מחדל | | --- | --- | --- | | **הקלטת התפריט** *(חובה)* | קובץ ה‑WAV שמקריא את האפשרויות. | — | | **ספרות מותרות** | אפשרויות המקלדת. לכל שורה יש **ספרה** ו**תווית**. | `1 · מכירות`, `2 · תמיכה` | | **פסק זמן לקלט (מילישניות)** | כמה זמן להמתין ללחיצה, במילישניות (1000–60000). | 7000 | | **מספר ניסיונות מרבי** | כמה פעמים להשמיע את התפריט מחדש לפני ויתור (1–5). | 2 | ### פלטים על הקנבס הבלוק צומח ומקבל **פורט אחד לכל ספרה**, ובנוסף שניים נוספים: | פורט | רץ כאשר | | --- | --- | | `1`,‏ `2`,‏ `3` … | המתקשר לחץ על המקש הזה. לפורט יש תווית עם הספרה והתווית שלכם, למשל `1 · מכירות`. | | **פסק זמן** | המתקשר לא לחץ על דבר בתוך פסק הזמן לקלט. | | **לא תקין** | המתקשר לחץ על מקש שאינו ברשימה שלכם. | | משתנה | מכיל | | --- | --- | | `{{voice.ivr.digit}}` | הספרה שנלחצה | | `{{voice.ivr.branch}}` | ההסתעפות שנבחרה | | `{{call.digit}}` · `{{call.gathered_digits}}` | הספרה האחרונה, וכל מה שנאסף | :::tip תמיד חברו את **פסק זמן** ואת **לא תקין** למשהו — בדרך כלל חזרה לאותו תפריט, או ישירות לנציג. מתקשר שלוחץ על המקש הלא נכון ומגיע למבוי סתום פשוט שומע שקט. ::: חינם — תפריט IVR אינו צורך קרדיטים. --- ## העברה לנציג {#forward-to-agent} מצלצלת לנציג **בדפדפן שלו** ומחברת את המתקשר ברגע שהוא עונה. | מאפיין | אפשרויות | ברירת מחדל | | --- | --- | --- | | **ניתוב** | נציג ספציפי · כל נציג זמין | נציג ספציפי | | **נציג** | בוחר נציגים. מופיע עבור **נציג ספציפי**. | — | | **פסק זמן לצלצול (שניות)** | 5–120 | 30 | **כל נציג זמין** בוחר את הנציג הראשון שמחובר כרגע לערוץ הקול. אם אף אחד אינו מחובר, המערכת נופלת חזרה לנציג הראשון שיש לו שלוחה קולית. ### שני פלטים | פורט | רץ כאשר | | --- | --- | | **הושלם** | הנציג ענה והשיחה הסתיימה. השתמשו בזה לעבודה שאחרי השיחה — תיעוד, רשומת CRM, אימייל שביעות רצון. | | **נדחה** | הנציג דחה, או שפסק הזמן לצלצול פג ללא מענה. השתמשו בזה כדי לנסות נציג אחר, להציע תא קולי, או לנתק באדיבות. | פלט שאינו מחובר פשוט מסיים את השיחה. ### מה המתקשר והנציג חווים 1. המתקשר שומע צלצול חוזר בזמן ש‑Teloring ממתינה. 2. חלון שיחה מופיע אצל הנציג, עם מספר המתקשר ופרטי איש הקשר. 3. **מענה** מחבר את שני הצדדים מיד. 4. **דחייה**, או המתנה עד שפסק הזמן לצלצול פג, מובילות למסלול **נדחה**. 5. כשאחד הצדדים מנתק, מסלול **הושלם** רץ. ### משתנים שזמינים במסלול "הושלם" מכיוון שהם מופיעים רק אחרי השיחה, הם מושלמים לדחיפת רשומת שיחה מלאה למערכת חיצונית: | משתנה | מכיל | | --- | --- | | `{{voice.forward.status}}` · `{{voice.forward.agent_id}}` | תוצאת ההעברה | | `{{call.agent_id}}` · `{{call.agent_name}}` | מי לקח את השיחה | | `{{call.duration_seconds}}` | אורך השיחה הכולל, מההגעה ועד הניתוק | | `{{call.talk_duration_seconds}}` | זמן שיחה, מהמענה ועד הניתוק | | `{{call.wait_duration_seconds}}` | כמה זמן המתקשר המתין עד שנענה | | `{{call.started_at}}` · `{{call.answered_at}}` · `{{call.ended_at}}` | חותמות זמן | | `{{call.conversation_id}}` · `{{call.customer_id}}` | היכן השיחה מתועדת | חינם — העברות פנימיות אינן צורכות קרדיטים. :::note לנציגים חייבת להיות הלשונית של Teloring פתוחה כדי שאפשר יהיה לצלצל אליהם. אין רישום טלפון קבוע, כך שנציג מנותק פשוט אינו זמין — שלבו את הבלוק הזה עם תנאי [זמינות נציגים](./conditions.md#agent-availability) כדי לבחור מסלול אחר כשאין אף אחד. ::: --- ## העברה לטלפון חיצוני {#forward-to-external-phone} מעבירה את המתקשר למספר טלפון חיצוני — נייד של תורן, משרד שותף, שירות מענה. | מאפיין | מה הוא עושה | ברירת מחדל | | --- | --- | --- | | **מספר טלפון חיצוני** *(חובה)* | היעד, בפורמט בינלאומי (`+972501234567`). משתנים נתמכים. | — | | **פסק זמן לצלצול (שניות)** | 5–120 | 30 | | משתנה | מכיל | | --- | --- | | `{{voice.forward.status}}` | תוצאת ההעברה | | `{{voice.forward.external_number}}` | המספר שאליו חויג | המספר שאליו התקשרו אליכם במקור משמש כזיהוי המתקשר היוצא, כך שמי שמקבל את ההעברה רואה את המספר העסקי שלכם. :::caution **הבלוק הזה מחייב בקרדיטים.** העברה למספר טלפון חיצוני מבצעת שיחה יוצאת אמיתית. העברות פנימיות לנציגים הן חינם. ::: --- ## ניתוק {#hang-up} מסיימת את השיחה. | מאפיין | אפשרויות | ברירת מחדל | | --- | --- | --- | | **סיבת הניתוק** | ניתוק רגיל · תפוס · אין מענה | ניתוק רגיל | | משתנה | מכיל | | --- | --- | | `{{voice.hangup.cause}}` | הסיבה שנשלחה | השתמשו ב**ניתוק רגיל** לפרידה רגילה. ‏**תפוס** ו**אין מענה** קיימים כדי שרשת המקור תראה סיבה משמעותית, מה שחשוב אם המתקשרים מנותבים על ידי מערכת אחרת לפני שהם מגיעים אליכם. :::tip סיימו כל מסלול בהעברה או בניתוק מפורש, אחרי הודעת סיום. מסלול שפשוט נעצר משאיר את המתקשר בשקט עד שהקו נופל. ::: --- ## תנאים בתהליך קול כל שלושת [בלוקי התנאי](./conditions.md) עובדים על שיחות: | תנאי | שימוש קולי אופייני | | --- | --- | | **שעות פעילות** | פתוח ← תפריט; סגור ← הודעת "אנחנו סגורים" וניתוק. | | **זמינות נציגים** | מחובר ← העברה לנציג; מנותק ← הודעת תא קולי או העברה חיצונית. | | **תנאי If/Else** | ניתוב מתקשרי VIP לפי `call.caller_id`, או הסתעפות לפי סטטוס לקוח שמשכתם בבקשת HTTP. | ## מבנה אופייני ```text שיחה נכנסת (הקלטה: מופעלת) └─ השמעת צליל "ברוכים הבאים ל‑Acme. השיחה עשויה להיות מוקלטת." └─ שעות פעילות ├─ פתוח ──── תפריט IVR "הקישו 1 למכירות, 2 לתמיכה" │ ├─ 1 · מכירות ── זמינות נציגים │ │ ├─ מחובר ── העברה לנציג ──┬─ הושלם ── בקשת HTTP (תיעוד השיחה) │ │ │ └─ נדחה ─── השמעת צליל "מצטערים שפספסנו" ─ ניתוק │ │ └─ מנותק ── השמעת צליל "השאירו הודעה" ─ ניתוק │ ├─ 2 · תמיכה ─── העברה לטלפון חיצוני │ ├─ פסק זמן ───── השמעת צליל (חזרה) ─ תפריט IVR │ └─ לא תקין ───── השמעת צליל "זו לא הייתה אפשרות" ─ תפריט IVR └─ סגור ──── השמעת צליל "אנחנו סגורים. שעות הפעילות שלנו…" ─ ניתוק ``` ## רשימת בדיקה לפני פרסום - [ ] כל פורט ספרה ב‑IVR מחובר, כולל **פסק זמן** ו**לא תקין**. - [ ] כל מסלול מסתיים בהעברה או בניתוק. - [ ] מסלול שעות הסגירה אומר משהו מועיל, ולא רק שקט. - [ ] אם ההקלטה מופעלת, ההודעה הראשונה מכריזה על כך. - [ ] כל הודעה היא קובץ WAV, והאזנתם לכל אחת מהן. - [ ] ל**העברה לנציג** יש מסלול **נדחה**. - [ ] התקשרתם למספר בעצמכם ועברתם על כל הסתעפות. :::note **הרצת בדיקה** מפעילה את הלוגיקה של התהליך עם נתוני דוגמה, אבל אינה יכולה לבצע שיחה אמיתית. הבדיקה האמיתית היחידה של תהליך קול היא לחייג למספר. ::: ## הבא - [תיבת שיחות טלפון](../ring/voice.md) — חיבור המספר והסופטפון של הנציג. - [תנאים](./conditions.md) — הסתעפות לפי שעות פעילות וזמינות. - [מתכוני תהליכים](./examples.md) — דוגמה שלמה של תפריט טלפוני. --- # בדיקה, פרסום וגרסאות מקור: https://docs.teloring.com/he/docs/product/studio/publishing Markdown: https://docs.teloring.com/he/markdown/docs/product/studio/publishing.md מדור: Studio עודכן לאחרונה: 2026-08-20T20:49:57.000Z סטודיו שומר בהפרדה מוחלטת בין **מה שאתם עורכים** לבין **מה שרץ**. אפשר לבנות מחדש תהליך חי באמצע יום שני עמוס, ושום דבר לא ישתנה עבור הלקוחות שלכם עד שתלחצו **פרסום**. ## טיוטה, חי, מושהה | סטטוס | משמעות | | --- | --- | | **טיוטה** | התהליך מעולם לא פורסם. הוא אינו מגיב לדבר. | | **חי** | גרסה שפורסמה רצה ומטפלת באירועים אמיתיים. | | **מושהה** | התהליך עדיין קיים, עם כל הבלוקים שלמים, אבל הוא אינו מגיב לדבר. אתם קובעים זאת באמצעות [השהיית תהליך](#pause-and-resume); ‏Teloring גם קובעת זאת אוטומטית כשתהליך תלוי במשהו שנמחק. | לכל תהליך יש למעשה **שני עותקים** של הקנבס: | עותק | מה זה | משתנה על ידי | | --- | --- | --- | | **טיוטה** | מה שאתם רואים בעורך. | כל עריכה שאתם מבצעים, נשמרת אוטומטית. | | **חי** | מה שאירועים אמיתיים רצים מולו. | **פרסום**, ושום דבר אחר. | עריכת תהליך חי בטוחה. השינויים שלכם מצטברים בטיוטה; הגרסה שהלקוחות פוגשים היא זו שפרסמתם לאחרונה. :::note תהליך שנבנה על ידי [Hermes](./ai-flow-builder.md) מגיע גם הוא כ**טיוטה**. ה‑AI לעולם אינו מפרסם דבר — אתם סוקרים אותו על הקנבס, מריצים בדיקה ומפרסמים בדיוק כמו תהליך שציירתם בעצמכם. ::: ## שמירה ### שמירה אוטומטית השמירה האוטומטית מופעלת כברירת מחדל. כמה שניות אחרי שאתם מפסיקים לערוך, הטיוטה נשמרת והמחוון בסרגל העליון עובר מ**לא נשמר** ל**שומר…** ול**נשמר**. ### שמירה ידנית כבו את השמירה האוטומטית ב**⚙ הגדרות התהליך** כשאתם רוצים שליטה מלאה. שינויים בקנבס מסמנים אז את העורך כ**לא נשמר**, ושום דבר אינו נכתב עד שתלחצו על הכפתור **💾** או על `Cmd/Ctrl+S`. ![הגדרות התהליך](pathname:///img/screenshots/he/product/studio/flow-settings.png) דיאלוג הגדרות התהליך מציג גם את [המשתנים השמורים](./actions.md#save-as-variable) של התהליך, שם אפשר לסקור ולמחוק אותם. :::note שמירה **אינה** פרסום. טיוטה שנשמרה עדיין אינה משפיעה על תנועה חיה. ::: ## הרצת בדיקה {#test-run} **הרצת בדיקה** מריצה את הטיוטה — הגרסה שעל המסך שלכם — עם נתוני דוגמה. | מה היא עושה | מה היא אינה עושה | | --- | --- | | עוברת על התהליך מהטריגר הראשון | שולחת הודעות ללקוחות | | מריצה תנאים ומדווחת אילו הסתעפויות תאמו | שולחת מיילים (שליחת אימייל מאמתת ומדווחת `test`) | | מדווחת כמה בלוקים הורצו | כותבת רשומות CRM | | חושפת שגיאות הגדרה מיד | מבצעת שיחות טלפון | ![תוצאת הרצת בדיקה](pathname:///img/screenshots/he/product/studio/test-run.png) התוצאה מציגה את **סטטוס** ההרצה ואת מספר **הבלוקים שהורצו**. אם עדיין אין לתהליך טריגר, סטודיו אומר לכם להוסיף אחד קודם. :::tip הרצת בדיקה מוכיחה את ה*מבנה* של התהליך — שהבלוקים מחווטים, מוגדרים וניתנים להגעה. היא אינה יכולה להוכיח את הניסוח של הודעה או את התזמון של המתנה. לשם כך, פרסמו לתיבת בדיקה ושלחו הודעה לעצמכם. ::: ## פרסום {#publishing} לחצו **פרסום** כדי להפוך את הטיוטה לגרסה החיה. ![אישור פרסום](pathname:///img/screenshots/he/product/studio/publish-modal.png) דיאלוג האישור מסכם את מה שאתם עומדים לשחרר: | שורה | משמעות | | --- | --- | | **טריגרים** | כמה בלוקי טריגר יש בתהליך. | | **בלוקים** | כמה בלוקים בסך הכול. | | **גרסה** | מספר הגרסה שהתהליך יקבל. | | **אזהרה** | מופיעה כשבלוק כלשהו עדיין מציג תג אזהרה. | אשרו והתהליך הופך ל**חי** מיד. ### מה הפרסום עושה 1. מעתיק את הטיוטה לגרסה החיה. 2. מקדם את מספר הגרסה. 3. שומר תמונת מצב בהיסטוריית הגרסאות. 4. מנקה את מצב "שינויים שלא פורסמו". 5. מפעיל ניטור לכל [התראת אנליטיקס](./triggers.md#analytics-alert) שהתהליך מפנה אליה. 6. מנקה כל אזהרת תלות שהשהתה את התהליך. ### מה חוסם פרסום | סיבה | תיקון | | --- | --- | | לתהליך אין טריגר | הוסיפו בלוק **WHEN**. | | בלוק קול נמצא בתהליך הודעות, או להפך | הסירו את הבלוק שאינו בתחום. תג האזהרה שלו מציין את הבעיה. | אזהרות אחרות — בלוק לא מחובר, תיבת אימייל חסרה, ‏JSON לא תקין — אינן חוסמות פרסום לחלוטין, אבל הדיאלוג מזכיר לכם וכדאי לתקן אותן קודם. :::caution הפרסום משפיע על **לקוחות אמיתיים באופן מיידי**. בדקו עם תיבה שקטה, או עם טריגר שמסונן לתיבת בדיקה אחת, לפני שאתם מפרסמים משהו שמשיב לאנשים. ::: ## היסטוריית גרסאות {#version-history} סטודיו שומר את **50 תמונות המצב האחרונות** של כל תהליך. לחצו על סרגל **הגרסה** בתחתית הפאנל הצדדי כדי לפתוח את הרשימה. ![היסטוריית גרסאות](pathname:///img/screenshots/he/product/studio/version-history.png) כל רשומה מציגה את מספר הגרסה, מתי היא נשמרה, מי שמר אותה, כמה בלוקים וחיבורים היו בה, האם היא החיה, ואיך היא נוצרה: | מקור | נוצר על ידי | | --- | --- | | **שמירה אוטומטית** | שמירה אוטומטית בזמן עריכה | | **שמירה ידנית** | הכפתור 💾 או `Cmd/Ctrl+S` | | **פורסם** | פרסום | | **שוחזר** | הפיכת גרסה ישנה לחיה | ### תצוגה מקדימה של גרסה לחצו על גרסה כדי לפתוח אותה על הקנבס ב**תצוגה מקדימה לקריאה בלבד**. כרזה בראש העמוד מציינת *תצוגה מקדימה לקריאה בלבד*, והעריכה, השמירה והבדיקה מושבתות, כך שלא תעבדו בטעות על העותק הלא נכון. מהכרזה אפשר: | כפתור | מה הוא עושה | | --- | --- | | **הפוך לחי** | מקדם את תמונת המצב הזו לגרסה החיה. | | **יציאה מהתצוגה** | מחזיר לטיוטה שלכם, בדיוק כפי שהשארתם אותה. | אם יש לכם שינויים שלא נשמרו כשאתם פותחים תצוגה מקדימה, סטודיו מזהיר אתכם קודם. הטיוטה שלכם אינה אובדת — היא מוסתרת עד שתצאו מהתצוגה. ### חזרה לאחור **הפוך לחי** הוא כפתור החזרה לאחור. הוא: 1. בודק שיש בתמונת המצב לפחות טריגר אחד. 2. מקדם אותה לגרסה החיה **וגם** לטיוטה שלכם. 3. מקדם את מספר הגרסה ומסמן את התהליך כ**חי**. 4. כותב תמונת מצב של שחזור, כך שגם החזרה לאחור ניתנת לביטול. :::tip חזרה לאחור היא התיקון המהיר ביותר כשתהליך שפורסם זה עתה מתנהג לא כשורה. פתחו את היסטוריית הגרסאות, הציגו את הגרסה שעבדה ולחצו **הפוך לחי** — ואז אתרו את התקלה בטיוטה השבורה בלי לחץ. ::: ## השהיה וחידוש {#pause-and-resume} **השהיה** מכבה תהליך חי בלי לשנות או למחוק דבר. פתחו את התהליך, לחצו **⚙ הגדרות התהליך** והשתמשו ב**השהיית התהליך** תחת **פעילות התהליך**. ![השהיית תהליך מהגדרות התהליך](pathname:///img/screenshots/he/product/studio/flow-pause.png) | בזמן ההשהיה | פירוט | | --- | --- | | התהליך אינו מגיב לדבר | הודעות נכנסות, שיחות, הגשות טפסים, לוחות זמנים, ‏Webhooks והתראות אנליטיקס — כולם חולפים על פניו. | | שום דבר אינו נמחק | כל בלוק, חיבור, גרסה שמורה ומשתנה שמור נשארים בדיוק כפי שהיו. | | תג הסטטוס מציג **מושהה** | גם בעורך וגם בכרטיס התהליך ברשימה. | | שיחות מוחזרות | כל מה שהתהליך החזיק יוצא מתור בוט סטודיו אל **ממתינות בתור**, כך שלקוח באמצע שיחה עם בוט אינו נשאר לחכות לבוט שלעולם לא יענה. | | הסתעפויות שמחנות בהמתנה נעצרות גם הן | תהליך שממתין לתשובת לקוח או לספירה לאחור אינו ממשיך בזמן ההשהיה. | | אפשר להמשיך לערוך | הטיוטה מתנהגת כרגיל. | | התראות אנליטיקס משוחררות | תהליך מושהה מפסיק לנטר את ההתראות שהפנה אליהן. | **חידוש התהליך** — אותו כפתור, לאחר שהתהליך מושהה — מפעיל אותו מחדש. :::note החידוש משחזר את **הגרסה האחרונה שפורסמה**, לא את הטיוטה הנוכחית שלכם. לכן ביטול השהיה לעולם אינו יכול לשחרר בטעות עריכה שלא הושלמה. כדי להעלות שינויים מהטיוטה לאוויר, השתמשו ב**פרסום**. ::: החידוש מחזיר את התהליך עבור אירועים *חדשים*. שיחות ששוחררו בזמן ההשהיה נשארות אצל הנציגים שלקחו אותן — הן אינן נמשכות בחזרה לבוט. ההשהיה זמינה רק בתהליך חי. בטיוטה, הכפתור מושבת — אין מה לעצור. | מטרה | איך | | --- | --- | | לעצור תהליך זמנית | **⚙ הגדרות התהליך ← השהיית התהליך.** הפיך בלחיצה אחת. | | להפעיל אותו שוב | **⚙ הגדרות התהליך ← חידוש התהליך.** | | לשחרר שינויים מהטיוטה | **פרסום.** | | להסיר תהליך לצמיתות | [מחקו אותו](#deleting-a-flow). | | לשנות תהליך בבטחה | ערכו בחופשיות. לטיוטה אין השפעה עד שאתם מפרסמים. | ## מחיקת תהליך {#deleting-a-flow} לכל כרטיס תהליך ברשימה יש פעולת **מחיקה**, כולל לתהליכים חיים. מכיוון שהמחיקה היא לצמיתות, הדיאלוג מבקש שתקלידו את שם התהליך המדויק לפני שהכפתור נפתח. ![מחיקת תהליך](pathname:///img/screenshots/he/product/studio/delete-flow-modal.png) המחיקה היא פירוק מלא: | מה נעלם | פירוט | | --- | --- | | כל בלוק וכל חיבור | הקנבס מתרוקן והתהליך מוסר. | | התהליך עצמו | שום טריגר, לוח זמנים או Webhook לא יוכלו להתחיל אותו שוב. | | כל הגרסאות השמורות | היסטוריית 50 תמונות המצב הולכת איתו — אין חזרה לאחור אחר כך. | | המשתנים השמורים של התהליך | כל ערך `var.*` שהתהליך הזה שמר מוסר. | | הרצות שעדיין המתינו | הרצה שמחנה בהמתנה לתשובת לקוח או לטיימר מבוטלת, במקום להישאר ולהתחדש לתוך שום דבר. | שיחות שהתהליך טיפל בהן **אינן** נמחקות. הן משוחררות מתור בוט סטודיו ונוחתות בחזרה ב**ממתינות בתור**, כך שנציג יוכל לקחת אותן מיד. :::caution מחיקת תהליך **חי** עוצרת אותו מיידית, כולל באמצע שיחה. אם לקוח היה באמצע שיחה עם בוט, הבוט פשוט מפסיק להשיב והשיחה עוברת לתור ההמתנה. אם אתם רק צריכים לכבות תהליך, [השהו אותו](#pause-and-resume) במקום. ::: ## השהיה אוטומטית אם תהליך תלוי במשהו שנמחק, Teloring משהה אותו במקום לתת לו להיכשל בשקט. כיום זה חל על [התראות אנליטיקס](./triggers.md#analytics-alert): מחקו התראה (או את הדוח שמאחוריה) וכל תהליך שמפנה אליה מסומן. כרטיס התהליך מציג תג אזהרה עם הסיבה, הבלוק שמפנה להתראה החסרה מסומן כלא תקין בעורך, ותהליך חי עובר ל**מושהה**. בחרו התראה אחרת — או הסירו את הבלוק — ופרסמו שוב. הפרסום מנקה את הסימון. ## שגרת שחרור בטוחה 1. בנו על טיוטה. 2. **הרצת בדיקה**, ותקנו כל מה שהיא מדווחת. 3. נקו כל תג אזהרה על הקנבס. 4. כוונו את הטריגר לתיבת בדיקה אחת ופרסמו. 5. שלחו הודעה לתיבה הזו בעצמכם ועברו על כל הסתעפות. 6. הרחיבו את הטריגר לתיבות האמיתיות ופרסמו שוב. 7. המשיכו לעקוב אחרי התיבה במהלך ההרצות האמיתיות הראשונות. ## הבא - [פתרון תקלות](./troubleshooting.md) — כשתהליך אינו מופעל. - [מתכוני תהליכים](./examples.md) — תהליכים שלמים להתחיל מהם. --- # מתכוני תהליכים מקור: https://docs.teloring.com/he/docs/product/studio/examples Markdown: https://docs.teloring.com/he/markdown/docs/product/studio/examples.md מדור: Studio עודכן לאחרונה: 2026-08-20T20:49:57.000Z תהליכים שלמים ועובדים שאפשר לבנות בכמה דקות כל אחד. כל מתכון מפרט את הבלוקים, את ההגדרות שלהם ואת ההיגיון מאחוריהם. :::tip אפשר לתאר כל מתכון שלמטה ל‑[Hermes](./ai-flow-builder.md) במשפט אחד — *"סנן ליד חדש ב‑WhatsApp ושלח אותו למכירות או לתמיכה"* — והוא ייבנה עבורכם. עדיין כדאי לקרוא את המתכונים: הם מראים איך נראה תהליך טוב, מה שמקל על בדיקת העבודה של ה‑AI. ::: | מתכון | טריגר | מתאים ל | | --- | --- | --- | | [ברכת קבלה מיידית](#1-instant-welcome-reply) | הודעה נכנסת | כל תיבה חדשה | | [מענה אוטומטי מחוץ לשעות הפעילות](#2-after-hours-auto-reply) | הודעה נכנסת | צוותים עם שעות קבועות | | [סינון וניתוב של ליד חדש](#3-qualify-and-route-a-new-lead) | הודעה נכנסת | הפרדה בין מכירות לתמיכה | | [הסלמה של לקוח לא מרוצה](#4-escalate-an-unhappy-customer) | שינוי בשיחה | שימור לקוחות | | [דחיפת ליד חדש ל‑CRM חיצוני](#5-push-a-new-lead-into-an-external-crm) | מילוי טופס | אינטגרציות | | [פתיחת שיחה ממערכת חיצונית](#6-start-a-conversation-from-an-external-system) | Webhook נכנס | עדכוני הזמנות ומשלוחים | | [סיכום בוקר יומי](#7-daily-morning-summary) | זמן מתוזמן | מנהלים | | [התרעה למנהל כשמדד יורד](#8-alert-a-manager-when-a-metric-slips) | התראת אנליטיקס | תפעול | | [תפריט טלפוני עם העברה לנציג](#9-phone-menu-with-agent-transfer) | שיחה נכנסת | קול | --- ## 1. ברכת קבלה מיידית {#1-instant-welcome-reply} השיבו תוך שנייה, כדי שאף אחד לא ימתין בשקט. ```text הודעה נכנסת (תיבות: WhatsApp) └─ מענה בהודעה └─ סיום סשן ``` | בלוק | הגדרות | | --- | --- | | **הודעה נכנסת** | סמנו את תיבת ה‑WhatsApp שלכם. | | **מענה בהודעה** | `שלום {{contact.name}}! תודה שפניתם ל‑Acme. אחד מאנשי הצוות שלנו יחזור אליכם בקרוב.` · המתנה לתשובת הלקוח: **כבוי** | | **סיום סשן** | סימון השיחה כטופלה: **כבוי** | **למה סיום סשן?** בלעדיו, סטודיו ממשיך להחזיק בשיחה והיא יושבת בתור בוט סטודיו. סיום סשן משחרר אותה כך שהיא מופיעה ב**ממתינות בתור** ונציג יכול לקחת אותה. :::tip `{{contact.name}}` ריק עבור איש קשר חדש בחלק מהערוצים. או שתכתבו ברכה שנקראת היטב גם בלעדיו, או שתסתעפו על `contact.name` עם האופרטור **קיים**. ::: --- ## 2. מענה אוטומטי מחוץ לשעות הפעילות {#2-after-hours-auto-reply} אמרו משהו מועיל כשאתם סגורים, ושתקו כשאתם פתוחים. ```text הודעה נכנסת └─ שעות פעילות ├─ פתוח ──── (כלום — תנו לנציגים לטפל) └─ סגור ──── מענה בהודעה ── סיום סשן ``` | בלוק | הגדרות | | --- | --- | | **הודעה נכנסת** | השאירו את התיבות ריקות כדי לכסות כל ערוץ. | | **שעות פעילות** | בחרו את הלוח שיצרתם ב**הגדרות ← שעות פעילות**. | | **מענה בהודעה** (סגור) | `תודה על ההודעה! הצוות שלנו לא זמין כרגע. אנחנו פתוחים ראשון–חמישי, 09:00–18:00, ונחזור אליכם עם פתיחת היום.` | | **סיום סשן** | סימון כטופל: **כבוי** | השארת הפורט **פתוח** ללא חיבור היא בכוונה — בשעות העבודה התהליך צריך לא לעשות דבר ולתת לנציגים להשיב כרגיל. --- ## 3. סינון וניתוב של ליד חדש {#3-qualify-and-route-a-new-lead} שאלו שאלה אחת, ואז שלחו את השיחה לצוות הנכון עם התווית הנכונה. ```text הודעה נכנסת └─ מענה בהודעה (המתנה לתשובה) └─ תנאי If/Else ├─ מכירות ──── שינוי שיחה (תווית: מכירות, מסירה לתור) ├─ תמיכה ───── שינוי שיחה (תווית: תמיכה, מסירה לתור) └─ Else ────── מענה בהודעה "מצטערים, לא הבנתי…" ``` | בלוק | הגדרות | | --- | --- | | **מענה בהודעה** | `שלום! אתם פונים אלינו בנושא **מכירות** או **תמיכה**? השיבו במילה אחת.` · המתנה לתשובת הלקוח: **מופעל** · פסק זמן להמתנה: `60` | | **תנאי If/Else** | מצב התאמה: **ההתאמה הראשונה בלבד** · הוספת הסתעפות ELSE: **מופעל** | | — IF 1 | תווית `מכירות` · ערך `message.content` · אופרטור **מכיל** · השוואה כטקסט · השוואה מול `מכירות` | | — IF 2 | תווית `תמיכה` · ערך `message.content` · אופרטור **מכיל** · השוואה כטקסט · השוואה מול `תמיכה` | | **שינוי שיחה** (מכירות) | מצב תוויות: הוספה · תוויות: `מכירות` · התערבות אנושית: **מופעלת** · מסירה אל: **תור ההמתנה** | | **שינוי שיחה** (תמיכה) | אותו דבר, עם התווית `תמיכה`. | | **מענה בהודעה** (Else) | `מצטערים, לא הבנתי. אנא השיבו "מכירות" או "תמיכה".` · המתנה לתשובת הלקוח: **מופעל** | **למה `מכיל` ולא `שווה ל`?** אנשים מקלידים *"מכירות בבקשה"* ו*"אני צריך מכירות"*. ‏`מכיל` אינו רגיש לאותיות גדולות/קטנות ומוצא התאמה בתוך משפט. **לולאת ה‑ELSE.** הסתעפות ה‑ELSE שואלת שוב וממתינה שוב, כך שהלקוח מקבל הזדמנות נוספת. שקלו להוסיף מונה עם **שמירה כמשתנה**, או ניסיון שלישי שמוסר לאדם, כדי שלקוח מבולבל לעולם לא ייתקע. --- ## 4. הסלמה של לקוח לא מרוצה {#4-escalate-an-unhappy-customer} הגיבו ברגע שה‑AI מזהה תסכול. ```text שינוי בשיחה (איתותי AI: זיהוי רגש) └─ תנאי If/Else └─ שלילי ── שינוי שיחה (עדיפות: דחוף, דגל: חשוב) └─ הערה פרטית └─ שליחת אימייל ``` | בלוק | הגדרות | | --- | --- | | **שינוי בשיחה** | איתותי AI: **זיהוי רגש**. השאירו את שאר המסננים על *כל*. | | **תנאי If/Else** | IF `שלילי` · ערך `conversation.customer_emotion` · אופרטור **קטן מ** · השוואה כמספר · השוואה מול `3` | | **שינוי שיחה** | עדיפות: **דחופה** · דגל: **חשוב** · התערבות אנושית: **מופעלת** · מסירה אל: **תור ההמתנה** | | **הערה פרטית** | `⚠️ ה‑AI זיהה רגש שלילי ({{conversation.customer_emotion}}). איתות: {{ai.message}}` | | **שליחת אימייל** | אל ראש הצוות שלכם · נושא `הסלמה: {{contact.name}}` · הגוף כולל את `{{conversation.id}}` ואת `{{ai.message}}` | --- ## 5. דחיפת ליד חדש ל‑CRM חיצוני {#5-push-a-new-lead-into-an-external-crm} שלחו כל הגשת טופס ישירות למערכת אחרת, ותעדו את התוצאה. ```text מילוי טופס (טופס: צור קשר) └─ בקשת HTTP (לכידת תגובה: מופעלת) └─ תנאי If/Else ├─ הצלחה ── שמירה כמשתנה ── הערה פרטית └─ Else ─── שליחת אימייל (התרעה למנהל) ``` | בלוק | הגדרות | | --- | --- | | **מילוי טופס** | בחרו את הטופס הספציפי. | | **בקשת HTTP** | שיטה **POST** · כתובת נקודת הקצה של ה‑CRM שלכם · כותרת `Content-Type: application/json` · סוג גוף **JSON** · לכידת תגובה **מופעלת** · פסק זמן `15` | | **תנאי If/Else** | IF `הצלחה` · ערך `http.ok` · אופרטור **שווה ל** · השוואה כבוליאני · השוואה מול `true` | | **שמירה כמשתנה** | מפתח `var.{{contact.id}}.crm_id` · ערך `{{http.json.id}}` · סוג טקסט | | **הערה פרטית** | `הליד סונכרן ל‑CRM כ‑{{http.json.id}}.` | | **שליחת אימייל** (Else) | אל מנהל החשבון שלכם · הגוף כולל את `{{http.status_code}}` ואת `{{http.error}}` | גוף ה‑JSON: ```json { "name": "{{answers.full_name}}", "email": "{{answers.email}}", "phone": "{{answers.phone}}", "source": "{{sourceParams.utm_source}}", "answers": {{answers.list}}, "teloring_contact_id": "{{contact.id}}", "teloring_execution_id": "{{system.execution_id}}" } ``` **שימו לב ל‑`{{answers.list}}` ללא מרכאות.** מכיוון שהמשתנה ממלא ערך שלם, סטודיו מכניס את המערך האמיתי במקום מחרוזת. ראו [משתנים בגוף JSON](./variables.md#variables-in-a-json-body). --- ## 6. פתיחת שיחה ממערכת חיצונית {#6-start-a-conversation-from-an-external-system} תנו לפלטפורמת ההזמנות שלכם לעדכן לקוח שהמשלוח שלו בדרך. ```text Webhook נכנס └─ מענה בהודעה └─ עדכון איש קשר ``` | בלוק | הגדרות | | --- | --- | | **Webhook נכנס** | העתיקו את הכתובת · שיטות מותרות **POST** · למידת הבקשה הבאה **מופעלת**, ואז שלחו בקשה אמיתית אחת. | | **מענה בהודעה** | מזהה שיחה `{{webhook.body.conversation_id}}` · הודעה `חדשות טובות {{contact.name}} — הזמנה {{webhook.body.order_id}} יצאה למשלוח. למעקב: {{webhook.body.tracking_url}}` | | **עדכון איש קשר** | שדה `last_order_status` ← `{{webhook.body.status}}` | **איך משיגים את מזהה השיחה.** לתהליך שמתחיל ב‑Webhook אין שיחה משלו, ולכן `{{conversation.id}}` ריק. או שהצד הקורא ישלח מזהה שיחה במטען, כמו למעלה, או שתאתרו אותו קודם בבקשת HTTP. --- ## 7. סיכום בוקר יומי {#7-daily-morning-summary} הערה פרטית בשיחה נבחרת, או אימייל, בכל בוקר עבודה. ```text זמן מתוזמן (א׳–ה׳, 08:30, Asia/Jerusalem) └─ בקשת HTTP (לכידת תגובה: מופעלת) └─ שליחת אימייל ``` | בלוק | הגדרות | | --- | --- | | **זמן מתוזמן** | חמש שורות: ראשון–חמישי, שעה `8`, דקה `30`, אזור זמן `Asia/Jerusalem`. | | **בקשת HTTP** | משכו את המספרים שאתם רוצים לדווח עליהם. לכידת תגובה **מופעלת**. | | **שליחת אימייל** | אל הצוות · נושא `סיכום בוקר — {{datetime.result}}` · הגוף בנוי מערכי `{{http.json...}}` | הוסיפו בלוק **תאריך ושעה** לפני האימייל (פעולה **עיצוב תאריך**, פורמט `%d/%m/%Y`) אם אתם רוצים תאריך נוח בשורת הנושא. --- ## 8. התרעה למנהל כשמדד יורד {#8-alert-a-manager-when-a-metric-slips} חברו התראת אנליטיקס להתרעה אמיתית, ועדכנו כשהמצב חוזר לנורמה. ```text התראת אנליטיקס (התראות: "שיחות ממתינות מעל 20") ├─ התראה ────── שליחת אימייל ── שינוי שיחה (עדיפות: דחופה) └─ התאוששות ── שליחת אימייל ``` | בלוק | הגדרות | | --- | --- | | **התראת אנליטיקס** | סמנו את ההתראה שיצרתם באנליטיקס. | | **שליחת אימייל** (התראה) | נושא `🔴 {{alert.name}}` · גוף `{{alert.report_title}} עומד על {{alert.current_value}} ({{alert.direction}} הסף של {{alert.threshold}}) נכון ל‑{{alert.crossed_at}}.` | | **שליחת אימייל** (התאוששות) | נושא `🟢 {{alert.name}} חזר לנורמה` · גוף `{{alert.report_title}} חזר ל‑{{alert.current_value}}.` | ההתראה מופעלת **פעם אחת** בכל חצייה, כך שאתם מקבלים אימייל אחד — ולא אחד בכל דקה כל עוד המספר גבוה. --- ## 9. תפריט טלפוני עם העברה לנציג {#9-phone-menu-with-agent-transfer} חוויית שיחה נכנסת מלאה. ```text שיחה נכנסת (הקלטה: מופעלת) └─ השמעת צליל "ברוכים הבאים ל‑Acme. השיחה עשויה להיות מוקלטת." └─ שעות פעילות ├─ פתוח ──── תפריט IVR │ ├─ 1 · מכירות ── זמינות נציגים │ │ ├─ מחובר ── העברה לנציג ──┬─ הושלם ── בקשת HTTP │ │ │ └─ נדחה ─── השמעת צליל ─ ניתוק │ │ └─ מנותק ── השמעת צליל ─ ניתוק │ ├─ 2 · תמיכה ─── העברה לטלפון חיצוני │ ├─ פסק זמן ───── השמעת צליל ─ ניתוק │ └─ לא תקין ───── השמעת צליל ─ ניתוק └─ סגור ──── השמעת צליל ─ ניתוק ``` | בלוק | הגדרות | | --- | --- | | **שיחה נכנסת** | תיבת קול: המספר שלכם · הקלטת השיחה: **מופעלת** | | **השמעת צליל** (ברכה) | קובץ WAV שכולל את הודעת ההקלטה. | | **שעות פעילות** | הלוח שלכם. | | **תפריט IVR** | קובץ WAV של התפריט · ספרות `1 · מכירות`, `2 · תמיכה` · פסק זמן לקלט `7000` · ניסיונות מרביים `2` | | **זמינות נציגים** | בדיקה **נציגים ספציפיים** ← צוות המכירות שלכם · נחשב מחובר כאשר **לפחות אחד** | | **העברה לנציג** | ניתוב **כל נציג זמין** · פסק זמן לצלצול `30` | | **בקשת HTTP** (הושלם) | תעדו את `{{call.duration_seconds}}`, `{{call.talk_duration_seconds}}` ו‑`{{call.agent_name}}` במערכת שלכם. | | **העברה לטלפון חיצוני** | קו התמיכה שלכם, בפורמט בינלאומי. **מחייב בקרדיטים.** | | **ניתוק** | סיבה **ניתוק רגיל** | ראו [תהליכי שיחות קול](./voice-flows.md) למדריך הבלוקים המלא. --- ## דפוסים ששווה לחזור עליהם | דפוס | איך | | --- | --- | | **תמיד תנו לאנשים דרך החוצה** | כל תהליך שממתין זקוק להסתעפות ELSE או למסירה, כדי שלקוח לעולם לא ייתקע. | | **תייגו לפני שאתם מוסרים** | שיחה שמגיעה לתור כשהיא כבר מתויגת ובעלת עדיפות חוסכת לנציג צעד. | | **השאירו הערה, לא תעלומה** | הערה פרטית שמסבירה מה הבוט אסף שווה לנציג יותר מציר זמן נקי. | | **תעדו את המזהים** | שלחו את `{{conversation.id}}`, `{{contact.id}}` ו‑`{{system.execution_id}}` לכל מערכת חיצונית שאתם קוראים לה. | | **הוסיפו פתקים להסתעפויות** | חצי שנה אחר כך, פתק שמסביר *למה* קיימת הסתעפות הוא ההבדל בין שיפור תהליך לבנייתו מחדש. | | **שאלה אחת בכל הודעה** | שתי שאלות מקבלות תשובה אחת, ולתנאי שלכם אין מה להתאים בצורה נקייה. | ## הבא - [פתרון תקלות](./troubleshooting.md) — כשמתכון לא מתנהג כמצופה. - [בדיקות ופרסום](./publishing.md) — הדרך הבטוחה לשחרר תהליך. --- # פתרון תקלות מקור: https://docs.teloring.com/he/docs/product/studio/troubleshooting Markdown: https://docs.teloring.com/he/markdown/docs/product/studio/troubleshooting.md מדור: Studio עודכן לאחרונה: 2026-08-20T20:49:57.000Z רוב הבעיות בסטודיו נופלות לשלוש קטגוריות: התהליך מעולם לא התחיל, התהליך התחיל אבל בחר במסלול שגוי, או שבלוק לא עשה את מה שציפיתם. עברו עליהן בסדר הזה. ## התחילו כאן 1. **האם התהליך חי?** תהליכי טיוטה ותהליכים מושהים לעולם אינם רצים על אירועים אמיתיים. 2. **האם פרסמתם אחרי העריכה האחרונה?** העריכה משנה רק את הטיוטה. 3. **האם השיחה בבעלות אדם?** ‏סטודיו מדלג על שיחות שמשויכות לנציג. 4. **הריצו בדיקה.** היא עוברת על הטיוטה עם נתוני דוגמה ומדווחת כמה בלוקים הורצו, וזו הדרך המהירה ביותר להבחין בין בעיית הגדרה לבין טריגר שמעולם לא תאם. :::note מדור **יומן ההרצה** בפאנל הצדדי מסומן **בקרוב** — היסטוריית הרצה לכל בלוק עדיין אינה זמינה. יומן ריק שם אינו עדות לכך שבלוק נכשל. ::: --- ## התהליך לעולם לא רץ | תסמין | סיבה סבירה | תיקון | | --- | --- | --- | | שום דבר לא קורה על הודעה אמיתית | התהליך עדיין בטיוטה, או שהעריכה האחרונה מעולם לא פורסמה | לחצו **פרסום**. | | שום דבר לא קורה והתג מציג **מושהה** | מישהו השהה את התהליך, או ש‑Teloring השהתה אותו כי תלות נמחקה | פתחו **⚙ הגדרות התהליך ← חידוש התהליך**. אם כרטיס התהליך מציג תג אזהרה, תקנו את הבלוק שהוא מציין ופרסמו במקום זאת. | | שום דבר לא קורה, והתהליך *כן* חי | מסנן התיבות של הטריגר אינו כולל את התיבה שממנה בדקתם | פתחו את הטריגר וסמנו את התיבה הנכונה — או הסירו את כל הסימונים כדי להאזין לכולן. | | זה עבד, ואז נעצר | נציג משויך לשיחה | ‏סטודיו אינו מתערב בשיחות שאדם מחזיק בהן. בדקו עם שיחה חדשה. | | זה נעצר עבור לקוח מסוים | הרצה קודמת מסרה את השיחה הזו לאדם | המסירה נשארת בתוקף עד שהשיחה מסומנת כטופלה או שתהליך מריץ **סיום סשן**. סמנו אותה כטופלה ונסו שוב. | | כרטיס התהליך מציג תג אזהרה | תלות נמחקה — בדרך כלל התראת אנליטיקס | תקנו את הבלוק שהוא מציין, ואז פרסמו שוב. | | תהליך מתוזמן לעולם אינו מופעל | אזור הזמן של שורת הלוח, או היום/השעה, אינם מה שחשבתם | בדקו את השורה. זכרו שמרווח ב**ימים** בלוח זמנים חוזר מוגבל ל‑24 שעות. | | ‏Webhook מחזיר שגיאה | הבקשה אינה תואמת לפורמט שנלמד | הפעילו מחדש את **למידת הבקשה הבאה** ושלחו את המבנה החדש פעם אחת. | | רק אחד מכמה תהליכים תואמים רץ | בדרך כלל זה לא כך — כל התהליכים החיים התואמים רצים. אבל ברגע שאחד מוסר את השיחה לאדם, השאר מדולגים | בדקו אם בתהליך קודם מופעלת **התערבות אנושית**. | ## התהליך רץ אבל בוחר מסלול שגוי | תסמין | סיבה סבירה | תיקון | | --- | --- | --- | | תנאי לעולם אינו תואם | לשדה **ערך / משתנה** יש סוגריים מסולסלים סביבו | כתבו `message.content`, לא `{{message.content}}`, באופרנד של תנאי. | | תנאי לעולם אינו תואם, חלק שני | שימוש ב**שווה ל** על טקסט חופשי | עברו ל**מכיל**. אנשים אמיתיים מקלידים "מכירות בבקשה", לא "מכירות". | | השוואה מספרית תמיד נכשלת | הערך אינו מספר | `גדול מ` וחבריו עובדים רק על מספרים. ערך שאינו מספרי לעולם אינו תואם. | | שתי הסתעפויות רצו כשציפיתם לאחת | מצב ההתאמה הוא **כל ההסתעפויות התואמות** | עברו ל**ההתאמה הראשונה בלבד**, וסדרו את הכללים מהספציפי ביותר לכללי ביותר. | | שום דבר אחרי התנאי לא רץ | אף כלל לא תאם ואין הסתעפות ELSE | הוסיפו הסתעפות ELSE. | | התהליך תקוע אחרי שאלה | תנאי שאחרי המתנה לא תאם לדבר ואין ELSE | התהליך ממתין להודעה הבאה ומעריך מחדש. הוסיפו הסתעפות ELSE או בלוק **סיום סשן**. | | הסתעפות רצה אבל לא עושה כלום | פורט הפלט שלה אינו מחובר | גררו מחבר מהפורט הזה. | | בלוק לעולם אינו רץ | אין לו חיבור נכנס | הבלוק מציג *הבלוק הזה אינו מחובר לשום דבר*. חברו אותו. | | שתי הודעות הגיעו באותו זמן למרות המתנה | ההמתנה מעכבת רק את ההסתעפות שלה | הסתעפויות אחיות רצות מיד, בכוונה. שימו את ההמתנה על המסלול המשותף אם אתם רוצים לעכב הכול. | ## משתנה ריק | תסמין | סיבה סבירה | תיקון | | --- | --- | --- | | `{{some.variable}}` מופיע כפשוטו בהודעה | המפתח אינו קיים בנקודה הזו בתהליך | גררו אותו מ**המשתנים הזמינים** במקום להקליד אותו. אם הוא אינו ברשימה, הבלוק שמפיק אותו אינו לפניו. | | `{{contact.name}}` ריק | איש הקשר חדש לגמרי ועדיין אין לו שם | הסתעפו על `contact.name` עם **קיים**, או כתבו ברכה שנקראת היטב גם בלעדיו. | | `{{conversation.id}}` ריק | לטריגר אין שיחה — לוח זמנים, ‏Webhook, התראת אנליטיקס, סטטוס נציג | ספקו מזהה שיחה בעצמכם, מהמטען או מחיפוש. | | `{{http.json.something}}` ריק | לכידת התגובה כבויה, או שהשדה אינו בתגובה | הפעילו את **לכידת התגובה לפעולות הבאות**, ואז שלחו את `{{http.body}}` להערה פרטית כדי לראות בדיוק מה חזר. | | `{{answers.my_field}}` ריק | **מזהה השדה** בטופס אינו `my_field` | מזהי השדות הם שמות המשתנים. בדקו את הטופס. | | `{{webhook.body.x}}` ריק | המטען אינו מכיל `x`, או שהפורמט מעולם לא נלמד | השתמשו ב**למידת הבקשה הבאה** וקראו את צ׳יפי המשתנים שנלמדו. | | `{{var.something}}` ריק | משתנים שמורים הם לכל תהליך בנפרד | ערך `var.*` שנשמר על ידי תהליך אחד אינו גלוי לתהליך אחר. | ## בלוק נכשל | בלוק | תסמין | תיקון | | --- | --- | --- | | **מענה בהודעה** | שום דבר אינו נשלח | בדקו שמזהה השיחה מתפענח, ושהערוץ עדיין יכול לשלוח (חלון WhatsApp שפג, תיבה מנותקת). | | **בקשת HTTP** | נכשלת תמיד | ‏סטודיו קורא רק לכתובות ציבוריות. ‏localhost, רשתות פרטיות ושמות מארח פנימיים חסומים. | | **בקשת HTTP** | תיבת JSON אדומה | הגוף אינו JSON תקין אחרי מילוי המשתנים. חפשו פסיק חסר או מחרוזת ללא מרכאות. | | **שליחת אימייל** | *בחרו מאיזו תיבת אימייל לשלוח* | בחרו תיבה, או העבירו את **שליחה מ** לשולח המערכתי של Teloring. | | **שליחת אימייל** | אין תיבות ברשימה הנפתחת | חברו תיבת אימייל ב[טבעת הערוצים](../ring/email.md), או השתמשו בשולח המערכתי. | | **שליחת אימייל** | הנמענים נדחו | לכל היותר 25 כתובות בסך הכול בשדות **אל**, **CC** ו‑**BCC**. חפשו טעות הקלדה. | | **קוד** | נכשל בכל פעם | הקוד חייב להחזיר ערך עם `return`. גם אין לו גישה לרשת — לשם כך השתמשו בבקשת HTTP. | | **רשומת לקוח** | *בחרו לאיזה סוג אובייקט הרשומה שייכת* | בחרו סוג אובייקט; רשימת השדות נגזרת מהבחירה הזו. | | **רשומת לקוח** | האימות נכשל | ערך אינו מתאים לסוג השדה. בדקו את הגדרות השדות של האובייקט. | | **עדכון איש קשר** | שדה חסר ברשימה הנפתחת | מופיעים רק שדות שהוגדרו בעורך השדות של איש הקשר. שדות מערכת מוגנים אינם ניתנים לכתיבה. | | **זמינות נציגים** | תמיד **מנותק** | כאשר **נציגים ספציפיים** נבחר ואף אחד לא סומן, התשובה היא תמיד מנותק — בכוונה. בחרו נציגים, או עברו ל*כל אחד בחשבון*. | | **זמינות נציגים** | נציג AI אינו נספר | נציגי AI לעולם אינם נחשבים מחוברים; אין להם סשן. | | **שעות פעילות** | תמיד **סגור** | בדקו את אזור הזמן של הלוח ואת השעות השבועיות שלו בהגדרות, והאם לוח חגים סוגר את היום. | ## בעיות בערוץ הקול | תסמין | סיבה סבירה | תיקון | | --- | --- | --- | | בלוקי קול חסרים בבורר | לתהליך אין טריגר **שיחה נכנסת** | רק תהליך שמתחיל בשיחה נכנסת הוא תהליך קול. | | הפרסום חסום | בלוק הודעות נמצא בתהליך קול, או להפך | הסירו את הבלוק שתג האזהרה מציין. | | ההקלטה אינה מושמעת | הקובץ אינו WAV | ‏WAV בלבד. הפורמט הבטוח הוא 8 kHz מונו PCM. | | מתקשרים שומעים שקט והקו נופל | מסלול מסתיים בלי העברה או ניתוק | סיימו כל מסלול בהודעת סיום וב**ניתוק**. | | לחיצה על מקש אינה עושה דבר | הפורט של הספרה הזו אינו מחובר | חברו כל ספרה, וגם את **פסק זמן** ואת **לא תקין**. | | העברה לנציג לעולם אינה מתחברת | הנציג אינו מחובר — אין רישום טלפון קבוע | שלבו אותה עם **זמינות נציגים**, ותמיד חברו את הפלט **נדחה**. | | לא נשמרה הקלטה | ההקלטה כבויה בטריגר | ההקלטה נשלטת רק על ידי **הקלטת השיחה** בטריגר שיחה נכנסת. | | הרצת בדיקה אינה מצלצלת בטלפון | הרצת בדיקה אינה יכולה לבצע שיחות | חייגו למספר באמת. | ## בנייה עם AI‏ (Hermes) | תסמין | סיבה סבירה | תיקון | | --- | --- | --- | | **בנייה בעזרת AI** אפור | המתג **AI Studio** כבוי בחשבון | מנהל חשבון מפעיל אותו ב[עולם AI](../ai-world.md). | | *"בתהליך הזה כבר יש בלוקים. צרו תהליך חדש כדי לבנות אחד בעזרת AI."* | פתחתם את בונה ה‑AI על תהליך שכבר יש לו קנבס | ‏Hermes בונה רק לתוך תהליך ריק, כדי שלעולם לא ימחק עבודה שמישהו עשה ידנית. צרו תהליך חדש. | | **בנה את התהליך** נדחה, עם הפניה לעורך | הקנבס נערך ידנית במהלך הריאיון | העריכות שלכם מנצחות. סיימו את התהליך בעורך, או התחילו תהליך חדש וריאיון חדש. | | תיבת ההודעה מושבתת | התהליך נבנה — השיחה נסגרת בכוונה | ערכו את התהליך על הקנבס, או צרו תהליך חדש כדי להריץ ריאיון חדש. | | השיחה נפתחת מחדש במקום הקנבס | בתהליך עדיין מוצג **⚡ המשך עם AI** | זה הריאיון שלא הושלם. השתמשו בכפתור **עריכה** בכרטיס כדי להגיע לקנבס. | | ‏Hermes בחר תיבה או צוות שגויים | נאמר לו משהו שגוי, או שהמשאב עדיין לא היה קיים | פתחו את הבלוק על הקנבס ובחרו את הנכון. צרו תיבות וצוותים חסרים *לפני* הריאיון. | | לבלוק ש‑Hermes יצר יש תג ⚠ | הוא זקוק למשהו שרק אתם יכולים לספק — בדרך כלל קובץ WAV או תבנית WhatsApp | פתחו את הבלוק ומלאו אותו. רשימת **דורש את תשומת ליבכם** בסרגל אמרה זאת במהלך הריאיון. | | *"Hermes לא הצליח לענות על זה. שלחו את ההודעה שוב."* | ה‑AI החזיר תשובה שסטודיו לא הצליח לקרוא. התור **לא** נשמר, כך ששום דבר אינו חורג מסנכרון | ההודעה שלכם מוחזרת לתיבה — לחצו שליחה שוב. | | *"התשובה הזו הייתה ארוכה מדי כדי ש‑Hermes יסיים."* | תשובה בודדת חרגה ממה שה‑AI יכול להפיק בתור אחד | שלחו את אותו דבר בחלקים קצרים יותר, או פצלו לשתי תשובות. | | הריאיון נעצר והודיע שהגיע למגבלה | ריאיון מוגבל ל‑60 שאלות, ולחשבונות יש הגבלת קצב הודעות קצרה | ההתקדמות נשמרת. המתינו רגע והמשיכו, או סיימו את התהליך ידנית בעורך. | | סגרתי את הלשונית ואיבדתי את המקום | לא איבדתם — כל תשובה נשמרת | פתחו את התהליך מחדש מרשימת סטודיו ולחצו על הכרטיס. | ## דברים שמפתיעים אנשים | התנהגות | למה זה עובד כך | | --- | --- | | עריכת תהליך חי אינה משנה דבר עד שאתם מפרסמים | הטיוטה והגרסה החיה הם עותקים נפרדים בכוונה. | | המחיקה מבקשת שתקלידו את שם התהליך | המחיקה היא לצמיתות ולוקחת איתה את הגרסאות ואת המשתנים השמורים, ולכן היא דורשת אישור מודע. | | השהיה אינה זהה למחיקה | תהליך מושהה שומר כל בלוק וניתן לחידוש בלחיצה אחת. | | מסנן ריק פירושו "הכול" | טריגר של הודעה נכנסת בלי תיבות מסומנות מאזין לכולן. | | בחירת נציגים ריקה פירושה "אף אחד" | בזמינות נציגים, בלוק **נציגים ספציפיים** שלא הושלם לא צריך להתנהג כמו *כל אחד*. | | המתנה אינה מעכבת הסתעפויות אחרות | רק ההסתעפות שההמתנה יושבת עליה מושהית. | | משתנה שמור אינו משותף בין תהליכים | `var.*` מוגדר לכל תהליך בנפרד, כדי ששני תהליכים לא ידרסו זה את זה. | | שכפול בלוק אינו מעתיק את החיבורים שלו | כמעט אף פעם אינכם רוצים שהעותק יהיה מחווט באותה צורה. | | פתקים לעולם אינם רצים | הם הערות לעורך בלבד ואינם חלק מהתהליך שפורסם. | | בניית תהליך AI מסיימת את השיחה | ברגע שהבלוקים שלכם לעריכה, בנייה מחדש הייתה חייבת לדרוס את השינויים שלכם. | ## איך להשיג יותר פרטים | היכן | מה זה מספר לכם | | --- | --- | | **הרצת בדיקה** | האם מבנה הטיוטה תקין, בלי לגעת בלקוחות. | | **הערה פרטית זמנית** | שתלו אחת בהסתעפות עם המשתנים שאתם לא בטוחים לגביהם — זו הדרך המהירה ביותר לראות מה בלוק באמת הפיק. | | **היסטוריית גרסאות** (סרגל הגרסה) | מה השתנה, מתי, ומי שינה — ואת הכפתור לחזרה לאחור. | | **יומן הלוגים** (הגדרות) | מי פרסם, השהה, חידש, שחזר או מחק תהליך. | ## הבא - [בדיקות ופרסום](./publishing.md) — שגרת שחרור בטוחה. - [מתכוני תהליכים](./examples.md) — תהליכים ידועים כתקינים להשוואה. --- # תפקידים והרשאות מקור: https://docs.teloring.com/he/docs/product/roles/overview Markdown: https://docs.teloring.com/he/markdown/docs/product/roles/overview.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z **תפקיד** הוא חבילת הרשאות בעלת שם. אתם קובעים פעם אחת למה תפקיד רשאי לגשת, ואז נותנים את התפקיד הזה לכמה נציגים שתרצו. שנו את התפקיד בהמשך ו**כל מי שמשויך אליו יעודכן מיד** — לעולם אינכם עורכים הרשאות לאדם אחד בכל פעם. פתחו **ניהול ← נציגים, צוותים ותפקידים ← תפקידים והרשאות** בסרגל הצד. ![עמוד התפקידים וההרשאות עם חמשת כרטיסי תפקידי ברירת המחדל](pathname:///img/screenshots/he/product/roles/roles-overview.png) כל חשבון מגדיר את התפקידים שלו. אין רשימה קבועה של שמות תפקידים ב‑Teloring — ‏*Owner*,‏ *Team Leader*,‏ *Marketing*,‏ *Agent* ו‑*Viewer* הם חמש נקודות פתיחה שמגיעות עם החשבון שלכם, ואפשר לשנות את שמם, את היקפם, לשכפל או למחוק כל אחד מהם, למעט **Owner**. :::info בידוד חשבונות תפקידים שייכים אך ורק לחשבון Teloring הנוכחי. תפקיד שנוצר כאן לעולם אינו גלוי בחשבון אחר, ולנציג אפשר לתת רק תפקיד שקיים בחשבון שלו. ::: ## מה תפקיד שולט בו תפקיד עונה על שתי שאלות נפרדות, והן פועלות בצורה שונה. לכל אחת יש לשונית משלה בעורך התפקידים. | לשונית | על איזו שאלה היא עונה | איך זה מבוטא | | --- | --- | --- | | **הרשאות מערכת** | *האם הנציג הזה רשאי להגיע ליכולת הזו?* | כל יכולת מפוצלת לעד ארבע פעולות: **צפייה**, **יצירה**, **עדכון**, **מחיקה**. | | **הרשאות ערוצים** | *באילו תיבות הנציג הזה עובד, ומה מותר לו לעשות שם?* | 18 יכולות של הפעלה/כיבוי, שנקבעות בנפרד לכל תיבה. | הפיצול קיים כי מדובר בשתי בעיות שונות באמת. "האם האדם הזה יכול לפתוח אנליטיקס?" היא שאלת כן/לא על עמוד. "האם האדם הזה יכול לראות את תור ההמתנה של WhatsApp אבל לא של האימייל?" היא שאלה על *מקומות*, ושום שילוב של צפייה/יצירה/עדכון/מחיקה אינו מתאר אותה. - **[מדריך הרשאות המערכת ←](./system-permissions.md)** כל יכולת ומה כל פעולה פותחת - **[מדריך הרשאות הערוצים ←](./channel-permissions.md)** כל 18 יכולות התיבה, וכלל התיבה העתידית - **[תפקידים ומתכונים לדוגמה ←](./examples.md)** הגדרות מוכנות להעתקה ## עובדות מרכזיות | עובדה | משמעות | | --- | --- | | תפקיד הוא חבילת הרשאות | לא תואר תפקיד, ולא צוות. | | לנציג יש בדיוק תפקיד אחד | אין ערימה או שילוב של תפקידים. | | התפקידים הם ברמת החשבון | כולם עובדים מאותה רשימת תפקידים. | | עריכת תפקיד משפיעה על כל מי שמשויך אליו | מיד, כבר בלחיצה הבאה שלהם. אין צורך בהתחברות מחדש. | | ‏Owner אינו ניתן לעריכה או למחיקה | בכוונה — ראו [תפקיד ה‑Owner](#the-owner-role). | | צוות אינו הרשאה | חברות ב[צוות](../teams.md) משפיעה רק על *ניתוב* שיחות. היא אינה מעניקה ואינה מגבילה דבר. | | מחלקה אינה הרשאה | שדה **המחלקה** של נציג הוא תווית טקסט חופשי לתצוגה ולחיפוש. | | נאכף בשרת | הסתרת כפתור היא נימוס. הכלל מוחל שוב בכל בקשה. | | עד 50 תפקידים בחשבון | מספיק לכל מבנה אמיתי; אם אתם צריכים יותר, כנראה שאתם מתארים אנשים ולא תפקידים. | :::warning ההרשאות נאכפות פעמיים, בכוונה Teloring מסתירה את מה שנציג אינו יכול להשתמש בו — פריטי תפריט נעלמים, כפתורים מתפוגגים, תורים חוזרים ריקים. זה נועד רק לשמור על סביבת עבודה כנה ונקייה. ההגנה האמיתית נמצאת בשרת. כל פעולה בודקת את התפקיד שוב לפני שהיא רצה, כך שנציג שמגיע ליכולת מוגבלת בדרך אחרת — קישור שמור, קונסולת דפדפן, ה‑API הציבורי — נדחה עם שגיאת *אין הרשאה*. לעולם אינכם צריכים להסתמך על כך שהממשק מסתיר משהו. ::: --- ## עמוד התפקידים ### כרטיסי תפקיד העמוד נפתח בגלריה עם כרטיס אחד לכל תפקיד. ![כרטיס תפקיד בודד עם התג, התיאור, מספר הנציגים ומספר ההרשאות](pathname:///img/screenshots/he/product/roles/role-card.png) | רכיב | מה הוא מציג | | --- | --- | | **שם התפקיד** | השם שנציגים ומנהלים רואים בעת השיוך. | | **תג** | **קבוע**, **ברירת מחדל** או **מותאם** — ראו את הטבלה למטה. | | **תיאור** | ההערה שלכם על מה התפקיד הזה נועד. היא מופיעה שוב מתחת לבוחר התפקידים בעמוד הנציגים, אז כתבו אותה עבור מי שבוחר. | | **נציגים** | כמה נציגים **פעילים** מחזיקים כרגע בתפקיד הזה. נציגים שהושבתו אינם נספרים. | | **הרשאות** | כמה הרשאות בודדות מוענקות. מדד גס לרוחב התפקיד — שימושי לזיהוי תפקיד שגדל בשקט. ל‑Owner מוצג `∞`. | | **עריכה** / **צפייה** | פותח את עורך התפקידים. מוצג **צפייה** עבור תפקיד ה‑Owner ועבור כל מי שאין לו הרשאה לשנות תפקידים. | | **שכפול** | יוצר עותק שלא נשמר — *Agent* הופך ל‑`Agent (copy)` — עם אותן הרשאות, מוכן להתאמה. הדרך המהירה ביותר לבנות תפקיד חדש. | | **מחיקה** | מסיר את התפקיד. ראו [מחיקת תפקיד](#delete-a-role). | ### תגים | תג | משמעות | | --- | --- | | **קבוע** | תפקיד ה‑Owner. גישה מלאה, לצמיתות. אינו ניתן לשינוי או למחיקה על ידי אף אחד. | | **ברירת מחדל** | אחד מחמשת התפקידים שנוצרו יחד עם החשבון. ניתן לעריכה ולמחיקה במלואו — התג רק אומר לכם ש‑Teloring יצרה אותו, לא אתם. | | **מותאם** | תפקיד שמישהו בחשבון שלכם יצר. | ### כפתורים ומצבים | רכיב | מה הוא עושה | | --- | --- | | **+ תפקיד חדש** | פותח עורך תפקידים ריק. מוסתר אם אין לכם הרשאה ליצור תפקידים. | | **אין עדיין תפקידים** | מצב ריק, עם קיצור דרך ליצירת התפקיד הראשון. בדרך כלל לא תראו את זה — כל חשבון נוצר עם חמישה. | --- ## יצירת תפקיד 1. פתחו **ניהול ← נציגים, צוותים ותפקידים ← תפקידים והרשאות**. 2. לחצו **+ תפקיד חדש** — או לחצו **שכפול** על התפקיד הקרוב ביותר למה שאתם רוצים, מה שבדרך כלל מהיר יותר. 3. הזינו **שם תפקיד**. זה מה שמופיע בבוחר התפקידים בעמוד הנציגים, אז תנו שם ברור: *מפקח משמרת לילה*, לא *תפקיד 4*. 4. אופציונלית, כתבו **תיאור** — למה התפקיד הזה נועד. הוא מוצג מתחת לבוחר כשמישהו משייך אותו. 5. בלשונית **הרשאות מערכת**, סמנו למה התפקיד הזה רשאי להגיע. 6. בלשונית **הרשאות ערוצים**, קבעו קודם את ברירות המחדל של **התיבה העתידית**, ואז התאימו את התיבות הבודדות שנבדלות. 7. לחצו **שמירה**. ![עורך התפקידים עם שדות השם והתיאור ושתי הלשוניות](pathname:///img/screenshots/he/product/roles/role-editor-header.png) ### מדריך השדות | שדה | חובה | מגבלה | הערות | | --- | --- | --- | --- | | **שם התפקיד** | כן | 60 תווים | לפחות 2 תווים וייחודי בחשבון. השמות מושווים בלי רגישות לאותיות גדולות/קטנות, כך ש‑`Agent` ו‑`agent` מתנגשים. | | **תיאור** | לא | 400 תווים | טקסט חופשי. מוצג בכרטיס התפקיד ומתחת לבוחר התפקידים בעמוד הנציגים. | :::tip התחילו משכפול בניית תפקיד מרשת ריקה פירושה סימון עשרות תיבות וניסיון לזכור מה נציג תמיכה באמת צריך. שכפול של **Agent** או **Team Leader** ושינוי של חמישה דברים מהיר יותר והרבה פחות מועד לטעויות. ::: --- ## עריכת תפקיד לחצו **עריכה** על הכרטיס, שנו מה שצריך ולחצו **שמירה**. **השינוי מיידי.** כל מי שמשויך לתפקיד מקבל את ההרשאות החדשות בלחיצה הבאה שלו — אף אחד לא צריך להתנתק ולהתחבר מחדש. אם אתם מסירים הרשאה ממישהו שמשתמש ביכולת הזו ממש עכשיו, הפעולה הבאה שלו שם תידחה. :::warning עריכת התפקיד שלכם עצמכם אם אתם עורכים את התפקיד שאתם עצמכם מחזיקים, אתם משנים את הגישה שלכם. הסרת **תפקידים והרשאות ← עדכון** מהתפקיד שלכם פירושה שלא תוכלו עוד לפתוח את העמוד הזה כדי להחזיר את זה. Teloring אינה עוצרת אתכם: בחשבון יכולים להיות כמה תפקידים שמנהלים תפקידים, וניחוש כוונותיכם היה גרוע יותר. אם זה קורה, ‏Owner יכול לשחזר — וזו הסיבה ש‑Owner אינו ניתן לעריכה. ::: --- ## מחיקת תפקיד {#delete-a-role} לחצו **מחיקה** על הכרטיס. **אם אף אחד אינו מחזיק בתפקיד**, הוא מוסר מיד. **אם נציגים עדיין מחזיקים בו**, Teloring לא תשאיר אותם יתומים. הדיאלוג מודיע לכם כמה יש ושואל לאיזה תפקיד הם צריכים לעבור. ![דיאלוג מחיקת תפקיד ששואל לאיזה תפקיד הנציגים המושפעים עוברים](pathname:///img/screenshots/he/product/roles/delete-role.png) | רכיב | מה הוא עושה | | --- | --- | | **העבירו את הנציגים האלה ל** | התפקיד שכל נציג מושפע יקבל. כל תפקיד אחר בחשבון מופיע ברשימה. | | **מחיקה** | מעביר את הנציגים, ואז מוחק את התפקיד. | | **ביטול** | שום דבר לא משתנה. | מחיקת תפקיד **אינה** מוחקת נציגים, שיחות, לקוחות או כל דבר אחר. הנציגים המושפעים ממשיכים לעבוד מיד — עם ההרשאות של התפקיד החדש שלהם. :::note אי אפשר למחוק את תפקיד ה‑Owner כפתור **מחיקה** אינו מופיע בכרטיס ה‑Owner, וה‑API דוחה את הבקשה. ראו למטה. ::: --- ## תפקיד ה‑Owner {#the-owner-role} **Owner** הוא התפקיד היחיד ש‑Teloring מתייחסת אליו כמיוחד. יש לו גישה מלאה להכול, לצמיתות, והוא **אינו ניתן לעריכה או למחיקה על ידי אף אחד — כולל Owner**. זו אינה שגגה. אפשר לצמצם כל תפקיד אחר עד שלא יוכל עוד להגיע לעמוד התפקידים, ולכן בלי תפקיד אחד שמובטח שיעבוד, חשבון היה יכול לנעול את עצמו מחוץ לסביבת העבודה שלו בשמירה שגויה אחת. ‏Owner הוא ההבטחה הזו. | שאלה | תשובה | | --- | --- | | אפשר לשנות מה מותר ל‑Owner? | לא. הכרטיס שלו נפתח לקריאה בלבד, מסומן במלואו, ללא כפתור **שמירה**. | | אפשר למחוק אותו? | לא. | | אפשר לשנות את שמו? | לא. | | אפשר לתת Owner ליותר אנשים? | **כן** — לכמה שתרצו. זהו שיוך רגיל בעמוד הנציגים. | | למי הוא בהתחלה? | לאדם שיצר את החשבון. | | אפשר לקחת Owner ממישהו? | כן, כל עוד יש למישהו אחר. | ### ה‑Owner האחרון מוגן Teloring דוחה כל שינוי שיותיר את החשבון **ללא Owner פעיל**: - העברת ה‑Owner האחרון לתפקיד אחר; - השבתת ה‑Owner האחרון; - מחיקת הפרופיל של ה‑Owner האחרון. כל שלושת המקרים חסומים עם ההודעה *"זהו ה‑Owner האחרון בחשבון. תנו Owner לנציג אחר קודם."* — גם מעמוד הנציגים וגם מכלי התמיכה של Teloring. שני דברים לעולם אינם נחשבים כגיבוי: נציג **מושבת**, ו**נציג AI**. תוכנה אינה יכולה לנהל חשבון. :::tip תנו Owner לשני אנשים ‏Owner אחד הוא נקודת כשל יחידה — מישהו בחופשה, מישהו שעזב. שני Owners פירושם שההגנה שלמעלה לעולם לא תפריע לכם, ותמיד יש מישהו שיכול להגיע לחיובים ולהגדרות. ::: --- ## שיוך תפקיד לנציג התפקידים משויכים בעמוד **נציגים**, לא כאן. 1. פתחו **ניהול ← נציגים, צוותים ותפקידים ← נציגים**. 2. לחצו על ✏️ בשורת הנציג — או על **הוספת נציג** עבור מישהו חדש. 3. בחרו **תפקיד**. הרשימה מכילה כל תפקיד בחשבון שלכם, והתיאור מופיע מתחת כדי שתוכלו לוודא שבחרתם נכון. 4. שמרו. ![בוחר התפקידים בטופס הנציג, עם תיאור התפקיד מתחת](pathname:///img/screenshots/he/product/roles/agent-role-picker.png) ההרשאות החדשות של הנציג חלות מיד, בלחיצה הבאה שלו. | מצב | מה קורה | | --- | --- | | נציג חדש נוצר בלי בחירת תפקיד | מקבל את תפקיד **Agent** של החשבון — ברירת המחדל ההגיונית עם ההרשאות המצומצמות ביותר, לעולם לא "אין גישה". | | התפקיד של נציג נמחק | הוא מועבר לתפקיד שנבחר בדיאלוג המחיקה. | | הנציג הוא ה‑Owner האחרון | אי אפשר להעביר אותו לתפקיד אחר עד שמישהו אחר יהיה Owner. | עמודת **התפקיד** בטבלת הנציגים מציגה את שם התפקיד של כל אדם, כך שאפשר לסרוק את הרשימה ולראות למי יש מה. ראו [נציגים ונציגי AI](../agents.md). :::note לנציגי AI אין תפקידים לנציג AI אין התחברות, ולכן תפקיד לא היה אומר לו דבר. מה שמותר לנציג AI לעשות מוגדר בפרופיל שלו — ראו [נציגים ונציגי AI](../agents.md). ::: --- ## חמשת תפקידי ברירת המחדל כל חשבון חדש נוצר עם החמישה האלה. הם נקודת פתיחה, לא מבנה קבוע: שנו את שמם, שנו את היקפם, או מחקו את אלה שאינכם צריכים. | תפקיד | נבנה עבור | אופי | | --- | --- | --- | | **Owner** | האדם שמחזיק בסביבת העבודה | הכול, לצמיתות. קבוע. | | **Team Leader** | מנהל תמיכה שאינו בעל החשבון | מנהל את הרצפה: כל תיבה, כל שיחה, צוותים, סטודיו, מאגר ידע, אנליטיקס מלא, שעות פעילות. **ללא חיובים, ללא ניהול נציגים, ללא מפתחות API, ללא מחיקת סביבת העבודה.** | | **Marketing** | קמפיינים, אוטומציות ודיווח | אנליטיקס, סטודיו, טפסים, מאגר ידע, לקוחות. מטפל בשיחות שלו אבל **אינו רואה את תורי התמיכה המשותפים**. | | **Agent** | תמיכה בקו הראשון | טיפול מלא בשיחות בכל תיבה, למעט התורים של בוט סטודיו ונציג AI. לקוחות: צפייה/יצירה/עדכון. ללא ניהול חשבון. | | **Viewer** | מבקר לקריאה בלבד — רואה חשבון, יועץ, בעל עניין | קורא אנליטיקס, לקוחות והגדרות. **ללא גישה לשיחות כלל.** | להרשאות המדויקות, ראו את טבלאות ההשוואה ב[הרשאות מערכת](./system-permissions.md#what-the-default-roles-grant) וב[הרשאות ערוצים](./channel-permissions.md#what-the-default-roles-grant). :::info שמות תפקידי ברירת המחדל עוקבים אחרי השפה שלכם חמשת השמות והתיאורים שלמעלה מוצגים בשפת הממשק של כל נציג — קונסולה בעברית מציגה *בעלים* במקום *Owner*, בלי ששום דבר שונה בחשבון. ברגע שאתם עורכים את ה**שם** או ה**תיאור** של תפקיד ברירת מחדל, הוא הופך לטקסט שלכם ו‑Teloring מפסיקה לתרגם את השדה הזה. שנו את *Agent* ל*נציג תמיכה* וכל נציג יראה *נציג תמיכה*, בכל שפה שהוא משתמש בה. תפקידים שאתם יוצרים בעצמכם לעולם אינם מתורגמים, מאותה סיבה. ::: :::info חשבון קיים שמעולם לא ראה את העמוד הזה חשבונות שנוצרו לפני שהתפקידים וההרשאות היו קיימים מקבלים את אותם חמישה תפקידים בפעם הראשונה שהעמוד נפתח, והנציגים הקיימים שלהם מותאמים לתפקיד הקרוב ביותר — מנהל החשבון הופך ל‑**Owner**, וכל השאר הופכים ל‑**Agent**. שום דבר לא אובד ואין צורך במיגרציה. סקרו את השיוכים בעמוד הנציגים אחר כך. ::: --- ## מה לעולם אינו מוגבל חלקים מסוימים ב‑Teloring זמינים לכל נציג מחובר, בלי קשר לתפקידו. הם אינם ברשת ההרשאות כי כיבוי שלהם היה מייצר סביבת עבודה שבורה ולא מוגבלת. | תמיד זמין | למה | | --- | --- | | **לוח הבקרה** (הבית) | עמוד הנחיתה אחרי ההתחברות. התוכן שלו כבר משקף את מה שהנציג רשאי לראות. | | תפריט **השיחות** והתורים שלו | התפריט לעולם אינו נעלם. מה שמופיע *בתוך* כל תור נשלט על ידי [הרשאות הערוצים](./channel-permissions.md). | | **שלי** | שיחות המשויכות לנציג תמיד נגישות, בכל תיבה. ראו [למה "שלי" לעולם אינו מסונן](./channel-permissions.md#why-mine-is-never-filtered). | | **מדריכים** | אתר התיעוד הזה. | | **הפרופיל שלהם** | שם, תמונה, שפה, אזור זמן, הסיסמה והאימייל שלהם. | | **התראות** והפעמון | נציג חייב להיות מסוגל לראות על מה הותרע לו. | | **צ׳אט הצוות** | צ׳אט פנימי בין נציגים. | | **הסופטפון הקולי** | ביצוע וקבלה של שיחות. *הגדרת תיבת הקול* עדיין נמצאת תחת **טבעת הערוצים**, וגישה קולית לכל נציג עדיין מופעלת על ידי מי שיש לו הרשאות נציגים. | --- ## היכן התפקידים נאכפים שימושי לדעת כשאתם בודקים תפקיד, או מסבירים לנציג למה משהו נעלם. | שכבה | מה היא עושה | | --- | --- | | **סרגל הצד והתפריטים** | פריטים שהתפקיד אינו יכול להגיע אליהם אינם מוצגים כלל. מדור שלם נעלם כשהתפקיד אינו מגיע לאף חלק ממנו — אין כותרת *ניהול* ריקה. | | **כפתורים ופקדים** | פקדי יצירה, עריכה ומחיקה מוסתרים. חלק מהפקדים — בוחר עדיפות או תווית בתוך שיחה — מוצגים אפורים במקום, כך שהנציג עדיין יכול *לקרוא* את הערך הנוכחי. | | **רשימות ומונים** | תורי שיחות ומספרי התג שלהם בסרגל הצד כוללים רק תיבות שהתפקיד רשאי לראות. תג לעולם אינו מציג 12 מעל רשימה של 3. | | **חיפוש** | חיפוש שיחות והודעות מוגבל לאותן תיבות כמו התור שנחפש בו, כך שהחיפוש לעולם אינו יכול לחשוף משהו שהרשימה הייתה מסתירה. | | **עמודים** | פתיחת עמוד מוגבל לפי כתובת מפנה ללוח הבקרה עם ההודעה *"אין לכם הרשאה לעשות זאת"*. | | **כל בקשת API** | הבדיקה הסופית. נדחית עם HTTP 403 וההרשאה החסרה המדויקת, בין שהבקשה הגיעה מסביבת העבודה, מסקריפט או מה‑API הציבורי. | | **יומן הלוגים** | ‏`role.created`,‏ `role.updated` ו‑`role.deleted` נרשמים, עם מי ביצע ומה השתנה. ראו **ניהול ← יומן לוגים**. | ### מה מפתח API יכול לעשות **מפתח API** של חשבון הוא אישור למכונה ואינו נושא תפקיד. הוא יכול להגיע ל‑API התפעולי — שיחות, הודעות, אנשי קשר, לקוחות, רשומות CRM, תצוגות, סטודיו, טפסים, מאגר ידע — והוא אינו יכול להגיע לנציגים, לצוותים, לתפקידים, לחיובים, להגדרות, להגדרת תיבות או למעצב אובייקטי ה‑CRM. זה קבוע ואינו ניתן להגדרה. נהלו מפתחות תחת **הגדרות ← API**, מה שדורש את ההרשאה **הגדרות ← API**. --- ## מגבלות ודברים שכדאי לשים לב אליהם אלו מגבלות מוצר אמיתיות היום, לא טעויות מצידכם. | פריט | מה באמת קורה | עשו זאת במקום | | --- | --- | --- | | **תפקיד אחד לנציג** | נציג אינו יכול להחזיק בשני תפקידים. אין שילוב או ערימה. | שכפלו את התפקיד הקרוב ביותר והתאימו אותו. | | **אין ירושת תפקידים** | התפקידים שטוחים. עריכת *Agent* אינה משפיעה על תפקיד ששכפלתם ממנו. | החילו את השינוי מחדש על כל תפקיד, או החזיקו פחות תפקידים. | | **ניהול תפקידים הוא כוח רב** | כל מי שיש לו **תפקידים והרשאות ← יצירה** או **עדכון** יכול להעניק לעצמו הכול, כי זו בדיוק המשמעות של עריכת תפקיד. | תנו את זה לכמה שפחות אנשים — בדרך כלל רק ל‑Owners. | | **אתם יכולים לנעול את עצמכם מחוץ לעמוד** | הסרת הרשאה מהתפקיד שלכם עצמכם נכנסת לתוקף מיד, כולל לעמוד התפקידים עצמו. | החזיקו שני Owners. בדקו תפקידים מגבילים על נציג רזרבי, לא על עצמכם. | | **אין שעות עבודה לפי תפקיד** | לתפקיד אין לוח זמנים. הוא אינו יכול להעניק גישה רק במשמרת. | השתמשו ב[שעות פעילות](../settings.md) בסטודיו, או השביתו את הנציג. | | **אין הרשאות ברמת הרשומה** | ההרשאות הן לפי יכולת ולפי תיבה, לעולם לא לפי לקוח, תצוגה או דוח בודדים. נציג שיכול לקרוא לקוחות יכול לקרוא את כולם. | הפרידו את הנתונים לפי תיבה במקומות שזה חשוב. | | **צוות ≠ הרשאה** | חברות ב[צוות](../teams.md) אינה מגבילה מה נציג יכול לפתוח. הצוותים משפיעים רק על ניתוב. | השתמשו בהרשאות ערוצים לצורך נראות. | | **תפקיד ללא שום סימון** | נשמר בסדר גמור. הנציגים שלו יכולים להתחבר, לראות את לוח הבקרה, ולהגיע לשום דבר אחר. | שימושי רק לחשבון מושהה. השביתו את הנציג במקום. | | **מחיקת תיבה** | ההגדרות שלה לכל תפקיד נשארות שמורות, בלי נזק, ונעלמות מהעורך. | אין מה לעשות. | --- ## פתרון תקלות ### נציג אומר שפריט תפריט נעלם התפקיד שלו אינו מעניק **צפייה** ביכולת הזו. פתחו **ניהול ← נציגים, צוותים ותפקידים ← תפקידים והרשאות**, ערכו את התפקיד שלו וסמנו **צפייה** עבורה. הפריט יופיע מחדש בטעינת העמוד הבאה שלו. ### נציג יכול לפתוח עמוד אבל כל הכפתורים חסרים **צפייה** מוענקת, ואילו **יצירה**, **עדכון** ו**מחיקה** לא. זו ההתנהגות המכוונת של תפקיד לקריאה בלבד — הנציג יכול להסתכל, לא לשנות. ### תור ריק אצל נציג אחד ומלא אצל אחר תפקידים שונים, או אותו תפקיד עם תיבות שונות מסומנות. פתחו את לשונית **הרשאות ערוצים** של התפקיד ובדקו את היכולת לאותו תור — `צפייה בתור ההמתנה` עבור **ממתינות בתור**, `צפייה בכל השיחות הפתוחות` עבור **כל הפתוחות**, וכן הלאה. ראו [הרשאות ערוצים](./channel-permissions.md). ### "קבלת הבא בתור" אומר שאין שיחות ממתינות, אבל התור מציג שיחות `קבלת הבא בתור` היא הרשאה נפרדת מ‑`צפייה בתור ההמתנה`, לכל תיבה. תפקיד יכול לצפות בתור בלי שיקבל ממנו עבודה. סמנו **קבלת הבא בתור** עבור אותה תיבה. בדקו גם את [הצוותים](../teams.md): לנציג אפשר למסור רק שיחה ללא צוות, או שיחה מצוות שהוא חבר בו. ### אני לא מצליח להסיר את הסימון מ"צפייה" כי **יצירה**, **עדכון** או **מחיקה** מסומנים באותה שורה, ואף אחד מהם אינו יכול לעבוד בלי צפייה. הסירו קודם את סימוני הכתיבה והצפייה תשתחרר. ראו [איך ארבע הפעולות עובדות](./system-permissions.md#how-the-four-actions-work). ### "כבר קיים תפקיד בשם הזה" השמות ייחודיים לחשבון ומושווים בלי רגישות לאותיות גדולות/קטנות, כך ש‑`Agent` ו‑`agent` מתנגשים. בחרו שם אחר או ערכו את התפקיד הקיים. ### "זהו ה‑Owner האחרון בחשבון" אתם מנסים להעביר, להשבית או למחוק את הנציג היחיד עם תפקיד ה‑Owner. תנו Owner למישהו אחר קודם, ואז חזרו על השינוי. ### הסרתי את הגישה שלי לעמוד התפקידים בקשו מ‑Owner לשחזר אותה. ‏Owner תמיד יכול, כי אי אפשר לצמצם אותו. אם לאף אחד בחשבון אין Owner — מה שההגנה על ה‑Owner האחרון של Teloring נועדה למנוע — פנו לתמיכה של Teloring. ### לנציג עדיין יש הרשאות ישנות ההרשאות מתרעננות בבקשה הבאה של הנציג; אין מה לנקות ואין צורך להתנתק. אם זה נמשך יותר מדקה, ודאו ששמרתם את התפקיד ושהנציג באמת מחזיק בתפקיד שערכתם — בדקו את עמודת **התפקיד** בעמוד הנציגים. --- ## מדריכים קשורים - [מדריך הרשאות המערכת](./system-permissions.md) — כל יכולת ומה כל פעולה פותחת. - [מדריך הרשאות הערוצים](./channel-permissions.md) — 18 יכולות התיבה וכלל התיבה העתידית. - [תפקידים ומתכונים לדוגמה](./examples.md) — הגדרות להעתקה. - [נציגים ונציגי AI](../agents.md) — היכן משייכים תפקיד לאדם. - [צוותים](../teams.md) — ניתוב, שהוא עניין נפרד מהרשאות. - [שיחות](../../getting-started/conversations.md) — התורים שהרשאות הערוצים שולטות בהם. - [הגדרות החשבון](../settings.md) — עמודי ההגדרות שרשת ההרשאות מפנה אליהם. --- # CRM ולקוחות מקור: https://docs.teloring.com/he/docs/product/crm Markdown: https://docs.teloring.com/he/markdown/docs/product/crm.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z הלקוחות הם מערכת ה‑CRM של Teloring. היא מחברת שיחות, אנשי קשר, שיחות טלפון, מסמכים, אירועי מסע ורשומות עסקיות מותאמות סביב פרופיל לקוח. חשבו על לקוח כעל הרשומה המרכזית של מערכת יחסים. לקוח יכול לייצג עסק, חשבון, משק בית, ארגון או אדם, בהתאם לאופן שבו הצוות שלכם עובד. סביב אותו לקוח, Teloring מחברת את האנשים שפונים אליכם, את השיחות שלהם, את היסטוריית השיחות הטלפוניות, את המסמכים החתומים וכל אובייקט מותאם שהחשבון שלכם יוצר. ## רשימת הלקוחות פתחו את הלקוחות מסרגל הצד כדי לראות את רשימת ה‑CRM. הרשימה כוללת: | פקד | השתמשו בו כדי | | --- | --- | | חיפוש | למצוא לקוחות לפי שם, פרטי קשר או מידע אחר שניתן לחיפוש. | | שלבי מחזור חיים | לסנן לקוחות לפי סטטוס כמו ליד, פעיל, לא פעיל או לא רלוונטי. | | יצירת לקוח | להוסיף לקוח חדש ידנית. | | עורך השדות | להתאים את השדות שמוצגים ברשומות הלקוח. | | כרטיסי / רשת הלקוחות | לפתוח פרופיל לקוח לפרטים ולהיסטוריה. | ![רשימת הלקוחות ב‑Teloring](pathname:///img/screenshots/he/product/crm/customers-list.png) רשימת הלקוחות היא בדרך כלל נקודת ההתחלה הטובה ביותר למנהלים ולמנהלי חשבון. הנציגים יגיעו לרוב לאותו פרופיל לקוח מתוך שיחה, דרך מדור הלקוחות בסרגל הצד של השיחה. ## יצירת לקוח כדי ליצור לקוח ידנית: 1. פתחו את הלקוחות. 2. לחצו על יצירת לקוח. 3. הזינו את השם הנדרש. 4. הוסיפו פרטים אופציונליים כמו תעשייה, טלפון, אימייל, אתר, נציג משויך, כתובת, תגיות והערות. 5. שמרו את הלקוח. ## פרופיל הלקוח פתחו לקוח כדי לצפות בפרופיל המלא. בהתאם ליכולות המופעלות ולנתונים הזמינים, הפרופיל יכול לכלול: | אזור | מה הוא מציג | | --- | --- | | סקירה | שדות הלקוח המרכזיים ופרטי תקציר. | | מסע | אירועים חשובים של הלקוח לאורך זמן. | | אנשי קשר | אנשי קשר וזהויות מקושרים. | | שיחות | שיחות קשורות של הלקוח בכל התיבות. | | שיחות טלפון | פעילות קולית המקושרת ללקוח. | | מסמכים | מסמכים חתומים או שהועלו והמקושרים ללקוח. | | אובייקטים מותאמים | רשומות ייחודיות לחשבון, כמו נכסים, קריאות שירות, עסקאות, מנויים או אובייקטים עסקיים אחרים. | ![פרופיל לקוח ב‑Teloring](pathname:///img/screenshots/he/product/crm/customer-profile.png) ## כותרת הלקוח בראש פרופיל הלקוח מוצגים פרטי הלקוח החשובים ביותר. האזור הזה נועד לזיהוי מהיר לפני פתיחת הלשוניות המעמיקות. הוא יכול לכלול: | פריט | משמעות | | --- | --- | | שם הלקוח | שם התצוגה הראשי של הלקוח. | | שלב מחזור חיים | שלב הלקוח הנוכחי, כמו ליד, פעיל, לא פעיל או לא רלוונטי. | | תעשייה | התעשייה או הקטגוריה העסקית של הלקוח. | | פרטי קשר | טלפון, אימייל, אתר, כתובת או שדות מרכזיים אחרים. | | נציג משויך | הנציג האחראי ללקוח, כאשר החשבון משתמש בזה. | | תגיות והערות | הקשר קצר ברמת הלקוח. | מנהלי חשבון יכולים להתאים את שדות הלקוח העליונים בעזרת עורך השדות. ## לשוניות מובנות בפרופיל הלקוח כל פרופיל לקוח מאורגן בלשוניות. הלשוניות מפרידות בין סוגי מידע שונים, כדי שנציגים ומנהלים ימצאו היסטוריה במהירות. ### מסע המסע הוא ציר זמן של אירועים חשובים אצל הלקוח. הוא עוזר לצוותים להבין איך רשומת הלקוח השתנתה לאורך זמן. המסע יכול לכלול אירועים כמו: | סוג אירוע | דוגמה | | --- | --- | | לקוח נוצר | נוספה רשומת לקוח חדשה. | | שדה השתנה | שלב מחזור חיים, בעלים או שדה אחר עודכנו. | | איש קשר נוסף | איש קשר חדש קושר ללקוח. | | פעילות ברשומת אובייקט | רשומת אובייקט מותאם נוצרה או עודכנה. | השתמשו במסע כשאתם צריכים להבין את רצף האירועים, ולא רק את המצב הנוכחי. ### אנשי קשר אנשי הקשר הם האנשים המחוברים ללקוח. ללקוח עסקי יכולים להיות כמה אנשי קשר, למשל בעלים, איש קשר בכספים, איש קשר בתמיכה או מנהל סניף. השתמשו באנשי הקשר כדי: | משימה | למה זה חשוב | | --- | --- | | לקשר איש קשר קיים | לחבר ללקוח הזה אדם שכבר קיים ב‑Teloring. | | לסקור את כל אנשי הקשר של הלקוח | לראות מי יכול לפנות לצוות שלכם בשם הלקוח. | | לערוך שדות של איש קשר | לשמור על שמות, טלפונים, כתובות אימייל, תפקידים, ערוצים מועדפים והערות מדויקים. | | למזג רשומות לקוח | לנקות לקוחות כפולים בעת הצורך. | אנשי קשר שונים מלקוחות. איש קשר הוא האדם. לקוח הוא החשבון או מערכת היחסים שהאדם שייך אליהם. ### שיחות לשונית השיחות מציגה שיחות שמקושרות ללקוח. היא יכולה לכלול שיחות פתוחות ושיחות שטופלו מתיבות שונות. השתמשו בה כדי: | משימה | למה זה חשוב | | --- | --- | | לסקור שיחות פתוחות | לראות עבודה פעילה שמקושרת ללקוח. | | לסקור שיחות שטופלו | להבין בעיות ותוצאות קודמות. | | לעבור מה‑CRM לטיפול בשיחה | לפתוח שיחה קשורה מתוך פרופיל הלקוח. | | להשוות ערוצים | לראות אם הלקוח פנה אליכם ב‑WhatsApp, באימייל, בצ׳אט באתר, בטלפון או בתיבה אחרת. | ### שיחות טלפון לשונית שיחות הטלפון מציגה פעילות קולית שמקושרת ללקוח, כאשר ערוץ הקול מופעל. השתמשו בה כדי לסקור: | פריט | משמעות | | --- | --- | | כיוון וסטטוס השיחה | האם השיחה נענתה, לא נענתה, נדחתה או הושלמה. | | נציג | הנציג שהיה מחובר לשיחה, כשזמין. | | משך | כמה זמן השיחה נמשכה. | | שיחה קשורה | השיחה או הקשר הלקוח שמחוברים לשיחה הטלפונית. | ### מסמכים לשונית המסמכים מציגה מסמכים שמקושרים ללקוח, כולל פעילות חתימת מסמכים כשהיא מופעלת. השתמשו בה כדי לסקור: | סטטוס | משמעות | | --- | --- | | מוכן | מסמך הוכן ומוכן לחתימה או לשליחה. | | נחתם | הלקוח השלים את המסמך. | | נדחה או פג תוקף | המסמך לא הושלם. | המסמכים עוזרים לצוותים לשמור הסכמים, טפסים, אישורים וקבצים חתומים קרוב להיסטוריית הלקוח. ## קישור אנשי קשר ללקוחות אפשר לקשר אנשי קשר לרשומות לקוח, כדי שהנציגים יראו את ההקשר העסקי המלא בזמן הטיפול בשיחות. דוגמאות נפוצות: | דוגמה | למה לקשר | | --- | --- | | לקוח אחד, אנשי קשר רבים | כמה עובדים פונים לתמיכה עבור אותה חברה. | | איש קשר אחד, שיחות רבות | לקוח פונה דרך WhatsApp, אימייל וצ׳אט באתר. | | בירור היסטורי | מנהלים רוצים לסקור את כל האינטראקציות של עסק אחד. | ## שלבי מחזור חיים שלבי מחזור החיים עוזרים לצוותים לקבץ לקוחות לפי סטטוס הקשר. | שלב | משמעות אופיינית | | --- | --- | | ליד | לקוח פוטנציאלי או הזדמנות חדשה. | | פעיל | לקוח קיים. | | לא פעיל | לקוח שאינו פעיל כרגע. | | לא רלוונטי | רשומה שאין להתייחס אליה כאל הזדמנות או לקוח פעיל. | הצוות שלכם יכול להחליט על המשמעות התפעולית המדויקת של כל שלב. ## אובייקטים מותאמים {#custom-objects} אובייקטים מותאמים מאפשרים לחשבון שלכם למדל נתונים עסקיים שאינם מתאימים לשדות הלקוח הבסיסיים. דוגמאות: | אובייקט | מה הוא יכול לייצג | | --- | --- | | קריאות שירות | פניות תמיכה, ביקורים טכניים, תלונות או בקשות תפעוליות. | | עסקאות | הזדמנויות מכירה, הצעות מחיר, חידושים או תהליכים מסחריים. | | נכסים | מוצרים, מכשירים, מיקומים, מנויים, חוזים או ציוד המקושרים ללקוח. | | פרויקטים | עבודת הטמעה, שלבי יישום או עבודה ארוכת טווח. | | כל אובייקט מותאם | סוג רשומה שמנהל החשבון יוצר עבור התהליך העסקי שלכם. | האובייקטים המותאמים מופיעים כלשוניות נוספות בפרופיל הלקוח. כל לשונית מכילה רשומות מאותו סוג אובייקט עבור הלקוח הנוכחי. למשל, ללקוח אחד יכולים להיות: | לקוח | רשומות מותאמות קשורות | | --- | --- | | Acme בע"מ | 3 קריאות שירות, 2 עסקאות, 5 נכסים, פרויקט חידוש אחד | לכל רשומת אובייקט יש שדות משלה, פאנל פרטים משלה וקישורים אופציונליים לרשומות אובייקט אחרות. ![לשוניות אובייקטים מותאמים בפרופיל לקוח ב‑Teloring](pathname:///img/screenshots/he/product/crm/customer-object-tabs.png) ## יצירת סוגי אובייקטים מנהלי חשבון יכולים ליצור סוגי אובייקטים חדשים מתוך פרופיל הלקוח. ביצירת סוג אובייקט, המנהל מגדיר: | הגדרה | משמעות | | --- | --- | | תווית ברבים | שם הלשונית, כמו "נכסים" או "פרויקטים". | | תווית ביחיד | השם לרשומה אחת, כמו "נכס" או "פרויקט". | | סמל | הסמל הוויזואלי שמוצג בלשונית הלקוח. | | מזהה API | מזהה טכני יציב לאובייקט. שימושי לאינטגרציות ולאוטומציה. | לאחר יצירת סוג האובייקט, הוא מופיע כלשונית בפרופיל הלקוח. אז מנהלי החשבון יכולים להשתמש בעורך השדות כדי להגדיר את השדות של אותו אובייקט. ## עורך השדות {#field-editor} עורך השדות שולט באילו שדות מופיעים בלקוחות, באנשי קשר ובאובייקטים מותאמים. מנהלי החשבון יכולים להשתמש בו כדי: | פעולה | מה היא עושה | | --- | --- | | להוסיף מדורים | לארגן שדות בקבוצות, כמו כללי, חיובים, חוזה או פרטי שירות. | | להוסיף שדות | להוסיף שדות חדשים מארגז הכלים. | | לשנות סדר של מדורים ושדות | לגרור שדות לסדר הנכון עבור הנציגים. | | לסמן שדות כחובה | להפוך נתונים חשובים למחייבים. | | לערוך תוויות | לשנות שמות של שדות כך שיתאימו לשפה של הצוות שלכם. | | לערוך אפשרויות | להגדיר ערכים לרשימות נפתחות, ללחצני רדיו, לתיבות סימון ולבחירה מרובה. | | לשמור את הסכמה | להחיל את הפריסה המעודכנת על אותו סוג אובייקט. | ![עורך השדות ב‑Teloring](pathname:///img/screenshots/he/product/crm/field-editor.png) סוגי השדות הזמינים כוללים: | סוג שדה | מתאים ביותר ל | | --- | --- | | טקסט | ערכים קצרים כמו שם, מספר סידורי או אסמכתה. | | אזור טקסט | הערות או תיאורים ארוכים יותר. | | מספר | כמויות, ספירות או מזהים מספריים. | | אימייל | כתובות אימייל. | | טלפון | מספרי טלפון. | | תאריך | תאריך בודד, כמו תאריך חידוש. | | תאריך ושעה | תאריך ושעה יחד. | | תיבת סימון | ערך כן/לא. | | לחצני רדיו | בחירה אחת מתוך מערך קטן וקבוע. | | רשימה נפתחת | בחירה אחת מתוך רשימה. | | בחירה מרובה | כמה בחירות מתוך רשימה. | | מטבע | סכומי כסף. | | כתובת אינטרנט | קישורים למשאבים חיצוניים. | | טקסט עשיר | הערות מעוצבות או תוכן ארוך יותר. | | בוחר נציגים | שיוך נציג פנימי. | | קובץ | שדות של קובץ מצורף, במקומות שנתמכים. | | כיתוב | תווית ויזואלית או מפריד בתוך הטופס. | חלק מהשדות הם שדות מערכת. שדות מערכת נדרשים על ידי Teloring ואי אפשר להסיר אותם, אם כי מנהלי החשבון עשויים לשלוט באופן הצגתם. :::note עורך שדות או מאפייני שיחה? עורך השדות מעצב רשומות ש**שורדות את השיחה** — האדם, העסק והאובייקטים שמתחתיהם. אם מה שאתם רוצים לתעד שייך ל**שיחה אחת** ("למה הם כתבו היום?", "איך זה הסתיים?"), השתמשו ב[מאפייני שיחה](./conversation-attributes.md), שמעוצבים בהגדרות וממולאים מתוך השיחה עצמה. מבחן מהיר: *אם אותו אדם היה פונה אליכם שוב מחר, האם הערך הזה צריך עדיין להיות שם?* **כן** ← שדה של איש קשר או לקוח. **לא** ← מאפיין שיחה. ::: ## שדות לקוח עליונים מול שדות אובייקט שדות הלקוח העליונים מתארים את הלקוח עצמו. שדות האובייקט מתארים רשומה אחת תחת אותו לקוח. | מיקום השדה | שדות לדוגמה | השתמשו בו עבור | | --- | --- | --- | | שדות לקוח | שם, שלב מחזור חיים, תעשייה, טלפון, אימייל, אתר, כתובת, נציג משויך, תגיות, הערות | מידע ששייך ישירות ללקוח. | | שדות איש קשר | שם פרטי, שם משפחה, טלפון, אימייל, תפקיד, ערוץ מועדף, הערות | מידע על אדם שמקושר ללקוח. | | שדות אובייקט | סטטוס שירות, סכום עסקה, מספר סידורי של נכס, תאריך חידוש, בעלים של פרויקט | מידע ששייך לרשומת אובייקט מותאם אחת. | למשל, "אימייל הלקוח" שייך ללקוח. "הטכנאי שמשויך לקריאת השירות הזו" שייך לאובייקט קריאת השירות. "מספר סידורי" שייך לאובייקט נכס. ## קישור רשומות בין אובייקטים אפשר לקשר רשומות של אובייקטים מותאמים לרשומות אובייקט אחרות. כך נוצר קשר בין שתי רשומות, כדי שמשתמשים יוכלו לנווט ביניהן. דוגמאות לקשרים: | רשומת מקור | רשומה מקושרת | למה לקשר אותן | | --- | --- | --- | | קריאת שירות | נכס | קריאת השירות עוסקת במוצר או במכשיר מסוים. | | עסקה | פרויקט | עסקה שנסגרה פתחה פרויקט הטמעה. | | מנוי | מסמך | הסכם חתום שייך למנוי. | | קריאת שירות | עסקה | פנייה לתמיכה יצרה הזדמנות לחידוש או להרחבה. | כשאתם מקשרים רשומות, Teloring מציגה את הקשר באזור הפריטים הקשורים. רשומת המקור מציגה את הפריט המקושר. גם רשומת היעד יודעת שרשומה אחרת מקשרת אליה בחזרה. המשמעות היא שמשתמשים יכולים לפתוח קריאת שירות, לראות את הנכס הקשור, לפתוח את הנכס, ועדיין לראות שקריאת השירות מחוברת אליו. ![רשומות אובייקט קשורות ב‑Teloring](pathname:///img/screenshots/he/product/crm/related-items.png) ## רשימות רשומות והגדרות עמודות כל לשונית של אובייקט מותאם מציגה טבלת רשומות. משתמשים יכולים לפתוח רשומה כדי לצפות בפרטים, לערוך אותה, למחוק אותה כשמותר, או לסקור פריטים קשורים. חלק מטבלאות האובייקטים מאפשרות הגדרות עמודות, כך שמשתמשים יכולים לבחור אילו שדות מופיעים ברשימה והאם קישורים קשורים יופיעו כעמודה. זה עוזר לכל צוות לשמור על השדות החשובים ביותר גלויים. ## דוגמה מעשית חברת שירות עשויה להשתמש ב‑CRM כך: 1. פרופיל הלקוח שומר את שם החברה, את שלב מחזור החיים, את פרטי הקשר, את הנציג המשויך ואת ההערות. 2. אנשי הקשר שומרים את האנשים שמתקשרים או כותבים לחברה. 3. השיחות שומרות כל אינטראקציה ב‑WhatsApp, באימייל, בטלפון או בצ׳אט באתר. 4. קריאות השירות שומרות את פניות התמיכה. 5. הנכסים שומרים את המוצרים או הציוד של הלקוח. 6. קריאת שירות מקושרת לנכס שהיא עוסקת בו. 7. המסמכים שומרים הסכמי שירות חתומים. 8. המסע מציג את השינויים החשובים לאורך זמן. כך מערכת היחסים עם הלקוח, התקשורת היומיומית והרשומות העסקיות המובנות נשארות מחוברות במקום אחד. --- # בהמתנה מקור: https://docs.teloring.com/he/docs/product/on-hold Markdown: https://docs.teloring.com/he/markdown/docs/product/on-hold.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z **"בהמתנה" מחנה שיחה עד למועד שאתם בוחרים.** הלקוח ביקש שתחזרו אליו אחרי הצהריים, אתם מחכים למשלוח שיגיע, עמית צריך לבדוק משהו מחר בבוקר — העבירו את השיחה להמתנה והפסיקו לחשוב עליה. ‏Teloring מחזירה אותה מעצמה. היא חוזרת בשתי דרכים, לפי המוקדם מביניהן: 1. **הזמן חלף.** ‏Teloring מחזירה אותה לתור שלכם ומסמנת אותה כלא נקראה. 2. **הלקוח כותב שוב.** ההמתנה מסתיימת מיד — גם אחרי 2 דקות בהמתנה של 5 שעות. הכלל השני הוא החשוב. לקוח שאומר "תחזרו אליי בעוד חמש שעות" ואז כותב בחזרה כעבור עשרים דקות צריך להיות מולכם עכשיו, ולא לישון עד המועד. :::info בהמתנה הוא סטטוס, לא תיקייה בהמתנה הוא **סטטוס שיחה ברמה העליונה**, לצד פתוחה וטופלה — ולא תת‑מצב של פתוחה. שיחה בהמתנה **נעלמת** מהתורים שלי, ממתינות בתור, בוט סטודיו, נציג AI וכל הפתוחות, ומפסיקה להיספר במספרים של לוח הבקרה שלכם. זו כל הנקודה: עבודה מוחנית לא צריכה לשבת ברשימה הפעילה שלכם וליצור דחיפות מדומה. ::: ## עובדות מרכזיות | עובדה | משמעות | | --- | --- | | היא שומרת על הבעלים שלה | השיחה נשארת משויכת אליכם. כשהיא חוזרת, היא חוזרת **אליכם**, ולא לתור הכללי. | | יש לה תור משלה | **שיחות ← בהמתנה** בסרגל הצד, באותה רמה כמו שלי וממתינות בתור. | | התור הוא ברמת החשבון | כל נציג רואה כל שיחה בהמתנה, כמו בכל הפתוחות. סננו לפי **נציג משויך** כדי לראות רק את שלכם. | | תשובה של לקוח מבטלת אותה | בכל ערוץ, וגם כשאינכם מחוברים. | | הטיימר מדויק בערך לדקה | ‏Teloring בודקת המתנות שפגו פעם בדקה, ולכן שיחה חוזרת בתוך כדקה מהמועד שלה. | | המועדים משתמשים באזור הזמן **העסקי** | לא באזור הזמן האישי שלכם. ראו [באיזה אזור זמן משתמשים](#which-timezone-is-used). | | אי אפשר להעביר להמתנה שיחות שטופלו | פתחו אותן מחדש קודם. המתנה על שיחה סגורה אינה אומרת דבר. | | הכול מתועד | כניסה להמתנה ויציאה ממנה מופיעות בציר הזמן של השיחה וביומן הלוגים של החשבון. | ## מתי להשתמש בזה | מצב | למה "בהמתנה" מתאים | | --- | --- | | "תחזרו אליי אחר הצהריים." | השיחה חוזרת בזמן שסיכמתם, בלי תזכורת אישית ובלי פתק דביק. | | ממתינים למשלוח, להחזר כספי או לתיקון | החנו אותה למועד ריאלי במקום לקרוא אותה מחדש כל שעה. | | ממתינים לעמית או למחלקה אחרת | היא יוצאת מהרשימה הפעילה שלכם אבל נשארת שלכם, כך ששום דבר לא נופל. | | אי אפשר להשיג את הלקוח כרגע | נסו שוב מחר בבוקר בלי לאבד את השרשור. | | הבטחה עם תאריך | "נבדוק ביום ראשון" הופך למשהו שהמערכת זוכרת, ולא משהו שאתם צריכים לזכור. | מתי **לא** להשתמש בזה: | מצב | עשו זאת במקום | | --- | --- | | הנושא הסתיים | **סמנו כטופל**. "בהמתנה" נועד לעבודה שעדיין פתוחה. | | מישהו אחר צריך לטפל בזה | **החזירו לתור** או שייכו לנציג או ל[צוות](./teams.md). | | אתם צריכים שכל הצוות יראה שזה תקוע | הוסיפו גם **תווית** או **דגל** — תור ההמתנה מציג את המועד, אבל תווית מסבירה *למה*. | --- ## העברת שיחה להמתנה פתחו את השיחה והשתמשו בכפתור **בהמתנה** בסרגל העליון, לצד **סימון כטופל**. ![הסרגל העליון של השיחה עם כפתור בהמתנה לצד סימון כטופל](pathname:///img/screenshots/he/product/on-hold/on-hold-button.png) זה פותח את בוחר משך הזמן. ![בוחר משך ההמתנה עם כפתורי הקיצור ושדה התאריך המותאם](pathname:///img/screenshots/he/product/on-hold/on-hold-picker.png) ### בוחר משך הזמן | רכיב | מה הוא עושה | | --- | --- | | **שעה** | חוזרת בעוד שעה. | | **4 שעות** | חוזרת בעוד ארבע שעות. | | **מחר 9:00** | חוזרת ב‑09:00 ביום הקלנדרי הבא, לפי אזור הזמן העסקי. | | **שבוע** | חוזרת בעוד שבעה ימים. | | **מותאם** | חושף שדה תאריך ושעה, כדי שתוכלו לבחור כל רגע. | | **תאריך ושעה** (מותאם בלבד) | זמן החזרה המדויק. נקרא לפי אזור הזמן העסקי. | | הערת אזור הזמן | מציינת את אזור הזמן שבו הזמנים מחושבים, כך שלעולם לא תהיה אי‑התאמה שקטה. | | **העברה להמתנה** | מאשר ומחנה את השיחה. | | **ביטול** | סוגר את הבוחר ואינו משנה דבר. | זמן מותאם חייב להיות לפחות **דקה** מעכשיו ולא יותר מ‑**365 יום** מעכשיו. כל דבר מחוץ לטווח הזה נדחה עם הודעה בבוחר, והשיחה אינה מושפעת. ### מה קורה ברגע שאתם מאשרים 1. סטטוס השיחה הופך ל**בהמתנה**. 2. היא **יוצאת** מהתור שהסתכלתם עליו, ופאנל השיחה נסגר. 3. היא **מופיעה** בתור ההמתנה עבור כולם בחשבון. 4. היא נשארת **משויכת אליכם**. 5. המסכים של כל השאר מתעדכנים מיד — בלי צורך ברענון. :::note השיוך שלכם נשמר בכוונה "בהמתנה" אינו משחרר את הבעלות. זה לא "החזרה לתור עם טיימר" — זה "תחזור *אליי* מאוחר יותר". ::: --- ## תור ההמתנה פתחו **שיחות ← בהמתנה** בסרגל הצד. התג סופר כל שיחה בהמתנה בחשבון, ומוסתר כשאין אף אחת. ![פריט בהמתנה בסרגל הצד של Teloring עם תג של שיחה אחת בהמתנה](pathname:///img/screenshots/he/product/on-hold/on-hold-queue.png) ברשימה עצמה, כל שורה נושאת צ׳יפ **⏸ מועד**, כך שאפשר לסרוק את התור ולראות מה מתעורר מתי. | רכיב | מה הוא מציג | | --- | --- | | תג בסרגל הצד | כמה שיחות בחשבון נמצאות בהמתנה. מוסתר כשאין. | | צ׳יפ **⏸** על כרטיס | מתי אותה שיחה אמורה לחזור, לפי אזור הזמן **שלכם**. | | חיפוש, מיון, מסננים | עובדים בדיוק כמו בשאר התורים. | | מסנן **נציג משויך** | השתמשו בו כדי לצמצם את התור לשיחות שבהמתנה שלכם. | :::tip לראות רק את השיחות בהמתנה שלכם התור הוא ברמת החשבון בכוונה — מפקח צריך לראות מה הצוות החנה. כדי לראות רק את שלכם, פתחו את פאנל ה**מסננים** ובחרו את עצמכם תחת **נציג משויך**. ::: פתיחת שיחה בהמתנה עובדת כרגיל: אפשר לקרוא אותה, להוסיף הערה פרטית, לשנות תוויות ואפילו להשיב. **מענה אינו מסיים את ההמתנה** — רק שלושת הטריגרים שלמטה עושים זאת. --- ## איך המתנה מסתיימת ### 1. הזמן חלף Teloring בודקת פעם בדקה אילו המתנות פגו. כשאחת פגה: | מה משתנה | פירוט | | --- | --- | | סטטוס | חוזר ל**פתוחה**. | | שיוך | ללא שינוי — היא חוזרת לאותו נציג. | | לא נקרא | מסומנת כ**לא נקראה**, כך שהיא בולטת ברשימה. | | תור | יוצאת מבהמתנה, מופיעה מחדש ב**שלי** עבור הבעלים שלה וב**כל הפתוחות**. | אינכם צריכים להיות מחוברים. אם ההמתנה פגה בלילה, השיחה ממתינה, לא נקראה, כשאתם מתחברים. ### 2. הלקוח משיב אם הלקוח שולח משהו לפני המועד, ההמתנה מסתיימת **מיד**: - השיחה חוזרת ל**פתוחה**, עדיין משויכת אליכם; - היא מופיעה מחדש ב**שלי** וב**כל הפתוחות** עם ההודעה החדשה; - המועד נזרק. זה עובד ב**כל ערוץ** — WhatsApp, אימייל, SMS, טלגרם, LINE, צ׳אט באתר, Messenger, פייסבוק ואינסטגרם, TikTok ותיבת ה‑API — וזה קורה בצד של Teloring, כך שזה אינו תלוי בכך שמישהו פותח את היישום. :::info התשובה נוחתת באותה שיחה לקוח שכותב לשיחה בהמתנה ממשיך את **אותה** שיחה. ‏Teloring אינה פותחת שנייה לצידה. ::: **ריאקציה** ב‑WhatsApp נחשבת לדיבור של הלקוח, ולכן היא גם מסיימת המתנה. הסרת ריאקציה אינה מסיימת. ### 3. אתם מסיימים בעצמכם כל עוד שיחה בהמתנה, הכפתור בסרגל העליון משתנה ל**בהמתנה עד …** והופך לפקד השחרור. מכיוון שהתווית הזו אינה מכריזה שלחיצה עליה מבטלת את ההמתנה, Teloring שואלת קודם, באישור קטן לצד הכפתור. ![כפתור בהמתנה עד עם אישור ההוצאה מהמתנה פתוח מתחתיו](pathname:///img/screenshots/he/product/on-hold/on-hold-release-confirm.png) | רכיב | מה הוא עושה | | --- | --- | | **בהמתנה עד …** (כפתור) | מציג את המועד. לחצו כדי להתחיל להוציא מהמתנה. | | **הוצאה מהמתנה** | מחזיר את השיחה לפתוחה מיד. | | **ביטול** | משאיר את ההמתנה כפי שהיא. | לחיצה על `Esc` או לחיצה בכל מקום מחוץ לחלון גם מבטלות. כשמשחררים כך, השיחה חוזרת ל**פתוחה** עם אותו בעלים. היא **אינה** מסומנת כלא נקראה — אתם כבר מסתכלים עליה. ### סימון כטופל או פתיחה מחדש גם מנקים אותה אם אתם **מסמנים כטופלה** שיחה בהמתנה, או מעבירים אותה לסטטוס אחר, ההמתנה נזרקת באותה פעולה. שיחה סגורה לעולם אינה יכולה להתעורר מטיימר ישן. --- ## שינוי מועד כדי להזיז מועד, הוציאו את השיחה **מהמתנה** והעבירו אותה להמתנה שוב עם הזמן החדש. אין פקד "הארכה" בבוחר. --- ## באיזה אזור זמן משתמשים {#which-timezone-is-used} ב‑Teloring קיימים שני אזורי זמן שונים, ו"בהמתנה" משתמש בשניהם — לתפקידים שונים. | אזור זמן | היכן הוא נקבע | מה הוא עושה עבור "בהמתנה" | | --- | --- | --- | | **אזור הזמן העסקי** | **הגדרות ← מידע כללי** (מנהל) | **מחשב** את המועד. "מחר 9:00" פירושו 09:00 לפי העסק, כך ששני נציגים בשתי מדינות שמחנים את אותה שיחה מקבלים את אותו רגע. | | **אזור הזמן שלכם לתצוגה** | **פרופיל ← פרטים אישיים** | **מציג** את המועד. הוא משנה מה שאתם קוראים על הכפתור ועל צ׳יפ ה‑⏸, לעולם לא מתי השיחה באמת חוזרת. | השאירו את אזור הזמן בפרופיל ריק ו‑Teloring תציג זמנים לפי אזור הזמן של הדפדפן שלכם, וזה מה שרוב הנציגים מצפים לו. :::warning מועד הוא כלל עסקי, לא העדפה אישית זהו אותו עיקרון כמו שעות פעילות, חלונות SLA ותקופות דיווח: כולם עוקבים אחרי אזור הזמן **העסקי**. אם אזור הזמן האישי שלכם שונה מזה של העסק, ההערה בבוחר אומרת לכם באיזה אזור הזמנים — קראו אותה לפני שאתם בוחרים זמן מותאם. ::: **דוגמה.** אזור הזמן העסקי הוא `Asia/Jerusalem` ואתם עובדים מלונדון. אתם בוחרים **מחר 9:00**. השיחה חוזרת ב‑09:00 שעון ירושלים, שהמסך שלכם מציג כ‑07:00 — נכון בשני המקומות, ואותו רגע בדיוק עבור כולם. --- ## הרשאות | פעולה | מי יכול לעשות אותה | | --- | --- | | להעביר שיחה להמתנה | ה**נציג המשויך**, או **מנהל**. | | להוציא אותה מהמתנה | הנציג המשויך, הנציג שהחנה אותה, או **מנהל**. | | לראות את תור ההמתנה | כל נציג בחשבון. | שיחה שאף אחד אינו מחזיק בה — יושבת בממתינות בתור, או מוחזקת על ידי בוט סטודיו או נציג AI — יכולה לעבור להמתנה רק על ידי מנהל. בדרך כלל **תיקחו** את השיחה קודם, ואז תעבירו אותה להמתנה. הכללים האלה נאכפים בשרת, ולא רק מוסתרים בממשק. --- ## "בהמתנה" ושאר Teloring | יכולת | התנהגות | | --- | --- | | **לוח הבקרה** | שיחות בהמתנה אינן נכללות במוני *שלי* ו*ממתינות*, כך שעבודה מוחנית אינה מנפחת את עומס העבודה שלכם. | | **ציר הזמן של השיחה** | כניסה להמתנה ויציאה ממנה מופיעות בציר הזמן של השיחה שטופלה, כולל כמה זמן היא הוחזקה ומה סיים אותה (טיימר או תשובת לקוח). | | **דוחות** | אפשר לסנן שיחות לפי סטטוס **בהמתנה** ב[אנליטיקס](./analytics.md). | | **יומן הלוגים** | כל המתנה וכל שחרור כותבים רשומה — מי החנה, עד מתי, ומה סיים. שחרור על ידי הטיימר נרשם כפעולת מערכת. שחרורים שנגרמו מתשובת לקוח נרשמים בשיחה עצמה ולא ביומן הלוגים, כי הם קורים במסלול העמוס ביותר בפלטפורמה. | | **AI Copilot** | עדיין זמין בתוך שיחה בהמתנה. בהמתנה פירושו מוחנה, לא סגור. | | **סטודיו** | טריגר **שינוי בשיחה** מופעל כששיחה נכנסת להמתנה או יוצאת ממנה. מסנן הסטטוס של הטריגר מציע *כל*, *נפתחה* ו*טופלה* בלבד, אז השתמשו ב*כל* וקראו את סטטוס השיחה בתוך התהליך. | | **Webhooks** | פולט את `conversation.on_hold` ואת `conversation.on_hold_released`. | :::note סטודיו אינו יכול להעביר שיחה להמתנה פעולת **שינוי שיחה** בסטודיו יכולה לקבוע פתוחה, ממתינה או טופלה — לא בהמתנה. להמתנה יש מועד ובעלים, ולכן זו פעולה של נציג. ::: --- ## מגבלות | מגבלה | פירוט | | --- | --- | | אין הארכה | שנו מועד על ידי שחרור והעברה מחדש להמתנה. | | אין תור לכל נציג | תור ההמתנה הוא ברמת החשבון; השתמשו במסנן **נציג משויך** כדי לצמצם אותו. | | מקסימום 365 יום | יותר מזה נדחה. | | מינימום דקה אחת | זמן בעבר, או פחות מדקה מעכשיו, נדחה. | | לא ניתן להגדרה מסטודיו או מנציג AI | נציגים (או מנהל) מעבירים שיחות להמתנה. | | מענה אינו משחרר | רק הטיימר, תשובת לקוח או שחרור מפורש מסיימים המתנה. | | אי אפשר להעביר להמתנה שיחות שטופלו | פתחו אותן מחדש קודם. | ## פתרון תקלות | תסמין | סיבה ותיקון | | --- | --- | | שיחה בהמתנה לא חזרה במועד שלה | ההמתנות נסרקות פעם בדקה, אז תנו לזה כדקה. אם זה הרבה יותר מאוחר, פנו למנהל שלכם — ייתכן שלוח הזמנים הדקתי של הפלטפורמה אינו רץ. | | הזמן שבחרתי אינו הזמן שמוצג על הכפתור | המועד מחושב לפי אזור הזמן **העסקי** ומוצג לפי אזור הזמן **שלכם**. שניהם נכונים. ראו [באיזה אזור זמן משתמשים](#which-timezone-is-used). | | כפתור **בהמתנה** חסר | השיחה טופלה. פתחו אותה מחדש קודם. | | "פתחו את השיחה מחדש לפני שתעבירו אותה להמתנה" | אתם בשיחה שטופלה. | | "רק הנציג המשויך או מנהל יכולים להעביר את השיחה הזו להמתנה" | קחו את השיחה קודם, או בקשו ממנהל. | | "בחרו זמן שהוא לפחות דקה מעכשיו" | הזמן המותאם בעבר או קרוב מדי. | | לקוח השיב אבל השיחה עדיין בהמתנה | רעננו את העמוד. אם זה נמשך, ייתכן שההודעה לא הגיעה ל‑Teloring — בדקו את חיבור התיבה ב[טבעת הערוצים](./ring/overview.md). | | אני לא מוצא את השיחות שלי בהמתנה | הן ב**שיחות ← בהמתנה**, ולא בתור **שלי**. סננו לפי **נציג משויך** כדי לראות רק את שלכם. | ## קשור - [שיחות](../getting-started/conversations.md) — התורים, המסננים ושגרת הטיפול היומיומית. - [צוותים](./teams.md) — ניתוב שיחות לקבוצה במקום לאדם אחד. - [הגדרות](./settings.md) — היכן נקבע אזור הזמן העסקי. - [אנליטיקס](./analytics.md) — דיווח על סטטוסים של שיחות. --- # מדריך הרשאות המערכת מקור: https://docs.teloring.com/he/docs/product/roles/system-permissions Markdown: https://docs.teloring.com/he/markdown/docs/product/roles/system-permissions.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z לשונית **הרשאות המערכת** עונה על שאלה אחת לגבי כל יכולת ב‑Teloring: *האם התפקיד הזה רשאי להגיע אליה, והאם הוא רשאי לשנות שם משהו?* ![לשונית הרשאות המערכת, מקובצת ללקוחות, סביבת עבודה, כלים, הגדרות, נציגים וצוותים, וחיובים](pathname:///img/screenshots/he/product/roles/system-permissions-tab.png) ## איך הרשת עובדת כל שורה היא יכולת. כל עמודה היא פעולה. סמנו תיבה כדי להעניק אותה. | רכיב | מה הוא עושה | | --- | --- | | **כותרת קבוצה** | שש קבוצות — *לקוחות*, *סביבת עבודה*, *כלים*, *הגדרות*, *נציגים וצוותים*, *חיובים*. לצורכי התמצאות בלבד; הקיבוץ אינו מעניק דבר. | | **תווית שורה** | היכולת, בניסוח שתואם לסרגל הצד כדי שתמצאו אותה במוצר. חלק מהשורות נושאות רמז בשורה אחת מתחתן, שמסביר פעולה לא מובנת מאליה. | | **כותרת עמודה** | **צפייה**, **יצירה**, **עדכון**, **מחיקה**. לחצו על כותרת כדי לסמן או לבטל את הפעולה הזו עבור **כל השורות בקבוצה בבת אחת** — לחיצה אחת מעניקה עמודה שלמה, לחיצה שנייה מנקה אותה. | | **תיבת סימון** | ההרשאה עצמה. | | **מקף `—`** | הפעולה הזו אינה קיימת עבור היכולת הזו. אין מה להעניק. ריחוף מציג *לא רלוונטי לפריט הזה*. | | שורות מוזחות | אובייקטים שחיים **בתוך לקוח**, מוצגים מקוננים תחת *לקוחות*. | ## איך ארבע הפעולות עובדות {#how-the-four-actions-work} | פעולה | מה היא מעניקה | | --- | --- | | **צפייה** | להגיע ליכולת ולהסתכל עליה. שום דבר אינו ניתן לשינוי. | | **יצירה** | להוסיף פריט חדש. | | **עדכון** | לשנות פריט קיים. | | **מחיקה** | להסיר פריט. | **יצירה, עדכון ומחיקה כוללות צפייה אוטומטית.** אינכם יכולים ליצור לקוח שאינכם רשאים לראות, ולכן ברגע שאתם מסמנים פעולת כתיבה כלשהי, **צפייה** נדלקת וננעלת — היא מקבלת גוון בהיר יותר ואי אפשר להסיר את הסימון שלה כל עוד פעולת כתיבה מוגדרת. ![שורה שבה הצפייה נעולה דלוקה כי העדכון מסומן](pathname:///img/screenshots/he/product/roles/implied-read.png) כדי לשחרר את הצפייה, הסירו קודם את סימוני פעולות הכתיבה. :::note למה נעילה ולא תיבה מוסתרת החלופה — לשמור בשקט "עדכון בלי צפייה" ואז להתעלם מזה — הייתה אומרת שהרשת שעל המסך אינה תואמת למה שהתפקיד באמת עושה. הנעילה שומרת על השניים זהים: מה שאתם רואים מסומן הוא בדיוק מה שנשמר. ::: :::tip תפקידים לקריאה בלבד הם השימושיים מבקר, רואה חשבון, יועץ, בעל עניין שרוצה לוחות בקרה — כולם רוצים **צפייה** בכמה דברים ותו לא. סמנו את עמודת הצפייה, שמרו, סיימתם. ::: --- ## לקוחות ה‑CRM. השורה הראשונה היא רשומת הלקוח עצמה; השורות המוזחות שמתחתיה הן האובייקטים שבתוך לקוח. | יכולת | צפייה | יצירה | עדכון | מחיקה | | --- | --- | --- | --- | --- | | **לקוחות** | פתיחת עמוד הלקוחות ורשומת לקוח | הוספת לקוח | עריכת לקוח, **ועריכת השדות של כל אובייקט לקוח** בעורך השדות | מחיקת לקוח | | **מסע** | צפייה בציר הזמן של הלקוח | `—` | `—` | `—` | | **שיחות** | צפייה בלשונית השיחות של הלקוח | `—` | `—` | `—` | | **שיחות טלפון** | צפייה בלשונית שיחות הטלפון של הלקוח | `—` | `—` | `—` | | **מסמכים** | צפייה בלשונית המסמכים החתומים של הלקוח | `—` | `—` | `—` | | **אנשי קשר**, **קריאות שירות**, **עסקאות**, **משימות**, **הערות**, וכל אובייקט שתיצרו | צפייה ברשומות מהסוג הזה | הוספת רשומה | עריכת רשומה | מחיקת רשומה | ### למה חלק מהשורות הן לקריאה בלבד **מסע**, **שיחות**, **שיחות טלפון** ו**מסמכים** נכתבים על ידי Teloring עצמה. רשומת מסע היא תיעוד של משהו שכבר קרה; יומן שיחה הוא תיעוד של שיחה. אין מה ליצור או לערוך מעמוד הלקוח, ולכן קיימת רק **צפייה**. ### סוגי האובייקטים שלכם מופיעים כאן אוטומטית כל סוג אובייקט CRM בחשבון שלכם מקבל שורה משלו עם כל ארבע הפעולות, כולל אלה שעיצבתם בעצמכם בעורך השדות. צרו אובייקט *חוזים* היום והוא ברשת הזו מיד, עם התווית והסמל שלו — בלי המתנה, בלי הגדרה נפרדת. סוגי אובייקטים מושבתים אינם מופיעים ברשימה, כי אין מה להתיר. :::warning "עדכון" על לקוחות מעניק גם את עורך השדות **לקוחות ← עדכון** מכסה שני דברים: עריכת רשומת לקוח, *וגם* שינוי ה**מבנה** של ה‑CRM שלכם — הוספת סוג אובייקט, הוספה או הסרה של שדות, שינוי הסדר שלהם. כך המוצר בנוי: שניהם "שינוי מודל הלקוח". אם אתם רוצים שמישהו יערוך נתוני לקוח אבל לעולם לא ישנה את מבנה ה‑CRM, ההפרדה הזו אינה קיימת היום. תנו **עדכון** בשורות של האובייקטים הבודדים והשאירו את **לקוחות ← עדכון** כבוי — הם יוכלו אז לערוך רשומות של האובייקטים האלה בלי להגיע למעצב. ::: --- ## סביבת עבודה {#workspace} | יכולת | צפייה | יצירה | עדכון | מחיקה | | --- | --- | --- | --- | --- | | **תצוגות** | פתיחת התצוגות והרצת תצוגה שמורה | בניית תצוגה חדשה | עריכת תצוגה קיימת | מחיקת תצוגה | | **טבעת הערוצים (תיבות)** | פתיחת טבעת הערוצים וצפייה בהגדרות התיבות | חיבור תיבה חדשה | שינוי הגדרות תיבה | ניתוק תיבה | | **אנליטיקס** | פתיחת האנליטיקס, קריאת לוחות ודוחות, ייצוא | יצירת דוח או לוח | עריכת דוח, לוח או לשונית | מחיקת דוח או לוח שלם | | **מאפייני שיחה** | צפייה בפאנל המאפיינים בשיחה ובשיחה שטופלה, ופתיחת עמוד ההגדרות | `—` | מילוי ערכים בשיחה, **וגם** הוספה או עריכה של מאפיינים בהגדרות | הסרת מאפיין מהעיצוב של החשבון | :::note למאפייני שיחה אין יצירה מאפיין הוא חלק מעיצוב אחד ברמת החשבון, ולא פריט נפרד — ולכן הוספת מאפיין *היא* עריכת העיצוב הזה, והיא דורשת **עדכון**. ראו [מאפייני שיחה](../conversation-attributes.md). **עדכון מכסה גם מילוי וגם עיצוב**, בדיוק כפי ש**לקוחות ← עדכון** מכסה גם את עורך השדות. אם אתם רוצים שנציגי קו ראשון יתעדו סיבה ותוצאה בלי יכולת לשנות את מבנה הטופס, ההפרדה הזו אינה קיימת היום; בפועל עמוד ההגדרות אינו מקום שנציגים מגיעים אליו. **מחיקה** היא תמיד רק "הסרת מאפיין מהעיצוב". היא לעולם אינה מוחקת את הערכים שכבר נשמרו בשיחות — הם נשמרים, ויצירה מחדש של המאפיין עם אותו מזהה API מחזירה אותם לתצוגה. ::: :::info טבעת הערוצים היא *הגדרת* תיבות, לא *גישה* לתיבות **טבעת הערוצים** שולטת בעמוד ההגדרה — חיבור מספר WhatsApp, עריכת הגדרות אימייל, ניתוק ערוץ. השאלה אם נציג יכול *לעבוד בתוך* תיבה היא דבר נפרד לחלוטין, בלשונית [הרשאות ערוצים](./channel-permissions.md). לנציג בקו הראשון בדרך כלל **אין** גישה לטבעת הערוצים כלל, בזמן שהוא עובד בכל התיבות כל היום. השלכה אחת שכדאי להכיר: נציג עם **טבעת הערוצים ← צפייה** רואה שם את כל התיבות בחשבון, כולל כאלה שהוא אינו יכול לעבוד בהן. אם זה משנה לכם, אל תעניקו את זה. ::: --- ## כלים | יכולת | צפייה | יצירה | עדכון | מחיקה | | --- | --- | --- | --- | --- | | **סטודיו** | פתיחת סטודיו, קריאת תהליכים, גרסאות והיסטוריית הרצות | יצירת תהליך או לוח זמנים | עריכה, פרסום, השהיה, חידוש או בדיקה של תהליך | מחיקת תהליך או לוח זמנים | | **עולם AI** | פתיחת עולם AI וצפייה באילו יכולות מופעלות | `—` | **הפעלה וכיבוי של יכולות AI** | `—` | | **מאגר ידע** | פתיחה, עיון במקורות, שאילת שאלות | יצירת מאגר ידע, העלאת מקור | רענון מקור | מחיקת מאגר ידע או מקור | | **תגובות מהירות** | פתיחת התגובות המהירות ושימוש בהן בשיחה | יצירת תגובה מהירה או קטגוריה | עריכה | מחיקה | | **בונה הטפסים** | פתיחת הטפסים, קריאת טפסים והגשות, ייצוא | יצירה או שכפול של טופס | עריכת טופס, פרסום, העלאת תמונה | מחיקת טופס | | **חתימת מסמכים** | פתיחה וקריאת מסמכים | יצירת מסמך ושליחתו לחתימה | עריכת מסמך | מחיקת מסמך | | **מחסן קבצים** | פתיחה, צפייה ו**הורדה** של קבצים | `—` | `—` | מחיקת קבצים | | **הישגים** | פתיחת עמוד ההישגים וצפייה בהתקדמות | `—` | **איסוף הישג שהושלם** | `—` | ### היוצאים מן הכלל ל**עולם AI** אין פריטים ליצירה או למחיקה — זהו לוח של מתגים. **עדכון** הוא מה שמאפשר למישהו להפעיל אותם. עם **צפייה** בלבד, נציג רואה אילו יכולות AI מופעלות אך אינו יכול לשנות אף אחת. **הישגים** עובד באותו אופן. **צפייה** מציגה את העמוד ואת ההתקדמות; **עדכון** הוא מה שמאפשר למישהו ללחוץ **איסוף** ולהוסיף את קרדיטי הפרס לחשבון. ל**מחסן הקבצים** אין יצירה, כי הקבצים מגיעים מהעלאה במקום אחר — קובץ מצורף בשיחה, מקור במאגר ידע, תמונה בטופס. **צפייה** כוללת הורדה. **מחיקה** היא זו שחשובה, והיא ההרשאה שמאפשרת גם למחוק העלאה של מישהו *אחר* ולהשתמש ב**מחיקת הכול**. :::note תגובות מהירות: אישיות מול משותפות כתיבת תגובה מהירה **אישית** שרק אתם רואים היא שירות עצמי — כל מי שיש לו **צפייה** יכול לעשות זאת. **יצירה**, **עדכון** ו**מחיקה** שולטות באלה **ברמת החשבון** שכל נציג רואה. תפקיד **Agent** של ברירת המחדל מחזיק בכל הארבע, כך שנציגי הקו הראשון יכולים לבנות את הספרייה המשותפת. אם אתם מעדיפים שרק ישתמשו בה, הורידו את התפקיד ל**צפייה** ושמרו את פעולות הכתיבה למפקחים. ::: --- ## הגדרות כל לשונית הגדרות היא שורה נפרדת, כי מדובר בעניינים שונים באמת — קריאת כתובת העסק אינה קריאת מפתחות ה‑API. תפקיד שאינו מעניק אף אחת מהן אינו רואה **הגדרות** בסרגל הצד כלל; תפקיד שמעניק אחת נוחת ישירות באותה לשונית. | יכולת | צפייה | יצירה | עדכון | מחיקה | | --- | --- | --- | --- | --- | | **מידע כללי** | פתיחת הלשונית | `—` | שינוי שם העסק, לוגו, שפה, אזור זמן, מטבע, מדינה | `—` | | **שעות פעילות** | פתיחת הלשונית | הוספת לוח זמנים או לוח חגים | עריכה | מחיקה | | **אבטחה והתחברות** | פתיחת הלשונית, צפייה בסשנים פעילים | `—` | שינוי רשימת ה‑IP המורשים, אכיפת אימות דו‑שלבי, פסק זמן לחוסר פעילות; **ניתוק כפוי של סשן** | `—` | | **API** | פתיחת הלשונית וצפייה ברשימת המפתחות | **הנפקת מפתח API חדש** | `—` | **ביטול מפתח** | | **נתונים ופרטיות** | פתיחת הלשונית | **בקשת ייצוא נתונים** | `—` | **מחיקת החשבון כולו** | :::danger נתונים ופרטיות ← מחיקה מוחקת את סביבת העבודה זו ההרשאה ההרסנית ביותר ב‑Teloring. היא מה שמאפשר את הפעולה **אזור מסוכן ← מחיקת החשבון**. תפקידי ברירת המחדל נותנים אותה ל‑**Owner בלבד**. השאירו את זה כך, אלא אם יש לכם סיבה ספציפית. ::: :::note ל‑API אין עדכון אי אפשר לערוך מפתח API — מפתח הוא סוד, ושינוי שלו פירושו הנפקה של אחד חדש. לכן הפעולות הן **יצירה** (הנפקה) ו**מחיקה** (ביטול). מנויי Webhook נשלטים על ידי אותה שורה, כי הם חלק מאותו משטח פיתוח. ::: --- ## נציגים וצוותים | יכולת | צפייה | יצירה | עדכון | מחיקה | | --- | --- | --- | --- | --- | | **נציגים** | פתיחת ספריית הנציגים וחיפוש בה | הזמנת נציג חדש, יצירת נציג AI | עריכת כל נציג — תפקיד, שפה, אימות דו‑שלבי, מחלקה, הערות, **הגישה הקולית שלו**; איפוס סיסמה של נציג **אחר**; העברת אימייל של נציג **אחר**; שליחה חוזרת של הזמנה; השבתה | מחיקת פרופיל של נציג | | **צוותים** | פתיחת הצוותים וצפייה ברשימה | יצירת צוות | עריכת צוות — שם, חברים, כללים | מחיקת צוות | | **תפקידים והרשאות** | פתיחת העמוד הזה וקריאת כל תפקיד | יצירת תפקיד | עריכת תפקיד | מחיקת תפקיד | | **יומן לוגים** | פתיחת יומן הלוגים וקריאתו | `—` | `—` | `—` | ### דברים שהם תמיד שירות עצמי שתי פעולות בעמוד הנציגים לעולם אינן דורשות הרשאה, כי הן נוגעות לנציג עצמו: - איפוס הסיסמה **שלו**; - שינוי אימייל ההתחברות **שלו**. שתיהן עוברות דרך קישור חד‑פעמי שנשלח לתיבה שלו. ‏**נציגים ← עדכון** הוא מה שמרחיב את הפעולות האלה ל*אנשים אחרים*. :::danger תפקידים והרשאות הוא המפתח הראשי כל מי שיכול ליצור או לערוך תפקיד יכול לתת לעצמו — או לכל אחד אחר — כל הרשאה אחרת ב‑Teloring, כולל חיובים ומחיקת חשבון. זה אינו פגם; זו בדיוק המשמעות של עריכת תפקיד. התייחסו לזה בדיוק כמו לסיסמת מנהל. תפקידי ברירת המחדל נותנים **יצירה**, **עדכון** ו**מחיקה** ל‑**Owner בלבד**, ו**צפייה** ל‑Team Leader, כדי שמנהל יוכל לראות את המבנה בלי לשנות אותו. ::: :::note הגישה הקולית נמצאת תחת נציגים הפעלת חיוג בדפדפן עבור אדם מסוים היא חלק מעריכת אותו נציג, ולכן היא דורשת **נציגים ← עדכון**. המתג הקולי ברמת החשבון והגדרת *תיבת* הקול נמצאים תחת **טבעת הערוצים**. ::: --- ## חיובים | יכולת | צפייה | יצירה | עדכון | מחיקה | | --- | --- | --- | --- | --- | | **קרדיטים** | צפייה ביתרת הקרדיטים, בתג הקרדיטים בכותרת ובהיסטוריית העסקאות | `—` | `—` | `—` | | **מנוי** | צפייה במסלול הנוכחי, במושבים ובמדדי השימוש | `—` | **שינוי מסלול** | `—` | | **כרטיסי אשראי** | צפייה בכרטיסים השמורים — סוג המותג וארבע הספרות האחרונות בלבד | הוספת כרטיס | עדכון תוקף של כרטיס | הסרת כרטיס | | **תמחור שימוש** | צפייה במחירון לכל פעולה | `—` | `—` | `—` | הפריט **חיובים** נעלם מסרגל הצד לחלוטין כשתפקיד אינו מעניק אף אחת מאלה. אם תפקיד מעניק חלק, רק אותן לשוניות מופיעות, ופתיחת החיובים נוחתת על אחת שהנציג יכול לקרוא. :::note תג הקרדיטים בכותרת נתוני הקרדיטים החודשיים והנטענים בסרגל העליון מוצגים רק לתפקידים עם **קרדיטים ← צפייה**. תפקידים בלעדיה לעולם אינם רואים את יתרת החשבון. ::: --- ## מה תפקידי ברירת המחדל מעניקים {#what-the-default-roles-grant} `R` צפייה · `C` יצירה · `U` עדכון · `D` מחיקה · `—` אין גישה | יכולת | Owner | Team Leader | Marketing | Agent | Viewer | | --- | --- | --- | --- | --- | --- | | **לקוחות** | R C U D | R C U D | R C U | R C U | R | | מסע | R | R | R | R | R | | שיחות (בתוך לקוח) | R | R | R | R | R | | שיחות טלפון | R | R | R | R | R | | מסמכים | R | R | R | R | R | | אנשי קשר / קריאות שירות / עסקאות / משימות / הערות | R C U D | R C U D | R C U | R C U | R | | **תצוגות** | R C U D | R C U D | R C U D | R | R | | **טבעת הערוצים (תיבות)** | R C U D | R U | R | — | R | | **אנליטיקס** | R C U D | R C U D | R C U D | — | R | | **מאפייני שיחה** | R U D | R U D | R U | R U | R | | **סטודיו** | R C U D | R C U D | R C U D | — | — | | **עולם AI** | R U | R U | R U | — | — | | **מאגר ידע** | R C U D | R C U D | R C U D | R | R | | **תגובות מהירות** | R C U D | R C U D | R C U D | R C U D | R | | **בונה הטפסים** | R C U D | R C U D | R C U D | — | R | | **חתימת מסמכים** | R C U D | R C U D | R | R C | R | | **מחסן קבצים** | R D | R D | R | R | R | | **הישגים** | R U | R U | R U | R U | R | | **הגדרות ← מידע כללי** | R U | R | R | — | R | | **הגדרות ← שעות פעילות** | R C U D | R C U D | R | — | — | | **הגדרות ← אבטחה והתחברות** | R U | R | — | — | — | | **הגדרות ← API** | R C D | R | — | — | — | | **הגדרות ← נתונים ופרטיות** | R C D | — | — | — | — | | **נציגים** | R C U D | R | R | R | R | | **צוותים** | R C U D | R C U D | R | R | R | | **תפקידים והרשאות** | R C U D | R | — | — | — | | **יומן לוגים** | R | R | — | — | — | | **חיובים ← קרדיטים** | R | — | — | — | — | | **חיובים ← מנוי** | R U | — | — | — | — | | **חיובים ← כרטיסי אשראי** | R C U D | — | — | — | — | | **חיובים ← תמחור שימוש** | R | — | — | — | — | ‏Owner מוצג מסומן במלואו לצורך התמצאות. בפועל זו אינה רשת שמורה בכלל — זו גישה מלאה קבועה שאינה ניתנת לעריכה. :::note הרשאות חדשות אינן מתווספות לתפקידים קיימים הטבלה הזו היא מה שחשבון **שנוצר זה עתה** מקבל. הרשאה שנוספה ל‑Teloring אחרי שהחשבון שלכם נוצר **אינה** מסומנת בתפקידים הקיימים שלכם — שום דבר לעולם אינו מוענק מאחורי הגב שלכם. **מאפייני שיחה** היא הדוגמה האחרונה: עד שתסמנו אותה, רק Owner מגיע ליכולת. פתחו תפקיד, סמנו את השורה ושמרו. ::: ### איך לקרוא את הטבלה - **Team Leader** הוא מנהל תמיכה מלא ללא הישג יד פיננסי או ניהולי. הוא יכול לראות את רשימת מפתחות ה‑API ואת הגדרות האבטחה אך לא לשנות אף אחת מהן, כך שמנהל יכול לענות על "האם אימות דו‑שלבי נאכף?" בלי יכולת להחליף מפתח. - **Marketing** בונה ומודד. הוא יכול לשנות את מבנה הסטודיו, הטפסים והאנליטיקס אבל אינו יכול לחבר תיבה, לנהל נציגים או להגיע לחיובים. - **Agent** מצומצם בכוונה מחוץ לשיחות: לקוחות, תגובות מהירות, מאגר הידע לצורך בירורים, ושליחת מסמכים לחתימה. ללא סטודיו, ללא אנליטיקס, ללא הגדרות. הוא כן מקבל **מאפייני שיחה ← עדכון**, כי תיעוד סיבה ותוצאה הוא חלק מהטיפול בשיחה. - **Viewer** הוא צפייה כמעט בכל מקום וכתיבה בשום מקום — ובעיקר, **ללא שיחות כלל** (ראו [הרשאות ערוצים](./channel-permissions.md#what-the-default-roles-grant)). --- ## מדריכים קשורים - [תפקידים והרשאות](./overview.md) — יצירה, עריכה, שיוך ומחיקה של תפקידים. - [מדריך הרשאות הערוצים](./channel-permissions.md) — החצי השני של תפקיד. - [תפקידים ומתכונים לדוגמה](./examples.md) — הגדרות להעתקה. - [הגדרות החשבון](../settings.md) — לשוניות ההגדרות שהרשת הזו מפנה אליהן. - [CRM ולקוחות](../crm.md) — אובייקטי לקוח ועורך השדות. - [מאפייני שיחה](../conversation-attributes.md) — היכולת שמאחורי שורת מאפייני השיחה. --- # מדריך הרשאות הערוצים מקור: https://docs.teloring.com/he/docs/product/roles/channel-permissions Markdown: https://docs.teloring.com/he/markdown/docs/product/roles/channel-permissions.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z לשונית **הרשאות הערוצים** קובעת מה נציג רשאי לעשות **בכל תיבה**. זהו החצי של התפקיד שמעצב את יום העבודה בפועל של הנציג. ![לשונית הרשאות הערוצים עם כרטיס התיבה העתידית פתוח מעל התיבות המחוברות](pathname:///img/screenshots/he/product/roles/channel-permissions-tab.png) אלו אינן צפייה/יצירה/עדכון/מחיקה. תיבה היא *מקום*, והשאלות המועילות על מקום שונות: האם הוא רואה את תור ההמתנה שלו, האם אפשר למסור לו עבודה ממנו, האם מותר לו להשיב, האם מותר לו לסמן כטופל. לכן לכל תיבה יש אותן **18 יכולות של הפעלה/כיבוי**. ## איך הלשונית עובדת | רכיב | מה הוא עושה | | --- | --- | | **תיבה עתידית (ברירת מחדל)** | הכרטיס הראשון, מסומן במסגרת מקווקוות. קובע את ברירות המחדל לכל תיבה שתחברו מעכשיו — וגם לכל תיבה למטה שלא הגדרתם. תמיד פתוח. | | **כרטיס תיבה** | אחד לכל תיבה מחוברת, עם השם שלה וסוג הערוץ. לחצו על הכותרת כדי לפתוח או לכווץ. | | **מונה** (`12/18`) | כמה מתוך 18 היכולות מופעלות לאותה תיבה. אפשר לקרוא במבט אחד בלי לפתוח. | | תג **בירושה** | התיבה הזו מעולם לא הוגדרה בתפקיד הזה, ולכן היא עוקבת אחרי **התיבה העתידית**. | | **תיבת סימון** | היכולת. לכל אחת יש הסבר בשורה אחת מתחתיה. | | **בחירת הכול** / **ניקוי הכול** | סימון או ניקוי של כל 18 היכולות לאותה תיבה בלחיצה אחת. | :::tip הגדירו קודם את התיבה העתידית, ואז טפלו בחריגים הסדר היעיל הוא: 1. פתחו את **התיבה העתידית** וקבעו מה התפקיד הזה אמור לרוב לעשות בכל תיבה. 2. השאירו כל תיבה שתואמת לברירות המחדל האלה בלי לגעת — היא תציג **בירושה** ותעקוב אחריהן. 3. פתחו ושנו רק את התיבות שבאמת שונות. תפקיד לצוות שעובד רק ב‑WhatsApp הוא לכן: נקו הכול ב**תיבה העתידית**, ואז סמנו מה שאתם צריכים בתיבת ה‑WhatsApp בלבד. שני כרטיסים במקום עשרה. ::: --- ## תיבה עתידית — איך הירושה עובדת זהו הרעיון החשוב ביותר בעמוד, והוא חוסך הכי הרבה עבודה. כרטיס תיבה בתוך תפקיד נמצא באחד משני מצבים: | מצב | תג | התנהגות | | --- | --- | --- | | **בירושה** | **בירושה** | מעולם לא שיניתם את התיבה הזו בתפקיד הזה. היא משתמשת בערכי **התיבה העתידית**, וממשיכה לעקוב אחריהם — כולל אם תשנו את התיבה העתידית בהמשך. | | **מפורש** | ללא | שיניתם לפחות תיבת סימון אחת בתיבה הזו. עכשיו יש לה הגדרות משלה והיא כבר אינה עוקבת אחרי התיבה העתידית. | ברגע שאתם מסמנים או מבטלים סימון בכרטיס בירושה, הוא הופך למפורש. ‏Teloring מעתיקה קודם את ערכי התיבה העתידית הנוכחיים, כך ששינוי תיבת סימון אחת לעולם אינו מנקה בשקט את שבע עשרה האחרות. ### למה זה חשוב **חברו תיבה חדשה וכל תפקיד כבר יודע מה לעשות איתה.** מספר WhatsApp חדש, תיבת תמיכה שנייה, בוט טלגרם — כל אחד מהם קולט אוטומטית את הגדרות התיבה העתידית של כל תפקיד. אינכם חוזרים לעמוד הזה, ואף תפקיד אינו נשאר בטעות עם גישה לערוץ שאיש לא בדק. זה עובד בשני הכיוונים: | מצב | מה קורה | | --- | --- | | אתם מחברים תיבה חדשה | כל תפקיד מחיל עליה את ערכי **התיבה העתידית** שלו, מיד. | | אתם משנים בהמשך את **התיבה העתידית** בתפקיד | כל תיבה באותו תפקיד שעדיין מציגה **בירושה** מתעדכנת גם היא. תיבות מפורשות אינן נוגעות. | | אתם יוצרים תפקיד חדש אחרי חיבור התיבה | אותו כלל — הסדר אינו משנה. | | אתם מוחקים תיבה | ההגדרות השמורות שלה נשארות בכל תפקיד בלי נזק ונעלמות מהעורך. | :::warning התיבה העתידית היא הרשאה, לא מציין מקום קל לקרוא *"תיבה עתידית"* כתבנית שאינה עושה דבר עד שערוץ מגיע. זהו כלל חי: כל תיבה שמציגה **בירושה** נשלטת על ידו ממש עכשיו. סימון **צפייה בכל השיחות הפתוחות** בתיבה העתידית מעניק אותה בכל תיבה בירושה באותו תפקיד מיד — לא רק בעתידיות. ::: --- ## 18 היכולות הן מקובצות למטה לפי מה שהן עושות. במוצר הן מופיעות בסדר הזה בדיוק. ### מה הנציג יכול לראות | יכולת | מה היא מעניקה | היכן הנציג מבחין בזה | | --- | --- | --- | | **צפייה בתור ההמתנה** | גישה לשיחות *ממתינות בתור* מהתיבה הזו | תור **ממתינות בתור** ומונה התג שלו | | **קבלת הבא בתור** | מאפשרת לקחת את השיחה הממתינה הבאה מהתיבה הזו | כפתור **קבלת הבא בתור** | | **צפייה בשיחות בוט סטודיו** | שיחות שמטופלות כרגע על ידי תהליך סטודיו | תור **בוט סטודיו** | | **צפייה בשיחות נציג AI** | שיחות שמטופלות כרגע על ידי נציג AI | תור **נציג AI** | | **צפייה בשיחות בהמתנה** | שיחות שהוחנו עד למועד | תור **בהמתנה** | | **צפייה בכל השיחות הפתוחות** | כל שיחה פתוחה בתיבה הזו, בבעלות כל אחד | תור **כל הפתוחות** | | **צפייה בכל השיחות שטופלו** | כל שיחה שטופלה בתיבה הזו | תור **טופלו** | | **צפייה בשיחות קודמות** | פאנל *השיחות הקודמות* בתוך שיחה | הפאנל הצדדי | ### מה הנציג יכול לעשות | יכולת | מה היא מעניקה | | --- | --- | | **שליחת הודעה חדשה** | מענה ללקוח בתיבה הזו | | **פתיחת שיחה חדשה** | התיבה הזו מופיעה בבוחר של **+ שיחה חדשה** | | **שליחת הערה פרטית** | כתיבת הערה פנימית על שיחה בתיבה הזו | | **העברת שיחה להמתנה** | שימוש בכפתור **בהמתנה** | | **יכול לשייך שיחות** | שינוי **משויך ל** או **צוות משויך** | | **סימון שיחה כטופלה** | שימוש בכפתור **סימון כטופל** | | **מחיקת שיחה** | כפתור **מחיקה** — **תיבות אימייל בלבד** | | **קביעת עדיפות לשיחה** | בוחר העדיפות | | **הצבת דגל על שיחה** | בוחר הדגל | | **הוספת תווית לשיחה** | הוספה, שינוי או הסרה של תוויות | ### הערות על יכולות בודדות **צפייה בתור ההמתנה** ו**קבלת הבא בתור** נפרדות בכוונה. תפקיד יכול לצפות בתור מתמלא בלי שיימסרו לו שיחות ממנו — שימושי למפקח שמנטר אך אינו לוקח שיחות, ולצוות שאמור לקבל עבודה רק מהערוץ שלו. **צפייה בכל השיחות הפתוחות** היא הרחבה. היא מציגה שיחות בבעלות נציגים אחרים. השאירו אותה כבויה והנציג יעבוד רק מ*שלי* ומכל מה שהוא לוקח מתור ההמתנה — ההגדרה הקלאסית של קו ראשון. **שליחת הודעה חדשה** ו**שליחת הערה פרטית** נפרדות בכוונה. תפקיד יכול להוסיף הערות לשיחה עבור עמיתים בלי שיהיה מורשה לדבר עם הלקוח — בקר איכות, מומחה שמוסיף הקשר, מתלמד שהתשובות שלו עדיין נבדקות. **פתיחת שיחה חדשה** שולטת בבוחר התיבות. כשנציג לוחץ **+ שיחה חדשה**, מוצעות רק תיבות עם היכולת הזו. **יכול לשייך שיחות** מכסה גם את בוחר הנציגים וגם את בוחר הצוותים. החזרת שיחה **שלכם עצמכם** עם **החזרה לתור** לעולם אינה דורשת אותה — נציג חייב תמיד להיות מסוגל לשחרר את העבודה שלו. **מחיקת שיחה** מופיעה רק בתיבות **אימייל**, כי אימייל הוא הערוץ היחיד שבו מחיקת שרשור היא פעולה רגילה. סימון שלה בתיבת WhatsApp אינו מזיק ואינו עושה דבר. זו הרשאת השיחה ההרסנית ביותר שיש — היא משמידה את היסטוריית ההודעות — והיא לעולם אינה משתמעת מ**סימון כטופל**. **צפייה בשיחות קודמות** ראויה לרגע של תשומת לב. הפאנל מציג שיחות אחרות עם אותו לקוח, שעשויות להיות מתיבות שהנציג אינו יכול לעבוד בהן אחרת. ‏Teloring מסננת את הפאנל הזה לפי תיבה, כך שכל שיחה קודמת מופיעה רק אם לנציג יש את היכולת הזו **בתיבה שאליה השיחה שייכת** — ולא בזו שהוא קורא כרגע. --- ## למה "שלי" לעולם אינו מסונן {#why-mine-is-never-filtered} **שיחות המשויכות לנציג תמיד נגישות לו במלואן, בכל תיבה, בלי קשר להרשאות הערוצים.** הסיבה מעשית. אם לנציג משויכת שיחת אימייל והאימייל מוגבל בהמשך עבור התפקיד שלו, סינון שלה מ*שלי* היה משאיר לקוח אמיתי ממתין לשיחה שאף אחד אינו רואה. השיוך תמיד מנצח. לכן: | תור | מסונן לפי תיבה? | | --- | --- | | **שלי** | **לא.** לעולם לא. | | ממתינות בתור | כן — `צפייה בתור ההמתנה` | | בוט סטודיו | כן — `צפייה בשיחות בוט Studio` | | נציג AI | כן — `צפייה בשיחות נציג AI` | | בהמתנה | כן — `צפייה בשיחות בהמתנה` | | כל הפתוחות | כן — `צפייה בכל השיחות הפתוחות` | | טופלו | כן — `צפייה בכל השיחות שטופלו` | אותו כלל חל על שיחה שמגיעים אליה דרך קישור או חיפוש: אם היא משויכת לאותו נציג, הוא יכול לפתוח אותה. :::info תפריט השיחות לעולם אינו נעלם בכל מה שתפקיד מתיר, מדור **השיחות** וכל שבעת התורים נשארים בסרגל הצד. רק ה*תוכן* משתנה. זה בכוונה. תפריט שמשנה צורה מאדם לאדם קשה לתמיכה — "לחצו על ממתינות בתור" מפסיקה להיות עצה אמינה. תור שנציג אינו רואה בו דבר פשוט מציג רשימה ריקה. ::: --- ## מה עוד עוקב אחרי ההרשאות האלה הרשאות הערוצים מוחלות בכל מקום שבו שיחה יכולה להופיע, ולא רק ברשימות התורים. | מקום | התנהגות | | --- | --- | | **מוני התגים בסרגל הצד** | נספרים לפי אותם כללים כמו הרשימה, כך שתג לעולם אינו מציג 12 מעל רשימה של 3. תג מנופח היה עצמו חושף כמה תנועה הנציג אינו רשאי לראות. | | **חיפוש שיחות** | מוגבל לאותן תיבות כמו התור שנחפש בו, כך שהחיפוש אינו יכול לחשוף משהו שהרשימה מסתירה. | | **חיפוש הודעות** | אותו דבר — *תוכן* הודעות מתיבה מוגבלת לעולם אינו מוחזר. | | **קבלת הבא בתור** | מציעה רק שיחות מתיבות עם **קבלת הבא בתור**. | | **מסננים** | פאנל המסננים יכול רק לצמצם את מה שהנציג כבר רשאי לראות. אי אפשר להשתמש בו כדי לעקוף הגבלה. | | **שיחות קודמות** | מסוננות לפי תיבה, כמתואר למעלה. | | **אריחי לוח הבקרה** | נתוני ה*ממתינות* וה*טופלו היום* בעמוד הבית עוקבים אחרי אותם כללים. | | **AI Copilot** | זמין היכן שלנציג מותר **לשלוח הודעה חדשה**, כי ה‑Copilot מנסח תשובות. אין מה לנסח, אין מה להציג. | | **פתיחה לפי מזהה** | שיחה בתיבה מוגבלת מדווחת *לא נמצא*, ולא *אסור* — עצם קיומה הוא בעצמו מידע. | | **ה‑API** | אותם כללים, אותן תוצאות. סקריפט שמשתמש בסשן של נציג רואה בדיוק את מה שהנציג רואה. | :::note מה נציג רואה כשפקד מוסר כפתורים — **סימון כטופל**, **בהמתנה**, **מחיקה** — מוסתרים לחלוטין. בוחרים שמציגים ערך נוכחי — עדיפות, דגל, תוויות, שיוך — מוצגים **אפורים** במקום. הנציג עדיין יכול לקרוא ששיחה היא דחופה, בלי יכולת לשנות. הסרתם הייתה מסתירה מידע שהנציג באמת צריך. ::: --- ## מה תפקידי ברירת המחדל מעניקים {#what-the-default-roles-grant} אלו ערכי **התיבה העתידית** של כל תפקיד, שכל תיבה יורשת עד שתקבעו אחרת. | יכולת | Owner | Team Leader | Marketing | Agent | Viewer | | --- | --- | --- | --- | --- | --- | | צפייה בתור ההמתנה | כן | כן | לא | כן | לא | | קבלת הבא בתור | כן | כן | לא | כן | לא | | צפייה בשיחות בוט סטודיו | כן | כן | לא | לא | לא | | צפייה בשיחות נציג AI | כן | כן | לא | לא | לא | | צפייה בשיחות בהמתנה | כן | כן | לא | כן | לא | | צפייה בכל השיחות הפתוחות | כן | כן | לא | כן | לא | | צפייה בכל השיחות שטופלו | כן | כן | לא | כן | לא | | שליחת הודעה חדשה | כן | כן | כן | כן | לא | | פתיחת שיחה חדשה | כן | כן | כן | כן | לא | | שליחת הערה פרטית | כן | כן | כן | כן | לא | | צפייה בשיחות קודמות | כן | כן | כן | כן | לא | | העברת שיחה להמתנה | כן | כן | כן | כן | לא | | יכול לשייך שיחות | כן | כן | כן | כן | לא | | סימון שיחה כטופלה | כן | כן | כן | כן | לא | | מחיקת שיחה | כן | כן | לא | לא | לא | | קביעת עדיפות לשיחה | כן | כן | כן | כן | לא | | הצבת דגל על שיחה | כן | כן | כן | כן | לא | | הוספת תווית לשיחה | כן | כן | כן | כן | לא | ### איך לקרוא את הטבלה - ל‑**Team Leader** יש הכול, בכל תיבה, כולל מחיקת שרשורי אימייל. זהו תפקיד רצפת התמיכה. - **Marketing** יכול לעבוד עם שיחות — להשיב, לפתוח, לשייך, לסמן כטופל, לתייג — אבל אינו רואה **אף אחד מהתורים המשותפים**. בפועל הוא עובד רק מ*שלי*: שיחות שמשויכות אליו, או כאלה שהוא פתח. זו המשמעות של "לא יכול לראות את השיחות של כולם" ברשת הרשאות. - ל‑**Agent** יש הסט המלא של הקו הראשון, פחות שני תורי הבוט ופחות המחיקה. נציגי קו ראשון אינם צריכים לעקוב אחרי מה שסטודיו וה‑AI מטפלים בו, ולא צריכה להיות להם היכולת להשמיד שרשור אימייל. - ל‑**Viewer** אין **כלום**. זהו תפקיד דיווח ללא גישה לשיחות בכלל — כל תור ריק עבורו, והוא עדיין יכול לקרוא אנליטיקס ולקוחות. --- ## הגדרות נפוצות ### צוות אחד, ערוץ אחד *צוות WhatsApp שאסור לו לראות אימייל.* 1. שכפלו את תפקיד **Agent** וקראו לו *צוות WhatsApp*. 2. פתחו **הרשאות ערוצים** ← **תיבה עתידית** ← **ניקוי הכול**. 3. פתחו את תיבת ה‑WhatsApp ← **בחירת הכול**, ואז הסירו את הסימון מ**מחיקת שיחה**. 4. שמרו. כל תיבה אחרת נשארת בירושה מתיבה עתידית ריקה, כך שהם אינם רואים שם דבר — כולל כל תיבה שתחובר בהמשך, וזו הנקודה. ### מפקח שצופה אך אינו עונה 1. שכפלו את **Agent** וקראו לו *מפקח רצפה*. 2. ב**תיבה העתידית**, השאירו את כל יכולות ה*צפייה* מופעלות. 3. הסירו את הסימון מ**קבלת הבא בתור** — הוא מנטר ולא לוקח עבודה. 4. השאירו את **יכול לשייך שיחות** מופעלת, כדי שיוכל לנתב. 5. הסירו את הסימון מ**שליחת הודעה חדשה** אם הוא לעולם לא אמור להשיב ישירות. ### בקר איכות שמעיר אך לעולם אינו משיב 1. שכפלו את **Agent** וקראו לו *בקרת איכות*. 2. ב**תיבה העתידית**, השאירו את **צפייה בכל השיחות הפתוחות**, **צפייה בכל השיחות שטופלו** ו**צפייה בשיחות קודמות** מופעלות. 3. הסירו את הסימון מ**שליחת הודעה חדשה**, **פתיחת שיחה חדשה**, **סימון שיחה כטופלה** ו**קבלת הבא בתור**. 4. השאירו את **שליחת הערה פרטית** מופעלת, ואת **הוספת תווית לשיחה**, כדי שיוכל לתייג את מה שביקר. הוא יכול לקרוא כל שיחה ולהוסיף הערות, והלקוח לעולם אינו שומע ממנו. ### קבלן חיצוני בערוץ אחד 1. צרו תפקיד וקראו לו על שם הקבלן. 2. **הרשאות מערכת**: סמנו **לקוחות ← צפייה** ותו לא. 3. **הרשאות ערוצים**: **תיבה עתידית** ← **ניקוי הכול**. 4. בתיבה היחידה שלו, סמנו רק את מה שהוא צריך: *צפייה בתור ההמתנה*, *קבלת הבא בתור*, *שליחת הודעה*, *סימון כטופל*, *צפייה בשיחות קודמות*. 5. שמרו. מתכונים נוספים ב[תפקידים ומתכונים לדוגמה](./examples.md). --- ## מגבלות ודברים שכדאי לשים לב אליהם | פריט | מה באמת קורה | עשו זאת במקום | | --- | --- | --- | | **אין הרשאה לפי שיחה** | ההרשאות הן לפי תיבה, לעולם לא לפי שיחה, לקוח או תווית בודדים. | הפרידו את התנועה לפי תיבה אם היא חייבת להיות מופרדת. | | **אי אפשר להגביל את "שלי"** | שיחה משויכת תמיד גלויה לבעלים שלה, בכוונה. | שלטו במי שאפשר *לשייך* אליו באמצעות **יכול לשייך שיחות** ו[צוותים](../teams.md). | | **התורים תמיד בסרגל הצד** | נציג ללא גישה לערוצים עדיין רואה שבעה קישורי תור, כולם ריקים. | אין מה לעשות. הוא לא ילחץ פעמיים. | | **המחיקה חלה רק על אימייל** | סימון **מחיקת שיחה** בתיבת WhatsApp או SMS אינו משפיע — אין פעולת מחיקה בערוצים האלה. | לא מזיק; השאירו או נקו. | | **טבעת הערוצים ← צפייה מציגה כל תיבה** | נציג עם גישת *הגדרה* לתיבות רואה שם את כל התיבות ברשימה, כולל כאלה שאינו יכול לעבוד בהן. | אל תעניקו **טבעת הערוצים ← צפייה** לתפקידים שלא אמורים לדעת שתיבה קיימת. | | **הצוותים הם מגבלה נפרדת** | גם עם **קבלת הבא בתור**, לנציג נמסרות רק שיחות ללא צוות, או מצוות שהוא חבר בו. | בדקו את [הצוותים](../teams.md) כשעבודה אינה מגיעה. | | **תיבה שנמחקה שומרת את הרשומה שלה** | ההגדרות שלה נשארות שמורות בתפקיד, בלי נזק, ואינן מוצגות עוד. | אין מה לעשות. | | **אין לוח זמנים לפי תפקיד** | תפקיד אינו יכול להעניק גישה רק במשמרת. | השביתו את הנציג, או טפלו בזה בסטודיו. | --- ## פתרון תקלות ### תור ריק אצל נציג אחד ולא אצל אחר התפקידים שלהם שונים, או שלאותו תפקיד יש תיבות שהוגדרו אחרת. פתחו את לשונית **הרשאות הערוצים** של התפקיד, פתחו את התיבה הרלוונטית ובדקו את היכולת לאותו תור. זכרו את תג **בירושה**: אם התיבה בירושה, התשובה נמצאת ב**תיבה העתידית**, לא בכרטיס ההוא. ### "קבלת הבא בתור" אומר שאין שיחות ממתינות, אבל אני רואה שיחות ממתינות שתי סיבות אפשריות, בסדר הזה: 1. **קבלת הבא בתור** כבויה עבור התיבות האלה, בזמן ש**צפייה בתור ההמתנה** מופעלת. התפקיד מוגדר לצפות, לא לקחת. 2. כל השיחות הממתינות שייכות ל[צוות](../teams.md) שהנציג אינו חבר בו. ### נציג אינו יכול להשיב, אבל השיחה פתוחה מולו **שליחת הודעה חדשה** כבויה עבור התיבה הזו. אם **שליחת הערה פרטית** מופעלת, הוא ינחת בלשונית ההערה הפרטית — וזה בכוונה, כדי שלא יבהה בתיבת חיבור שתידחה. ### נציג אינו יכול לשנות עדיפות של שיחה, אבל רואה אותה התנהגות נכונה. **קביעת עדיפות לשיחה** כבויה, ולכן הבוחר אפור ולא מוסתר — הוא יכול לקרוא את הערך, לא לשנות אותו. ### תיבה חדשה גלויה לתפקיד שלא אמור לקבל אותה **התיבה העתידית** של אותו תפקיד מעניקה אותה, והתיבה החדשה ירשה את ברירות המחדל האלה. או שתנקו את התיבה העתידית עבור אותו תפקיד, או שתפתחו את התיבה החדשה ותנקו שם. ### פאנל השיחות הקודמות חסר **צפייה בשיחות קודמות** כבויה עבור התיבה שהנציג קורא. אם הפאנל קיים אך קצר מהצפוי, הרשומות החסרות שייכות לתיבות שבהן היכולת כבויה. ### נציג רואה שיחה מתיבה מוגבלת כמעט תמיד כי היא **משויכת אליו** — *שלי* לעולם אינו מסונן. בדקו **משויך ל** בשיחה. אם היא באמת לא שלו, בדקו אם כרטיס התיבה הוא **בירושה** ומה **התיבה העתידית** מעניקה. --- ## מדריכים קשורים - [תפקידים והרשאות](./overview.md) — יצירה, עריכה ושיוך של תפקידים. - [מדריך הרשאות המערכת](./system-permissions.md) — החצי השני של תפקיד. - [תפקידים ומתכונים לדוגמה](./examples.md) — הגדרות מלאות להעתקה. - [שיחות](../../getting-started/conversations.md) — התורים, **קבלת הבא בתור**, מסננים ופעולות. - [טבעת הערוצים — תיבות](../ring/overview.md) — חיבור התיבות שההרשאות האלה חלות עליהן. - [צוותים](../teams.md) — ניתוב, שמשפיע גם הוא על מה שנמסר לנציג. - [בהמתנה](../on-hold.md) — התור שמאחורי **צפייה בשיחות בהמתנה**. --- # תצוגות מקור: https://docs.teloring.com/he/docs/product/views Markdown: https://docs.teloring.com/he/markdown/docs/product/views.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z התצוגות הופכות את ה‑CRM שלכם לטבלאות שאתם בונים בעצמכם. **תצוגה** היא טבלה שמורה, הניתנת לסינון ולמיון, מעל כל אובייקט ב‑Teloring — הלקוחות שלכם, או כל רשומה שחיה תחת לקוח (הערות, שיחות טלפון, עסקאות, משימות, קריאות שירות, מסמכים, נתוני טפסים וכל אובייקט מותאם שהחשבון שלכם יוצר). הרעיון פשוט. בדרך כלל, הערה או עסקה כלואות בתוך פרופיל של לקוח אחד. כדי לענות על שאלה כמו *"הראו לי כל הערה במערכת, עם האימייל של הלקוח שהיא שייכת אליו"*, הייתם צריכים לפתוח לקוחות אחד אחד. תצוגה עושה זאת בטבלה אחת: בוחרים את האובייקט שכל שורה מייצגת, בוחרים את העמודות להצגה — כולל עמודות שנמשכות מהלקוח — מסננים וממיינים את התוצאה, ושומרים עם שם. אם השתמשתם בתצוגות של Airtable, בדוחות מותאמים של HubSpot או במסדי נתונים מקושרים של Notion, התצוגות ירגישו מוכרות. זהו אותו רעיון, מובנה בתוך ה‑CRM של Teloring. השתמשו בתצוגות כדי לענות על שאלות כמו *"כל העסקאות הפתוחות שללקוח שלהן כבר יש מסמך חתום"*, *"כל קריאת שירות שנפתחה השבוע, עם מספר הטלפון של הלקוח"*, *"לקוחות ללא משימות"*, או *"הערות שתאריך היצירה שלהן תואם לתאריך החידוש של הלקוח"*. :::info תצוגה רק **קוראת** נתונים. היא לעולם אינה משנה, מזיזה או מוחקת רשומה. לחיצה על שורה פשוט פותחת את הרשומה האמיתית שבה אפשר לערוך אותה. ::: ## עובדות מרכזיות | עובדה | משמעות | | --- | --- | | תצוגה היא טבלה שמורה | מגדירים אותה פעם אחת — אובייקט, עמודות, מסננים, מיון — ופותחים אותה מחדש בכל עת. | | תמיד חיה | תצוגה משקפת את הנתונים העדכניים שלכם בכל פתיחה או רענון. היא אינה תמונת מצב קפואה. | | מבודדת לחשבון | תצוגה קוראת אך ורק את הנתונים של החשבון שלכם. | | אובייקט בסיס אחד לכל תצוגה | כל שורה בתצוגה היא אותו סוג רשומה — כל ההערות, כל העסקאות, כל הלקוחות וכן הלאה. | | משיכת עמודות מהלקוח | בכל אובייקט שתחת לקוח, אפשר להוסיף עמודות מאותו לקוח (האימייל שלו, השלב שלו וכן הלאה) — קבוצת **מהלקוח**. | | מסננים חזקים | שלבו תנאים עם **וגם** / **או**, השוו שדה לשדה אחר, וסננו לפי הרשומות ה*אחרות* של הלקוח ("יש לו לפחות מסמך אחד"). | | אישית או משותפת | שמרו תצוגה לעצמכם, או שתפו אותה עם כל מי שבחשבון. | | נעיצת מועדפות | נעצו עד חמש תצוגות בסרגל הצד לגישה בלחיצה אחת. | | ייצוא לכל מקום | הורידו את התוצאה המלאה כ‑Excel או כ‑PDF, עם העמודות והתוויות שלכם. | | עובדת עם כל אובייקט | סוגי אובייקטים מותאמים שאתם יוצרים מופיעים כאובייקטי בסיס לתצוגה אוטומטית — בלי הגדרה. | ## מי משתמש בתצוגות | תפקיד | שימוש אופייני | | --- | --- | | נציגים | בונים רשימות עבודה אישיות — "קריאות השירות הפתוחות שלי השבוע", "לידים ללא משימה" — ונועצים אותן בסרגל הצד. | | מנהלי צוותים | משתפים תצוגות חשבון שכל הצוות מסתמך עליהן, כמו "כל העסקאות הפתוחות עם מסמכים חתומים". | | מנהלי חשבון | אוצרים מערך של תצוגות משותפות לכל תהליך עסקי ושולטים במה אישי מול משותף. | ## עמוד הנחיתה של התצוגות פתחו **תצוגות** מסרגל הצד כדי להגיע לעמוד הנחיתה. זהו הבית של כל התצוגות שלכם. ![עמוד הנחיתה של התצוגות ב‑Teloring](pathname:///img/screenshots/he/product/views/views-landing.png) יש בו שתי לשוניות: | לשונית | מה היא מציגה | | --- | --- | | התצוגות שלי | תצוגות שיצרתם והשארתם **אישיות**. רק אתם רואים אותן. | | תצוגות החשבון | תצוגות ש**שותפו** עם כל החשבון. כולם יכולים לראות ולפתוח אותן. | כל שורה היא תצוגה אחת ומציגה: | עמודה | משמעות | | --- | --- | | שם ותיאור | הכותרת של התצוגה והתיאור האופציונלי בשורה אחת. | | אובייקט | אובייקט הבסיס שהתצוגה בנויה עליו, עם הסמל שלו (למשל 💰 עסקאות). | | היקף | תג **אישית** או **חשבון**. | | בעלים | מי יצר את התצוגה (מוצג *אתם* עבור שלכם). | | שינוי אחרון | מתי התצוגה שונתה לאחרונה. | | פעולות | כפתור ה**נעיצה** ותפריט **⋮** — ראו למטה. | לחצו על שורה כלשהי כדי לפתוח את התצוגה. לחצו **+ תצוגה חדשה** כדי לבנות אחת. ### פעולות שורה | פעולה | היכן | מה היא עושה | | --- | --- | --- | | נעיצה / ביטול נעיצה | כפתור ה‑📌 בשורה | מוסיף או מסיר את התצוגה מקיצורי הדרך בסרגל הצד (עד חמש). | | פתיחה | תפריט ⋮ | פותח את התצוגה. | | עריכה | תפריט ⋮ | פותח את הבונה לשינוי התצוגה. | | שכפול | תפריט ⋮ | יוצר עותק אישי בבעלותכם, בשם "… (עותק)". | | ייצוא ל‑Excel | תפריט ⋮ | מוריד את התוצאה המלאה כקובץ `.xlsx`. | | ייצוא ל‑PDF | תפריט ⋮ | מוריד את התוצאה המלאה כ‑PDF. | | מחיקה | תפריט ⋮ | מוחק את התצוגה לצמיתות. תצוגות משותפות מזהירות אתכם קודם. | ### תצוגות פתיחה בפעם הראשונה שמישהו בחשבון שלכם פותח את התצוגות, Teloring יוצרת שלוש תצוגות **חשבון** מוכנות, כדי שיהיו לכם דוגמאות עובדות מיד: | תצוגת פתיחה | מציגה | | --- | --- | | כל ההערות | כל הערה אצל כל הלקוחות, עם שם הלקוח והאימייל של כל הערה. | | לידים פתוחים | כל הלקוחות שנמצאים כרגע בשלב מחזור החיים **ליד**. | | קריאות שירות השבוע | קריאות שירות שנפתחו השבוע, עם שם הלקוח והטלפון שלו. | אלו תצוגות רגילות — אפשר לערוך, לשכפל או למחוק אותן כמו כל אחת אחרת. הן נוצרות פעם אחת; מחיקה שלהן לא תחזיר אותן. ## איך תצוגה עובדת כל תצוגה בנויה מארבע בחירות. ברגע שהן מתחברות, כל הבונה קל. | בחירה | על איזו שאלה היא עונה | דוגמה | | --- | --- | --- | | אובייקט בסיס | מה כל שורה מייצגת? | עסקאות | | עמודות | אילו שדות אני רוצה לראות? | שם העסקה, סכום, שלב, **אימייל הלקוח** | | מסננים | אילו שורות צריכות להיכלל? | השלב הוא פתוח, ולַלקוח יש מסמך חתום | | מיון | באיזה סדר? | הסכום הגבוה ביותר תחילה | תצוגה בשם **"עסקאות פתוחות עם מסמך חתום"** היא פשוט: אובייקט בסיס = עסקאות, עמודות = שם העסקה + סכום + שלב + אימייל הלקוח, מסננים = השלב הוא פתוח **וגם** ללקוח יש לפחות מסמך חתום אחד, מיון = סכום בסדר יורד. ## יצירת תצוגה 1. פתחו **תצוגות** ולחצו **+ תצוגה חדשה**. 2. עברו על חמשת המדורים (אובייקט בסיס, עמודות, מסננים, מיון ופרטים). 3. עקבו אחרי ה**תצוגה המקדימה החיה** שמתעדכנת תוך כדי. 4. לחצו **שמירת התצוגה**. הבונה הוא עמוד אחד עם חמישה מדורים ממוספרים. **תצוגה מקדימה חיה** של השורות הראשונות יושבת לצידו ומתרעננת עם כל שינוי. ![בונה התצוגות ב‑Teloring](pathname:///img/screenshots/he/product/views/view-builder-overview.png) ### שלב 1 — אובייקט בסיס בחרו את האובייקט שכל שורה בטבלה מייצגת. אפשר לבחור: | אובייקט בסיס | כל שורה היא | | --- | --- | | לקוחות | לקוח אחד. | | אנשי קשר | איש קשר אחד (אדם שמקושר ללקוח). | | שיחות | שיחה אחת. | | כל אובייקט מותאם | רשומה אחת של אותו אובייקט — הערות, עסקאות, משימות, קריאות שירות, או כל סוג אובייקט שהחשבון שלכם יצר. | לחצו על כרטיס כדי לבחור בו. :::warning אם תשנו את אובייקט הבסיס אחרי שכבר בחרתם עמודות או מסננים, Teloring תזהיר אתכם ותאפס אותם — כי העמודות והמסננים שייכים לאובייקט שהתחלתם ממנו. ::: ### שלב 2 — עמודות בחרו אילו שדות יהפכו לעמודות בטבלה. לבוחר השדות שתי קבוצות: | קבוצה | מה היא מכילה | | --- | --- | | **שדות [האובייקט]** | השדות המקוריים של אובייקט הבסיס (למשל שם, סכום ושלב של עסקה). | | **מהלקוח** | שדות מה**לקוח** שהרשומה שייכת אליו (למשל האימייל או שלב מחזור החיים של הלקוח). | ![עמודות בבונה התצוגות](pathname:///img/screenshots/he/product/views/builder-columns.png) סמנו שדה כדי להוסיף אותו כעמודה. בצד, אפשר לבצע על העמודות שנבחרו: | פקד | מה הוא עושה | | --- | --- | | ידית גרירה (⠿) | גררו עמודה למעלה או למטה כדי לשנות את סדרה. | | תיבת שינוי שם | לחצו על שם העמודה והקלידו תווית כותרת משלכם. | | הסרה (×) | מוציא את העמודה מהתצוגה. | עמודת **מהלקוח** נושאת תגית *לקוח* קטנה, כדי שיהיה ברור שהערך מגיע מהלקוח ולא מהרשומה. :::note קבוצת **מהלקוח** מופיעה עבור כל אובייקט בסיס **למעט לקוחות** — בתצוגת לקוחות, הלקוח *הוא* השורה, ולכן השדות שלו כבר נמצאים בקבוצה הראשונה. ::: #### למה עמודות מהלקוח, אבל לא עמודות "אחים" כל רשומה שתחת לקוח שייכת בדיוק ל**לקוח אחד**, ולכן "האימייל של הלקוח" הוא תמיד תשובה יחידה וברורה. זו הסיבה שאפשר למשוך עמודות לקוח על עסקה, על הערה או על קריאת שירות. אינכם יכולים למשוך עמודות מאובייקט אחר — למשל, אינכם יכולים להוסיף את "סכום העסקה" כעמודה בתצוגת **הערות**. ללקוח יכולות להיות עסקאות רבות, ולכן לא ברור *של איזו* עסקה הסכום. כשאתם צריכים לסנן לפי הרשומות האחרות של הלקוח, השתמשו במקום זאת ב**מסנן רשומות קשורות** (ראו למטה), ששואל שאלת כן/לא ("האם ללקוח יש עסקה?") ואין בו את העמימות הזו. ### שלב 3 — מסננים המסננים קובעים אילו שורות מופיעות. תצוגה ללא מסננים מציגה כל רשומה של אובייקט הבסיס. המסננים מאורגנים ב**קבוצות**. כל קבוצה משלבת את התנאים שלה בהגדרה אחת: | מצב התאמה | משמעות | | --- | --- | | וגם | שורה נכללת רק אם **כל** תנאי בקבוצה נכון. | | או | שורה נכללת אם **לפחות תנאי אחד** נכון. | החליפו בין **וגם** ל**או** בראש כל קבוצה. אפשר לקנן קבוצה בתוך קבוצה (עד שתי רמות) כדי לבנות לוגיקה כמו *"השלב הוא פתוח **וגם** (הסכום מעל 1000 **או** העדיפות גבוהה)"*. ![מסננים בבונה התצוגות](pathname:///img/screenshots/he/product/views/builder-filters.png) בתוך קבוצה אפשר להוסיף שלושה סוגי תנאים. #### 1. תנאי על שדה לחצו **+ הוספת מסנן** כדי להוסיף שורה שבודקת שדה אחד. לתנאי שדה שלושה חלקים: | חלק | משמעות | | --- | --- | | שדה | השדה לבדיקה. הבוחר מקובץ לשדות של האובייקט עצמו ולשדות **מהלקוח**, כך שאפשר לסנן לפי הרשומה או לפי הלקוח שלה. | | אופרטור | איך להשוות — שווה, הוא אחד מ, מכיל, לפני, בתקופה האחרונה… ועוד. האופרטורים הזמינים תואמים לסוג השדה. | | ערך | מול מה להשוות. כשהערך הוא רשימה ידועה (שדה רשימה נפתחת, נציג, שלב), Teloring מציגה **רשימה נפתחת** במקום תיבת טקסט חופשי. | האופרטורים הם בדיוק אותו מערך שמשמש ב**אנליטיקס**, כך ש"החודש" או "ב‑7 הימים האחרונים" אומרים אותו דבר בכל מקום ב‑Teloring. ראו [אופרטורים](#operators) למטה לרשימה המלאה. #### 2. השוואה לשדה אחר כל תנאי שדה יכול להשוות שדה ל**שדה אחר** במקום לערך קבוע. לחצו על מתג **⇄ השוואה לשדה** בשורת התנאי ובחרו את השדה להשוואה. זה שימושי לשאלות כמו: | דוגמה | משמעות | | --- | --- | | *תאריך יצירת* העסקה **שווה ל**תאריך החידוש של הלקוח | עסקאות שנוצרו בדיוק בתאריך החידוש. | | *סכום* העסקה **גדול מ**מסגרת האשראי של הלקוח | עסקאות מעל המסגרת של הלקוח. | Teloring מציעה בצד השני רק שדות מ**אותו סוג** — תאריך אפשר להשוות רק לתאריך, מספר למספר — כך שאי אפשר להגדיר השוואה בצורה שגויה. :::note בהשוואת שני שדות **תאריך** לשוויון, Teloring מתאימה לפי ה**יום** ולא לפי השנייה המדויקת — כך שרשומה שנוצרה בכל שעה בתאריך החידוש נחשבת להתאמה. ::: #### 3. מסנן רשומות קשורות לחצו **+ הוספת מסנן רשומות קשורות** כדי לסנן לפי הרשומות ה**אחרות** של הלקוח — בלי להוסיף אותן כעמודות. השורות האלה נראות שונה בכוונה (סגנון מקווקו ומודגש), כי הן שואלות על הלקוח ולא על השורה עצמה. הן נקראות כמשפט: > **ללקוח** [ יש לפחות ] [ 1 ] [ מסמכים ] *(אופציונלי: שבהם …)* | חלק | אפשרויות | | --- | --- | | כמות | **יש לפחות**, **אין**, **יש בדיוק**, או **יש יותר מ**. | | מספר | כמה רשומות (מוסתר כשבוחרים *אין*). | | אובייקט | באיזה אובייקט קשור להסתכל — מסמכים, משימות, עסקאות וכן הלאה. | | שבהם (אופציונלי) | תנאי אחד או יותר שהרשומות הקשורות חייבות לעמוד בהם, נוספים עם **+ הוספת תנאי**. | דוגמאות: | מסנן | משמעות | | --- | --- | | ללקוח **יש לפחות 1** מסמכים | ללקוח יש לפחות מסמך אחד חתום או שהועלה. | | ללקוח **אין** משימות | ללקוח אין רשומות משימה כלל. | | ללקוח **יש לפחות 1** משימות *שבהן תאריך היצירה הוא ב‑24 השעות האחרונות* | הלקוח קיבל משימה חדשה ביום האחרון. | :::tip **"אין"** היא פשוט הכמות **אין** — אין מתג נפרד. השתמשו בה כדי למצוא לקוחות שחסר להם משהו, כמו לידים ללא משימה או לקוחות ללא מסמך חתום. ::: ### שלב 4 — מיון בחרו את סדר השורות. הוסיפו **רמות מיון** אחת או יותר; לכל אחת שדה וכיוון (**עולה** או **יורד**). אפשר למיין לפי שדות האובייקט עצמו או לפי שדות **מהלקוח**, ואפשר להוסיף עד שלוש רמות — למשל, למיין לפי שלב ואז לפי סכום בתוך כל שלב. ### שלב 5 — שם ושיתוף סיימו את התצוגה עם: | שדה | משמעות | | --- | --- | | שם התצוגה | חובה. כותרת ברורה כמו *עסקאות פתוחות עם מסמכים*. | | תיאור | סיכום אופציונלי בשורה אחת, שמוצג בעמוד הנחיתה. | | מי יכול לראות את התצוגה | **אישית** (רק אתם) או **משותפת עם החשבון** (כולם). ראו [שיתוף והיקף](#sharing-and-scope). | לחצו **שמירת התצוגה** כדי ליצור אותה. תגיעו לתצוגה הפתוחה. ### תצוגה מקדימה חיה תוך כדי הגדרת התצוגה, חלונית ה**תצוגה המקדימה החיה** מציגה את השורות הראשונות ומונה שורות מתעדכן, כך שתראו את ההשפעה של כל שינוי מיד. כל עוד אתם באמצע מילוי תנאי, התצוגה המקדימה פשוט מתעלמת ממנו עד שהוא שלם — כך שתמיד תראו נתונים ולא שגיאה. אימות מלא מתבצע בשמירה. ## התצוגה הפתוחה פתיחת תצוגה מציגה את הטבלה שלה ברוחב מלא. ![תצוגה פתוחה ב‑Teloring](pathname:///img/screenshots/he/product/views/view-runner.png) | אזור | מה זה | | --- | --- | | כותרת | שם התצוגה, תג ההיקף שלה והתיאור. | | סרגל כלים | **עריכה**, **שכפול**, **ייצוא ▾**, **נעיצה / ביטול נעיצה** ו**מחיקה**. | | צ׳יפי מסננים | סיכום לקריאה בלבד של המסננים של התצוגה. לחצו על צ׳יפ כלשהו כדי לפתוח את הבונה ולשנות אותם. | | טבלה | השורות, עם כותרות עמודה נעוצות. עמודות שנמשכו **מהלקוח** מסומנות במחוון ⤷ קטן. | | כותרת תחתונה | מספר השורות הכולל וחלוקה לעמודים (50 שורות לעמוד). | ### מיון בלחיצה על עמודה לחצו על כותרת עמודה כדי למיין את הטבלה לפיה; לחצו שוב כדי להפוך את הכיוון. זהו מיון מהיר וזמני — הוא **אינו** משנה את התצוגה השמורה. כשמיון הלחיצה שלכם שונה מהמיון השמור של התצוגה, מופיע סרגל **שמירת המיון בתצוגה**, כדי שתוכלו לשמור את הסדר החדש לצמיתות או **לאפס** בחזרה לשמור. ### פתיחת רשומה משורה התצוגות הן דרך *להיכנס* לרשומות הקיימות שלכם, ולא מקום חדש לערוך אותן. לחצו על שורה כלשהי כדי לקפוץ לרשומה האמיתית: | סוג השורה | פותחת | | --- | --- | | לקוח | את פרופיל הלקוח הזה. | | רשומה שתחת לקוח (הערה, עסקה, משימה וכן הלאה) | את פרופיל הלקוח הזה עם הרשומה פתוחה. | | איש קשר | את הלקוח שאיש הקשר שייך אליו. | | שיחה | את השיחה הזו. | ### תוצאה ריקה אם שום דבר אינו תואם, התצוגה מציגה *"אין רשומות שתואמות למסננים של התצוגה"* עם קיצור דרך לעריכת המסננים. הרחיבו או הסירו תנאי כדי לראות שורות. ## שיתוף והיקף {#sharing-and-scope} כל תצוגה היא או אישית או משותפת עם החשבון. | היקף | מי יכול לראות אותה | | --- | --- | | אישית | רק אתם (היוצרים). היא מופיעה בלשונית **התצוגות שלי** שלכם. | | משותפת עם החשבון | כל מי שבחשבון. היא מופיעה בלשונית **תצוגות החשבון**. | | התנהגות | פירוט | | --- | --- | | נקבע ביצירה | בחרו את ההיקף בשלב 5 כשאתם בונים את התצוגה. | | ניתן לשינוי בהמשך | ערכו את התצוגה ושנו את ההיקף בכל עת. | | חזרה לאישית | רק ה**בעלים** של התצוגה יכול להחזיר תצוגה משותפת לאישית. | | עריכת תצוגות משותפות | כל נציג יכול לפתוח ולערוך תצוגת חשבון — קחו זאת בחשבון עבור תצוגות שכל הצוות מסתמך עליהן. | | מחיקת תצוגות משותפות | מחיקת תצוגת חשבון מזהירה אתכם שהיא משותפת עם כל החשבון לפני שהיא מסירה אותה עבור כולם. | ## תצוגות נעוצות נעצו את התצוגות שאתם משתמשים בהן הכי הרבה בסרגל הצד, לגישה בלחיצה אחת. ![תצוגות נעוצות בסרגל הצד של Teloring](pathname:///img/screenshots/he/product/views/pinned-views-sidebar.png) | עובדה | פירוט | | --- | --- | | היכן נועצים | השתמשו בכפתור ה‑📌 בשורה בעמוד הנחיתה, או בכפתור **נעיצה** בתוך תצוגה פתוחה. | | היכן הן מופיעות | תחת הפריט **תצוגות** בסרגל הצד, כקיצורי דרך בעלי שם. | | לכל אדם בנפרד | הנעיצות הן שלכם בלבד. נעיצת תצוגה אינה נועצת אותה עבור אף אחד אחר. | | מגבלה | עד **חמש** תצוגות נעוצות. כדי לנעוץ שישית, בטלו נעיצה של אחת קודם — ‏Teloring מזכירה לכם כשאתם מגיעים למגבלה. | ## ייצוא ל‑Excel או ל‑PDF אפשר לייצא את תוצאות התצוגה מתפריט ה‑**⋮** בעמוד הנחיתה או מכפתור **ייצוא ▾** בתוך תצוגה פתוחה. | פורמט | מתאים ביותר ל | | --- | --- | | Excel (`.xlsx`) | עבודה עם הנתונים בגיליון אלקטרוני. העמודות שומרות את התוויות שלכם, ותאריכים ומספרים מיוצאים כתאריכים ומספרים אמיתיים. | | PDF | שיתוף טבלה נקייה וניתנת להדפסה. הוא נושא את שם התצוגה, את שם החשבון שלכם ואת זמן הייצוא בכותרת. | | עובדה | פירוט | | --- | --- | | תוצאה מלאה | הייצוא כולל את **כל** מערך התוצאות — כל שורה תואמת, ולא רק העמוד שאתם צופים בו. | | ההגדרה שלכם | העמודות, התוויות, המסננים והמיון הנוכחי — כולם נשמרים. | | הורדה | הקובץ יורד למחשב שלכם כשהוא מוכן. | :::note ייצוא PDF מוגבל ל‑3,000 השורות הראשונות, כדי לשמור על מסמך שמיש. לתוצאות גדולות מאוד, השתמשו ב‑Excel. ::: ## דוגמאות מעובדות המתכונים האלה מראים איך החלקים מתחברים. | מטרה | אובייקט בסיס | עמודות | מסננים | מיון | | --- | --- | --- | --- | --- | | כל ההערות עם האימייל של הלקוח שלהן | הערות | כותרת ההערה, תוכן, תאריך יצירה, **אימייל הלקוח** | — | תאריך יצירה, יורד | | לידים פתוחים | לקוחות | שם, אימייל, טלפון, שלב מחזור חיים | שלב מחזור החיים הוא **ליד** | תאריך יצירה, יורד | | קריאות שירות שנפתחו השבוע | קריאות שירות | נושא, סטטוס, תאריך יצירה, **שם הלקוח**, **טלפון הלקוח** | תאריך היצירה הוא **השבוע** | תאריך יצירה, יורד | | עסקאות פתוחות שללקוח שלהן יש מסמך חתום | עסקאות | שם העסקה, סכום, שלב, **אימייל הלקוח** | השלב הוא **פתוח** **וגם** ללקוח **יש לפחות 1** מסמכים | סכום, יורד | | עסקאות שנוצרו בתאריך החידוש של הלקוח | עסקאות | שם העסקה, סכום, **תאריך חידוש של הלקוח** | *תאריך יצירת* העסקה **שווה ל**תאריך החידוש של הלקוח (השוואה לשדה) | — | | לקוחות ללא משימות פתוחות | לקוחות | שם, שלב מחזור חיים, נציג משויך | ללקוח **אין** משימות | שם, עולה | | עסקאות בסכום גבוה מעל מסגרת האשראי של הלקוח | עסקאות | שם העסקה, סכום, **מסגרת האשראי של הלקוח** | *סכום* העסקה **גדול מ**מסגרת האשראי של הלקוח (השוואה לשדה) | סכום, יורד | ## אופרטורים {#operators} תנאי שדה מציעים אופרטורים שתואמים לסוג השדה. אלו אותם אופרטורים שבשימוש ב[אנליטיקס](./analytics.md). ### שדות טקסט, מספר, בחירה ורשימה | אופרטור | השתמשו בו כדי | | --- | --- | | שווה / אינו שווה | להתאים ערך מדויק. | | הוא אחד מ / אינו אף אחד מ | להתאים מול כמה ערכים בבת אחת. | | מכיל / אינו מכיל | להתאים חלק מערך טקסט, או חברות בשדה רשימה כמו תגיות. | | מתחיל ב / מסתיים ב | להתאים את ההתחלה או הסוף של ערך טקסט. | | גדול מ / קטן מ (וגם הגרסאות הכוללות שוויון) | להשוות מספרים. | | בין | להתאים טווח מספרי. | | ריק / אינו ריק | להתאים שורות ללא ערך, או עם ערך כלשהו, בשדה. | | נכון / לא נכון | להתאים שדה כן/לא. | ### שדות תאריך שדות תאריך מציעים מערך עשיר של אופרטורי זמן **יחסיים** — הם תמיד נעים עם התאריך הנוכחי, כך שתצוגה שמוגדרת ל*החודש* ממשיכה להציג את החודש הנוכחי לאורך זמן. | קבוצה | אופרטורים | | --- | --- | | מדויק | בתאריך, לא בתאריך, לפני תאריך, אחרי תאריך, בין תאריכים. | | יחסי (מספר + יחידה) | בתקופה האחרונה…, בתקופה הקרובה…, לפני יותר מ‑…. יחידות: דקות, שעות, ימים, שבועות, חודשים. | | יום | היום, אתמול, מחר, היום ואתמול, היום ומחר. | | שבוע | השבוע, שבוע שעבר, שבוע הבא, לפני שבועיים, השבועיים הקרובים. | | חודש | החודש, חודש שעבר, חודש הבא, החודשיים האחרונים, החודשיים הקרובים. | | רבעון | הרבעון הזה, הרבעון הקודם, הרבעון הבא, Q1–Q4 של השנה הזו. | | שנה | השנה, שנה שעברה, שנה הבאה. | | מתגלגל | בשעה האחרונה / בשעתיים האחרונות, 30 / 60 / 90 הימים האחרונים, 30 / 60 / 90 הימים הקרובים. | | נוכחות | יש ערך, אין ערך. | ## טיפים | טיפ | למה זה עוזר | | --- | --- | | תנו לתצוגות שמות ברורים | כותרת טובה מסבירה את התצוגה במבט אחד בלשונית תצוגות החשבון המשותפת. | | התחילו מתצוגת פתיחה | שכפלו את "כל ההערות" או "לידים פתוחים" והתאימו אותה במקום לבנות מאפס. | | השתמשו בעמודות **מהלקוח** | הוסיפו את האימייל או הטלפון של הלקוח לכל תצוגת אובייקט, כדי ששורה תהיה ניתנת לפעולה בפני עצמה. | | העדיפו מסנני תאריך יחסיים | "השבוע" או "ב‑7 הימים האחרונים" נשארים נכונים לאורך זמן בלי עריכה. | | השתמשו במסנני רשומות קשורות ל"יש / אין" | הם עונים על "האם ללקוח הזה יש X" בלי העמימות של משיכת עמודות אחים. | | נעצו את התצוגות היומיומיות שלכם | שמרו את שתיים‑שלוש הרשימות שאתם משתמשים בהן כל יום בלחיצה אחת בסרגל הצד. | | שתפו את התצוגות המרכזיות של הצוות | שימו תצוגות שכל הצוות מסתמך עליהן בהיקף **חשבון**, כדי שכולם יעבדו מאותה רשימה. | ## פתרון תקלות | בעיה | מה לבדוק | | --- | --- | | התצוגה ריקה | ייתכן שמסנן צר מדי. פתחו את המסננים והרחיבו או הסירו תנאי. זכרו ש"וגם" דורש שה**כול** יתאים. | | אני לא מצליח להוסיף עמודת לקוח | אתם בתצוגת **לקוחות** — שדות הלקוח כבר הם השדות של השורה עצמה, ולכן אין קבוצת **מהלקוח** נפרדת. | | אני לא מצליח להוסיף אובייקט "אח" כעמודה | זה בכוונה. השתמשו ב**מסנן רשומות קשורות** כדי לשאול על הרשומות האחרות של הלקוח, או הוסיפו את הערך ללקוח בעזרת מנהל החשבון שלכם כדי שיהפוך לעמודת לקוח. | | בצד הימני של "השוואה לשדה" יש מעט אפשרויות | מוצעים רק שדות מ**אותו סוג**, כך שתאריך מושווה לתאריך ומספר למספר. | | מיון העמודה שלי לא נשמר | לחיצה על כותרת עמודה היא מיון זמני. השתמשו בסרגל **שמירת המיון בתצוגה** שמופיע כדי לשמור אותו, או ב**איפוס** כדי לחזור. | | מונה השורות אומר "מוצגות 10,000 הראשונות" | תצוגה מחזירה לכל היותר 10,000 שורות. הוסיפו מסנן (כמו טווח תאריכים) כדי לצמצם את התוצאה. | | אני לא מצליח לנעוץ תצוגה נוספת | כבר יש לכם חמש תצוגות נעוצות. בטלו נעיצה של אחת קודם. | | תצוגה משותפת שונתה על ידי מישהו אחר | כל נציג יכול לערוך תצוגת חשבון. העבירו תצוגות קריטיות ללשונית **חשבון** במכוון, והשתמשו בתצוגות אישיות לרשימות עבודה פרטיות. | | אובייקט מותאם חדש אינו מופיע כאובייקט בסיס | ודאו שסוג האובייקט מופעל ב‑CRM. סוגי אובייקטים חדשים מופיעים כאובייקטי בסיס לתצוגות אוטומטית לאחר היצירה. | --- # מאפייני שיחה מקור: https://docs.teloring.com/he/docs/product/conversation-attributes Markdown: https://docs.teloring.com/he/markdown/docs/product/conversation-attributes.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z **מאפייני שיחה הם שדות מותאמים ששייכים לשיחה אחת.** אתם מעצבים אותם פעם אחת עבור כל החשבון — *סיבת הפנייה*, *תוצאה*, *מספר הזמנה*, *סכום החזר* — והנציגים ממלאים אותם מסרגל הצד של השיחה תוך כדי עבודה. המילה החשובה היא **שיחה**. שדה של איש קשר מתאר *אדם* ומלווה אותו לנצח. מאפיין שיחה מתאר *את ההתכתבות הזו*: למה הוא כתב היום, מה עשיתם בעניין, איזו הזמנה הייתה מעורבת. אותו לקוח שיכתוב שוב בשבוע הבא יתחיל עם **מערך ריק ונקי** — כי זו שיחה חדשה עם סיבה חדשה ותוצאה חדשה. זה מה שהופך אותם לשווים דיווח. "כמה שיחות עסקו בחיובים החודש?" היא שאלה על שיחות, ורק שדה שנשמר על השיחה יכול לענות עליה. :::info מערך מאפיינים אחד לכל חשבון בשונה מאובייקטי CRM, שבהם אפשר ליצור *עסקאות*, *משימות* ו*חוזים* זה לצד זה, לחשבון יש בדיוק **מערך אחד** של מאפייני שיחה. כל שיחה בחשבון — כל ערוץ, כל תיבה — יכולה לשאת את אותם מאפיינים. אין מה לבחור לפני שמתחילים למלא. ::: ## עובדות מרכזיות | עובדה | משמעות | | --- | --- | | נשמרים על השיחה | הערכים חיים עם אותה שיחה, לעולם לא על איש הקשר או על הלקוח. | | טריים בכל שיחה | שיחה חדשה עם אותו אדם מתחילה ריקה. שום דבר אינו נורש או מועתק קדימה. | | מערך אחד לכל חשבון | אתם מעצבים פריסה אחת בהגדרות; היא חלה על כל שיחה. | | שדה אחד בכל שורה | פאנל השיחה הוא עמודה צרה, ולכן המאפיינים תמיד נערמים אחד בכל שורה. הבונה מציג תצוגה מקדימה בדיוק כך. | | ממולאים על ידי אנשים **או** אוטומציה | הנציגים מקלידים בפאנל; תהליכי [סטודיו](./studio.md) מגדירים אותם אוטומטית. | | זמינים לאוטומציה | כל מאפיין הופך למשתנה `{{conversation.custom_attributes.…}}` עבור בלוקים מאוחרים יותר בסטודיו, כולל בקשות HTTP. | | ניתנים לדיווח | המאפיינים מופיעים ב[אנליטיקס](./analytics.md) כשדות שאפשר לקבץ לפיהם, למדוד ולסנן. | | נשמרים אחרי סיום הטיפול | הערכים מלווים את השיחה לארכיון השיחות שטופלו ונשארים קריאים שם. | | נשלטים בהרשאה | [הרשאת תפקיד](./roles/system-permissions.md#workspace) נפרדת קובעת מי יכול לראות, למלא ולשנות מאפיינים. | ## למה אנשים משתמשים בהם | מאפיין | סוג | למה | | --- | --- | --- | | סיבת הפנייה | רשימה נפתחת — חיובים, טכני, מכירות, תלונה | שדה הדיווח השימושי ביותר שחסר לרוב צוותי התמיכה. | | תוצאה | רשימה נפתחת — נפתר, הוסלם, הוחזר כסף, אין פעולה | מאפשר למדוד את איכות הפתרון, לא רק את מהירותו. | | מספר הזמנה | טקסט | קושר שיחה להזמנה במערכת שלכם, וסטודיו יכול לדחוף אותו לשם. | | סכום החזר | מטבע | סכמו אותו באנליטיקס כדי לראות כמה כסף זז בכל חודש, בכל נציג, בכל ערוץ. | | תאריך מעקב | תאריך | תאריך שאפשר לסנן ולדווח עליו. | | מוצרים שנדונו | בחירה מרובה | אילו מוצרים עולים הכי הרבה, בכל ערוץ. | | טופל על ידי (מומחה) | בוחר נציגים | מתעד מי באמת פתר, כשהשיחה עברה בין כמה אנשים. | | הוסלם לספק | תיבת סימון / רשימה נפתחת | דגל פשוט שאפשר לספור. | :::tip מאפיינים, תוויות או תגיות? שלושתם מארגנים שיחה, אבל הם עונים על שאלות שונות. - **תוויות** הן רשימה שטוחה שגדלה בחופשיות, שנציגים מוסיפים תוך כדי תנועה. מצוינות לנושאים רופפים; קשה לדווח עליהן בעקביות כי כל אחד יכול להמציא חדשה. - **מאפיינים** הם **טופס מובנה**: מערך קבוע של שדות בעלי שם, לכל אחד סוג משלו וערכים מותרים משלו. השתמשו בהם כשאתם רוצים את אותה תשובה באותו מקום בכל שיחה. - **תגיות** מתנהגות כמו תוויות. כלל טוב: אם הייתם שמים את זה בעמודה בגיליון אלקטרוני, זה מאפיין. ::: --- ## חלק 1 — בניית המאפיינים (הגדרות) עיצוב המאפיינים הוא עבודה של מנהל שמבצעים פעם אחת. הנציגים לעולם אינם רואים את המסך הזה. פתחו **הגדרות ← מאפייני שיחה** מסרגל הצד. ![בונה מאפייני השיחה בהגדרות של Teloring, עם הפריסה בצד אחד, התצוגה המקדימה החיה מתחתיה, וארגז הכלים של סוגי המאפיינים בצד השני](pathname:///img/screenshots/he/product/conversation-attributes/builder-overview.png) למסך שלושה חלקים: | אזור | מה זה | | --- | --- | | **פריסה** | המדורים שלכם והמאפיינים שבתוכם. זה הדבר שאתם בונים. | | **תצוגה מקדימה (מתחת לפריסה)** | דגם חי של הפאנל שהנציגים יראו בשיחה. הוא מתעדכן תוך כדי עבודה. | | **ארגז כלים** | בלוק אחד לגרירה לכל סוג מאפיין, ובנוסף בלוק **מדור**. | אם השתמשתם ב[עורך השדות](./crm.md#field-editor) של ה‑CRM, זהו אותו רעיון עם הבדל אחד מכוון: **מאפייני שיחה הם תמיד אחד בכל שורה**, כי פאנל השיחה הוא עמודה צרה וטופס בשתי עמודות לא היה נכנס. ### הוספת מאפיין 1. **גררו** סוג מאפיין מארגז הכלים אל מדור בפריסה. 2. חלון העריכה נפתח אוטומטית. קבעו את ה**תווית**, ואת ה**מזהה API** אם אתם רוצים משהו נוח יותר מזה שנוצר אוטומטית. 3. עבור סוג בחירה, הוסיפו את ה**אפשרויות** שלכם. 4. סמנו **חובה** אם הנציגים חייבים למלא. 5. לחצו **שמירה** בחלון כדי לסגור אותו. 6. חזרו על כך לכל מאפיין, ואז לחצו **שמירת המאפיינים** בראש העמוד. שום דבר אינו חי עד שאתם לוחצים **שמירת המאפיינים**. :::note גרירה למקום מסוים שחרור מאפיין **על כרטיס קיים** מכניס אותו *מעל* אותו כרטיס. שחרור באזור הריק של מדור מוסיף אותו בסוף. גררו כרטיסים קיימים באותה דרך כדי לשנות את סדרם, או למדור אחר כדי להעביר אותם. ::: ### מאפייני המאפיין לחצו על כרטיס מאפיין כלשהו כדי לפתוח את העורך שלו. ![חלון עריכת המאפיין עם תווית, מזהה API, אפשרויות ותיבת הסימון חובה](pathname:///img/screenshots/he/product/conversation-attributes/attribute-edit-popover.png) | מאפיין | מה הוא עושה | הערות | | --- | --- | --- | | **תווית** | השם שהנציגים רואים מעל השדה. | כתבו אותו בשפה שהצוות שלכם מדבר — *סיבת הפנייה*, לא *reason_code*. שנו אותו מתי שתרצו; זה אינו משפיע על הנתונים השמורים. | | **מזהה API** | השם הטכני היציב — משמש במשתני סטודיו, בשמות שדות באנליטיקס וב‑API. | אותיות אנגליות קטנות, ספרות וקווים תחתונים, מתחיל באות (למשל `reason_for_contact`). ראו את האזהרה למטה לפני שאתם משנים אחד. | | **אפשרויות** | הערכים המותרים למאפיין מסוג בחירה. | מוצג רק עבור רשימה נפתחת, לחצני רדיו, בחירה מרובה ותיבות סימון. נדרשת לפחות אפשרות אחת. | | **חובה** | מסמן את המאפיין ב‑`*` אדום עבור הנציגים. | סימן ויזואלי לצוות. הוא אינו חוסם נציג משמירת שאר הפאנל. | :::warning שינוי מזהה API אינו מעביר נתונים קיימים מזהה ה‑API הוא המפתח שהערכים נשמרים תחתיו. שינוי `reason` ל‑`contact_reason` נותן לכם מאפיין **חדש וריק** — הערכים שכבר נשמרו תחת השם הישן אינם מוצגים עוד, וכל בלוק סטודיו או דוח שמפנה לשם הישן מפסיק למצוא נתונים. קבעו את מזהה ה‑API כשאתם יוצרים את המאפיין, ואז אל תיגעו בו. ה**תווית** היא הדבר הבטוח לשינוי בהמשך — שנו אותה כמה שתרצו. ::: ### סוגי מאפיינים {#attribute-types} | סוג | הנציג רואה | מתאים ביותר ל | באנליטיקס | | --- | --- | --- | --- | | **טקסט** | תיבה בשורה אחת | מספר הזמנה, אסמכתה, מזהה חיצוני | סינון בלבד | | **אזור טקסט** | תיבה מרובת שורות | הערת טקסט חופשי קצרה על השיחה | סינון בלבד | | **מספר** | תיבה מספרית | ספירות, כמויות, ציונים | סכום, ממוצע, מינימום, מקסימום | | **מטבע** | תיבה מספרית | סכום החזר, ערך הזמנה, זיכוי שניתן | סכום, ממוצע, מינימום, מקסימום | | **רשימה נפתחת** | רשימת בחירה יחידה | סיבת פנייה, תוצאה, מחלקה | **קיבוץ לפי**, סינון | | **לחצני רדיו** | רשימת בחירה יחידה | כמו רשימה נפתחת — בפאנל השיחה הצר שניהם מוצגים כרשימה נפתחת | **קיבוץ לפי**, סינון | | **בחירה מרובה** | תיבת סימון לכל אפשרות, כמה מותרות | מוצרים שנדונו, מערכות שהושפעו | **קיבוץ לפי**, סינון | | **תיבות סימון** | תיבת סימון לכל אפשרות, כמה מותרות | כמה דגלי כן/לא מרשימה אחת | **קיבוץ לפי**, סינון | | **תאריך** | בוחר תאריכים | תאריך מעקב, תאריך שהובטח | קיבוץ לפי זמן | | **תאריך ושעה** | בוחר תאריך ושעה | שיחה חוזרת מתוזמנת | קיבוץ לפי זמן | | **אימייל** | תיבה עם מקלדת אימייל | כתובת חלופית ליצירת קשר עבור הנושא הזה בלבד | סינון בלבד | | **טלפון** | תיבה עם מקלדת טלפון | מספר לשיחה חוזרת עבור הנושא הזה בלבד | סינון בלבד | | **כתובת אינטרנט** | תיבת קישור | קישור לפנייה במערכת אחרת | סינון בלבד | | **בוחר נציגים** | רשימה של הנציגים שלכם | מי באמת טיפל, בעלים בקו שני | **קיבוץ לפי**, סינון | | **כיתוב** | טקסט עזר לקריאה בלבד | הוראה או מפריד בתוך הפאנל | אינו נשמר, אינו מדווח | :::tip העדיפו רשימה נפתחת על פני טקסט בכל הזדמנות רשימה נפתחת נותנת לכם תשובות עקביות שאפשר לספור. תיבת טקסט נותנת לכם `חיובים`, `חיוב`, `חיובים ‏` ו‑`שאלה על חיוב`. אם תרצו אי פעם להציג את השדה בגרף, הפכו אותו לסוג בחירה. ::: :::note על **כיתוב** כיתוב הוא הערה לנציג — *"מלאו את שדות ההחזר רק כשבאמת הוחזר כסף."*. הוא לעולם אינו נשמר על שיחה, לעולם אינו מופיע בסטודיו ולעולם אינו מופיע באנליטיקס. אי אפשר לסמן אותו כחובה. ::: ### מדורים מדורים מקבצים מאפיינים תחת כותרת קטנה בפאנל של הנציג. השתמשו בהם כשיש לכם יותר מקומץ מאפיינים — למשל **למה הם כתבו** ו**מה עשינו**. | פעולה | איך | | --- | --- | | הוספת מדור | לחצו **➕ הוספת מדור** והקלידו שם, או גררו את בלוק ה**מדור** מארגז הכלים. | | שינוי שם מדור | לחצו על כפתור ה‑✏️ בכותרת המדור. | | שינוי סדר המדורים | גררו כותרת מדור למעלה או למטה. | | העברת מאפיין בין מדורים | גררו את הכרטיס שלו למדור האחר. | | מחיקת מדור | לחצו על ה‑✕ בכותרת המדור. המאפיינים שלו עוברים למדור הראשון — הם אינם נמחקים. | עם מדור יחיד, הנציגים אינם רואים כותרת כלל — רק את השדות. כותרות מדורים מופיעות רק כשיש יותר מאחד. ### התצוגה המקדימה החיה מתחת לפריסה תקבלו **תצוגה מקדימה של פאנל השיחה**: בדיוק מה שהנציגים יראו, באותו סדר של אחד בכל שורה, עם כותרות המדורים שלכם ועם סימוני ה‑`*` שלכם. השתמשו בה כדי לבדוק אורך. פאנל עם עשרים מאפיינים הוא פאנל שאף אחד לא ממלא. לרוב הצוותים מתאימים **ארבעה עד שמונה**. ### מגבלות | מגבלה | ערך | | --- | --- | | מדורים | 20 | | מאפיינים | 60 | | אפשרויות למאפיין בחירה | 100 | ### מחיקת מאפיין הסירו מאפיין בלחיצה על ה‑**✕** בכרטיס שלו, ואז **שמירת המאפיינים**. | מה קורה | פירוט | | --- | --- | | הוא נעלם מפאנל הנציג | מיד, בשיחה הבאה שנפתחת. | | הערכים הקיימים **נשמרים** | הנתונים נשארים על השיחות שכבר החזיקו אותם — זו היסטוריה, ומחיקת שדה לא צריכה להשמיד את התיעוד של מה שקרה. | | החזירו אותו והנתונים חוזרים | צרו מחדש את המאפיין עם **אותו מזהה API** והערכים הישנים גלויים שוב. | | בלוקי סטודיו שמגדירים אותו | מדלגים עליו בשקט וממשיכים לרוץ. התהליך שלכם אינו נשבר. | | דוחות שמשתמשים בו | מפסיקים למצוא ערכים חדשים. ערכו את הדוח כך שיפנה למשהו אחר. | | הרשאה | הסרת מאפיין דורשת **מאפייני שיחה ← מחיקה**, שנפרדת מעריכה. | --- ## חלק 2 — מילוי המאפיינים (בשיחה) הנציגים עובדים עם המאפיינים ב**סרגל הצד** של שיחה, במדור שנקרא **מאפייני שיחה**, ממש מעל AI Copilot. ![מדור מאפייני השיחה בסרגל הצד של השיחה, מעל AI Copilot](pathname:///img/screenshots/he/product/conversation-attributes/conversation-panel.png) 1. פתחו שיחה. 2. פתחו את **מאפייני שיחה** בסרגל הצד. 3. מלאו את השדות. 4. לחצו **שמירה**. זו כל שגרת העבודה. הערכים נשמרים ל**שיחה הזו בלבד**. | התנהגות | פירוט | | --- | --- | | ניתן לכיווץ | לחצו על כותרת המדור כדי לפתוח או לסגור אותו, כמו שאר מדורי סרגל הצד. | | שומר את מה שאתם רואים | רק השדות המוצגים נשמרים. מאפיין שנוסף אחרי שהשיחה הזו התחילה לעולם אינו נמחק על ידי פאנל ישן יותר. | | אינו מקפיץ בתור | שמירת מאפיין היא רישום, לא הודעה ללקוח — השיחה **אינה** קופצת לראש הרשימה של אף אחד. | | מילוי חלקי בסדר גמור | מלאו מה שאתם יודעים עכשיו וחזרו מאוחר יותר. הסימן `*` מציין מאפיין שהצוות שלכם רואה כחשוב; הוא אינו חוסם שמירה. | | לקריאה בלבד עבור חלק מהתפקידים | עם **צפייה** אך ללא **עדכון**, השדות גלויים אך אפורים. | | מוסתר כשריק | אם החשבון שלכם לא הגדיר מאפיינים, המדור אינו מופיע כלל. | ### היכן הוא אינו מוצג | מצב | למה | | --- | --- | | לחשבון עדיין אין מאפיינים | אין מה להציג. בנו אותם קודם בהגדרות. | | לתפקיד אין **מאפייני שיחה ← צפייה** | כל המדור מוסתר. | | שיחה שטופלה | הוא הופך ל**קריאה בלבד** — ראו למטה. | --- ## חלק 3 — שיחות שטופלו כששיחה מסומנת כטופלה, המאפיינים שלה הולכים איתה. פתחו את התור **טופלו** ובחרו שיחה: הפאנל הצדדי מציג בלוק **מאפייני שיחה** לקריאה בלבד, לצד ציר הזמן, התוויות, הרגש ופרטי איש הקשר. ![מאפייני שיחה מוצגים לקריאה בלבד בפאנל המאפיינים של שיחה שטופלה](pathname:///img/screenshots/he/product/conversation-attributes/resolved-panel.png) | התנהגות | פירוט | | --- | --- | | לקריאה בלבד | שיחה שטופלה היא תיעוד של מה שקרה. פתחו אותה מחדש אם אתם באמת צריכים לתקן ערך. | | רק מאפיינים שמולאו | מאפיינים שאיש לא ענה עליהם מושמטים, כך שהבלוק נשאר קצר וקריא. | | שמות נציגים, לא מזהים | ערך של **בוחר נציגים** מציג את שם האדם. | | ערכי בחירה מרובה | מוצגים כרשימה מופרדת בפסיקים. | :::note סימון כטופל אינו מכריח אתכם למלא דבר Teloring אינה חוסמת את כפתור **סימון כטופל** על מאפיין ריק. אם התהליך שלכם דורש "אין סגירה בלי קוד סיכום", אכפו זאת במדיניות הצוות — או בנו תהליך [סטודיו](./studio.md) שמגיב לסגירה ומיידע את הנציג כשמאפיין מרכזי ריק. ::: המאפיינים נכללים גם ב‑**Webhook** של `conversation.resolved`, במלואם — ולא רק אלה שפעולת הסגירה שינתה במקרה — כך שמערכת חיצונית שמקבלת שיחה שטופלה מקבלת את התמונה המלאה במטען אחד. --- ## חלק 4 — אוטומציה (סטודיו) [סטודיו](./studio.md) יכול גם **לקרוא** וגם **לכתוב** מאפייני שיחה. ### הגדרת מאפיינים מתהליך המאפיינים מוגדרים בתוך פעולת **[שינוי שיחה](./studio/actions.md#change-conversation)** הקיימת — אין בלוק נפרד. הם שדות על השיחה, בדיוק כמו עדיפות ונושא, כך שתהליך שמגדיר שלושה מאפיינים ותווית נשאר צומת אחד קריא. ![בוחר מאפייני השיחה בתוך פעולת שינוי שיחה בסטודיו](pathname:///img/screenshots/he/product/conversation-attributes/studio-change-conversation.png) 1. הוסיפו או פתחו בלוק **שינוי שיחה**. 2. גללו אל **מאפייני שיחה**. 3. לחצו **הוספת שדה**, בחרו מאפיין מרשימת **בחירת שדה** והקלידו את הערך שלו. 4. הערכים מקבלים `{{משתנים}}` — למשל `{{webhook.body.order_id}}` או `{{answers.reason}}`. אם לחשבון עדיין אין מאפיינים, הבוחר אומר *"עדיין לא הוגדרו מאפייני שיחה בחשבון הזה."*. בנו אותם קודם בהגדרות. שימושים נפוצים: | תהליך | מה הוא מגדיר | | --- | --- | | בוט שואל "במה מדובר?" ומציע שלושה כפתורים | *סיבת הפנייה* = הכפתור שהלקוח לחץ | | טופס מוגש ופותח שיחה | *מספר הזמנה* = מספר ההזמנה מתשובות הטופס | | בקשת HTTP מאתרת את הלקוח ב‑ERP שלכם | *רמת החשבון* = הרמה שה‑API החזיר | | השיחה נסגרת אוטומטית על ידי הבוט | *תוצאה* = `נפתר על ידי הבוט` | | כלל | התנהגות | | --- | --- | | הערכים מאומתים | ערך ברשימה נפתחת שאינו אחת מהאפשרויות שלכם **מכשיל את הבלוק**, כך שתהליך לעולם לא יכתוב משהו שפאנל הנציג יסרב להציג. | | מאפיינים שנמחקו מדולגים | אם מאפיין הוסר מההגדרות אחרי שהתהליך נבנה, הבלוק מדלג על השורה הזו וממשיך לרוץ. | | ערכים קיימים ממוזגים | הגדרת מאפיין אחד אינה מנקה את האחרים. | | ערכי בחירה מרובה | הפרידו אותם בפסיקים או בשורות חדשות. | ### קריאת מאפיינים בתהליך כל מאפיין הופך למשתנה שנקרא על שם ה**מזהה API** שלו: ``` {{conversation.custom_attributes.reason_for_contact}} {{conversation.custom_attributes.order_number}} ``` והמערך כולו זמין כאובייקט אחד: ``` {{conversation.custom_attributes}} ``` | מאיפה הם מגיעים | פירוט | | --- | --- | | הטריגר | **הודעה נכנסת**, **שיחה נכנסת** ו**שינוי בשיחה** טוענים כולם את המאפיינים הנוכחיים של השיחה. אינכם צריכים בלוק שינוי שיחה כדי לקרוא אותם. | | בלוק שינוי שיחה | אחרי שהבלוק רץ, המשתנים מחזיקים את הערכים ה**חדשים**, כך שכל בלוק שאחריו רואה את מה שנכתב זה עתה. | | מאפיין שאיש לא מילא | מתפענח לערך ריק, ולא ל‑`{{placeholder}}` הגולמי. | זה מה שהופך את המאפיינים לשימושיים ל**[בקשת HTTP](./studio/actions.md#http-request)**: שימו את `{{conversation.custom_attributes.order_number}}` בכתובת או בגוף כדי לאתר את ההזמנה, או שלחו `{{conversation.custom_attributes}}` כדי לדחוף את כל קוד הסיכום למערכת שלכם בשדה אחד. הסתעפו לפיהם עם בלוק **[תנאי If/Else](./studio/conditions.md)** — למשל, נתבו כל שיחה שה*סיבת הפנייה* שלה היא `חיובים` ל[צוות](./teams.md) הכספים. :::tip תהליך יכול להגיב לנציג שממלא מאפיין שמירת פאנל המאפיינים נחשבת לשינוי בשיחה, ולכן טריגר **[שינוי בשיחה](./studio/triggers.md)** מופעל. השתמשו בזה לכללים כמו *"כשהתוצאה מוגדרת כהוסלמה, יידע את מנהל המשמרת"*. ::: --- ## חלק 5 — דיווח (אנליטיקס) מאפייני שיחה הם שדות מהמעלה הראשונה ב[אנליטיקס](./analytics.md). 1. צרו דוח ובחרו את מקור הנתונים **שיחות**. 2. המאפיינים שלכם מופיעים ברשימות השדות, בשמות התוויות שלהם. 3. השתמשו בהם כ**קיבוץ לפי**, כ**מדד** או כ**מסנן**. אין מה לבחור קודם — לחשבון יש מערך מאפיינים אחד, ולכן הם תמיד זמינים במקור השיחות. | שאלה | דוח | | --- | --- | | על מה אנשים פונים אלינו? | עוגה, שיחות, **קיבוץ לפי** *סיבת הפנייה* | | אילו סיבות לוקחות הכי הרבה זמן לפתרון? | עמודות, שיחות, **ממוצע** של *זמן פתרון*, **קיבוץ לפי** *סיבת הפנייה* | | כמה החזרנו החודש? | כרטיס ערך, שיחות, **סכום** של *סכום החזר* | | שיחות חיובים בשבוע | קו, שיחות, **ספירה**, **קיבוץ לפי** זמן, מסונן ל*סיבת הפנייה* = `חיובים` | | איזה נציג מטפל בהכי הרבה תלונות? | עמודות, שיחות, **ספירה**, **קיבוץ לפי** *נציג משויך*, מסונן ל*סיבת הפנייה* = `תלונה` | | תוצאות לפי ערוץ | עמודות מוערמות, שיחות, **ספירה**, **קיבוץ לפי** *סוג ערוץ*, מוערם לפי *תוצאה* | מה שכל סוג יכול לעשות נמצא ב[טבלת סוגי המאפיינים](#attribute-types) שלמעלה. בקצרה: מאפייני בחירה ובוחר נציגים ניתנים ל**קיבוץ**; מאפייני מספר ומטבע ניתנים ל**סכימה ולממוצע**; מאפייני תאריך יכולים להניע **קיבוץ לפי זמן**; מאפייני טקסט משמשים לסינון. :::note דוחות רואים רק את מה שמולא מאפיין שנוסף במרץ אינו יכול לתאר שיחה מינואר, ושיחות שאיש לא מילא בהן מקובצות תחת `(ללא)`. זהו סימן מוקדם טוב — פרוסת `(ללא)` גדולה בדרך כלל אומרת שהמאפיין עדיין אינו חלק מהשגרה של הצוות. ::: --- ## הרשאות למאפייני שיחה יש שורה משלהם בלשונית [הרשאות המערכת](./roles/system-permissions.md#workspace) של תפקיד, תחת **סביבת עבודה**. | פעולה | מה היא מעניקה | | --- | --- | | **צפייה** | לראות את מדור מאפייני השיחה בשיחה ובשיחה שטופלה, ולפתוח את עמוד ההגדרות כדי להסתכל על העיצוב. | | **עדכון** | למלא ערכים בשיחה, **וגם** להוסיף או לערוך מאפיינים בהגדרות. | | **מחיקה** | להסיר מאפיין מהעיצוב של החשבון. | אין **יצירה**, כי מאפיין הוא חלק מעיצוב אחד ברמת החשבון — הוספת מאפיין *היא* עריכת העיצוב הזה. :::warning "עדכון" מכסה גם מילוי וגם עיצוב זה משקף את הדרך שבה **לקוחות ← עדכון** מכסה גם את עורך השדות של ה‑CRM. אם אתם רוצים שנציגי הקו הראשון ימלאו מאפיינים בלי יכולת לעצב אותם מחדש, ההפרדה הזו אינה קיימת היום — הבקרה המעשית היא שעמוד ההגדרות אינו מקום שנציגים בדרך כלל מגיעים אליו. ::: תפקידי ברירת מחדל: | תפקיד | גישה | | --- | --- | | Owner | הכול, תמיד. | | Team Leader | צפייה, עדכון, מחיקה. | | Marketing | צפייה, עדכון. | | Agent | צפייה, עדכון — כדי שנציגי הקו הראשון יוכלו למלא מאפיינים. | | Viewer | צפייה. | :::note חשבונות קיימים צריכים להעניק את זה פעם אחת זו הרשאה חדשה. תפקידים שכבר היו קיימים לפני שהיא נוספה **אינם** מסומנים בה, ולכן בהתחלה רק ה‑**Owner** רואה את היכולת. פתחו **תפקידים והרשאות**, סמנו **מאפייני שיחה** בתפקידים שזקוקים לזה, ושמרו. חשבונות חדשים מקבלים את ברירות המחדל שלמעלה אוטומטית. ::: --- ## מאפיינים מול כל השאר | שמרו את זה כ | מתי | חי על | | --- | --- | --- | | **מאפיין שיחה** | זה נכון לגבי *השיחה הזו* — הסיבה, התוצאה, ההזמנה שנדונה. | השיחה | | **שדה של איש קשר** ([עורך השדות](./crm.md#field-editor)) | זה נכון לגבי *האדם* — המחלקה שלו, השפה המועדפת עליו. | איש הקשר | | **שדה של לקוח** ([CRM](./crm.md)) | זה נכון לגבי *העסק* — המסלול שלו, התעשייה שלו, מנהל הלקוח שלו. | הלקוח | | **רשומת אובייקט CRM** ([CRM](./crm.md#custom-objects)) | זה *דבר* עם חיים משלו — עסקה, קריאת שירות, חוזה. הוא יכול לשרוד את השיחה ויכולים להיות כמה כאלה לכל לקוח. | רשומה משלו תחת הלקוח | | **תווית** | נושא רופף שנוסף במהירות. | השיחה | מבחן מהיר: *אם אותו אדם היה פונה אליכם שוב מחר, האם הערך הזה צריך עדיין להיות שם?* אם **כן**, זהו שדה של איש קשר או של לקוח. אם **לא**, זהו מאפיין שיחה. --- ## דוגמה מעובדת — קוד סיכום למוקד תמיכה הגדרה של חמש דקות שרוב צוותי התמיכה יכולים להעתיק. **ב"הגדרות ← מאפייני שיחה":** | מדור | מאפיין | סוג | אפשרויות | | --- | --- | --- | --- | | למה הם כתבו | סיבת הפנייה `reason_for_contact` | רשימה נפתחת, חובה | חיובים · טכני · מכירות · תלונה · אחר | | למה הם כתבו | מספר הזמנה `order_number` | טקסט | — | | מה עשינו | תוצאה `outcome` | רשימה נפתחת, חובה | נפתר · הוסלם · הוחזר כסף · לא נדרשה פעולה | | מה עשינו | סכום החזר `refund_amount` | מטבע | — | | מה עשינו | נדרש מעקב עד `follow_up_by` | תאריך | — | **עבור הנציגים:** מלאו את שתי הרשימות הנפתחות לפני סימון כטופל. שלושים שניות לשיחה. **בסטודיו:** תהליך ברכה שואל "במה נוכל לעזור?" עם שלושה כפתורים וכותב את התשובה ישירות ל*סיבת הפנייה*, כך שרוב השיחות מגיעות מסווגות מראש. **באנליטיקס:** לוח עם עוגה של *סיבת הפנייה*, עמודות של זמן פתרון ממוצע לפי סיבה, וכרטיס ערך שסוכם את *סכום ההחזר* החודש. תוך חודש תוכלו לענות על *"על מה אנשים באמת פונים אלינו, כמה זמן לוקח כל סוג, וכמה זה עולה לנו"* — מנתונים שהצוות שלכם כבר ייצר. --- ## טיפים | טיפ | למה זה עוזר | | --- | --- | | התחילו בשני מאפיינים | *סיבה* ו*תוצאה* עונות על רוב השאלות. הוסיפו עוד אחרי שההרגל נקבע. | | העדיפו סוגי בחירה | ערכים עקביים הם ההבדל בין גרף לבין בלגן. | | שמרו את הפאנל קצר | ארבעה עד שמונה מאפיינים ממולאים. עשרים — לא. | | הוסיפו אפשרות **אחר** | בלעדיה, אנשים בוחרים את התשובה השגויה הקרובה ביותר ומרעילים את הנתונים בשקט. | | השתמשו ב**כיתוב** להוראות | שורת הנחיה אחת בפאנל עדיפה על מסמך הדרכה שאף אחד לא קורא שוב. | | מלאו מראש עם סטודיו | כל מה שהבוט, טופס או API כבר יודעים לא צריך להיות מוקלד על ידי אדם. | | עקבו אחרי פרוסת ה‑`(ללא)` | היא מספרת לכם עד כמה הצוות אימץ את השדה. | | קבעו מזהי API במכוון | אלו השמות בדוחות שלכם, בתהליכים שלכם וב‑API שלכם. בחרו אותם פעם אחת. | ## פתרון תקלות | בעיה | מה לבדוק | | --- | --- | | אני לא רואה את המדור בשיחה | ייתכן שלחשבון עדיין אין מאפיינים, או שלתפקיד שלכם חסרה **מאפייני שיחה ← צפייה**. תפקידים קיימים אינם מקבלים את ההרשאה החדשה אוטומטית. | | השדות אפורים | לתפקיד שלכם יש **צפייה** אך לא **עדכון**. | | אני לא מצליח לפתוח את עמוד ההגדרות | התפקיד שלכם צריך **מאפייני שיחה ← צפייה** כדי לצפות ו**עדכון** כדי לשנות. | | השמירה נכשלת עם "אינו אחת מהאפשרויות המותרות" | הערך אינו תואם לרשימת האפשרויות של המאפיין. בדרך כלל זה אומר שבלוק סטודיו שולח ערך ששמו שונה מאוחר יותר בהגדרות. | | בלוק סטודיו אינו שומר את המאפיין | ודאו שהמאפיין עדיין קיים בהגדרות ושה**מזהה API** שלו לא שונה. מזהה API ששונה הוא מאפיין אחר. | | הערכים הישנים שלי נעלמו | כנראה ששונה **מזהה API**. שנו אותו חזרה למקורי והערכים יופיעו שוב — הנתונים מעולם לא נמחקו. | | המאפיין אינו בדוח שלי | ודאו שמקור הנתונים הוא **שיחות**. מאפייני טקסט ואזור טקסט ניתנים רק לסינון, לא לקיבוץ — השתמשו בסוג בחירה לקיבוץ. | | קבוצת `(ללא)` גדולה בדוח | לשיחות האלה אין ערך למאפיין הזה — בדרך כלל שיחות מלפני שהמאפיין היה קיים, או שיחות שאיש לא מילא. | | מחקתי מאפיין בטעות | צרו אותו מחדש עם **אותו מזהה API**. הערכים נשמרו והופכים גלויים שוב. | | ערכים משיחה ישנה הופיעו בשיחה חדשה | זה לא ייתכן. המאפיינים הם לכל שיחה בנפרד. אם שתי שיחות מציגות את אותו ערך, שתיהן מולאו — בדקו אם תהליך סטודיו מגדיר אותו. | ## מדריכים קשורים - [שיחות](../getting-started/conversations.md) — סביבת העבודה של הנציג וסרגל הצד. - [CRM ולקוחות](./crm.md) — שדות איש קשר, שדות לקוח ואובייקטים מותאמים. - [סטודיו — שינוי שיחה](./studio/actions.md#change-conversation) — הגדרת מאפיינים מתהליך. - [סטודיו — משתנים](./studio/variables.md) — שימוש ב‑`{{conversation.custom_attributes.*}}`. - [אנליטיקס](./analytics.md) — בניית דוחות על המאפיינים שלכם. - [מדריך הרשאות המערכת](./roles/system-permissions.md#workspace) — הרשאת מאפייני השיחה. - [הגדרות החשבון](./settings.md) — שאר אזור ההגדרות. --- # תפקידים ומתכונים לדוגמה מקור: https://docs.teloring.com/he/docs/product/roles/examples Markdown: https://docs.teloring.com/he/markdown/docs/product/roles/examples.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z הגדרות מלאות שאפשר להעתיק. כל אחת מתחילה ב**שכפול** של תפקיד קיים, כי זה הרבה יותר מהיר ובטוח מאשר לסמן רשת ריקה. כל מתכון מפרט רק את מה שצריך **לשנות**. כל מה שאינו מוזכר נשאר כפי שהיה בתפקיד ששכפלתם. :::tip בדקו תפקיד לפני שאתם מחלקים אותו צרו נציג רזרבי אחד — *test@yourcompany.com* — ושייכו אליו את התפקיד החדש. התחברו כאותו נציג בחלון גלישה פרטי ועברו על מה שהוא אמור לעשות. חמש דקות כאלה תופסות יותר משעה של קריאת תיבות סימון, וזה לעולם אינו מסכן את הגישה שלכם. ::: --- ## נציג תמיכה בקו הראשון התפקיד הנפוץ ביותר. עונה ללקוחות, שומר על רשומות מסודרות, אינו נוגע בהגדרות. **כבר בנוי עבורכם** — תפקיד **Agent** של ברירת המחדל הוא בדיוק זה. השתמשו בו כמו שהוא. אם אתם רוצים להדק אותו מעט: | שינוי | למה | | --- | --- | | **תגובות מהירות** ← הורידו ל**צפייה** | הספרייה המשותפת מנוהלת על ידי מפקחים; הנציגים משתמשים בה אך לא מוסיפים לה. | | **לקוחות ← יצירה** כבוי | לקוחות מגיעים משיחות ומסטודיו, ולכן נציגים לעולם אינם צריכים להוסיף אחד ידנית. | | **הישגים ← עדכון** כבוי | רק מנהל אוסף את פרסי ההישגים של החשבון. | --- ## מפקח משמרת מנהל משמרת: רואה הכול, מנתב עבודה, מטפל בהסלמות. ללא חיובים, ללא ניהול נציגים. **שכפלו:** Team Leader | לשונית | שינוי | | --- | --- | | מערכת | השאירו כמו שהוא. ‏Team Leader כבר מכוון לזה. | | ערוצים | השאירו כמו שהוא — גישה מלאה לכל תיבה. | **צמצום אופציונלי:** | שינוי | למה | | --- | --- | | **הגדרות ← שעות פעילות** ← **צפייה** בלבד | ראשי משמרת קוראים את הלוח; המנהל קובע אותו. | | **מחסן קבצים ← מחיקה** כבוי | מחיקת קובצי חשבון אינה החלטה של משמרת. | | **מחיקת שיחה** כבוי בתיבה העתידית | מסיר את היכולת להשמיד שרשור אימייל. | --- ## מנטר רצפה — צופה, לא לוקח נציג בכיר שמפקח על התור, מנתב עבודה ונכנס לתמונה, אך אינו חלק מהרוטציה. **שכפלו:** Agent | לשונית | שינוי | | --- | --- | | ערוצים ← **תיבה עתידית** | הסירו את הסימון מ**קבלת הבא בתור**. השאירו את כל יכולות ה*צפייה* מופעלות. השאירו את **יכול לשייך שיחות** מופעלת. | | מערכת | הוסיפו **אנליטיקס ← צפייה** כדי שיוכל לראות נפח בזמן אמת. | הוא רואה את כל התור, מנתב אותו, ולעולם אינו מקבל שיחה בעצמו. --- ## בקר איכות — מעיר, לעולם אינו משיב קורא שיחות לצורך הדרכה ועמידה בכללים, מוסיף הערות, והלקוח לעולם אינו שומע ממנו. **שכפלו:** Agent | לשונית | שינוי | | --- | --- | | ערוצים ← **תיבה עתידית** | הסירו את הסימון מ**שליחת הודעה חדשה**, **פתיחת שיחה חדשה**, **סימון שיחה כטופלה**, **קבלת הבא בתור**, **העברת שיחה להמתנה**. השאירו את **צפייה בכל השיחות הפתוחות**, **צפייה בכל השיחות שטופלו**, **צפייה בשיחות קודמות**, **שליחת הערה פרטית**, **הוספת תווית לשיחה**. | | מערכת | **אנליטיקס ← צפייה**. כל השאר כבוי, למעט **לקוחות ← צפייה**. | שתי היכולות שגורמות לתפקיד הזה לעבוד הן **שליחת הערה פרטית** מופעלת (כדי שיוכל להשאיר הערות הדרכה) ו**שליחת הודעה חדשה** כבויה (כדי ששום דבר לא יגיע ללקוח). --- ## שיווק וקמפיינים בונה אוטומציות, טפסים ודוחות. עובד עם השיחות שלו, לא עם תורי התמיכה. **כבר בנוי עבורכם** — תפקיד **Marketing** של ברירת המחדל. כדאי לדעת: ל‑Marketing אין בכוונה **אף אחת** מיכולות ה*צפייה*, ולכן הוא עובד רק מ*שלי* — שיחות שמשויכות אליו, או כאלה שהוא פתח. אם צוות השיווק שלכם מכסה גם תיבה משותפת, סמנו את יכולות ה*צפייה* של אותה תיבה במפורש והשאירו את **התיבה העתידית** ריקה. | תוספת נפוצה | למה | | --- | --- | | **טבעת הערוצים ← עדכון** | אם השיווק מנהל את המראה של וידג'ט הצ׳אט באתר. | | **חתימת מסמכים ← יצירה** | אם השיווק שולח חוזים או הסכמים. | | בתיבה מסוימת: **צפייה בכל השיחות הפתוחות** | אם הם חולקים תיבת קמפיין אחת עם התמיכה. | --- ## צוות ייעודי לערוץ צוות שעובד בערוץ אחד ואסור לו לראות את האחרים — צוות WhatsApp במיקור חוץ, תיבה בשפה מסוימת, קו אזורי. **שכפלו:** Agent | לשונית | שינוי | | --- | --- | | ערוצים ← **תיבה עתידית** | **ניקוי הכול**. זה השלב המרכזי. | | ערוצים ← התיבה שלהם | **בחירת הכול**, ואז הסירו את הסימון מ**מחיקת שיחה**. | | מערכת | שקלו להוריד את **תגובות מהירות** ל**צפייה** ולכבות את **מחסן קבצים**. | מכיוון ש**התיבה העתידית** ריקה, **כל תיבה שתחברו בהמשך תהיה בלתי נראית לתפקיד הזה אוטומטית** — לעולם לא תצטרכו לזכור להגביל אותה. :::warning אל תעניקו כאן טבעת הערוצים ← צפייה נציג עם **טבעת הערוצים ← צפייה** רואה בעמוד ההוא את כל התיבות בחשבון, כולל כאלה שאינו יכול לעבוד בהן. עבור תפקיד שכל מטרתו היא הפרדת ערוצים, השאירו את טבעת הערוצים כבויה לחלוטין. ::: --- ## קבלן חיצוני או סוכנות התפקיד המצומצם ביותר שעדיין שימושי. ערוץ אחד, מינימום נתונים, שום דבר להגדרה. **התחילו מ:** **+ תפקיד חדש** (רשת ריקה מתאימה כאן — אתם רוצים להעניק במכוון, לא להסיר) | לשונית | הגדרה | | --- | --- | | מערכת | **לקוחות ← צפייה**. **מאגר ידע ← צפייה** כדי שיוכלו לחפש תשובות. שום דבר נוסף. | | ערוצים ← **תיבה עתידית** | הכול כבוי. | | ערוצים ← התיבה שלהם | **צפייה בתור ההמתנה**, **קבלת הבא בתור**, **שליחת הודעה חדשה**, **סימון שיחה כטופלה**, **צפייה בשיחות קודמות**, **הוספת תווית לשיחה**. | הוסיפו [צוותים](../teams.md) מעל: שימו את הקבלן בצוות אחד ונתבו אליו רק את העבודה של אותו צוות, כך ש**קבלת הבא בתור** לא תמסור לו דבר מחוץ להיקף שלו. | עשו גם | למה | | --- | --- | | אכפו אימות דו‑שלבי — **הגדרות ← אבטחה והתחברות** | גישה חיצונית ראויה לגורם אימות שני. | | שקלו רשימת IP מורשים | אם הם עובדים ממשרד קבוע. | | בדקו את **ניהול ← יומן לוגים** מדי פעם | הוא מתעד מה נעשה ועל ידי מי. | --- ## רואה חשבון או מנהל חשבונות צריך חשבוניות, פרטי מסלול וכרטיסים. לעולם לא אמור לראות שיחה עם לקוח. **התחילו מ:** **+ תפקיד חדש** | לשונית | הגדרה | | --- | --- | | מערכת | **חיובים ← קרדיטים ← צפייה**, **חיובים ← מנוי ← צפייה**, **חיובים ← כרטיסי אשראי ← צפייה**, **חיובים ← תמחור שימוש ← צפייה**. שום דבר נוסף. | | ערוצים ← **תיבה עתידית** | הכול כבוי. | הוסיפו **חיובים ← כרטיסי אשראי ← יצירה / עדכון / מחיקה** רק אם הם באמת מנהלים את כרטיס החברה. השאירו את **מנוי ← עדכון** כבוי, אלא אם הם בוחרים את המסלול שלכם — זה משנה כמה אתם משלמים. :::note הם יראו מעט מאוד מעבר לזה לתפקיד הזה אין **לקוחות ← צפייה**, ולכן גם עמוד הלקוחות נעלם. סרגל הצד מציג את לוח הבקרה, מדריכים, הישגים אם הוענקו, וחיובים. זו הנקודה. ::: --- ## בעל עניין לקריאה בלבד מנהל, משקיע או יועץ שרוצה מספרים ואין לו גישה לשום דבר אחר. **כבר בנוי עבורכם** — תפקיד **Viewer** של ברירת המחדל. צפייה כמעט בכל מקום, כתיבה בשום מקום, וללא גישה לשיחות כלל. אם הם צריכים לראות גם את *תוכן* השיחות — מבקר, למשל: | שינוי | למה | | --- | --- | | ערוצים ← **תיבה עתידית** ← סמנו **צפייה בכל השיחות הפתוחות**, **צפייה בכל השיחות שטופלו**, **צפייה בשיחות קודמות** | הם יכולים לקרוא כל שיחה ולא לשנות דבר, כי ל‑Viewer אין יכולות שליחה, סימון כטופל או שיוך. | השילוב הזה — כל יכולות ה*צפייה* מופעלות, כל יכולות ה*עשייה* כבויות — הוא באמת קריאה בלבד בכל התיבה. שווה לדעת שזה אפשרי. --- ## נציג מתלמד מישהו שלומד את התפקיד ושהתשובות שלו צריכות להיבדק לפני שהן מגיעות ללקוחות. **שכפלו:** Agent | לשונית | שינוי | | --- | --- | | ערוצים ← **תיבה עתידית** | הסירו את הסימון מ**שליחת הודעה חדשה**. השאירו את **שליחת הערה פרטית** מופעלת. הסירו את הסימון מ**סימון שיחה כטופלה**, **מחיקת שיחה** ו**יכול לשייך שיחות**. | | מערכת | השאירו כמו שהוא. | הוא יכול לפתוח את כל התור, לנסח את התשובה שלו כ**הערה פרטית**, ומפקח שולח אותה. כשהוא מוכן, סמנו **שליחת הודעה חדשה** — או פשוט העבירו אותו לתפקיד **Agent**, שזה בדרך כלל הצעד הנקי יותר. --- ## תפעול AI מישהו שמכוונן תהליכי סטודיו ונציגי AI אבל אינו מנהל תמיכה. **שכפלו:** Marketing | לשונית | שינוי | | --- | --- | | מערכת | השאירו **סטודיו ← כל הארבע** ו**עולם AI ← צפייה + עדכון**. השאירו **מאגר ידע ← כל הארבע**. הוסיפו **נציגים ← צפייה** כדי שיוכל לראות פרופילים של נציגי AI. הורידו **טפסים** ו**תצוגות** אם אינם נחוצים. | | ערוצים ← **תיבה עתידית** | סמנו **צפייה בשיחות בוט סטודיו** ו**צפייה בשיחות נציג AI** — הוא צריך לראות מה האוטומציה עושה. | שני התורים האלה הם אלה שתפקיד **Agent** של ברירת המחדל חסר בכוונה, ואלה שהתפקיד הזה הכי זקוק להם. :::note עריכת פרופיל של נציג AI דורשת נציגים ← עדכון נציג AI הוא שורה בספריית הנציגים, ולכן יצירה או עריכה שלו הן **נציגים ← יצירה / עדכון** — אותה הרשאה כמו ניהול אנשים. אין היום הרשאה נפרדת ל‑AI בלבד. אם זה רחב מדי, השאירו את השינויים בפרופילי ה‑AI אצל ה‑Owner או ה‑Team Leader ותנו לתפקיד הזה **נציגים ← צפייה**. ::: --- ## מבנה שמתאים לצמיחה אם אתם מקימים חשבון מאפס, זו נקודת פתיחה איתנה: | תפקיד | מי | מבוסס על | | --- | --- | --- | | **Owner** | אתם, ועוד אדם אחד אמין | קבוע | | **Team Leader** | מנהל תמיכה | ברירת מחדל | | **Agent** | כל מי שבקו הראשון | ברירת מחדל | | **Viewer** | בעלי עניין שרוצים לוחות בקרה | ברירת מחדל | | *(הוסיפו לפי הצורך)* | שיווק, קבלנים, רואה חשבון | המתכונים למעלה | ארבעה תפקידים מכסים את רוב החשבונות. הוסיפו חמישי כשאדם אמיתי אינו מתאים לאף אחד מהם — לא מראש. :::tip שני Owners, תמיד ‏Owner אחד הוא נקודת כשל יחידה: בחופשה, בחופשת מחלה, עזב את החברה. שניים פירושם שההגנה על ה‑Owner האחרון של Teloring לעולם לא תחסום שינוי לגיטימי, ותמיד יש מישהו שיכול להגיע לחיובים ולהגדרות. ::: ### סימנים שהתפקידים שלכם דורשים חשיבה מחדש | תסמין | מה זה בדרך כלל אומר | | --- | --- | | תפקיד לכל אדם | אתם ממדלים אנשים, לא עבודות. מזגו אותם. | | כולם Owner | שום דבר אינו מוגן. העבירו את רוב האנשים ל‑Team Leader או ל‑Agent. | | תפקיד שאף אחד לא מחזיק | מחקו אותו, או ציינו בתיאור שלו למה הוא נשמר. | | מספר ההרשאות של תפקיד ממשיך לטפס | הוא הורחב חריג אחר חריג. פצלו אותו, או קדמו את המחזיקים בו לתפקיד רחב יותר במכוון. | | נציגים ממשיכים לבקש גישה | התפקיד צר מדי לעבודה בפועל. הרחיבו את התפקיד במקום להעביר אנשים לתפקיד רחב יותר. | --- ## מדריכים קשורים - [תפקידים והרשאות](./overview.md) — יצירה, עריכה, שיוך ומחיקה של תפקידים. - [מדריך הרשאות המערכת](./system-permissions.md) — כל יכולת וכל פעולה. - [מדריך הרשאות הערוצים](./channel-permissions.md) — 18 יכולות התיבה. - [נציגים ונציגי AI](../agents.md) — שיוך תפקיד לאדם. - [צוותים](../teams.md) — ניתוב, שמשתלב היטב עם תפקידים ייעודיים לערוץ. --- # בונה הטפסים מקור: https://docs.teloring.com/he/docs/product/forms Markdown: https://docs.teloring.com/he/markdown/docs/product/forms.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z בונה הטפסים מאפשר לצוות שלכם ליצור טפסים מובנים, לפרסם אותם ללקוחות, לאסוף הגשות ולהפעיל אוטומציות סטודיו כאשר טופס הושלם. השתמשו בטפסים כשאתם צריכים מידע מבוקר מלקוחות — פרטי הצטרפות, בקשות שירות, סקרים, בקשות להצעת מחיר, אישורים, טופסי פנייה או מידע להמשך טיפול אחרי שיחה. הטפסים נפרדים מהשיחות. טופס אינו יוצר תיבה חדשה ואינו הופך לערוץ תקשורת. במקום זאת, הוא אוסף נתונים ויכול להעביר אותם לסטודיו, לתהליכי CRM או למערכות חיצוניות. ## עובדות מרכזיות | עובדה | משמעות | | --- | --- | | הטפסים אוספים נתונים מובנים | הלקוחות ממלאים שדות בעמוד טופס ציבורי. | | הטפסים מנוהלים בגרסאות | כל שמירה מקדמת את גרסת הטופס. | | ההגשות הן תמונות מצב | הגשות קיימות נשארות קריאות גם אם הטופס נערך או נמחק בהמשך. | | הפריסה מבוססת עמודות | העורך והטופס הציבורי משתמשים באותו מבנה קבוע של עמודות ושורות. | | שדות מוסתרים אינם מוצגים | שדות מוסתרים שומרים ערכים פנימיים בלי לתפוס מקום גלוי בטופס. | | סטודיו יכול להגיב | כל הגשה מוצלחת מפעילה את הטריגר `trigger.form_filled` בסטודיו. | | מזהי השדות חשובים | מזהי השדות הופכים למשתני סטודיו, לעמודות ייצוא ולמפתחות תשובה יציבים. | ## מי משתמש בטפסים | תפקיד | שימוש אופייני | | --- | --- | | מנהלי חשבון | בונים טפסים, מגדירים מיתוג, מפרסמים קישורים ומחברים הגשות לאוטומציות סטודיו. | | מנהלי צוותים | סוקרים הגשות, מחליטים אילו שדות נחוצים ומוודאים שהטפסים תואמים לתהליכים התפעוליים. | | נציגים | משתפים קישורי טפסים עם לקוחות כשהם זקוקים למידע מובנה. | | לקוחות | ממלאים את הטופס הציבורי מהדפדפן, במחשב או בנייד. | ## רשימת הטפסים פתחו את הטפסים מסרגל הצד של Teloring. עמוד הטפסים כולל: | אזור | השתמשו בו כדי | | --- | --- | | לשונית הטפסים | ליצור, לחפש, לפתוח, לשכפל, לפרסם, להעתיק קישורים ולמחוק טפסים. | | לשונית ההגשות | לסקור תשובות שהוגשו בכל הטפסים. | | מסנני סטטוס | להפריד בין טיוטות, טפסים שפורסמו, טפסים סגורים וטפסים בארכיון. | | פעולות בשורת הטופס | לערוך טופס, לשכפל אותו, להעתיק את הקישור הציבורי שלו או למחוק אותו. | ![רשימת הטפסים ב‑Teloring](pathname:///img/screenshots/he/product/forms/forms-list.png) ## יצירת טופס כדי ליצור טופס: 1. פתחו את הטפסים. 2. לחצו על יצירת טופס. 3. תנו לטופס שם ברור. 4. בחרו את סוג הטופס. 5. פתחו את העורך. 6. הוסיפו עמודים ושדות. 7. הגדירו את ההגדרות. 8. שמרו. 9. פרסמו כשהטופס מוכן. ## סוגי טפסים טפסים יכולים להיות פתוחים או ייעודיים. | סוג | משמעות | מתאים ביותר ל | | --- | --- | --- | | קישור ציבורי פתוח | קישור ציבורי אחד לשימוש חוזר. כל מי שיש לו את הקישור יכול לפתוח את הטופס כל עוד הוא מפורסם. | טפסים באתר, טופסי לידים ציבוריים, סקרים כלליים, בקשות פתוחות. | | קישור לאיש קשר ספציפי | קישור שנוצר לכל איש קשר, עבור איש קשר או שיחה מוכרים. הקישור יכול לשאת הקשר של איש הקשר ואפשר לסמן אותו כמילוי חד‑פעמי. | אישורים ייחודיים ללקוח, מעקבים, עדכוני חשבון, בקשות מותאמות אישית. | השתמשו בטופס פתוח כשאותו טופס אמור להיות משותף באופן רחב. השתמשו בטופס ייעודי כשהטופס שייך לאיש קשר או לשיחה אחת. ## סקירת העורך לעורך שלושה אזורים מרכזיים: | אזור | מה הוא עושה | | --- | --- | | פאנל הרכיבים | פלטת השדות. גררו מכאן רכיבים לעמודות שבעמוד. | | הקנבס המרכזי | פריסת הטופס. הוסיפו עמודים, קבעו עמודות ושנו את סדר השדות. | | פאנל המאפיינים | מאפיינים של העמוד, השדה או הגדרות הטופס שנבחרו. | ![עורך הטפסים ב‑Teloring](pathname:///img/screenshots/he/product/forms/forms-editor.png) הטפסים משתמשים בפריסת עמודות קבועה. כך הטופס הציבורי נשאר מיושר עם העורך. לעמוד יכולות להיות 1, 2, 3 או 4 עמודות. השדות ממוקמים בעמודות ונערמים לפי סדר. שדות מוסתרים מופיעים במגש שדות מוסתרים ואינם תופסים מקום גלוי בטופס הציבורי. ## עמודים ועמודות השתמשו בעמודים כדי לפצל טופס ארוך לשלבים ניתנים לניהול. מאפייני העמוד כוללים: | מאפיין | משמעות | | --- | --- | | כותרת | הכותרת שמוצגת עבור אותו עמוד. | | עמודות | מספר עמודות הפריסה בעמוד, מ‑1 עד 4. | | תצוגה | כללים אופציונליים שקובעים אם העמוד מופיע. | השתמשו בעמודה אחת לטפסים פשוטים ולטפסים שמתוכננים קודם לנייד. השתמשו בשתי עמודות או יותר כששדות קצרים וקשורים אמורים לשבת זה לצד זה, כמו שם פרטי ושם משפחה, או טלפון ואימייל. ## הוספה והזזה של רכיבים כדי להוסיף רכיב: 1. גררו רכיב מפאנל הרכיבים. 2. שחררו אותו לתוך עמודה בעמוד. 3. בחרו אותו כדי לערוך את המאפיינים שלו בפאנל המאפיינים. כדי לשנות את סדר השדות, גררו אותם בתוך עמודה או בין עמודות. הטופס הציבורי משתמש באותו מבנה עמודות וסדר. ## מאפייני שדה רוב שדות הקלט חולקים את המאפיינים האלה: | מאפיין | משמעות | | --- | --- | | מזהה השדה | המפתח הטכני היציב של התשובה. ‏סטודיו והייצוא משתמשים במזהה הזה. שמרו אותו קריא, כמו `email`, `request_type` או `campaign_id`. | | תווית | השאלה או שם השדה שמוצגים ללקוח. | | טקסט מציין מקום | טקסט עזר קליל בתוך תיבת הקלט. | | טקסט עזרה | הנחיה נוספת שמוצגת ליד השדה. | | חובה | מחייב את הלקוח למלא את השדה לפני שהוא ממשיך או מגיש. | | מקור הערך | קובע אם השדה ממולא על ידי הלקוח, מהכתובת, מערך מוסתר קבוע או מנתוני איש קשר. | | אימות | מגבלות אופציונליות כמו מינימום, מקסימום או אורך, בהתאם לסוג השדה. | | תצוגה | לוגיקה אופציונלית שקובעת אם השדה מופיע. | ### מזהה השדה וסטודיו מזהה השדה חשוב. אם לשדה טקסט יש מזהה שדה `email`, ‏סטודיו יכול להשתמש ב: ```text {{answers.email}} ``` אם לשדה מוסתר יש מזהה שדה `campaign_id`, ‏סטודיו יכול להשתמש ב: ```text {{hiddenValues.campaign_id}} ``` שינוי מזהה שדה משפיע על הגשות עתידיות ועל משתני סטודיו. הגשות קיימות נשארות שמורות כתמונות מצב. ## מקורות ערך מקור הערך שולט במקום שממנו הערך מגיע. | מקור ערך | שדות גלויים | שדות מוסתרים | משמעות | | --- | --- | --- | --- | | קלט משתמש | כן | לא | הלקוח ממלא את השדה. אין צורך בהגדרה נוספת. | | פרמטר בכתובת | כן | כן | ‏Teloring קוראת ערך מכתובת הטופס הציבורי. | | שדה של איש קשר | כן, בטפסים ייעודיים | כן, בטפסים ייעודיים | ‏Teloring קוראת ערך מאיש הקשר המקושר. | | ערך קבוע | לא | כן | ערך פנימי קבוע שנשמר עם ההגשה. | שדות גלויים אינם משתמשים בערכים קבועים. אם ערך צריך להיות קבוע ולא מוצג ללקוח, השתמשו בשדה מוסתר. ### דוגמה לפרמטר בכתובת אם שדה טקסט קצר גלוי משתמש ב: | הגדרה | ערך | | --- | --- | | מקור הערך | פרמטר בכתובת | | שם הפרמטר | `hi` | אז כתובת הטופס הזו: ```text https://forms.teloring.com/f/example?hi=333 ``` תמלא מראש את השדה בערך: ```text 333 ``` עבור שדות מוסתרים, אותו ערך פרמטר נשמר ב‑`hiddenValues` תחת מזהה השדה המוסתר. ## לוגיקת תצוגה כללי תצוגה מאפשרים לשדה או לעמוד להופיע רק כשתנאים מתקיימים. השתמשו בלוגיקת תצוגה עבור: | תרחיש | דוגמה | | --- | --- | | שאלות המשך | הצגת "תארו את הבעיה" רק כשסוג הבקשה שווה ל"תמיכה". | | עמודים מותנים | הצגת עמוד חיובים רק כשהלקוח בחר "בעיה בחשבונית". | | הסכמה אופציונלית | הצגת שדה חתימה רק כשהלקוח מסכים לתנאים. | לוגיקת התצוגה מכילה: | חלק | משמעות | | --- | --- | | לוגיקה | האם כל הכללים חייבים להתאים או שדי בכלל אחד. | | שדה | השדה לבדיקה. | | אופרטור | ההשוואה, כמו שווה, מכיל, גדול מ, קטן מ, ריק או מסומן. | | ערך | הערך להשוואה, כשהאופרטור זקוק לו. | שדות חובה מוסתרים ועמודים מוסתרים אינם נאכפים כשהם אינם גלויים. אימות בצד השרת בודק מחדש את התצוגה כשהלקוח מגיש את הטופס. ## מדריך הרכיבים ### שדות קלט | רכיב | מה הלקוחות עושים | שימוש נפוץ | מאפיינים חשובים | | --- | --- | --- | --- | | טקסט קצר | מקלידים תשובה קצרה אחת. | שם, עיר, מספר סידורי, מספר חשבון, נושא. | טקסט מציין מקום, חובה, מקור ערך, אורך מינימלי, אורך מקסימלי. | | טקסט ארוך | מקלידים תשובה ארוכה יותר. | תיאור, הערות, פרטי תלונה, הוראות. | טקסט מציין מקום, טקסט עזרה, חובה, אורך מינימלי, אורך מקסימלי. | | מספר | מזינים ערך מספרי. | כמות, גיל, תקציב, ציון, מספר מזהה כשנדרש אימות מספרי. | חובה, מינימום, מקסימום. | | אימייל | מזינים כתובת אימייל. | אימייל ליצירת קשר, אימייל לחיובים, אימייל להתחברות. | חובה, אימות אימייל. | | טלפון | מזינים מספר טלפון. | מספר לשיחה חוזרת, מספר WhatsApp, טלפון חלופי. | חובה, אימות טלפון. | | תאריך | בוחרים תאריך. | תאריך פגישה, תאריך חידוש, תאריך לידה, תאריך שירות מבוקש. | חובה, מקור ערך. | | שעה | בוחרים שעה. | שעה מועדפת לשיחה חוזרת, שעת פגישה, חלון משלוח. | חובה, מקור ערך. | | דירוג | בוחרים דירוג מספרי. | ציון שביעות רצון, איכות שירות, רמת דחיפות. | חובה, מינימום, מקסימום. | | תיבת סימון | מסמנים או מבטלים סימון של אפשרות אחת. | אישור כן/לא, העדפה אופציונלית. | חובה, לוגיקת תצוגה יכולה לבדוק אם היא מסומנת. | | הסכמה | מאשרים הסכמה. | אישור תנאים, אישור פרטיות, הסכמה לדיוור. | חובה, טקסט עזרה. | | חתימת משתמש | מציירים חתימה בעכבר או באצבע. | אישורים, אימותים, קבלה, סיום שירות. | חובה, טקסט עזרה. ההגשה שומרת את תמונת החתימה. | ### שדות בחירה | רכיב | מה הלקוחות עושים | שימוש נפוץ | מאפיינים חשובים | | --- | --- | --- | --- | | רשימה נפתחת | בוחרים אפשרות אחת מתפריט. | סוג בקשה, סניף, מחלקה, מוצר, קטגוריית תקלה. | אפשרויות, חובה, לוגיקת תצוגה. | | לחצני רדיו | בוחרים אפשרות אחת גלויה. | כן/לא עם תוויות, עדיפות, מסלול, העדפה. | אפשרויות, חובה, לוגיקת תצוגה. | | בחירה מרובה | בוחרים כמה אפשרויות. | מוצרים שמעניינים, סימפטומים, ימים זמינים, שירותים מבוקשים. | אפשרויות, חובה, לוגיקת תצוגה. | לכל אפשרות יש תווית וערך. התווית היא מה שהמשתמשים רואים. הערך הוא מה שההגשות וסטודיו משתמשים בו. ### רכיבי תצוגה | רכיב | מה הוא מציג | שימוש נפוץ | מאפיינים חשובים | | --- | --- | --- | --- | | כותרת | כותרת מדור. | תחילת מדור, כותרת עמוד, בלוק הוראות. | תוכן. | | תיאור | טקסט פסקה. | הוראות, הסברים, הערות משפטיות, הנחיות ללקוח. | תוכן. | | מפריד | קו הפרדה אופקי. | הפרדה בין קבוצות שדות. | לא נאספת תשובה. | | תמונה | תמונה בטופס. | לוגו, תמונת מוצר, תרשים, דוגמה, צילום מסך של הוראות. | העלאת תמונה או כתובת תמונה. תמונות שהועלו נשמרות באופן פרטי ומוצגות בקישורים חתומים. | רכיבי תצוגה אינם יוצרים תשובות. ### הרכיב המוסתר שדות מוסתרים שומרים ערכים פנימיים בלי להציג דבר ללקוח. השתמשו בשדות מוסתרים עבור: | תרחיש | דוגמה | | --- | --- | | מעקב אחר קמפיינים | `campaign_id = summer_2026` | | מעקב אחר מקור | `lead_source` מפרמטר בכתובת. | | ניתוב פנימי | `department = billing` | | מזהים חיצוניים | מזהה CRM, מזהה הצעת מחיר, מזהה הזמנה או אסמכתת לקוח. | שדות מוסתרים יכולים להשתמש בערך קבוע, בפרמטר בכתובת או בשדה של איש קשר כמקור הערך. הם אינם תופסים עמודה או שורה גלויה בטופס. ## הגדרות הטופס לחצו על הגדרות בעורך כדי להגדיר את הטופס. ![הגדרות טופס ב‑Teloring](pathname:///img/screenshots/he/product/forms/form-settings.png) ### הגדרות כלליות | הגדרה | משמעות | | --- | --- | | סוג | קישור ציבורי פתוח או קישור לאיש קשר ספציפי. | | סטטוס | טיוטה, פורסם, סגור או בארכיון. | | שפה | קוד השפה של הטופס. | | כיווניות | פריסה מימין לשמאל או משמאל לימין. | ### הגדרות מיתוג | הגדרה | משמעות | | --- | --- | | צבע ראשי | צבע ההדגשה המרכזי שמשמש בטופס הציבורי. | | צבע רקע | צבע רקע העמוד. | | משפחת גופנים | גופן מובנה שהטופס הציבורי משתמש בו. | | לוגו | העלאת תמונת לוגו לראש הטופס. | | תמונת רקע | העלאת תמונת רקע במקום שימוש בצבע בלבד. | | מופעל על ידי Teloring | הצגה או הסתרה של סימון Teloring בתחתית. | לוגו, רקע ותמונות שדה שהועלו נשמרים באחסון הפרטי של Teloring ונספרים כקובצי חשבון. ### הגדרות הגשה | הגדרה | משמעות | | --- | --- | | מילוי חד‑פעמי | עבור קישורים ייעודיים, מונע הגשה של אותו קישור יותר מפעם אחת. עבור קישורים פתוחים, אחסון הדפדפן מספק מניעת כפילויות במאמץ סביר. | | בעת ההגשה | הצגת הודעת תודה או הפניית הלקוח לכתובת אחרת. | | טקסט כפתור ההגשה | הטקסט שמוצג על כפתור ההגשה האחרון. | | צבע כפתור ההגשה | הצבע של כפתור ההגשה האחרון. | | הודעת תודה | הודעה שמוצגת אחרי ההגשה כשההגדרה היא הודעה. | | כתובת הפניה | כתובת היעד כשההגדרה היא הפניה. | ### הגנה מפני ספאם | הגדרה | משמעות | | --- | --- | | Honeypot | מלכודת ספאם בלתי נראית. השאירו אותה מופעלת אלא אם התמיכה מבקשת אחרת. | | Turnstile | אימות Cloudflare אופציונלי, כשהוא מופעל בחשבון. | ## שמירה, פרסום ושיתוף | פעולה | משמעות | | --- | --- | | שמירה | שומרת את הטופס הנוכחי כגרסה הבאה. | | פרסום | הופכת את הטופס לזמין ללקוחות אם סטטוס הטופס הוא "פורסם". | | העתקת קישור | מעתיקה את הכתובת הציבורית לשימוש חוזר בטפסים פתוחים. | | שכפול | יוצרת טיוטה חדשה על בסיס טופס קיים. | | מחיקה | מוחקת את הגדרת הטופס אך שומרת את ההגשות הקיימות ניתנות לייצוא. | :::important[חשוב] אחרי עריכת טופס שפורסם, שמרו את השינויים. הגשות חדשות משתמשות בגרסה השמורה האחרונה. הגשות קיימות שומרות את התשובות המקוריות ואת תמונת המצב של הטופס. ::: ## החוויה בטופס הציבורי הטופס הציבורי הוא העמוד שהלקוח רואה. הלקוחות יכולים: | פעולה | משמעות | | --- | --- | | לעבור בין עמודים | להשתמש בכפתורי הקודם והבא בטפסים מרובי עמודים. | | למלא שדות חובה | יש להשלים שדות חובה לפני שממשיכים. | | לצפות בתמונות | תמונות שבונה הטופס הוסיף יכולות להופיע כהוראות או כהקשר ויזואלי. | | לחתום | לצייר חתימה באצבע בנייד או בעכבר במחשב. | | להגיש | לשלוח את הטופס המלא ל‑Teloring. | ![טופס ציבורי ב‑Teloring](pathname:///img/screenshots/he/product/forms/public-form.png) ## הגשות כל הגשה נשמרת כתמונת מצב בלתי משתנה. המשמעות היא שההגשה נשארת קריאה גם אם הטופס נערך או נמחק בהמשך. ההגשות כוללות: | נתון | משמעות | | --- | --- | | מזהה ההגשה | מזהה ייחודי להגשה. | | שם הטופס והגרסה | גרסת הטופס שבה הלקוח השתמש. | | תשובות | שדות גלויים שהלקוח ענה עליהם או שמולאו מראש. | | ערכים מוסתרים | שדות מוסתרים שנשמרו עם ההגשה. | | פרמטרי מקור | פרמטרים בכתובת שהתקבלו בקישור הטופס הציבורי. | | מזהה איש קשר | קיים כשהטופס השתמש בקישור לאיש קשר ספציפי. | | מזהה שיחה | קיים כשקישור הטופס נוצר מהקשר של שיחה. | | זמן ההגשה | הזמן שבו הטופס הוגש. | פתחו את לשונית ההגשות כדי לסקור תשובות שהוגשו. שדות חתימה מופיעים כתצוגות מקדימות של חתימה במקום טקסט ארוך של נתוני תמונה. ## אינטגרציה עם סטודיו כאשר טופס מוגש, Teloring מפעילה את הטריגר בסטודיו: ```text trigger.form_filled ``` השתמשו בטריגר הזה כדי לבצע אוטומציה לעבודה שאחרי מילוי טופס. ראו [מילוי טופס](./studio/triggers.md#form-filled) למדריך המלא של הטריגר. דוגמאות נפוצות: | אוטומציה | דוגמה | | --- | --- | | יידוע צוות | הוספת הערה פרטית או שליחת הודעה פנימית כשמוגש טופס בקשת שירות. | | עדכון CRM | שמירת ערכי תשובות בשדות של איש קשר, לקוח או אובייקט מותאם. | | ניתוב עבודה | שיוך שיחה או יצירת משימת מעקב על סמך אפשרויות שנבחרו. | | שליחת נתונים החוצה | שימוש בפעולת בקשת HTTP כדי לשלוח את נתוני הטופס למערכת אחרת. | ![טריגר טופס בסטודיו של Teloring](pathname:///img/screenshots/he/product/forms/studio-form-trigger.png) ### משתני סטודיו טריגר הטפסים חושף את הנתונים שהוגשו כמשתנים. | משתנה | משמעות | | --- | --- | | `{{form.id}}` | מזהה הטופס שהוגש. | | `{{form.name}}` | שם הטופס שהוגש. | | `{{form.version}}` | גרסת הטופס שהוגש. | | `{{submission.id}}` | מזהה ההגשה. | | `{{contact.id}}` | מזהה איש הקשר עבור טפסים ייעודיים. | | `{{conversation.id}}` | מזהה השיחה כשהוא זמין. | | `{{answers.list}}` | מערך של תשובות גלויות, כל אחת עם מזהה שדה, תווית, סוג וערך. | | `{{answers}}` | אובייקט של תשובות לפי מזהה השדה. | | `{{answers.email}}` | התשובה המדויקת לשדה שמזהה השדה שלו הוא `email`. | | `{{hiddenValues}}` | אובייקט של ערכים מוסתרים לפי מזהה השדה המוסתר. | | `{{hiddenValues.campaign_id}}` | הערך המוסתר המדויק עבור מזהה השדה `campaign_id`. | | `{{sourceParams}}` | אובייקט של פרמטרים מכתובת הטופס הציבורי. | | `{{sourceParams.utm_source}}` | ערך הפרמטר המדויק עבור `?utm_source=...`. | השתמשו ב‑`answers.list` כששולחים את כל התשובות למערכת אחרת. השתמשו בנתיבים מדויקים כמו `answers.email` כששדה אחד אמור לעדכן שדה CRM אחד. ## עיצוב טפסים מומלץ טפסים טובים הם קצרים, ברורים וקלים להגשה. | המלצה | למה זה עוזר | | --- | --- | | השתמשו בתוויות שדה ברורות | הלקוחות מבינים מה להזין. | | שמרו על מזהי שדות יציבים | תהליכי סטודיו וייצוא נשארים צפויים. | | השתמשו בשדות מוסתרים למעקב | הלקוחות אינם רואים ערכי קמפיין או ניתוב פנימיים. | | פצלו טפסים ארוכים לעמודים | הלקוחות נוטים פחות לנטוש את הטופס. | | השתמשו בעמודות בזהירות | שתי עמודות יכולות לעזור לשדות קצרים; יותר מדי עמודות מקשות על סריקה בנייד. | | בדקו עם קישור ציבורי אמיתי | מאשר את הפרמטרים בכתובת, כללי התצוגה, שדות החובה והטריגרים בסטודיו. | | סקרו הגשות לפני שמשתמשים באוטומציה | ודאו שמזהי השדות והערכים תואמים למה שסטודיו מצפה לו. | ## פתרון תקלות | בעיה | מה לבדוק | | --- | --- | | הקישור הציבורי אומר שהטופס לא נמצא | ודאו שהטופס פורסם, שהקישור הועתק מהטופס הנוכחי ושהטוקן הציבורי קיים. | | שדה אינו מופיע | בדקו את כללי התצוגה של השדה ואת כללי התצוגה של העמוד. | | שדה חובה חוסם את ההגשה | בדקו אם השדה גלוי ואם הגדרת החובה מכוונת. | | הפרמטר בכתובת לא מילא מראש | ודאו שמקור הערך הוא פרמטר בכתובת ושהשם של הפרמטר תואם במדויק. | | ערך מוסתר חסר בסטודיו | ודאו שלשדה המוסתר יש מזהה שדה, מקור ערך וערך שנפתר. השתמשו ב‑`{{hiddenValues.field_id}}`, ולא במציין מקום כללי. | | משתנה סטודיו אינו נפתר | ודאו שמציין המקום משתמש במזהה השדה או בשם הפרמטר האמיתיים. | | התמונה אינה מוצגת | העלו את התמונה מחדש ושמרו את הטופס, כדי ש‑Teloring תוכל לשמור את נתיב הקובץ הפרטי ולרענן את כתובת התצוגה החתומה. | --- # אנליטיקס מקור: https://docs.teloring.com/he/docs/product/analytics Markdown: https://docs.teloring.com/he/markdown/docs/product/analytics.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z האנליטיקס הוא המקום שבו הצוות שלכם הופך פעילות יומיומית לדוחות. אתם בונים לוחות בקרה מהנתונים ש‑Teloring כבר אוספת — שיחות, הודעות, אנשי קשר, נציגים, לקוחות, אובייקטים מותאמים, הגשות טפסים וחתימות אלקטרוניות — ופורשים אותם ככרטיסים על קנבס חופשי. כל דוח הוא מתכון קטן: בוחרים **מקור נתונים**, בוחרים **מה למדוד**, אופציונלית **מקבצים**, **מסננים**, ובוחרים **איך להציג** (מספר, גרף, מד או טבלה). ‏Teloring מריצה את המתכון לפי דרישה מול הנתונים החיים שלכם ושומרת את התוצאה במטמון למהירות. השתמשו באנליטיקס כדי לענות על שאלות כמו "כמה שיחות פתחנו בכל ערוץ החודש?", "איזה נציג סוגר הכי הרבה צ׳אטים?", "כמה מסמכים נחתמו לעומת נדחו?", "מה הדירוג הממוצע מטופס המשוב שלנו?", או "לאילו שיחות לא הייתה תשובת נציג במשך יותר משעה?". ## עובדות מרכזיות | עובדה | משמעות | | --- | --- | | הדוחות הם מתכונים, לא תמונות מצב | דוח מתאר *איך* לשאול את הנתונים שלכם. הוא תמיד משקף נתונים חיים בפתיחה או ברענון. | | מבודדים לחשבון | דוח קורא אך ורק את הנתונים של החשבון שלכם. | | ללוחות הבקרה יש לשוניות | קבצו דוחות קשורים ללשוניות. כל לוח בקרה מתחיל בלשונית **סקירה**. | | קנבס חופשי | גררו כרטיסים כדי להזיז אותם ומשכו את הקצוות כדי לשנות גודל. המיקומים נשמרים אוטומטית. | | כל הזמן כברירת מחדל | דוח חדש מציג את כל הנתונים התואמים. אתם מצמצמים את חלון הזמן עם **מסנן תאריכים** בדוח עצמו. | | המסננים גמישים | שלבו תנאים עם **הכול** (וגם) או **כלשהו** (או) על כל שדה, כולל תאריכים ושדות מותאמים. | | לכל כרטיס עיצוב משלו | צבעים, עיצוב מספרים, מקרא, צירים, פסי מד ועמודות טבלה נקבעים לכל כרטיס בנפרד. | | לראות את השורות הגולמיות | לכל כרטיס יש **צפייה בנתונים** לבדיקת הרשומות המדויקות שמאחורי המספר — ו**ייצוא שלהן ל‑Excel או ל‑PDF**. | | נעיצת לשונית לעמוד הבית | כל לשונית יכולה להחליף את התיבות המוגדרות כברירת מחדל בעמוד הבית — לכולם בחשבון, או רק לכם. | | בניית דוחות עם AI | תארו את הדוח שאתם רוצים בשפה חופשית וה‑AI ימלא עבורכם את הבונה (כאשר **דוחות ואנליטיקס AI** מופעל). | ## מי משתמש באנליטיקס | תפקיד | שימוש אופייני | | --- | --- | | מנהלי חשבון | בונים לוחות בקרה, מעצבים כרטיסים ומגדירים את הדוחות שהצוות מסתמך עליהם. | | מנהלי צוותים | עוקבים אחרי נפח, זמני תגובה, עומס נציגים, תמהיל ערוצים, חתימות ותוצאות טפסים. | | נציגים | פותחים לוחות בקרה משותפים כדי לראות תורים, את העומס שלהם וסיכומים יומיים. | ## סביבת העבודה של האנליטיקס פתחו **אנליטיקס** מסרגל הצד של Teloring. ![לוח הבקרה של האנליטיקס ב‑Teloring](pathname:///img/screenshots/he/product/analytics/analytics-dashboard.png) לסביבת העבודה שלושה חלקים: | אזור | השתמשו בו כדי | | --- | --- | | לשוניות | לעבור בין לשוניות. לשונית **סקירה** קיימת תמיד ואי אפשר למחוק אותה. | | סרגל עליון | **הוספת דוח** פותחת את בונה הדוחות. **רענון** מריצה מחדש כל כרטיס בלשונית הנוכחית. **הוספת לשונית** יוצרת לשונית חדשה. **הגדרות הלשונית** (גלגל השיניים) משנות שם, סדר, מוחקות או נועצות את הלשונית הנוכחית — ראו [הגדרות הלשונית](#tab-settings). | | קנבס | הרשת שבה חיים כרטיסי הדוחות. גררו, שנו גודל, הגדילו והזיזו כאן. | ### לשוניות הלשוניות מאפשרות לארגן דוחות לפי נושא — למשל *סקירה*, *שיחות*, *נציגים*, *מכירות* או *מסמכים*. | פעולה | איך | | --- | --- | | מעבר לשונית | לחצו על שם הלשונית. | | הוספת לשונית | לחצו על כפתור **הוספת לשונית** והקלידו שם. | | שינוי שם, סדר, מחיקה או נעיצה של לשונית | פתחו את **הגדרות הלשונית** (גלגל השיניים בסרגל העליון) — ראו למטה. | לשונית **סקירה** מתרעננת אוטומטית, כך שהיא תמיד מציגה מספרים עדכניים. אי אפשר למחוק אותה. הסימן 📌 ליד שם לשונית פירושו שהלשונית הזו מוצגת כרגע בעמוד הבית של לוח הבקרה (ראו [הצגת לשונית בלוח הבקרה הראשי](#show-a-tab-on-your-main-dashboard)). ### הגדרות הלשונית {#tab-settings} לחצו על כפתור **גלגל השיניים** בסרגל העליון כדי לפתוח הגדרות עבור הלשונית **הנוכחית**. ![הגדרות הלשונית ב‑Teloring](pathname:///img/screenshots/he/product/analytics/tab-settings.png) | הגדרה | מה היא עושה | | --- | --- | | שם הלשונית | שינוי שם הלשונית. לחצו **שמירת שינויים** להחלה. | | סדר הלשוניות | הזזת הלשונית ימינה או שמאלה ביחס לשאר הלשוניות בעזרת הכפתורים **הזזה שמאלה / הזזה ימינה**. המיקום הנוכחי (למשל *2 / 4*) מוצג ביניהם. | | הצגה בלוח הבקרה הראשי | נעיצת הלשונית הזו לעמוד הבית — **כבוי**, **כולם** או **רק אני**. ראו [הצגת לשונית בלוח הבקרה הראשי](#show-a-tab-on-your-main-dashboard). | | אזור מסוכן ← מחיקת לשונית | מחיקה לצמיתות של הלשונית **וכל הדוחות שבה**. מוסתר בלשונית הסקירה, שאי אפשר למחוק. | :::note שינוי שם ושינוי סדר חלים על כולם בחשבון. מחיקת לשונית מוחקת גם כל דוח שבה, ואינה ניתנת לביטול. ::: ### פקדי הקנבס | פקד | מה הוא עושה | | --- | --- | | גרירת כרטיס | לחצו והחזיקו את כותרת הכרטיס (או את הקצה העליון) והזיזו אותו. הכרטיסים נצמדים לרשת קלה. | | שינוי גודל של כרטיס | גררו פינה או קצה כלשהם. | | זום | השתמשו בכפתורי הזום בפינה: הקטנה, הגדלה, **התאמת הכול** ואיפוס ל‑100%. | | הזזה | גררו אזור ריק בקנבס כדי להזיז את כל התצוגה. | ההזזה ושינוי הגודל נשמרים אוטומטית. ## הצגת לשונית בלוח הבקרה הראשי {#show-a-tab-on-your-main-dashboard} לוח הבקרה הראשי — עמוד ה**בית** שאליו אתם מגיעים — מציג בדרך כלל ארבע תיבות סיכום (שיחות פתוחות, ממתינות בתור, טופלו היום, ונציגים מחוברים) מעל השיחות האחרונות שלכם. אפשר להחליף את התיבות האלה בכל לשונית אנליטיקס, כך שהמדדים שחשובים לצוות שלכם הם הדבר הראשון שהוא רואה. ![עמוד הבית של לוח הבקרה עם לשונית אנליטיקס נעוצה](pathname:///img/screenshots/he/product/analytics/dashboard-home-pinned.png) פתחו את **הגדרות הלשונית** של הלשונית שאתם רוצים להבליט ובחרו תחת **הצגה בלוח הבקרה הראשי**: | בחירה | מי רואה זאת | הערות | | --- | --- | --- | | כבוי | — | עמוד הבית מציג שוב את ארבע התיבות שבברירת מחדל. | | כולם | כל מי שבחשבון | "עמוד שער" משותף אחד לחברה. נעיצת לשונית מחליפה את מה שהיה נעוץ לכולם קודם. | | רק אני | רק אתם | עמוד הבית האישי שלכם. נציגים אחרים אינם מושפעים. | איך Teloring מחליטה מה כל אדם רואה בעמוד הבית שלו: 1. אם **אתם** נעצתם לשונית ב**רק אני**, אתם רואים את הלשונית הזו. 2. אחרת, אם לשונית נעוצה עבור **כולם**, אתם רואים את הלשונית הזו. 3. אחרת, אתם רואים את ארבע התיבות שבברירת מחדל. כך נעיצה אישית תמיד מנצחת עבורכם, וכיבוי הנעיצה מחזיר את התיבות המוגדרות כברירת מחדל. רק לשונית אחת יכולה לתפוס כל מיקום (כולם / רק אני) — נעיצת לשונית חדשה מחליפה את הקודמת. הדוחות של הלשונית הנעוצה מוצגים ברשת נקייה ומסודרת אוטומטית (ולא בקנבס החופשי) ומתרעננים מעצמם. השיחות האחרונות שלכם עדיין מופיעות מתחתם. :::note לשונית נעוצה קוראת את אותם נתונים מבודדים לחשבון כמו בכל מקום אחר ב‑Teloring, כך שכל אדם רואה תמיד רק את המספרים של החשבון שלו. ::: ## איך דוח עובד כל דוח בנוי מכמה בחירות פשוטות. הבנה שלהן הופכת את שאר האנליטיקס לקל. | בחירה | על איזו שאלה היא עונה | דוגמה | | --- | --- | --- | | מקור נתונים | על אילו רשומות אני מדווח? | שיחות | | מדידה | איזה מספר אני רוצה? | ספירה | | קיבוץ | איך המספר צריך להתפצל? | לפי סוג ערוץ | | זמן | אם זו מגמה, איזו יחידת זמן? | לפי חודש | | מסננים | אילו רשומות צריכות להיכלל? | רק WhatsApp, רק החודש | | סוג הדוח | איך זה צריך להיראות? | גרף עמודות | | יעד | מול איזה יעד אני משווה? | 500 | | עיצוב | אילו צבעים ועיצוב? | צבעי המותג, ללא נקודות עשרוניות | דוח בשם **"שיחות פתוחות לפי ערוץ"** הוא פשוט: מקור נתונים = שיחות, מדידה = ספירה, קיבוץ = סוג ערוץ, מסנן = הסטטוס הוא פתוח, סוג הדוח = גרף עמודות. ## יצירת דוח 1. פתחו את האנליטיקס ובחרו את הלשונית שבה הדוח צריך לחיות. 2. לחצו **הוספת דוח**. 3. **שלב 1** — בחרו סוג דוח. 4. **שלב 2** — הגדירו את הדוח (כותרת, מקור נתונים, מדידה, קיבוץ, מסננים ועוד). 5. לחצו **יצירת דוח**. הכרטיס מופיע על הקנבס ורץ מיד. כדי לשנות אותו בהמשך, רחפו על הכרטיס ולחצו **עריכה**. ## בניית דוח עם AI אם בחשבון שלכם **דוחות ואנליטיקס AI** מופעל (ב**עולם AI**), אפשר לתאר את הדוח שאתם רוצים בשפה חופשית ולתת ל‑AI לבנות אותו — במקום למלא כל שדה בעצמכם. ![כפתור "בניית הדוח בעזרת AI" ב‑Teloring](pathname:///img/screenshots/he/product/analytics/ai-build-button.png) 1. לחצו **הוספת דוח**. בראש שלב סוג הדוח תראו **✨ בניית הדוח בעזרת AI** (אותו כפתור מופיע גם בפינה בזמן שאתם מגדירים דוח). לחצו עליו. 2. תארו את הדוח במילים שלכם — למשל *"שיחות שטופלו בכל יום בשבוע האחרון"* או *"שיחות פתוחות לפי ערוץ"*. אפשר ללחוץ על צ׳יפ דוגמה כדי להתחיל. 3. לחצו **יצירת דוח**. ![בונה הדוחות החכם ב‑Teloring](pathname:///img/screenshots/he/product/analytics/ai-report-builder.png) ה‑AI בוחר את **סוג הדוח, מקור הנתונים, המדידה, הקיבוץ, טווח הזמן והמסננים**, ואז פותח את הבונה ב**שלב 2** כשהכול מלא מראש, כדי שתוכלו: | ואז | איך | | --- | --- | | להשתמש בו כמו שהוא | לחצו **יצירת דוח**. | | להתאים אותו | שנו כל שדה — כותרת, מדד, קיבוץ, מסננים, עיצוב — לפני היצירה. | | לנסות שוב | לחצו **✨ שימוש ב‑AI** שוב והזינו תיאור חדש (תיאור חדש מחליף הכול). | :::note ה‑AI בונה דוחות רק מנתונים ש‑Teloring באמת שומרת. אם תבקשו משהו שהוא אינו יכול לענות עליו — כמו שאלת ידע כללי — הוא יאמר לכם שאינו יכול לבנות את הדוח הזה, במקום להמציא אחד. שום דבר אינו נוצר עד שאתם לוחצים **יצירת דוח**. ::: הכפתור מוסתר כאשר **דוחות ואנליטיקס AI** כבוי. בקשו ממנהל להפעיל אותו ב**עולם AI** אם אינכם רואים אותו. ## שלב 1: בחירת סוג דוח ![בוחר סוגי הדוחות ב‑Teloring](pathname:///img/screenshots/he/product/analytics/report-type-picker.png) סוגי הדוחות מתחלקים לארבע קבוצות. ### כרטיסי מספר בודד | סוג | מציג | מתאים ביותר ל | | --- | --- | --- | | ערך (KPI) | מספר גדול אחד. | סיכומים כמו "שיחות פתוחות" או "הודעות היום". | | מגמה | מספר גדול לצד **שינוי באחוזים מול התקופה הקודמת**, עם גרף מיני. | "שיחות חדשות השבוע מול שבוע שעבר". | | מד | מד מהירות של המספר מול **יעד**, עם פסים צבעוניים. | "טופלו היום" מול יעד יומי. | | התקדמות | סרגל התקדמות של המספר מול **יעד**, עם אחוז. | "מסמכים חתומים החודש מול יעד של 100". | ### גרפי פילוח | סוג | מציג | מתאים ביותר ל | | --- | --- | --- | | עוגה | פרוסות פרופורציונליות. | חלקו של כל ערוץ בשיחות. | | טבעת | עוגה עם הסכום במרכז. | כמו עוגה, עם הסכום הכולל גלוי. | | עמודות | עמודות אנכיות לכל קבוצה. | שיחות לכל נציג. | | עמודות אופקיות | עמודות פרושות לרוחב. | שמות קבוצה ארוכים, כמו שמות תיבות. | | עמודות מוערמות | עמודות מפוצלות לפי ממד שני. | שיחות לכל ערוץ, מפוצלות לפי סטטוס. | ### גרפי זמן | סוג | מציג | מתאים ביותר ל | | --- | --- | --- | | קו | קו לאורך זמן. | נפח שיחות יומי או חודשי. | | שטח | קו מלא לאורך זמן. | אותה מגמה עם דגש על נפח. | ### פירוט ומיוחדים | סוג | מציג | מתאים ביותר ל | | --- | --- | --- | | טבלה | שורות נתונים — רשומות גולמיות או סיכום מקובץ. | רשימת רשומות, או סיכומי "סוג ערוץ \| ספירה". | | משפך | שלבים עוקבים שאתם מגדירים. | נשירה שלב אחר שלב, כמו ליד ← מסונן ← נסגר. | ## שלב 2: הגדרת הדוח ![בונה הדוחות ב‑Teloring](pathname:///img/screenshots/he/product/analytics/report-builder.png) הבונה מציג רק את המדורים שרלוונטיים לסוג הדוח שבחרתם. ### כותרת שם ברור לכרטיס, כמו *שיחות פתוחות* או *מסמכים שנחתמו החודש*. ### מקור נתונים מקור הנתונים הוא סוג הרשומה שהדוח קורא. לחצו על מקור כדי לבחור בו. | מקור נתונים | מה הוא מכיל | | --- | --- | | שיחות | כל שיחה, עם ערוץ, סטטוס, נציג משויך, **צוות משויך**, עדיפות, חותמות זמן, מוני הודעות, ו**[מאפייני השיחה](./conversation-attributes.md)** של החשבון שלכם. | | הודעות | הודעות בודדות בכל השיחות (כיוון, סוג שולח, סוג תוכן, ערוץ). | | אנשי קשר | רשומות של אנשי קשר. | | נציגים | חברי צוות בודדים (תפקיד, מצב פעילות, פעילות התחברות). | | צוותים | רשומות [צוותים](./teams.md) — גודל הצוות וכללי הניתוב. לא השיחות שהצוות טיפל בהן; ראו את ההערה למטה. | | אירועים | אירועי פעילות מערכת. | | לקוחות | רשומות לקוח ב‑CRM (שלב מחזור חיים, תעשייה, נציג משויך, תגיות). | | אובייקטים מותאמים | רשומות של כל אובייקט מותאם שבניתם (עסקאות, משימות, חשבוניות וכן הלאה). בחרו את **סוג האובייקט** אחרי בחירת המקור הזה. | | הגשות טפסים | תשובות טפסים שהוגשו. אופציונלית בחרו **טופס אחד** כדי לנתח את השאלות שלו. | | חתימות (נחתמו) | סשני חתימה אלקטרונית שהושלמו ונדחו. | | מסמכים (תבניות) | תבניות מסמכי חתימה. | | חתימות ממתינות | קישורי חתימה שנשלחו אך טרם נחתמו. | כשאתם בוחרים **אובייקטים מותאמים** או **הגשות טפסים**, מופיע בורר נוסף כדי שתוכלו לבחור את סוג האובייקט או הטופס הספציפי. השדות הזמינים מתעדכנים בהתאם. :::tip גם שדות השיחה שלכם נמצאים כאן אם החשבון שלכם משתמש ב[מאפייני שיחה](./conversation-attributes.md) — שדות כמו *סיבת הפנייה*, *תוצאה* או *סכום החזר* — הם מופיעים ברשימות השדות של מקור ה**שיחות** תחת התוויות שלהם. אין צורך בבורר נוסף: לחשבון יש מערך מאפיינים אחד, ולכן הם תמיד זמינים. מה שכל אחד יכול לעשות נגזר מהסוג שלו: מאפייני רשימה נפתחת, רדיו, בחירה מרובה ובוחר נציגים ניתנים ל**קיבוץ**; מאפייני מספר ומטבע ניתנים ל**סכימה ולממוצע**; מאפייני תאריך מניעים **קיבוץ לפי זמן**; מאפייני טקסט משמשים לסינון. ::: :::tip דיווח על צוותים — בחרו את המקור הנכון שתי שאלות שונות, שני מקורות שונים: - **"כמה עבודה כל צוות טיפל בה?"** ← מקור נתונים **שיחות**, קיבוץ לפי **הצוות המשויך**. שם נמצאים הנפח, זמן הפתרון, העדיפות והערוץ. מזהי הצוותים מוצגים כ**שמות**, ושיחות ללא צוות מקובצות תחת `(ללא)`. - **"איך הצוותים שלנו מוגדרים?"** ← מקור נתונים **צוותים**. הוא עונה כמה צוותים קיימים, כמה הם גדולים (**נציגים בצוות**, עם ממוצע / סכום / מינימום / מקסימום), אילו מהם משתמשים ב**שיוך אוטומטי לנציג מחובר** או ב**נציגים אנושיים בלבד**, ומי יצר אותם. ראו [צוותים](./teams.md#teams-in-analytics). ::: ### מדידה המדידה היא המספר שהדוח מחשב. | מדד | מה הוא מחזיר | | --- | --- | | ספירה | מספר הרשומות התואמות. זהו המדד הנפוץ ביותר (למשל, מספר השיחות). | | ספירה (ייחודיים) | מספר הערכים הייחודיים בשדה (למשל, אנשי קשר ייחודיים). | | סכום | הסכום הכולל של שדה מספרי (למשל, סכום מוני ההודעות, או ערך העסקאות הכולל). | | ממוצע | הממוצע של שדה מספרי (למשל, דירוג ממוצע). | | מינימום / מקסימום | הערך הנמוך או הגבוה ביותר של שדה מספרי. | :::note **ספירה** סופרת רשומות — היא אינה זקוקה לשדה. בחרו **ספירה** עבור "כמה שיחות". כדי לסכם שדה מספרי כמו נפח הודעות או ערך עסקה, בחרו **סכום** ובחרו את השדה (למשל, *מונה הודעות*). ::: ### קיבוץ הקיבוץ מפצל את המדידה לקטגוריות. בגרף עמודות או עוגה זהו הפילוח; בטבלה הוא הופך את הדוח לסיכום מקובץ. | הגדרה | משמעות | | --- | --- | | קיבוץ לפי | השדה שלפיו לפצל, כמו סוג ערוץ, סטטוס, נציג משויך או שדה מותאם. השאירו ריק כדי לקבל סכום יחיד. | | רזולוציית זמן | עבור דוחות קו, שטח ומגמה — יחידת הזמן: שעה, יום, שבוע או חודש. | **טבלה** עם קיבוץ מציגה שתי עמודות: הקבוצה והמדד שלה (למשל, *סוג ערוץ | ספירה*). **טבלה** ללא קיבוץ מציגה שורות גולמיות — ראו **שדות להצגה**. ### שדות להצגה (טבלאות בלבד) עבור טבלת שורות גולמיות, בחרו אילו עמודות מופיעות. כל שדה זמין הוא תיבת סימון. השאירו את הקיבוץ ריק כדי להשתמש במצב הזה. ### יעד (מגמה, מד והתקדמות) מגמה, מד והתקדמות משווים את המספר ל**יעד**. קבעו את היעד באחת משתי דרכים: | מקור היעד | משמעות | דוגמה | | --- | --- | --- | | מספר קבוע | אתם מקלידים יעד. | יעד של `500`. | | מחושב | היעד הוא בעצמו מדידה, שמוגדרת עם מדד ומסננים משלה. | יעד = מספר השיחות שנוצרו בחודש שעבר, כך שהחודש הזה מושווה לחודש שעבר אוטומטית. | | סוג הדוח | איך היעד משמש | | --- | --- | | התקדמות | ממלא סרגל ל‑`ערך ÷ יעד` ומציג את האחוז. | | מד | מכוון את המחוג לערך בתוך טווח היעד, על פני פסים צבעוניים. | | מגמה | משווה את התקופה האחרונה לתקופה הקודמת ומציג את השינוי באחוזים (עלייה או ירידה). אפשר להציג גם יעד לצורך התייחסות. | ### שלבי משפך עבור משפך, הוסיפו **שלב** לכל צעד. לכל שלב יש תווית ומערך מסננים משלו. השלבים מוצגים לפי סדר עם הנשירה ביניהם. ### מסננים המסננים קובעים אילו רשומות נכללות. זה החלק החזק ביותר בבונה — ראו [סינון נתונים](#filtering-data) למטה. כשסיימתם, לחצו **יצירת דוח** (או **שמירת שינויים** בעריכה). ## סינון נתונים {#filtering-data} ![בונה המסננים ב‑Teloring](pathname:///img/screenshots/he/product/analytics/filters.png) מסנן הוא מערך של **תנאים**. אתם בוחרים איך הם משתלבים: | מצב התאמה | משמעות | | --- | --- | | כל התנאים | רשומה נכללת רק אם **כל** תנאי נכון (וגם). | | תנאי כלשהו | רשומה נכללת אם **לפחות תנאי אחד** נכון (או). | לחצו **הוספת תנאי** כדי להוסיף שורה. לכל תנאי שלושה חלקים: | חלק | משמעות | | --- | --- | | שדה | איזה שדה לבדוק (למשל, סוג ערוץ, סטטוס, תאריך יצירה או שדה מותאם). | | אופרטור | איך להשוות (שווה, הוא אחד מ, מכיל, לפני, בתקופה האחרונה… ועוד). | | ערך | מול מה להשוות. כשהערך הוא רשימה ידועה — תיבות, נציגים, סטטוס, סוג ערוץ — ‏Teloring מציגה **רשימה נפתחת** במקום תיבת טקסט, כדי שלא תצטרכו לנחש. | ### אופרטורים לטקסט, מספרים ורשימות | אופרטור | השתמשו בו כדי | | --- | --- | | שווה / אינו שווה | להתאים ערך מדויק. | | הוא אחד מ / אינו אף אחד מ | להתאים מול כמה ערכים בבת אחת (למשל, הסטטוס הוא **פתוח** או **לא נענתה**). | | מכיל / אינו מכיל | להתאים חלק מערך טקסט, או חברות בשדה רשימה כמו תגיות. | | מתחיל ב / מסתיים ב | להתאים את ההתחלה או הסוף של ערך טקסט. | | גדול מ / קטן מ (וגם הגרסאות הכוללות שוויון) | להשוות מספרים. | | בין | להתאים טווח מספרי. | | ריק / אינו ריק | להתאים רשומות ללא ערך, או עם ערך כלשהו, בשדה. | ### אופרטורים לתאריכים שדות תאריך (תאריך יצירה, תאריך סגירה, זמן ההודעה האחרונה, שדות תאריך מותאמים וכן הלאה) מציעים מערך עשיר של אופרטורי זמן. הם **יחסיים** — הם תמיד נעים עם התאריך הנוכחי. | קבוצה | אופרטורים | | --- | --- | | מדויק | בתאריך, לא בתאריך, לפני תאריך, אחרי תאריך, בין תאריכים. | | יחסי (בוחרים מספר + יחידה) | בתקופה האחרונה…, בתקופה הקרובה…, לפני יותר מ‑…. היחידות הן דקות, שעות, ימים, שבועות או חודשים. | | יום | היום, אתמול, מחר, היום ואתמול, היום ומחר. | | שבוע | השבוע, שבוע שעבר, שבוע הבא, לפני שבועיים, השבועיים הקרובים. | | חודש | החודש, חודש שעבר, חודש הבא, החודשיים האחרונים, החודשיים הקרובים. | | רבעון | הרבעון הזה, הרבעון הקודם, הרבעון הבא, Q1–Q4 של השנה הזו. | | שנה | השנה, שנה שעברה, שנה הבאה. | | מתגלגל | בשעה האחרונה / בשעתיים האחרונות, 30 / 60 / 90 הימים האחרונים, 30 / 60 / 90 הימים הקרובים. | | נוכחות | יש ערך, אין ערך. | :::note חלונות עתידיים (כמו *חודש הבא* או *ב‑30 הימים הקרובים*) מחזירים ריק עבור תאריכי "נוצר", כי אי אפשר ליצור רשומות בעתיד. הם שימושיים לשדות תאריך מותאמים שמחזיקים תאריכים עתידיים, כמו תאריך חידוש או שיחה חוזרת מתוזמנת. ::: ### סינון לפי תיבה מסוימת שיחות וחתימות שומרות את התיבה בשדה **תיבה**. סננו לפי **תיבה** ובחרו את הערוץ לפי שם (למשל, *WA פרויקט סודי (WhatsApp)*) כדי לדווח על תיבה אחת. סננו לפי **סוג ערוץ** במקום כדי לדווח על ערוץ שלם (למשל, כל תיבות הטלגרם). :::note ההודעות אינן שומרות לאיזו תיבה הן שייכות — רק את סוג הערוץ. כדי לדווח על הודעות מתיבה מסוימת אחת, דווחו על **שיחות** עבור אותה תיבה, או סננו **הודעות** לפי **סוג ערוץ**. ::: ### שיחות שמטופלות על ידי סטודיו כשתהליך סטודיו מטפל בשיחה, לא משויך אליה נציג. כדי למצוא או לקבץ את השיחות האלה, השתמשו בשדות השיחה **מטופל על ידי סטודיו** (סננו "אינו ריק") ו**תהליך סטודיו** (קבצו לפיו כדי לראות את הפילוח לפי תהליך). ## עיצוב המראה של כרטיס לכל כרטיס מראה משלו. רחפו על כרטיס ולחצו על פעולת ה**עיצוב** (הפלטה) כדי לפתוח את פאנל **העיצוב**. השינויים מוצגים בתצוגה מקדימה חיה; לחצו **שמירה** כדי לשמור אותם, **איפוס** כדי לחזור לברירות המחדל, או **ביטול** כדי לזרוק אותם. ![פאנל עיצוב הדוח ב‑Teloring](pathname:///img/screenshots/he/product/analytics/design-drawer.png) הפאנל מציג רק את המדורים שרלוונטיים לסוג הכרטיס. | מדור | חל על | מה אפשר לשנות | | --- | --- | --- | | כרטיס | הכול | דריסת כותרת, ועבור כרטיסי מספר — צבע וגודל המספר. | | מספרים | כרטיסים עם מספרים | מספר ספרות עשרוניות, מפריד אלפים, קידומת (כמו `₪`), סיומת (כמו ` דק׳`), מכפיל, סגנון אחוז/רגיל וצורה מקוצרת (1.2k,‏ 3.5M). | | צבעים | גרפים | צבע סדרה יחיד, וכשיש קטגוריות — צבע לכל קטגוריה. עמודות יכולות גם **להדגיש את הערך הגדול ביותר**. | | מקרא ותוויות | גרפים | הצגה או הסתרה של המקרא ומיקומו, הצגת ערכים על הגרף, והצגת אחוזים (עוגה/טבעת). | | צירים ורשת | עמודות, קו, שטח | הצגת קווי רשת, כותרות צירים, התחלת הציר מאפס, קביעת מינימום/מקסימום, החלקת קווים ואטימות מילוי השטח. | | מד | מד | הערך המינימלי ו**הפסים הצבעוניים** (לכל פס יש גבול עליון וצבע). | | התקדמות | התקדמות | צבע הסרגל והאם האחוז מוצג. | | מגמה | מגמה | איזה כיוון הוא "טוב" (כדי שעלייה או ירידה יוצגו בירוק), והאם הגרף המיני מוצג. | | טבלה | טבלה | שורות מפוספסות, שורות דחוסות, ו**מנהל עמודות** להצגה/הסתרה של עמודות, שינוי שמות כותרות ושינוי סדר. | העיצוב נשמר לכל כרטיס, כך ששני כרטיסים שנבנו מאותם נתונים יכולים להיראות שונים לחלוטין. ## עבודה עם כרטיס רחפו על כרטיס דוח כדי לחשוף את הפעולות שלו. | פעולה | מה היא עושה | | --- | --- | | צפייה בנתונים | פותחת את הרשומות שמאחורי הכרטיס בטבלה במסך מלא. | | עריכה | פותחת מחדש את בונה הדוחות לשינוי המתכון. | | עיצוב | פותחת את פאנל העיצוב שתואר למעלה. | | רענון | מריצה מחדש רק את הכרטיס הזה מול נתונים חיים. | | מחיקה | מסירה את הכרטיס מהלשונית. | ## צפייה בנתונים וייצוא (Excel ו‑PDF) **צפייה בנתונים** עונה על השאלה "מאיפה המספר הזה מגיע?". היא פותחת עמוד במסך מלא עם הרשומות המדויקות שהכרטיס ספר, וכפתור **חזרה** לחזרה ללוח הבקרה. ![צפייה בנתוני המקור ב‑Teloring](pathname:///img/screenshots/he/product/analytics/view-data.png) בתצוגת הנתונים אפשר: | פעולה | איך | | --- | --- | | לסנן את השורות | הקלידו בתיבת החיפוש כדי לצמצם את השורות הגלויות. | | למיין | לחצו על כותרת עמודה כדי למיין לפיה; לחצו שוב כדי להפוך את הכיוון. | | לייצא ל‑Excel | לחצו **ייצוא ל‑Excel** כדי להוריד קובץ `.xlsx` של השורות. | | לייצא ל‑PDF | לחצו **ייצוא ל‑PDF** כדי להוריד PDF מלוטש ומוכן לשיתוף — גרף הדוח (כשיש) ולאחריו טבלת הנתונים. | שני הייצואים **יורדים למחשב שלכם**. ה‑PDF הוא דוח מעוצב שאפשר לשלוח למישהו ישירות; קובץ ה‑Excel מתאים כשרוצים לעבוד עם הנתונים הגולמיים בגיליון אלקטרוני. זו גם הדרך המהירה ביותר לאמת דוח לפני שסומכים עליו. ## טווחי תאריכים אין בוחר תאריכים גלובלי. במקום זאת, **כל דוח שולט בחלון הזמן שלו** באמצעות מסנן תאריכים. כך כל כרטיס נשאר כן לגבי מה שהוא מציג. | אתם רוצים | עשו זאת | | --- | --- | | סיכומי כל הזמן | אל תוסיפו מסנן תאריכים — הדוח כולל הכול. | | חלון קבוע | סננו שדה תאריך, למשל **תאריך יצירה בין** שני תאריכים. | | חלון מתגלגל | סננו שדה תאריך עם אופרטור יחסי, למשל **תאריך יצירה הוא החודש** או **ב‑7 הימים האחרונים**. | מכיוון שהאופרטורים יחסיים, דוח שמוגדר ל**החודש** ממשיך להציג את החודש הנוכחי ככל שהזמן עובר — בלי צורך בעריכה. ## דוגמאות מעובדות המתכונים האלה מראים איך החלקים מתחברים. | מטרה | מקור נתונים | מדד | קיבוץ | מסננים | סוג | | --- | --- | --- | --- | --- | --- | | שיחות פתוחות עכשיו | שיחות | ספירה | — | הסטטוס הוא **פתוח** | ערך | | שיחות לכל ערוץ החודש | שיחות | ספירה | סוג ערוץ | תאריך היצירה הוא **החודש** | עמודות | | נפח הודעות יומי | הודעות | ספירה | זמן = יום | תאריך היצירה הוא **ב‑30 הימים האחרונים** | קו | | הודעות טלגרם, מאי–יוני | הודעות | ספירה | — | סוג הערוץ הוא **טלגרם**; תאריך היצירה **בין** 1 במאי ל‑30 ביוני | ערך | | מסמכים חתומים מול נדחו | חתימות (נחתמו) | ספירה | סטטוס | — | עוגה | | דירוג משוב ממוצע | הגשות טפסים (בחרו את הטופס) | ממוצע | — | — | ערך | | עסקאות שנסגרו ברבעון הזה | אובייקטים מותאמים ← עסקאות | ספירה | — | השלב הוא **נסגר**; תאריך היצירה הוא **הרבעון הזה** | ערך | | שיחות ללא תשובת נציג במשך יותר משעה | שיחות | ספירה | — | כיוון ההודעה האחרונה הוא **נכנס**; זמן ההודעה האחרונה הוא **לפני יותר משעה**; הסטטוס הוא **פתוח** או **לא נענתה** | ערך | | הודעות לכל תיבה (מספר WhatsApp אחד) | שיחות | סכום של **מונה הודעות** | תיבה | התיבה היא **(תיבת ה‑WhatsApp שלכם)** | עמודות אופקיות | | שיחות פתוחות לפי צוות | שיחות | ספירה | **צוות משויך** | הסטטוס הוא **פתוח** | עמודות | | זמן פתרון ממוצע לפי צוות | שיחות | ממוצע של **זמן פתרון (מ"ש)** | **צוות משויך** | תאריך הסגירה הוא **החודש** | עמודות אופקיות | | תור מכירות שאף אחד לא עליו | שיחות | ספירה | — | הצוות המשויך הוא **מכירות**; הנציג המשויך **ריק** | ערך | | נציגים לכל צוות | צוותים | ממוצע של **נציגים בצוות** | — | — | ערך | | צוותים שמשתמשים בשיוך אוטומטי | צוותים | ספירה | **שיוך אוטומטי לנציג מחובר** | — | עוגה | | על מה אנשים פונים אלינו? | שיחות | ספירה | **סיבת הפנייה** *(מאפיין)* | תאריך היצירה הוא **החודש** | עוגה | | אילו סיבות פנייה לוקחות הכי הרבה זמן | שיחות | ממוצע של **זמן פתרון (מ"ש)** | **סיבת הפנייה** *(מאפיין)* | תאריך הסגירה הוא **החודש** | עמודות אופקיות | | סך ההחזרים החודש | שיחות | סכום של **סכום החזר** *(מאפיין)* | — | תאריך הסגירה הוא **החודש** | ערך | | תוצאות לפי ערוץ | שיחות | ספירה | סוג ערוץ, מוערם לפי **תוצאה** *(מאפיין)* | — | עמודות מוערמות | ## טיפים | טיפ | למה זה עוזר | | --- | --- | | תנו לדוחות שמות ברורים | כותרת טובה מסבירה את הכרטיס במבט אחד בלוח בקרה משותף. | | השתמשו ב**צפייה בנתונים** כדי לאמת | מוודא שהמספר בנוי מהרשומות שאתם מצפים להן, לפני שאתם סומכים עליו. | | העדיפו מסנני תאריך יחסיים | "החודש" או "ב‑7 הימים האחרונים" נשארים נכונים לאורך זמן בלי עריכה. | | השתמשו ב**ספירה** לרשומות, ב**סכום** לסיכומים | הספירה עונה על "כמה"; הסכום עונה על "כמה" של שדה מספרי. | | קבצו טבלאות לסיכומים | טבלה מקובצת היא הדרך הפשוטה ביותר לקבל רשימת "קטגוריה ← ספירה" שאפשר לייצא. | | שמרו נושא אחד לכל לשונית | הפרידו סקירה, שיחות, נציגים ומכירות ללשוניות כדי שכל אחת תישאר קריאה. | ## פתרון תקלות | בעיה | מה לבדוק | | --- | --- | | המספר נראה נמוך מדי | בדקו את מסנן התאריכים של הדוח. ללא מסנן תאריכים הוא מציג את כל הזמן; עם מסנן יחסי כמו *השבוע* הוא מציג רק את החלון הזה. | | שני כרטיסים סותרים זה את זה | ודאו ששניהם משתמשים באותם מסננים. השתמשו ב**צפייה בנתונים** בכל אחד כדי להשוות את הרשומות. | | "מתכון דוח לא תקין" בשמירה | תנאי מסנן אינו שלם — למשל, **בתקופה האחרונה…** ללא מספר, או **בין** ללא ערך. השלימו את התנאי ושמרו שוב. | | מסנן סטטוס מפספס שיחות | רשימת השיחות מתייחסת ל**פתוח** כאל *פתוח + לא נענתה*. כדי להתאים לזה, סננו את הסטטוס באמצעות **הוא אחד מ** ובחרו גם **פתוח** וגם **לא נענתה**. | | אובייקט מותאם או טופס אינם מציגים שדות | בחרו מחדש את סוג האובייקט או את הטופס כדי שהשדות שלו ייטענו. | | דוח מקובץ מציג "(ללא)" | לחלק מהרשומות אין ערך בשדה הקיבוץ. זה צפוי; סננו אותו החוצה אם אינכם רוצים אותו. עבור [מאפיין שיחה](./conversation-attributes.md), קבוצת `(ללא)` גדולה בדרך כלל אומרת שמדובר בשיחות מלפני שהמאפיין היה קיים, או שהצוות עדיין אינו ממלא אותו. | | מאפיין שיחה אינו ברשימת השדות | ודאו שמקור הנתונים הוא **שיחות**. מאפייני טקסט ואזור טקסט ניתנים לסינון אך לא לקיבוץ — השתמשו במאפיין רשימה נפתחת או בחירה מרובה לקיבוץ. | | שיחות שמטופלות על ידי סטודיו אינן מציגות נציג | הן אינן משויכות לנציג. השתמשו ב**מטופל על ידי סטודיו** או ב**תהליך סטודיו** כדי לדווח עליהן. | | דוח דורש אינדקס ב‑Firestore | דוחות של אובייקטים מותאמים עשויים לדרוש אינדקס חד‑פעמי במסד הנתונים. אם כרטיס מציג אזהרת אינדקס, בקשו מהמנהל שלכם ליצור אותו. | | כפתור **שימוש ב‑AI** אינו מוצג | **דוחות ואנליטיקס AI** כבוי. מנהל יכול להפעיל אותו ב**עולם AI**. | | הלשונית הנעוצה שלי אינה בעמוד הבית | נעיצה אישית (**רק אני**) גוברת על נעיצת חשבון **עבורכם**. בדקו **הגדרות הלשונית ← הצגה בלוח הבקרה הראשי**; הגדירו **כבוי** כדי להחזיר את התיבות שבברירת מחדל. | | ה‑AI אומר שהוא לא יכול לבנות את הדוח שלי | הבקשה מבקשת משהו ש‑Teloring אינה שומרת, או שהיא כללית מדי. תארו מדד על הנתונים שלכם, למשל "שיחות פתוחות לפי ערוץ החודש". | --- # עולם AI מקור: https://docs.teloring.com/he/docs/product/ai-world Markdown: https://docs.teloring.com/he/markdown/docs/product/ai-world.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z **עולם AI** הוא חדר הבקרה של כל יכולת בינה מלאכותית ב‑Teloring. זהו עמוד אחד של מתגי הפעלה/כיבוי — אחד לכל יכולת — שקובעים כמה ה‑AI עוזר לצוות שלכם בשיחות, במאגר הידע ובאנליטיקס. הפעילו מתג והיכולת הזו הופכת לזמינה בכל מקום שהיא שייכת אליו: תיבת חיבור התשובה, פאנל ה‑AI Copilot, פעולת סימון כטופל, עמוד מאגר הידע או בונה הדוחות באנליטיקס. כבו אותו והיא נעלמת שוב. שום דבר כאן אינו משנה מה הנציגים שלכם *יכולים* לעשות ידנית — הוא רק קובע היכן ה‑AI מושיט יד. פתחו את **עולם AI** ממדור **כלים** בסרגל הצד. ![עמוד עולם AI — רשת מתגי יכולות ה‑AI](pathname:///img/screenshots/he/product/ai-world/ai-world-overview.png) ## עובדות מרכזיות | עובדה | משמעות | | --- | --- | | ברמת החשבון | כל מתג חל על כל העסק שלכם. כשמנהל מפעיל יכולת, היא מופעלת עבור **כל** הנציגים בחשבון. | | מנהלים משנים, כולם נהנים | רק **מנהלי חשבון** יכולים להפעיל מתג. נציגים יכולים לצפות בעמוד, אבל המתגים לקריאה בלבד עבורם. | | כבוי כברירת מחדל | כל יכולת מתחילה **כבויה**. שום נתון אינו נשלח ל‑AI עד שמנהל מפעיל אותה. | | נשמר מיד | אין כפתור שמירה. כל מתג נשמר ברגע שאתם מפעילים אותו ומציג סטטוס קצר **שומר… ← נשמר!** על הכרטיס. | | מתג ראשי אחד | **AI Copilot** הוא המתג הראשי לשישה העוזרים שפועלים בשיחות חיות. השישה אינם עושים דבר אלא אם ה‑AI Copilot מופעל גם הוא — ראו [התלות ב‑AI Copilot](#the-ai-copilot-dependency). | | הנתונים שלכם נשארים שלכם | ה‑AI קורא אך ורק את השיחות, הקבצים והרשומות של החשבון שלכם. היכולות מבודדות לחשבון במלואן. | | חלק מהכרטיסים במפת הדרכים | כמה מתגים מוצגים כדי להראות מה מגיע ו**אינם פעילים עדיין** — ראו [בקרוב](#coming-soon). | ## מי משתמש בעולם AI | תפקיד | מה הם עושים כאן | | --- | --- | | מנהלי חשבון | מחליטים באילו יכולות AI החשבון משתמש, ומפעילים או מכבים אותן. | | נציגים ומנהלים | נהנים ממה שהופעל — טיפים של Copilot, ניסוח מחדש, סיכומים ועוד — אבל אינם יכולים לשנות את המתגים. הודעת נעילה מופיעה בראש העמוד עבורם. | :::note אם אתם פותחים את עולם AI והמתגים אינם זזים, אתם מחוברים כמי שאינו מנהל. בקשו ממנהל חשבון לשנות את ההגדרות עבורכם. ::: ## איך העמוד עובד כל יכולת מוצגת כ**כרטיס** עם סמל, שם, תיאור בשורה אחת ומתג בצד. ![כרטיס יכולת בודד, מופעל](pathname:///img/screenshots/he/product/ai-world/feature-card-active.png) | רכיב | מה זה אומר | | --- | --- | | סמל וכותרת הכרטיס | שם היכולת ותיאור בשפה פשוטה של מה שהיא עושה. | | מתג | לחצו כדי להפעיל או לכבות את היכולת. | | הדגשת **פעיל** | כשיכולת מופעלת, הכרטיס שלה מקבל מסגרת טורקיז וגוון עדין, כדי שתראו במבט אחד מה מופעל. | | טקסט סטטוס | תווית קטנה ליד הכותרת מהבהבת **שומר…**, ואז **נשמר!** (או **השמירה נכשלה** אם משהו השתבש). | כדי להפעיל יכולת: לחצו על המתג שלה ל**מופעל**. כדי לכבות אותה: לחצו ל**כבוי**. זו כל שגרת העבודה — השינוי נכנס לתוקף בכל החשבון תוך רגעים. ## התלות ב‑AI Copilot {#the-ai-copilot-dependency} שש יכולות הן **עוזרים שרצים בתוך ה‑AI Copilot**. הן עובדות רק כשהמתג **AI Copilot** מופעל גם הוא: - עזרה וטיפים - זיהוי נושא חכם - שיוך תוויות אוטומטי - זיהוי סיכון נטישה - זיהוי הזדמנות מכירה - סימון דחיפות אוטומטי חשבו על **AI Copilot** כעל המנוע, ועל השישה האלה כעל אפשרויות שאתם מרכיבים עליו. אם ה‑AI Copilot **כבוי**, הפעלת אחת מהשש אינה משפיעה. אם ה‑AI Copilot **מופעל**, כל אחת מהשש שתפעילו מוסיפה עוד דבר שה‑Copilot עוקב אחריו כל עוד השיחה חיה. :::tip נקודת פתיחה טובה לרוב הצוותים: הפעילו את **AI Copilot**, ואז את **עזרה וטיפים**, **זיהוי נושא חכם** ו**שיוך תוויות אוטומטי**. הוסיפו זיהוי נטישה, הזדמנות מכירה ודחיפות אחרי שהצוות שלכם ירגיש בנוח. ::: --- ## מדריך היכולות המדורים למטה מכסים כל יכולת **פעילה** — מה היא עושה, איפה תראו אותה, ומה היא דורשת כדי לעבוד. ### סיוע בשיחה חיה (AI Copilot) היכולות האלה פועלות בזמן שהנציגים מתכתבים עם לקוחות. ה‑Copilot מנתח כל הודעה נכנסת חדשה מלקוח ברקע ומציג את הממצאים שלו בפאנל **AI Copilot** בצד השיחה. ראו [AI Copilot בשיחות](/he/docs/getting-started/conversations#ai-copilot) לתצוגה מצד הנציג. ה‑Copilot פועל רק על שיחות שהן **פתוחות או ממתינות** ו**אינן** מטופלות כבר על ידי תהליך סטודיו או נציג AI. #### 🧠 AI Copilot המתג הראשי לסיוע חי. כשהוא מופעל, ה‑Copilot קורא כל הודעה נכנסת מלקוח ויכול לפרסם תובנות בפאנל ה‑Copilot. בפני עצמו הוא אינו עושה דבר גלוי — שלבו אותו עם העוזרים למטה ועם **מאגר הידע** (לצורך תשובות). | | | | --- | --- | | **איפה תראו זאת** | פאנל ה‑AI Copilot בסרגל הצד של שיחה. | | **דורש** | כלום, אבל שימושי רק עם לפחות עוזר אחד מלמטה מופעל. | #### 💡 עזרה וטיפים ה‑Copilot מציע הצעות והכוונה בזמן אמת — איך להשיב, מה נראה שהלקוח צריך, ואיזה טון מתאים. הטיפים יכולים להופיע כמה פעמים ככל שהשיחה מתפתחת. | | | | --- | --- | | **איפה תראו זאת** | כטיפים של Copilot בפאנל ה‑AI Copilot. | | **דורש** | **AI Copilot** מופעל. | #### 🎯 זיהוי נושא חכם ה‑Copilot כותב שורת נושא קצרה וברורה לשיחה ברגע שהוא מבין את הנושא. | | | | --- | --- | | **איפה תראו זאת** | נושא השיחה מתעדכן אוטומטית; ה‑Copilot מציין שהוא קבע אותו. | | **דורש** | **AI Copilot** מופעל. | | **כדאי לדעת** | קובע נושא רק כשלשיחה **אין כבר נושא**. הוא לעולם אינו דורס נושא שאתם קבעתם. | #### 🏷️ שיוך תוויות אוטומטי ה‑Copilot מתייג את השיחה בתוויות קטגוריה רלוונטיות (למשל `חיובים, החזר` או `טכני, תקלה`), ויוצר אותן בחשבון שלכם אם הן עדיין אינן קיימות. | | | | --- | --- | | **איפה תראו זאת** | התוויות מופיעות על השיחה; ה‑Copilot מציין מה הוא הוסיף. | | **דורש** | **AI Copilot** מופעל. | | **כדאי לדעת** | מתייג רק שיחה שעדיין **אין לה תוויות**, עד 5 תוויות. הוא אינו נוגע בשיחות שכבר תייגתם. | #### 🚪 זיהוי סיכון נטישה ה‑Copilot עוקב אחרי סימנים שלקוח רוצה לבטל, לעזוב או שהוא מאוד לא מרוצה, ומעלה התרעה ברורה שמתארת מה הפעיל אותה. | | | | --- | --- | | **איפה תראו זאת** | התרעת נטישה בפאנל ה‑AI Copilot. היא יכולה גם להתחיל אוטומציה ב‑**סטודיו** (איתות סיכון נטישה). | | **דורש** | **AI Copilot** מופעל. | #### 💰 זיהוי הזדמנות מכירה ה‑Copilot מזהה כשלקוח מגלה עניין בקנייה, בשדרוג או בהוצאה נוספת, ומסמן את ההזדמנות עבור הנציג. | | | | --- | --- | | **איפה תראו זאת** | התרעת מכירה בפאנל ה‑AI Copilot. היא יכולה גם להתחיל אוטומציה ב‑**סטודיו** (איתות מכירה). | | **דורש** | **AI Copilot** מופעל. | #### 🔥 סימון דחיפות אוטומטי ה‑Copilot מעריך עד כמה שיחה דחופה וקובע את העדיפות שלה — `דחוף`, `גבוה`, `בינוני` או `נמוך`. | | | | --- | --- | | **איפה תראו זאת** | עדיפות השיחה משתנה אוטומטית. | | **דורש** | **AI Copilot** מופעל. | | **כדאי לדעת** | מתאים עדיפות רק כל עוד היא ברירת המחדל **בינוני**. הוא לא ידרוס עדיפות שקבעתם ידנית. | ### עזרה בכתיבה #### ✍️ ניסוח מחדש של הודעות מוסיף לנציגים כפתור **✨ ניסוח מחדש** בלחיצה אחת בתיבת חיבור התשובה. לפני השליחה, נציג יכול לשכתב את הטיוטה שלו בכמה דרכים. ![בוחר הניסוח מחדש בתיבת חיבור התשובה](pathname:///img/screenshots/he/product/ai-world/rephrase-picker.png) | אפשרות ניסוח | מה היא עושה | | --- | --- | | שיפור | הופכת את הטקסט לברור, מלוטש ומקצועי יותר. | | תיקון איות ודקדוק | מתקנת שגיאות בלי לשנות משמעות או טון. | | הרחבה | מוסיפה פירוט והרחבה. | | קיצור | מצמצמת לעיקר. | | ידידותי | משכתבת בטון חם ונגיש. | | רשמי | משכתבת בטון עסקי ומקצועי. | | פישוט | משתמשת במשפטים קצרים ובמילים פשוטות. | | תרגום | מתרגמת את התשובה לשפת ה**לקוח**, שמזוהה מההודעה האחרונה שלו. | | | | | --- | --- | | **איפה תראו זאת** | כפתור ה‑✨ לצד כלי העיצוב בתיבת חיבור התשובה. | | **דורש** | כלום נוסף — עובד בפני עצמו. | | **כדאי לדעת** | ה‑AI שומר על השפה המקורית של הנציג בכל אפשרות למעט **תרגום**. הנציגים תמיד בודקים את התוצאה לפני השליחה. | ### כששיחה מסומנת כטופלה שתי היכולות האלה רצות אוטומטית ברגע שנציג מסמן שיחה כ**טופלה**. הן קוראות את השיחה (מדלגות על הערות פרטיות) ופועלות ברקע. #### 📝 סיכום שיחה מייצר סיכום תמציתי בן 2–4 משפטים של השיחה — הנושא, מה הלקוח היה צריך ואיך זה נפתר — כתוב ב**אותה שפה** של השיחה. | | | | --- | --- | | **איפה תראו זאת** | מתווסף כ**הערה פרטית** (🤖 סיכום AI) בסוף השיחה, גלוי לצוות שלכם אך לעולם לא ללקוח. | | **דורש** | כלום נוסף. | #### 💭 רגשות קורא את מצב הרוח הכללי של הלקוח לאורך השיחה ורושם אותו בסולם בן 20 נקודות — מ*מרוצה*, *שמח* ו*מעריך*, דרך *ניטרלי*, ועד *מתוסכל*, *כועס* ו*מאיים*. | | | | --- | --- | | **איפה תראו זאת** | נשמר על השיחה (גלוי בתצוגות של שיחות שטופלו וזמין ל**אנליטיקס** ול‑**סטודיו**). | | **דורש** | כלום נוסף. | | **כדאי לדעת** | שינוי ברגש הלקוח יכול להתחיל אוטומציה ב‑**סטודיו** — שימושי להסלמה של סיום כועס, למשל. | ### ידע ומדיה #### 📚 מאגר ידע פותח את עמוד **מאגר הידע**, שבו אתם מעלים, סורקים ושומרים מסמכים שה‑AI מתייחס אליהם. הוא גם מאפשר ל**AI Copilot** לענות על שאלות של נציגים מהידע המאושר שלכם. | | | | --- | --- | | **איפה תראו זאת** | עמוד מאגר הידע (בסרגל הצד) הופך לשמיש; ה‑Copilot יכול לחפש בו. | | **דורש** | כלום כדי להפעיל אותו. תשובות הידע של ה‑Copilot דורשות גם **AI Copilot** מופעל. | | **כדאי לדעת** | כל עוד זה כבוי, עמוד מאגר הידע מציג הודעת "היכולת מושבתת" במקום הקבצים שלכם. | #### 🖼️ זיהוי תמונות עבור כל תמונה שלקוח שולח, ה‑AI מסתכל עליה ומתאר מה יש בה — עצמים, מותגים, מסמכים וכל טקסט גלוי. | | | | --- | --- | | **איפה תראו זאת** | התיאור מצורף לתמונה הנכנסת בשיחה, ומופיע ברגע שהניתוח מוכן. | | **דורש** | כלום נוסף. | ### אוטומציה #### 🎨 AI Studio מוסיף דרך שנייה ליצור תהליך בסטודיו: **Hermes**, בונה תהליכים חכם שמראיין אתכם בשפה חופשית ואז פורש את האוטומציה כולה — בלוקים, הגדרות וחיבורים — על הקנבס שלכם. ![דיאלוג התהליך החדש עם שני כרטיסי מצב הבנייה](pathname:///img/screenshots/he/product/studio/ai/new-flow-choose-mode.png) | | | | --- | --- | | **איפה תראו זאת** | ‏סטודיו ← **תהליך חדש** ← *איך תרצו לבנות אותו?* ← **בנייה בעזרת AI**. | | **דורש** | כלום נוסף. כדאי לחבר קודם את התיבות, הצוותים ואובייקטי ה‑CRM שאתם רוצים להפוך לאוטומטיים, כי Hermes מציע את שלכם בשמם. | | **מי יכול להשתמש בזה** | כל נציג עם **סטודיו ← יצירה**. הפעלת המתג הזה היא הרשאה אחרת — **עולם AI ← עדכון**. ראו [תפקידים והרשאות](./roles/overview.md). | | **כדאי לדעת** | ‏Hermes תמיד מייצר **טיוטה**. שום דבר אינו עולה לאוויר עד שמישהו מפרסם אותו מהעורך. בניית התהליך היא צעד חד‑כיווני שמסיים את השיחה; מכאן והלאה עורכים את התהליך ידנית כמו כל אחד אחר. | כל עוד המתג הזה כבוי, הכרטיס **בנייה בעזרת AI** עדיין מופיע בסטודיו אך הוא אפור, עם קישור חזרה לעמוד הזה. 📖 מדריך מלא: [בניית תהליך בעזרת AI‏ (Hermes)](/he/docs/product/studio/ai-flow-builder). ### אנליטיקס #### 📊 דוחות ואנליטיקס AI מוסיף כפתור **✨ בניית הדוח בעזרת AI** לבונה הדוחות באנליטיקס, כך שכל אחד יכול לתאר דוח בשפה חופשית ולתת ל‑AI למלא את השדות. | | | | --- | --- | | **איפה תראו זאת** | כפתור **✨ בניית הדוח בעזרת AI** ב[אנליטיקס](/he/docs/product/analytics). | | **דורש** | כלום נוסף. כשהוא כבוי, הכפתור מוסתר. | --- ## בקרוב {#coming-soon} כמה מתגים מופיעים בעמוד עולם AI כדי להראות מה נמצא במפת הדרכים. הם **אינם פעילים עדיין** — הפעלה שלהם אינה משנה דבר במוצר היום. אנחנו מפרטים אותם כאן כדי שתדעו מה כל אחד אמור לעשות. :::info היכולות האלה בפיתוח. השאירו אותן כבויות עד שהמדריך הזה יסמן אותן כפעילות. ::: | יכולת | התנהגות מתוכננת | | --- | --- | | 🌍 **תרגום שיחות** | תרגום שיחות שלמות בזמן אמת לתקשורת בין שפות. | | 🎙️ **תמלול שיחות** | הפיכת הודעות קוליות ואודיו לטקסט אוטומטית. | | 🧩 **העשרת מאגר הידע** | הגדלת מאגר הידע אוטומטית מהפתרונות שהנציגים שלכם נותנים בשיחות אמיתיות. | | 🛡️ **מניעת שפה בוטה** | מניעה מנציגים לשלוח שפה לא הולמת ללקוחות. | | 🔗 **זיהוי בעיות דומות** | זיהוי כשכמה שיחות אחרונות מדווחות על אותה בעיה, והתרעה לצוות שלכם. | | 🔐 **אבטחת AI** | זיהוי סיכוני אבטחה וסימני פריצה בזמן אמת. | | 💡 **הצעות AI** | הצגת תובנות והצעות מבוססות AI בלוח הבקרה הראשי. | | 🛡️ **הגנת קבצים AI** | סריקת כל קובץ נכנס ויוצא וחסימת קבצים זדוניים. | | 🎓 **זיהוי מיומנויות נציגים** | זיהוי אוטומטי של החוזקות של כל נציג מהשיחות ומהביצועים שלו. | ## שאלות נפוצות **האם אני חייב להפעיל הכול?** לא. התחילו מהיכולות שאתם צריכים. כל מתג עצמאי (למעט השש שדורשות AI Copilot — ראו [למעלה](#the-ai-copilot-dependency)). **האם הלקוחות ידעו שה‑AI מעורב?** העזרה שמופנית ללקוח תמיד בידי הנציג. הצעות ניסוח, טיפים של Copilot, סיכומים וציוני רגש מוצגים ל**צוות** שלכם בלבד — שום דבר אינו נשלח ללקוח אוטומטית. הסיכומים נשמרים כהערות פרטיות. **האם נציגים יכולים לשנות את ההגדרות האלה?** לא — רק מנהלי חשבון. הנציגים רואים את העמוד במצב קריאה בלבד עם הודעת נעילה. **מתג חזר למצב כבוי אחרי שלחצתי עליו.** יכולות שהופעלו נשארות מופעלות. אם מתג אינו נשאר דלוק, ייתכן שהוא אחד מפריטי מפת הדרכים ב[בקרוב](#coming-soon), שאינם פעילים עדיין — בררו מול איש הקשר שלכם ב‑Teloring. **איפה אני באמת רואה את ה‑AI פועל?** ב[סביבת העבודה של השיחות](/he/docs/getting-started/conversations#ai-copilot) (פאנל ה‑Copilot, ניסוח מחדש, תיאורי תמונות), בשיחות שטופלו (סיכומים ורגשות), בעמוד מאגר הידע, ב‑[סטודיו](/he/docs/product/studio/ai-flow-builder) כשאתם יוצרים תהליך, וב[אנליטיקס](/he/docs/product/analytics). --- # הגדרות מקור: https://docs.teloring.com/he/docs/product/settings Markdown: https://docs.teloring.com/he/markdown/docs/product/settings.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z ההגדרות הן מרכז הבקרה של החשבון לזהות, ללוגיקת זמן, לאבטחת התחברות, לגישת API ולנתוני החשבון. רוב ההגדרות הן ברמת החשבון, כלומר הן משפיעות על כל נציג באותו חשבון Teloring. השתמשו בהגדרות כשאתם צריכים: - לעדכן את זהות העסק ואת העדפות ברירת המחדל של החשבון. - ליצור לוחות שעות פעילות לניתוב בסטודיו. - לנהל לוחות חגים שגוברים על שעות הפעילות. - לשלוט באבטחת ההתחברות, באימות דו‑שלבי ובסשנים פעילים. - ליצור מפתחות API של החשבון. - לייצא נתוני חשבון או לבקש מחיקת חשבון. :::info ההגדרות הן ברמת החשבון. שינוי הגדרות בחשבון אחד אינו משפיע על חשבון אחר. ::: ## פתיחת ההגדרות פתחו **ניהול ← הגדרות** מסרגל הצד של Teloring. בהגדרות שישה מדורים: | מדור | במה הוא שולט | | --- | --- | | מידע כללי | פרופיל העסק, לוגו, שפה, אזור זמן ומטבע. | | שעות פעילות | לוחות חגים ולוחות זמנים בעלי שם שמשמשים את סטודיו. | | אבטחה והתחברות | הגבלות IP, אכיפת אימות דו‑שלבי, פסק זמן לחוסר פעילות, סשנים וגישת תמיכה. | | API | מפתחות API של החשבון לפעולות מערכת. | | נתונים ופרטיות | ייצוא נתונים, אזור מדיניות השמירה ואזור מסוכן למחיקת חשבון. | | [מאפייני שיחה](./conversation-attributes.md) | שדות מותאמים שנציגים ממלאים בשיחה — סיבת פנייה, תוצאה, מספר הזמנה. | כל מדור הוא [הרשאה](./roles/system-permissions.md) נפרדת. תפקיד שאינו מעניק אף אחת מהן אינו רואה **הגדרות** בסרגל הצד כלל; תפקיד שמעניק אחת נוחת ישירות באותו מדור. ![עמוד המידע הכללי בהגדרות](pathname:///img/screenshots/he/product/settings/general-info.png) ## מידע כללי המידע הכללי מכיל פרטי חשבון הניתנים לעריכה ופרטי מערכת לקריאה בלבד. ### שדות הניתנים לעריכה | שדה | משמעות | משמש את | | --- | --- | --- | | שם העסק | שם התצוגה של החשבון. | הכותרת, זהות החשבון, תצוגות ניהול. | | לוגו / תמונה | הזהות הוויזואלית של החשבון. | לוח הבקרה ומשטחי מיתוג החשבון. | | תעשייה | קטגוריה עסקית אופציונלית. | הקשר פנימי לחשבון ודיווח עתידי. | | אימייל ליצירת קשר | אימייל הקשר הראשי של החשבון. | קשר עם המנהל והפניות מערכת. | | טלפון ליצירת קשר | טלפון הקשר הראשי של החשבון. | קשר עם המנהל והפניות מערכת. | | שפת ברירת מחדל | שפת ברירת המחדל של החשבון. | ברירות מחדל של החשבון וחוויית משתמש חדש. | | אזור זמן | אזור הזמן של החשבון. בחרו מהרשימה הנפתחת. | דוחות, שעות פעילות, לוחות בקרה, מסננים ולוגיקת סטודיו מבוססת זמן. | | מטבע ברירת מחדל | המטבע של החשבון. | חיובים, תמחור וברירות מחדל של החשבון. | ### למה אזור הזמן חשוב אזור הזמן אינו רק טקסט לתצוגה. הוא שולט באופן שבו Teloring מבינה תאריכים ושעות עבור החשבון. אזור הזמן משפיע על: - לוחות שעות פעילות. - בדיקות חגים. - תנאי סטודיו שתלויים בזמן. - דוחות ומסנני לוח בקרה. - התנהגות חשבון מבוססת תאריכים. אם אזור הזמן שגוי, תהליך סטודיו יכול להתייחס להודעת לקוח כאל בתוך או מחוץ לשעות העבודה ברגע הלא נכון. ### פרטי חשבון לקריאה בלבד בלוק פרטי החשבון מנוהל על ידי המערכת. הוא מוצג לצורך התמצאות ואינו ניתן לעריכה מהעמוד הזה. | שדה | משמעות | | --- | --- | | מזהה החשבון | המזהה הפנימי של החשבון. שימושי לתמיכה ולאיתור תקלות ב‑API. | | מסלול | המסלול הנוכחי של החשבון. | | אזור | תווית אזור האחסון. למשל, `ישראל`. | | נוצר | תאריך יצירת החשבון. | | בעלים | בעל החשבון או המנהל הראשון. | ## שעות פעילות לשעות הפעילות שתי לשוניות: - **שעות פעילות** — לוחות זמנים שבועיים בעלי שם. - **חגים** — לוחות חגים שיכולים לגבור על לוחות הזמנים. שעות הפעילות הן אופציונליות. חשבונות חדשים אינם מקבלים לוח זמנים כברירת מחדל. מנהלי החשבון יוצרים רק את הלוחות שהם באמת צריכים. ![רשימת לוחות שעות הפעילות](pathname:///img/screenshots/he/product/settings/business-hours-list.png) ## לשונית שעות הפעילות לשונית שעות הפעילות מציגה כרטיסי לוחות זמנים. כל כרטיס הוא לוח זמנים בעל שם עם אזור זמן, שעות פתיחה שבועיות ולוחות חגים אופציונליים. השתמשו בכמה לוחות כשצוותים שונים עובדים בשעות שונות. דוגמאות: | לוח זמנים | שימוש לדוגמה | | --- | --- | | שעות תמיכה | ניתוב תמיכת לקוחות. | | שעות מכירות | ניתוב לידים למכירות. | | שעות תמיכת VIP | שעות עבודה מיוחדות ללקוחות בעדיפות גבוהה. | ### הוספת לוח שעות פעילות כדי ליצור לוח זמנים: 1. פתחו **הגדרות ← שעות פעילות**. 2. הישארו בלשונית **שעות פעילות**. 3. לחצו **הוספת שעות פעילות חדשות**. 4. הזינו שם ללוח. 5. בחרו את אזור הזמן של הלוח. 6. מלאו את שעות הפתיחה השבועיות. 7. הפעילו את **התחשבות בחגים** אם הלוח הזה אמור להיסגר בלוחות חגים נבחרים. 8. בחרו לוח חגים אחד או יותר. 9. לחצו **שמירת הלוח**. ![חלון הוספת שעות פעילות](pathname:///img/screenshots/he/product/settings/business-hours-modal.png) ### שדות הלוח | שדה | משמעות | | --- | --- | | שם | שם לוח קריא לבני אדם. השתמשו בשמות ברורים, כי סטודיו מציג את השם הזה בעת בחירת לוח. | | אזור זמן | אזור הזמן שבו הלוח נבדק. הוא יכול להיות שונה מאזור הזמן של החשבון בעת הצורך. | | שורות שבועיות | שעת פתיחה ושעת סגירה לכל יום. השאירו יום ריק כשהעסק סגור באותו יום. | | התחשבות בחגים | מתג שמפעיל התנהגות דריסה של חגים עבור הלוח הזה. | | תיבות סימון של חגים | לוחות החגים שאמורים לגבור על השעות השבועיות. | ### התנהגות הדריסה של חגים כש**התחשבות בחגים** כבויה, נבדקות רק השעות השבועיות. כש**התחשבות בחגים** מופעלת, לוחות החגים שנבחרו גוברים על השעות השבועיות. דוגמה: | כלל בלוח | מצב החג | תוצאה בסטודיו | | --- | --- | --- | | יום שני 09:00-17:00 | אין חג נבחר היום | `פתוח` בין 09:00 ל‑17:00 | | יום שני 09:00-17:00 | היום נמצא בלוח חגים נבחר | `סגור` כל היום | | שבת ריקה | אין חג נבחר היום | `סגור` | זה חשוב כי סטודיו יכול להסתעף לפי תנאי שעות פעילות. ## תנאי שעות הפעילות בסטודיו סטודיו קורא את הלוחות שנוצרו בהגדרות. בסטודיו: 1. הוסיפו בלוק תנאי **שעות פעילות**. 2. בחרו לוח מההגדרות. 3. חברו את פלט **פתוח** למסלול של שעות העבודה. 4. חברו את פלט **סגור** למסלול של טיפול מחוץ לשעות או בחגים. הבלוק מחזיר: | פלט | משמעות | | --- | --- | | פתוח | ההודעה הגיעה בתוך הלוח שנבחר ולא בחג נבחר. | | סגור | ההודעה הגיעה מחוץ ללוח שנבחר, או בחג שדורס אותו. | ![בלוק שעות הפעילות בסטודיו](pathname:///img/screenshots/he/product/settings/studio-business-hours.png) ## לשונית החגים לשונית החגים מציגה כרטיסים של לוחות חגים. יש שני לוחות מערכת: | לוח | ניתן לעריכה? | משמעות | | --- | --- | --- | | חגי ישראל היהודיים | לא | לוח החגים היהודי הגלובלי, מתעדכן על ידי מנהל העל של Teloring מ‑Hebcal. | | חגים נוצריים | לא | חגים נוצריים בתאריכים קבועים שנוצרו על ידי Teloring. | מנהלי חשבון יכולים גם ליצור לוחות חגים מותאמים לימים ייחודיים לחברה או מקומיים. דוגמאות: - אירוע שנתי של החברה. - סגירת משרד מקומית. - יום גיבוש. - יום מיוחד אזורי. ![לשונית לוחות החגים](pathname:///img/screenshots/he/product/settings/holiday-calendars.png) ### לוחות חגים של המערכת לוחות המערכת הם לצפייה בלבד עבור מנהלי החשבון. אתם יכולים: - לראות את התאריכים. - לבחור אותם בלוחות שעות פעילות. - להשתמש בהם כלוגיקת דריסה בסטודיו. אינכם יכולים: - לערוך את התאריכים שלהם. - למחוק אותם. - לשנות את שמם. ### לוחות חגים מותאמים כדי ליצור לוח חגים מותאם: 1. פתחו **הגדרות ← שעות פעילות ← חגים**. 2. לחצו **הוספת לוח חגים**. 3. הזינו שם ללוח. 4. הוסיפו תאריך אחד בכל שורה. 5. שמרו. השתמשו בפורמט הזה: ```text YYYY-MM-DD | Title | כותרת בעברית ``` דוגמה: ```text 2026-09-01 | Company day | יום חברה 2026-12-31 | Office closed | המשרד סגור ``` הכותרת בעברית אופציונלית. ## אבטחה והתחברות אבטחה והתחברות שולטות בגישה לחשבון ובהתנהגות הסשנים. ![הגדרות אבטחה והתחברות](pathname:///img/screenshots/he/product/settings/security-login.png) ### רשימת IP מורשים רשימת ה‑IP המורשים היא אופציונלית. כשהיא ריקה, משתמשים יכולים להתחבר מכל כתובת IP שעוברת אימות רגיל. כשהיא מלאה, רק כתובות ה‑IP או טווחי ה‑CIDR שברשימה יכולים להתחבר. כללים: - לכל היותר 5 רשומות. - תומכת בכתובות IP בודדות. - תומכת בטווחי CIDR. דוגמאות: ```text 203.0.113.10 198.51.100.0/24 ``` השתמשו ברשימת IP מורשים כשחשבון אמור להיות נגיש רק ממשרד, מ‑VPN או מרשת מבוקרת. ### אכיפת אימות דו‑שלבי לכל החברים כשזה מופעל, כל חבר חייב לאמת באימייל בזמן ההתחברות. התהליך: 1. המשתמש מזין אימייל וסיסמה. 2. ‏Teloring שולחת קוד אימות באימייל. 3. המשתמש חייב להזין את הקוד בתוך 5 דקות. 4. ההתחברות מושלמת רק לאחר האימות. ### אימות מכשיר חדש Teloring גם שולחת קוד אימות באימייל כשמשתמש מתחבר מדפדפן שעדיין אינו מהימן. זה יכול לקרות גם כשהאימות הדו‑שלבי ברמת החשבון כבוי. מטרה: - להגן על חשבונות כשהסיסמה נכונה אבל הדפדפן חדש. - להפחית סיכון מאישורים שנגנבו. ### פסק זמן לחוסר פעילות / סשן פסק הזמן לחוסר פעילות מנתק משתמשים לא פעילים. כשהוא מופעל: - קבעו פסק זמן בין דקה אחת ל‑60 דקות. - אם נציג אינו מבצע פעולה ב‑Teloring במהלך הזמן הזה, הסשן מסתיים. - הנציג עובר למצב מנותק ומוחזר למסך ההתחברות. ### סשנים פעילים טבלת הסשנים הפעילים מציגה סשנים אחרונים בלוח הבקרה. השתמשו בה כדי: - לראות אילו נציגים מחוברים. - לסקור כתובות IP וזמני נראות אחרונה. - לנתק סשן בכפייה. ניתוק בכפייה מבטל את הסשן. המשתמש המושפע מנותק בבקשה המאומתת הבאה. ### מתן גישה זמנית לתמיכה של Teloring המתג הזה מאפשר גישת תמיכה זמנית לצוות Teloring. השתמשו בו כשהתמיכה של Teloring צריכה לחקור התנהגות בחשבון באישורכם. אפשר לכבות אותו שוב בכל עת. ## API עמוד ה‑API מנהל מפתחות API ברמת החשבון. המפתחות האלה מיועדים לפעולות מערכת. הם אינם מפתחות התחברות אישיים של נציגים. ![עמוד הגדרות ה‑API](pathname:///img/screenshots/he/product/settings/api-keys.png) ### יצירת מפתח API כדי ליצור מפתח: 1. פתחו **הגדרות ← API**. 2. הזינו שם למפתח. 3. הזינו הרשאות (scopes) מופרדות בפסיקים. 4. לחצו **יצירת מפתח**. 5. העתיקו את המפתח מיד. :::warning המפתח הגולמי מוצג פעם אחת בלבד. שמרו אותו בבטחה לפני שאתם עוזבים את העמוד. ::: ### מאפייני מפתח API | מאפיין | משמעות | | --- | --- | | שם | שם מפתח קריא לבני אדם. השתמשו בשמות כמו `סנכרון CRM` או `אינטגרציית מחסן`. | | הרשאות | ההרשאות המבוקשות עבור המפתח הזה. מופרדות בפסיקים. | | שימוש אחרון | זמן השימוש הידוע האחרון. ריק פירושו שהמפתח עדיין לא היה בשימוש. | | ביטול | משבית את המפתח. מפתחות שבוטלו אינם ניתנים לשימוש שוב. | ## נתונים ופרטיות נתונים ופרטיות מכילים כלי ייצוא ומחיקת חשבון. ![הגדרות נתונים ופרטיות](pathname:///img/screenshots/he/product/settings/data-privacy.png) ### ייצוא נתונים ייצוא הנתונים יוצר גיבוי zip של נתוני החשבון. הייצוא כולל נתוני חשבון כמו שיחות, הודעות, הגדרות ונתוני מסמכים קשורים ב‑Firestore. התהליך: 1. מנהל לוחץ **בקשת ייצוא**. 2. ‏Teloring מכניסה לתור משימת ייצוא ברקע. 3. הכפתור מושבת כל עוד הייצוא בתור או רץ. 4. כשהוא מוכן, Teloring שולחת אימייל למבקש. 5. טבלת הייצוא מציגה את קישור ההורדה כשהוא זמין. אפשר לבקש רק ייצוא אחד שלא הושלם בכל פעם. אם ייצוא כבר בתור, ממתין, רץ, מעובד או בתהליך, הכפתור מציג **ייצוא בתהליך**. ### מדיניות שמירת נתונים אזור מדיניות השמירה שמור למסמך ה‑PDF של מדיניות שמירת הנתונים בחשבון. ### אזור מסוכן: מחיקת חשבון מחיקת חשבון היא בלתי הפיכה. לאחר אישור: - החשבון מסומן כנמחק ולא פעיל. - כל החברים מושבתים. - משתמשים אינם יכולים עוד להתחבר לאותו חשבון. כדי להימנע ממחיקה בטעות, המנהל חייב להקליד את שמו המלא לפני האישור. :::danger השתמשו במחיקת חשבון רק כשהחשבון אמור להיות מושבת לצמיתות. פנו לתמיכה של Teloring אם אתם לא בטוחים. ::: ## מאפייני שיחה **הגדרות ← מאפייני שיחה** הוא המקום שבו אתם מעצבים את השדות המותאמים שנציגים ממלאים בשיחה — *סיבת הפנייה*, *תוצאה*, *מספר הזמנה*, *סכום החזר*. בשונה משדות של איש קשר ושל לקוח, אלה שייכים ל**שיחה אחת**: אותו לקוח שיכתוב שוב בשבוע הבא מתחיל עם מערך ריק. זה מה שהופך אותם לשדות שאתם מפיקים עליהם דוחות ב[אנליטיקס](./analytics.md), ולאלה ש‑[סטודיו](./studio.md) יכול להגדיר אוטומטית. אתם בונים את הפריסה בגרירת סוגי מאפיינים מארגז כלים, עם תצוגה מקדימה חיה של הפאנל שהנציגים יראו. מדריך מלא: **[מאפייני שיחה](./conversation-attributes.md)**. ## תפקידים והרשאות התפקידים וההרשאות אינם עוד בתוך ההגדרות. הם מופיעים כפריט ניהול נפרד מתחת ל**נציגים** ומעל ל**יומן לוגים**. ## רשימת בדיקה מומלצת להקמה עבור חשבון חדש: 1. הגדירו שם עסק, פרטי קשר, אזור זמן ומטבע במידע הכללי. 2. העלו לוגו. 3. סקרו את פרטי החשבון לקריאה בלבד. 4. צרו לוחות חגים מותאמים לפי הצורך. 5. צרו לוח שעות פעילות אחד או יותר. 6. חברו את הלוחות לתנאי שעות הפעילות בסטודיו. 7. החליטו אם להפעיל אימות דו‑שלבי ברמת החשבון. 8. הוסיפו רשומות לרשימת ה‑IP המורשים רק כשההתחברות צריכה להיות מוגבלת לרשתות מוכרות. 9. סקרו את הסשנים הפעילים אחרי ההצטרפות. 10. צרו מפתחות API רק לאינטגרציות מהימנות. 11. הגדירו את [מאפייני השיחה](./conversation-attributes.md) שלכם — רוב הצוותים מתחילים ב*סיבת הפנייה* וב*תוצאה*. --- # הישגים מקור: https://docs.teloring.com/he/docs/product/achievements Markdown: https://docs.teloring.com/he/markdown/docs/product/achievements.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z **ההישגים** הופכים אבני דרך יומיומיות — חיבור הערוץ הראשון שלכם, בניית אוטומציה, הגדלת הצוות — ל**קרדיטים חינם** שאפשר להוציא בכל מקום ב‑Teloring. בכל פעם שהחשבון שלכם מגיע ליעד, פרס הופך זמין לאיסוף. לחצו **איסוף** והקרדיטים נכנסים ליתרה שלכם. חשבו על זה כעל תוכנית נאמנות שמובנית בתוך המוצר: ככל שתגדירו את Teloring ותשתמשו בה טוב יותר, כך תרוויחו יותר קרדיטים. פתחו את **ההישגים** ממדור **כלים** בסרגל הצד (ממש מתחת לעולם AI). ![עמוד ההישגים — סיכום עליון ואחריו שורות מקובצות לפי מצב](pathname:///img/screenshots/he/product/achievements/achievements-overview.png) ## עובדות מרכזיות | עובדה | משמעות | | --- | --- | | הפרסים הם **קרדיטים** | כל הישג משלם **קרדיטים** ליתרת החשבון שלכם. הקרדיטים הם המטבע ש‑Teloring משתמשת בו להתכתבות, ל‑AI וליכולות נמדדות אחרות. | | הקרדיטים תקפים **365 יום** | קרדיטים שנאספו מתווספים למאגר הטעינה שלכם ופגים **שנה** מהיום שבו אספתם אותם. אספו אותם כשאתם מוכנים להשתמש בהם. | | **פעם אחת לכל חשבון** | כל הישג ניתן לאיסוף **פעם אחת לכל חשבון עסקי** — לא פעם אחת לכל נציג. מי שלוחץ **איסוף** ראשון תובע אותו עבור כל החשבון. | | **התקדמות ברמת החשבון** | ההתקדמות נמדדת על פני כל החשבון שלכם. אם נציג כלשהו מחבר ערוץ או סוגר שיחה, זה נספר לטובת ההישגים של החשבון. | | **מאומת בשרת** | המערכת בודקת את הקריטריונים האמיתיים בשרתים שלה לפני שהיא מעניקה פרס. אינכם יכולים לפתוח פרס שלא באמת הרווחתם, וכפתור **האיסוף** מופיע רק ברגע שאתם עומדים בתנאים. | | **כל נציג יכול לאסוף** | אין הגבלה למנהלים — כל נציג מחובר בחשבון יכול לאסוף פרס מוכן בשם החשבון. | | חלקם **בקרוב** | כמה הישגים מוצגים כמצייני מקום ליכולות שעדיין בבנייה. הם גלויים כדי שתדעו מה מגיע, אך אינם ניתנים לאיסוף עדיין — ראו [הישגים שיגיעו בקרוב](#coming-soon-achievements). | :::info לעוזרי AI ולעיון מהיר עמוד ההישגים מפרט אבני דרך של פרסים עבור חשבון Teloring יחיד. לכל הישג יש **קוד**, **סמל**, **שם**, **תיאור של איך להרוויח אותו** ו**פרס בקרדיטים**. הישג עובר בין מצבים: *בתהליך* ← *מוכן לאיסוף* ← *נאסף*. הפרסים משולמים כקרדיטים עם תוקף של 365 יום, מוענקים פעם אחת לכל חשבון, ותמיד מאומתים בשרת ברגע האיסוף. ::: ## כותרת הסיכום בראש העמוד תמונת מצב מהירה של המרחק שעברתם. ![סיכום ההישגים — טבעת ההשלמה, מספר ההישגים שנפתחו והקרדיטים שנצברו](pathname:///img/screenshots/he/product/achievements/achievements-hero.png) | רכיב | מה הוא מציג | | --- | --- | | **טבעת ההשלמה** | מד התקדמות מעגלי עם אחוז במרכז — כמה מסך ההישגים פתחתם. | | **נפתחו** | ספירה כמו `7 / 26` — הישגים שנאספו מתוך הסך הזמין. | | **קרדיטים שנצברו** | הסכום המצטבר של הקרדיטים שאספתם מהישגים עד כה. | | **שורת הודעה** | תזכורת קצרה שאלה קרדיטים חינם, תקפים לשנה מרגע האיסוף. | ## ארבעת המדורים מתחת לכותרת, ההישגים מקובצים לפי מצב כדי שתמיד תדעו איפה להסתכל. כל מדור מופיע רק כשיש בו לפחות הישג אחד, ומציג ספירה לצד הכותרת שלו. ![ארבעת מדורי המצב — מוכן, בתהליך, נאסף, בקרוב](pathname:///img/screenshots/he/product/achievements/achievements-sections.png) | מדור | נקודה צבעונית | מה נמצא בו | אפשר לפעול? | | --- | --- | --- | --- | | **מוכן לאיסוף** | ירוקה | הרווחתם אותם — הפרס ממתין. | ✅ זהו המדור היחיד עם כפתור **איסוף**. | | **בתהליך** | כחולה | עדיין לא הורווחו. מציג סרגל התקדמות וספירת `נוכחי / יעד` היכן שרלוונטי. | אין כפתור — המשיכו להשתמש ב‑Teloring כדי למלא את הסרגל. | | **נאסף** | סגולה | כבר נתבעו. מציג את התאריך שבו אספתם כל אחד. | אין מה לעשות — הקרדיטים כבר ביתרה שלכם. | | **בקרוב** | אפורה | הישגים כמצייני מקום ליכולות שעדיין בבנייה. | לא ניתנים לאיסוף עדיין — ראו [הישגים שיגיעו בקרוב](#coming-soon-achievements). | :::note מדור **בתהליך** ממוין כך שההישגים הקרובים ביותר להשלמה מופיעים ראשונים — אלה שאתם עומדים לפתוח עולים לראש. ::: ## מבנה של שורת הישג כל הישג הוא שורה אופקית אחת, בעיצוב של סרגל גביע בקונסולת משחקים. ![שורת הישג בודדת, עם תוויות](pathname:///img/screenshots/he/product/achievements/achievements-row.png) | חלק | מה זה | | --- | --- | | **סמל** | תג אימוג'י שמייצג את ההישג. | | **סרגל התקדמות** (המילוי הרחב) | המילוי הצבעוני מראה כמה אתם קרובים. הוא ריק כשההישג נעול, מלא חלקית בזמן התקדמות, ומלא לגמרי כשהוא מוכן או נאסף. | | **כותרת** | שם ההישג. | | **תגית הפרס** | הקרדיטים שתקבלו, למשל `+150 קרדיטים`. הישגים מוסתרים מציגים `?` במקום. | | **תיאור** | שורה בשפה פשוטה שמסבירה בדיוק איך להרוויח אותו. | | **ספירת `נוכחי / יעד`** | ליעדים שניתנים למדידה (למשל סגירת 500 שיחות) מוצגת ההתקדמות החיה שלכם, כמו `120 / 500`. | | **צד הפעולה** | משתנה לפי המצב — כפתור **איסוף**, חותמת **נאסף ✓** עם תאריך, ערך **%**, תווית **בקרוב**, או **?** לאתגרים מוסתרים. | ### מה צד הפעולה אומר | מצב | משמעות | | --- | --- | | כפתור **איסוף** | הורווח ומוכן — לחצו כדי לתבוע את הקרדיטים שלכם. | | **נאסף ✓** + תאריך | כבר נתבע בתאריך המוצג. | | **אחוז** (למשל `40%`) | בתהליך — כמה התקדמתם. | | **בקרוב** | מציין מקום להישג שיגיע; אינו זמין עדיין. | | **?** | אתגר מוסתר (ראו [הביצה המוסתרת](#the-hidden-easter-egg)). | ## איסוף פרס 1. אתרו הישג במדור **מוכן לאיסוף**. 2. לחצו **איסוף**. 3. חלון חגיגה קופץ ומאשר את ההישג ואת הקרדיטים שהוענקו. 4. הקרדיטים מתווספים מיד ליתרה שלכם, וההישג עובר למדור **נאסף**. ![חלון החגיגה שמוצג אחרי איסוף פרס](pathname:///img/screenshots/he/product/achievements/achievements-celebrate.png) :::tip אין קנס על המתנה, אבל זכרו שהקרדיטים מתחילים את הספירה לאחור של **365 הימים** ברגע האיסוף. אם אינכם עומדים להשתמש בהם בקרוב, בסדר גמור להשאיר פרס במצב "מוכן" עד שתצטרכו אותו. ::: :::caution אם שני נציגים באותו חשבון לוחצים **איסוף** על אותו הישג באותו רגע, רק אחד יצליח — הפרס מוענק **פעם אחת לכל חשבון**. הלחיצה השנייה תציג "כבר תבעתם את ההישג הזה", וזה צפוי. ::: ## רשימת ההישגים המלאה הנה כל הישג, מה נדרש כדי להרוויח אותו, והפרס שלו. הפרסים המוצגים הם ברירות המחדל — לחשבון יכולים להיות סכומי פרס מותאמים שנקבעו על ידי Teloring. ### הקמה והגדרה | סמל | הישג | איך מרוויחים | פרס | | --- | --- | --- | --- | | 📞 | **הצלצול הראשון** | חברו את ערוץ ה‑WhatsApp הראשון שלכם. | 40 | | 🌐 | **טירון אומני‑ערוצי** | חברו 3 *סוגי* ערוצים שונים (למשל WhatsApp + אימייל + טלגרם). | 50 | | 📚 | **ידע זה כוח** | העלו את המסמך הראשון שלכם למאגר הידע. | 30 | | ⚡ | **דחיפת אוטומציה** | צרו את תהליך האוטומציה הראשון שלכם בסטודיו. | 25 | | 🧱 | **בונה CRM** | צרו את סוג האובייקט המותאם הראשון שלכם ב‑CRM. | 150 | | 🚀 | **אנחנו באוויר!** | חברו וידג'ט צ׳אט באתר שלכם **וגם** קבלו בו את ההודעה הראשונה. | 100 | ### הגדלת הצוות והשימוש | סמל | הישג | איך מרוויחים | פרס | | --- | --- | --- | --- | | 🪑 | **מרחיב מושבים** | הגיעו ל‑3 נציגים בסך הכול בחשבון (אתם + 2 נוספים). | 150 | | 👥 | **שחקן קבוצתי** | הגיעו ל‑5 נציגים מחוברים בו‑זמנית. | 300 | | 🔥 | **לוחם שבועי** | נציג כלשהו בחשבון מתחבר 7 ימים ברציפות. | 200 | | 🎓 | **אמן הידע** | העלו 50 מסמכים למאגר הידע. | 300 | | 🎨 | **יצירת מופת** | סגרו 500 שיחות. | 240 | | 🦉 | **ינשוף לילה** | סגרו שיחה ב‑3 לפנות בוקר לפי השעון המקומי שלכם. | 50 | | 📝 | **רשם הערות** | הוסיפו את ההערה הפנימית ה‑100 שלכם (לשונית "הערה" הפרטית בתוך שיחה). | 150 | | ✍️ | **חתום וחתום** | הגיעו ל‑10 מסמכים שנחתמו והושלמו על ידי לקוחות דרך חתימת מסמכים. | 150 | ### נאמנות וערך | סמל | הישג | איך מרוויחים | פרס | | --- | --- | --- | --- | | 💎 | **מאמין** | שדרגו ממסלול חינם לכל מסלול בתשלום. | 500 | | 🎂 | **יום הולדת שנה** | החשבון שלכם חוגג שנה. | 1,000 | | 🏆 | **3 שנות נאמנות** | החשבון שלכם חוגג 3 שנים. | 2,000 | | 🗝️ | **האספן** | פתחו 10 הישגים בעמוד הזה. | 250 | ### מבוססי AI | סמל | הישג | איך מרוויחים | פרס | | --- | --- | --- | --- | | 🤖 | **אמן AI** | תנו ל‑AI Copilot לעזור לכם (טיפים, הצעות, תובנות) ב‑10 שיחות. | 100 | | 🪄 | **לוחש ל‑AI** | ה‑AI סוגר באופן עצמאי 10 מהשיחות שלכם עם לקוחות. | 400 | | 😊 | **AI שמח** | סגרו 50 שיחות שבהן הלקוח הרגיש שמח. | 600 | | 🪃 | **בומרנג** | אותו לקוח חוזר 10 פעמים בתוך 3 חודשים. | 300 | :::note הישגי ה‑AI תלויים בעולם AI ארבעת הישגי ה‑AI מתקדמים רק כשהיכולת המתאימה **מופעלת** ב[עולם AI](/he/docs/product/ai-world): - **אמן AI** דורש ש‑**AI Copilot** יהיה מופעל — הוא סופר שיחות שבהן ה‑Copilot ייצר טיפ או הצעה. - **AI שמח** דורש ש**רגשות בשיחה** יהיו מופעלים — זה מה שרושם איך כל לקוח הרגיש. - **לוחש ל‑AI** דורש **נציג AI** שסוגר שיחות באופן עצמאי. אם היכולת המתאימה כבויה, ההישגים האלה יישארו על 0% ולא משנה כמה תשתמשו במערכת. ::: ### הישגים שיגיעו בקרוב {#coming-soon-achievements} אלה מוצגים כמצייני מקום **בקרוב**. הם מייצגים יכולות שעדיין אינן פעילות, ולכן **אי אפשר לאסוף אותם** — הם מוצגים כדי שתראו מה בדרך. | סמל | הישג | היעד המתוכנן | פרס | | --- | --- | --- | --- | | 💳 | **טעינה ראשונה** | בצעו את רכישת הטעינה הראשונה שלכם בכרטיס אשראי. | 100 | | 👑 | **מלך ההפניות** | הפנו לקוח חדש ל‑Teloring. | 250 | | 🔌 | **חוקר API** | בצעו את קריאת ה‑API הראשונה שלכם ל‑Teloring. | 100 | ## הביצה המוסתרת {#the-hidden-easter-egg} | סמל | הישג | פרס | | --- | --- | --- | | 🥚 | **ביצת פסחא** — *"יש ביצה מוסתרת איפשהו במערכת. תצליחו למצוא אותה?"* | 2,000 | הביצה המוסתרת היא הישג **סודי**. הוא אינו מציג יעד או סרגל התקדמות — רק `?` מסתורי — והוא נפתח רק כשאתם מגלים טריגר מוסתר איפשהו ב‑Teloring. הוא יושב עם ההישגים **בתהליך** עד שתמצאו אותו. :::tip המשיכו לחקור — הפרס הבודד הגדול ביותר בעמוד מוסתר בכוונה. 🥚 ::: ## כללים ואותיות קטנות - **איסוף אחד לכל חשבון.** כל הישג ניתן לאיסוף פעם אחת עבור כל העסק. הוספת נציגים נוספים אינה נותנת לכל אחד מהם עותק משלו. - **אפשר לאסוף רק את מה שהרווחתם.** כפתור **האיסוף** מופיע רק אחרי שהקריטריונים האמיתיים מתקיימים, והשרת בודק שוב ברגע הלחיצה. אין דרך לאסוף מוקדם. - **הקרדיטים פגים תוך שנה.** פרסים שנאספו הם קרדיטים תקפים ל‑365 יום מתאריך האיסוף. - **ההתקדמות יכולה לנוע לשני הכיוונים.** חלק מיעדי "בתהליך" תלויים בתנאים חיים — למשל, *שחקן קבוצתי* דורש 5 נציגים **מחוברים בו‑זמנית**, ו*לוחם שבועי* דורש רצף התחברויות ללא הפסקה. אם התנאי יורד, הסרגל משקף את המציאות הנוכחית עד שתעמדו בו שוב. - **Teloring יכולה להתאים פרסים.** סכום הקרדיטים לכל הישג ניתן להתאמה לכל חשבון על ידי Teloring, ולכן מה שאתם רואים עשוי להיות שונה מברירות המחדל שלמעלה. ## שאלות נפוצות **עשיתי את הדבר, אבל ההישג עדיין מציג "בתהליך". למה?** כמה בדיקות תלויות בנתוני רקע או בכך שיכולת מסוימת מופעלת: - **הישגי AI** (אמן AI, ‏AI שמח, לוחש ל‑AI) מתקדמים רק כשהמתג המתאים מופעל ב[עולם AI](/he/docs/product/ai-world). - **רשם הערות** סופר הערות פנימיות מכאן והלאה; הערות ותיקות מאוד שנוצרו לפני היכולת הזו עשויות שלא להיספר. - **ינשוף לילה** בודק את השיחות שסגרתם לאחרונה — סגרו אחת ב‑3 לפנות בוקר והוא יירשם. אם הכול נראה תקין והוא עדיין לא התעדכן לאחר זמן קצר, רעננו את העמוד. **האם קרדיטים מהישגים עובדים כמו קרדיטים בתשלום?** כן — הם נכנסים לאותה יתרה ומוצאים באותו אופן. ההבדל היחיד הוא שהם חינם ונושאים תוקף של 365 יום מרגע האיסוף. **האם נציג יכול לאבד הישג שהחשבון כבר אסף?** לא. לאחר האיסוף, הוא נשאר במדור **נאסף** לצמיתות והקרדיטים כבר שלכם. --- ## עמודים קשורים - [עולם AI](/he/docs/product/ai-world) — הפעילו את יכולות ה‑AI שמניעות את הישגי ה‑AI. - [טבעת הערוצים — תיבות](/he/docs/product/ring/overview) — חברו ערוצים עבור *הצלצול הראשון* ו*טירון אומני‑ערוצי*. - [סטודיו](/he/docs/product/studio) — בנו את האוטומציה עבור *דחיפת אוטומציה*. - [CRM](/he/docs/product/crm) — צרו סוג אובייקט מותאם עבור *בונה CRM*. --- # מאגר ידע מקור: https://docs.teloring.com/he/docs/product/knowledge-base Markdown: https://docs.teloring.com/he/markdown/docs/product/knowledge-base.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z **מאגר הידע** הוא המקום שבו אתם מלמדים את ה‑AI של Teloring על *העסק שלכם*. אתם מעלים קבצים ואתרים, Teloring קוראת ומאנדקסת אותם, ואז כל אחד (אדם או ה‑AI) יכול לשאול שאלה בשפה חופשית ולקבל תשובה שנבנתה **אך ורק** מהתוכן שסיפקתם — לעולם לא מהאינטרנט הפתוח ולעולם לא מהידע הכללי של ה‑AI. חשבו על זה כעל ספרייה פרטית שניתנת לחיפוש עבור החשבון שלכם. צוות תמיכה יכול לטעון מדריכי מוצר, מחירונים, מדיניות ומאמרי עזרה; ואז נציג (או ה‑AI Copilot) שואל "מה חלון ההחזרה לפריטים פגומים?" ומקבל את התשובה המדויקת, עם הפניה למסמך שממנו היא הגיעה. פתחו את **מאגר הידע** ממדור **כלים** בסרגל הצד (סמל הספר 📖, לצד עולם AI). ![עמוד מאגר הידע עם מאגר נבחר — פאנל הרשימה, פאנל ראשי עם נתונים, העלאה, מקורות ותיבת השאלה](pathname:///img/screenshots/he/product/knowledge-base/kb-overview.png) ## עובדות מרכזיות | עובדה | משמעות | | --- | --- | | התשובות מגיעות רק מהתוכן שלכם | ה‑AI מונחה להשתמש **אך ורק** בקבצים ובעמודים שהעליתם. אם התשובה אינה בתוכן שלכם, הוא אומר זאת — הוא לעולם אינו ממציא משהו מהרשת. | | מבודד לחשבון | מאגר ידע וכל מה שבתוכו שייכים לחשבון אחד. עסק א׳ לעולם אינו יכול לראות את התוכן של עסק ב׳. | | כמה מאגרי ידע | אפשר ליצור כמה מאגרי ידע נפרדים שתרצו — למשל אחד ל*תמיכה*, אחד ל*מכירות*, אחד ל*משאבי אנוש* — וכל אחד נחפש בנפרד. | | מופעל על ידי AI | כל מסמך שמועלה נקרא, מפוצל לחלקים קטנים והופך לצורה שניתנת לחיפוש, כדי שה‑AI ימצא את החלקים הרלוונטיים ביותר *בתוכן שלכם* לכל שאלה. | | קבצים **וגם** אתרים | העלו מסמכים (PDF, Word, Excel, טקסט, CSV, תמונות) או הפנו את Teloring לעמוד אינטרנט — אופציונלית עם סריקת העמודים הפנימיים שלו. | | העיבוד קורה ברקע | לאחר ההעלאה, Teloring ממשיכה לעבוד בזמן שאתם ממשיכים בשלכם. כל מקור מציג סטטוס חי (מעבד ← מוכן) והעמוד מתעדכן מעצמו. | | דורש שיכולת ה‑AI תהיה מופעלת | מאגר הידע נפתח על ידי המתג **מאגר ידע** ב[עולם AI](/he/docs/product/ai-world). כל עוד הוא כבוי, העמוד מציג הודעת "היכולת מושבתת". | | מזין את ה‑AI Copilot | ברגע שיש במאגר ידע תוכן, נציגים יכולים להפנות אליו את [ה‑AI Copilot](/he/docs/getting-started/conversations#ai-copilot) כדי לענות על שאלות לקוחות בשיחה חיה. | ## מי משתמש במאגר הידע | תפקיד | שימוש אופייני | | --- | --- | | מנהלי חשבון | מפעילים את היכולת בעולם AI, יוצרים מאגרי ידע ומחליטים איזה תוכן נכנס. | | מנהלי צוותים | שומרים על התוכן מדויק ועדכני — מעלים מדיניות חדשה, סורקים מחדש אתרים שהשתנו, מסירים קבצים מיושנים. | | נציגים | שואלים שאלות כדי למצוא תשובות במהירות, ומאפשרים ל‑AI Copilot להסתמך על מאגר הידע בזמן התכתבות עם לקוחות. | | ה‑AI | ה‑AI Copilot ונציגי ה‑AI קוראים את מאגר הידע כדי לעגן את התשובות שלהם בתוכן המאושר שלכם. | ## לפני שמתחילים: הפעילו את היכולת עמוד מאגר הידע עובד רק כאשר יכולת **מאגר הידע** מופעלת ב[עולם AI](/he/docs/product/ai-world). - אם היא **מופעלת**, העמוד עובד כרגיל. - אם היא **כבויה**, תראו כרטיס "מאגר הידע מושבת" עם כפתור שמוביל להגדרות עולם AI. ![ההודעה "מאגר הידע מושבת" שמוצגת כשהיכולת כבויה בעולם AI](pathname:///img/screenshots/he/product/knowledge-base/kb-disabled.png) :::note רק **מנהלי חשבון** יכולים להפעיל את היכולת בעולם AI. אם העמוד נעול, בקשו ממנהל להפעיל אותה. ::: ## איך העמוד בנוי לעמוד שני אזורים: | אזור | מה יש בו | | --- | --- | | **פאנל הצד** | יצירת מאגר ידע חדש, ורשימת כל מאגרי הידע שלכם עם תג ספירה. | | **הפאנל הראשי** | כל מה שקשור למאגר הידע שבחרתם: נתונים סטטיסטיים, העלאה, טבלת המקורות ותיבת השאלה. | כשאתם פותחים את העמוד לראשונה — לפני שבחרתם מאגר ידע — הפאנל הראשי מציג הנחיה של "בחרו מאגר ידע". לחצו על מאגר ידע כלשהו ברשימה (או צרו אחד) כדי למלא את הפאנל הראשי. ## מאגרי ידע (פאנל הצד) **מאגר ידע** הוא ספרייה אחת של תוכן. רוב העסקים מחזיקים כמה — למשל ספריות נפרדות למחלקות או למוצרים שונים — כדי ששאלה תיענה רק מקבוצת המסמכים הרלוונטית. ### יצירת מאגר ידע בכרטיס **יצירה חדשה**: 1. הקלידו **שם מאגר ידע** (חובה, עד 200 תווים) — למשל `מסמכי תמיכה`. 2. אופציונלית הוסיפו **תיאור** — הערה קצרה על מה שהוא מכיל. 3. לחצו **יצירת מאגר ידע**. מאגר הידע החדש מתווסף לרשימה שלכם ונבחר אוטומטית, מוכן להעלאת תוכן. ### רשימת מאגרי הידע שלכם הכרטיס **מאגרי הידע שלכם** מציג כל מאגר ידע בחשבון, עם תג ספירה שמראה כמה יש. | רכיב | מה הוא עושה | | --- | --- | | שורה | לחצו עליה כדי לבחור את מאגר הידע הזה ולטעון את התוכן שלו לפאנל הראשי. הנבחר מודגש. | | שם ותיאור | מציגים את השם, ואת התיאור אם הוספתם. | | 🗑️ מחיקה (סמל פח) | מופיע בריחוף מעל שורה. מוחק את מאגר הידע **ואת כל התוכן שלו**. | :::warning מחיקת מאגר ידע מסירה את **כל** המקורות שלו וכל מה ש‑Teloring למדה מהם, לצמיתות. אין ביטול. תתבקשו לאשר קודם. ::: ## הוספת תוכן כל מה שאתם מוסיפים חי בתוך מאגר הידע **שנבחר כרגע**. בחרו אחד קודם, ואז השתמשו בכרטיס **העלאת קובץ**. ### העלאת קובץ | שיטה | איך | | --- | --- | | לחיצה | לחצו על אזור ההעלאה המקווקו ובחרו קובץ. | | גרירה ושחרור | גררו קובץ מהמחשב שלכם אל האזור המקווקו. | ![כרטיס ההעלאה — אזור הגרירה, שורת כתובת האתר ואפשרות סריקת העמודים הפנימיים](pathname:///img/screenshots/he/product/knowledge-base/kb-upload.png) **סוגי קבצים נתמכים:** PDF, ‏Word‏ (`.docx`), ‏Excel‏ (`.xlsx`), טקסט רגיל (`.txt`), ‏CSV ותמונות (`.jpg`,‏ `.png`,‏ `.gif`,‏ `.webp`). | כלל | פירוט | | --- | --- | | גודל מרבי | 50 MB לקובץ. | | מסמכי טקסט | הטקסט נקרא ומאונדקס כדי שאפשר יהיה לחפש בו. | | קובצי PDF סרוקים (ללא טקסט לבחירה) | כל עמוד נקרא כתמונה, כדי שה‑AI עדיין יוכל להבין אותו. | | תמונות | התמונה עצמה מובנת על ידי ה‑AI, כך שאפשר לשאול שאלות על מה שהיא מציגה. | ### הוספת כתובת אתר כדי להביא עמוד אינטרנט במקום קובץ: 1. הדביקו את הכתובת המלאה (שמתחילה ב‑`http://` או ב‑`https://`) בתיבת **הזינו כתובת אתר**. 2. אופציונלית סמנו **סרוק גם עמודים פנימיים באתר הזה** (ראו למטה). 3. לחצו **הוספת כתובת אתר**. Teloring מבקרת בעמוד, מחלצת את הטקסט הקריא שלו ומאנדקסת אותו. #### סריקת עמודים פנימיים כשאתם מסמנים **סרוק גם עמודים פנימיים באתר הזה**, Teloring אינה קוראת רק את העמוד האחד — היא מגלה עמודים אחרים ב**אותו אתר** וקוראת גם אותם (דרך מפת האתר והקישורים שבעמוד), **עד 20 עמודים**. כולם נשמרים תחת מקור אחד, ושם המקור מציג כמה עמודים נוספים נכללו (למשל `https://example.com (+7 עמודים)`). השתמשו בזה כדי לטעון מרכז עזרה שלם או מדור מוצר בצעד אחד, במקום להוסיף כל עמוד ידנית. ### בזמן שהתוכן מעובד ההעלאה מיידית, אבל הקריאה והאינדוקס קורים **ברקע**, כדי שלא תצטרכו לחכות. לאחר ההעלאה: - מופיעה הודעת סטטוס (*"מעבד ברקע… סטטוס המקור יתעדכן אוטומטית."*). - המקור החדש מופיע בטבלת המקורות במצב **מעבד**. - העמוד בודק עדכונים מעצמו כל כמה שניות ומחליף את הסטטוס ל**מוכן** (או ל**נכשל**) בסיום — בלי צורך לרענן. ## מקורות **מקור** הוא דבר אחד שהוספתם: קובץ או אתר. טבלת **המקורות** מציגה את כל מה שנמצא במאגר הידע שנבחר. ![טבלת המקורות עם קבצים ואתרים, הסוג, הסטטוס, מספר החלקים, התאריך והפעולות בכל שורה](pathname:///img/screenshots/he/product/knowledge-base/kb-sources.png) | עמודה | מה היא מציגה | | --- | --- | | **שם** | שם הקובץ, או כתובת האתר. שמות ארוכים מקוצרים; רחפו כדי לראות את השם המלא. | | **סוג** | סוג המקור — `pdf`,‏ `docx`,‏ `xlsx`,‏ `txt`,‏ `csv`,‏ `url`, או סוג תמונה. | | **סטטוס** | **מוכן** (מאונדקס וניתן לחיפוש), **מעבד** (עדיין נקרא — מוצג עם סמל טעינה), או **נכשל** (משהו השתבש). | | **חלקים** | לכמה חלקים ניתנים לחיפוש המקור הזה פוצל (ראו [איך זה עובד](#how-it-works)). מדד גס לכמות התוכן שהוא מחזיק. | | **תאריך** | מתי המקור נוסף. | | **פעולות** | כפתורים לכל שורה (למטה). | ### פעולות שורה | פעולה | מופיעה על | מה היא עושה | | --- | --- | --- | | 🔄 **סריקה מחדש** | מקורות אתר (URL) שאינם בעיבוד כרגע | קורא את האתר מחדש מאפס: מסיר את התוכן הישן ומביא את הגרסה הנוכחית. השתמשו בזה אחרי שהאתר משתנה. | | ✕ **מחיקה** | כל מקור | מסיר את המקור ואת כל מה ש‑Teloring למדה ממנו. תתבקשו לאשר. | :::tip אתרים משתנים עם הזמן. כשעמוד שהוספתם מתעדכן, השתמשו ב**סריקה מחדש** כדי שמאגר הידע ישקף את התוכן העדכני. קבצים אינם משתנים מעצמם, ולכן אין סריקה מחדש לקבצים שהועלו — מחקו והעלו מחדש אם המסמך עצמו השתנה. ::: ## נתונים סטטיסטיים שורת **הנתונים** נותנת בדיקת בריאות מהירה של מאגר הידע שנבחר. | נתון | משמעות | | --- | --- | | **סה"כ מקורות** | כמה קבצים ואתרים יש במאגר הידע הזה. | | **סה"כ חלקים** | המספר הכולל של חלקים ניתנים לחיפוש בכל המקורות. | | **חלקי טקסט** | חלקים שהגיעו מטקסט (מסמכים ועמודי אינטרנט). | | **חלקי תמונה** | חלקים שהגיעו מתמונות או מעמודי PDF סרוקים. נשאר 0 במאגר ידע של טקסט בלבד. | כפתור **מחיקת מאגר הידע** נמצא בפינה של הכרטיס הזה — הוא מסיר את מאגר הידע כולו (בדיוק כמו סמל הפח ברשימה). ## שאילת שאלה הכרטיס **שאלו שאלה** הוא המקום שבו אתם (או ה‑AI) שואלים את מאגר הידע. ![תיבת השאלה עם בוחר מודל ה‑AI, וכרטיס תשובה עם טקסט התשובה והמקורות שבהם השתמש עם ציוני התאמה](pathname:///img/screenshots/he/product/knowledge-base/kb-ask.png) 1. בחרו **מודל AI** (ראו את הטבלה למטה). 2. הקלידו את השאלה שלכם בשפה חופשית — בדיוק כפי שהייתם שואלים עמית. 3. לחצו **שאל** (או **Enter**; השתמשו ב‑**Shift + Enter** לשורה חדשה). ### בחירת מודל AI המודל קובע איך התשובה נכתבת וכמה עולה להריץ אותה. שלושתם עונים אך ורק מהתוכן שלכם — הם נבדלים במהירות, בעומק ובעלות. | מודל | מתאים ביותר ל | | --- | --- | | **Haiku (מהיר וזול)** | בירורים מהירים וישירים שבהם אתם רק צריכים את העובדה. | | **Sonnet (מאוזן)** | ברירת המחדל — איזון טוב בין איכות לעלות לרוב השאלות. | | **Opus (החזק ביותר)** | שאלות מורכבות שדורשות הסקה זהירה על פני כמה מסמכים. | ### התשובה כאשר ל‑AI יש תשובה, היא מופיעה בכרטיס מודגש עם: | חלק | מה הוא מציג | | --- | --- | | **טקסט התשובה** | התשובה, כתובה ב**אותה שפה** של השאלה שלכם (שאלו בעברית, תקבלו עברית; שאלו באנגלית, תקבלו אנגלית). | | **המודל והחלקים שבהם נעשה שימוש** | איזה מודל ענה, וכמה חלקים מהתוכן שלכם הוא קרא לשם כך. | | **מקורות שבהם נעשה שימוש** | צ׳יפ לכל מסמך שהתשובה הסתמכה עליו, עם **ציון התאמה** (עד כמה החלק הזה תאם לשאלה), ומספר עמוד כשלמקור יש עמודים. | ### כשאין תשובה אם שום דבר בתוכן שלכם אינו רלוונטי לשאלה, ה‑AI **אינו** מנחש. הוא משיב **"לא נמצא מידע רלוונטי."**. זה בכוונה: המשמעות היא שהתשובה באמת אינה במאגר הידע שלכם, כך שתוכלו לסמוך על כך שכל תשובה אמיתית הגיעה מהמסמכים שלכם. (לשימושים אוטומטיים, מקרה ה"לא נמצא" מוחזר כאיתות נקי שנציג AI יכול לפעול לפיו.) ## איך זה עובד {#how-it-works} אינכם צריכים להכיר את המנגנון הפנימי כדי להשתמש בעמוד, אבל הסבר קצר עוזר גם לאנשים וגם ל‑AI להבין למה לצפות. 1. **קריאה** — ‏Teloring פותחת כל קובץ או עמוד אינטרנט ומחלצת את הטקסט שלו (או קוראת אותו כתמונה, עבור PDF סרוקים ותמונות). 2. **פיצול** — הטקסט מפוצל ל**חלקים** קטנים וחופפים, כך שכל חלק הוא קטע עצמאי בגודל נוח. 3. **אינדוקס** — כל חלק הופך ל"טביעת אצבע" מתמטית (הטמעת AI) שלוכדת את המשמעות שלו, ונשמר. 4. **חיפוש** — כשאתם שואלים שאלה, Teloring הופכת את השאלה לאותו סוג טביעת אצבע ומאתרת את החלקים שהמשמעות שלהם הקרובה ביותר. חלקים שאינם קרובים מספיק נדחים, כך שהתאמות חלשות אינן מזהמות את התשובה. 5. **תשובה** — החלקים הרלוונטיים ביותר מועברים למודל ה‑AI שבחרתם, שכותב תשובה בשפה פשוטה שמעוגנת אך ורק בחלקים האלה — ומספר לכם באילו מקורות השתמש. מכיוון שהחיפוש מבוסס על *משמעות* ולא על מילים מדויקות, שאלה כמו "כמה זמן יש לי להחזיר משהו?" עדיין יכולה למצוא מדיניות שאומרת "החזרות מתקבלות בתוך 30 יום". ## היכן עוד מאגר הידע משמש עמוד מאגר הידע הוא המקום שבו אתם **בונים ובודקים** את התוכן שלכם, אבל התמורה האמיתית היא שאותו תוכן מפעיל AI במקומות אחרים ב‑Teloring: | היכן | איך הוא משתמש במאגר הידע | | --- | --- | | [AI Copilot](/he/docs/getting-started/conversations#ai-copilot) | בשיחה חיה, נציג יכול להפנות את ה‑Copilot למאגר ידע ולשאול שאלה — ה‑Copilot עונה מהתוכן שלכם בלי לצאת מהשיחה. זה דורש ש‑**AI Copilot** יהיה מופעל ב[עולם AI](/he/docs/product/ai-world). | | נציגי AI | מענה AI אוטומטי יכול להסתמך על מאגר ידע כדי להשיב ללקוחות במידע המאושר שלכם. | שמירה על מאגרי ידע מדויקים משפרת ישירות את איכות תשובות ה‑AI האלה. ## מדריך הרכיבים מפה מהירה של כל פקד בעמוד. ### פאנל הצד | רכיב | שימוש | | --- | --- | | שדה **שם מאגר הידע** | שם למאגר ידע חדש (חובה, עד 200 תווים). | | שדה **תיאור** | הערה אופציונלית על מאגר הידע. | | כפתור **יצירת מאגר ידע** | יוצר את מאגר הידע ובוחר אותו. | | שורת מאגר ידע | בוחרת את מאגר הידע הזה. | | תג ספירה | מספר מאגרי הידע בחשבון. | | 🗑️ מחיקה בכל שורה | מוחקת את מאגר הידע ואת כל התוכן שלו (עם אישור). | ### פאנל ראשי — נתונים | רכיב | שימוש | | --- | --- | | **סה"כ מקורות / סה"כ חלקים / חלקי טקסט / חלקי תמונה** | ספירות לקריאה בלבד שמתארות את מאגר הידע שנבחר. | | כפתור **מחיקת מאגר הידע** | מוחק את מאגר הידע שנבחר ואת כל התוכן שלו (עם אישור). | ### פאנל ראשי — העלאה | רכיב | שימוש | | --- | --- | | אזור ההעלאה (תיבה מקווקוות) | לחצו או גררו קובץ כדי להוסיף מסמך או תמונה. | | שדה **הזינו כתובת אתר** | כתובת האינטרנט לקריאה. | | כפתור **הוספת כתובת אתר** | קורא ומאנדקס את העמוד. | | תיבת סימון **סרוק גם עמודים פנימיים** | קורא גם עמודים מקושרים באותו אתר, עד 20. | | שורת סטטוס | מציגה מעלה / מעבד / הושלם / נכשל. | ### פאנל ראשי — מקורות | רכיב | שימוש | | --- | --- | | טבלת המקורות | מציגה כל קובץ ואתר, עם סוג, סטטוס, מספר חלקים ותאריך. | | 🔄 סריקה מחדש (מקורות URL) | קורא מחדש אתר כדי לקלוט שינויים. | | ✕ מחיקה | מסירה מקור ואת התוכן שלו (עם אישור). | ### פאנל ראשי — שאלו שאלה | רכיב | שימוש | | --- | --- | | רשימת **מודל AI** | בחרו Haiku,‏ Sonnet או Opus. | | תיבת השאלה | הקלידו את השאלה (Enter לשליחה, Shift+Enter לשורה חדשה). | | כפתור **שאל** | שולח את השאלה. | | כרטיס התשובה | מציג את התשובה, את המודל והחלקים שבהם נעשה שימוש, ואת המקורות עם ציוני ההתאמה. | ## עבודה נכונה | המלצה | למה זה עוזר | | --- | --- | | פצלו תוכן למאגרי ידע ממוקדים | מאגר *תמיכה* ומאגר *מכירות* נותנים תשובות נקיות יותר מספרייה ענקית ומעורבבת. | | תנו לכל מאגר ידע שם ותיאור ברורים | מבהיר איזה מהם לבחור — ועוזר ל‑AI Copilot לבחור את הנכון. | | העלו את מקור האמת, לא תקצירים | ה‑AI יכול לענות רק ממה שנתתם לו, אז טענו את המדריכים, המדיניות והמחירונים האמיתיים. | | סרקו מחדש אתרים אחרי שהם משתנים | שומר על תשובות עדכניות. אחרת ה‑AI עונה מהגרסה הישנה. | | בדקו עם שאלות אמיתיות | שאלו את השאלות שהלקוחות שלכם באמת שואלים, וודאו שהתשובות והמקורות נראים נכון לפני שאתם מסתמכים על ה‑AI Copilot. | | הסירו מקורות מיושנים | מסמכים ישנים יכולים לייצר תשובות ישנות — מחקו את מה שכבר אינו נכון. | ## פתרון תקלות | בעיה | מה לבדוק | | --- | --- | | העמוד מציג "מאגר הידע מושבת" | המתג **מאגר ידע** כבוי ב[עולם AI](/he/docs/product/ai-world). בקשו ממנהל להפעיל אותו. | | מקור תקוע במצב **מעבד** | קבצים גדולים וסריקות אתר מרובות עמודים לוקחים יותר זמן. העמוד מתעדכן מעצמו; תנו לזה קצת זמן. אם הוא הופך ל**נכשל**, נסו שוב. | | מקור מציג **נכשל** | ייתכן שהקובץ פגום, מוגן בסיסמה, ריק, או שהאתר חסם גישה או שלא היה בו טקסט קריא. בדקו את הקובץ או הכתובת והוסיפו מחדש. | | התשובה היא "לא נמצא מידע רלוונטי" | התוכן באמת אינו במאגר הידע הזה. הוסיפו את המסמך הרלוונטי, בחרו את מאגר הידע הנכון, או נסחו מחדש את השאלה. | | התשובות נראות לא עדכניות | המסמך או האתר שמאחוריהן השתנו. **סרקו מחדש** את האתר, או מחקו והעלו מחדש את הקובץ. | | אתר הוסיף כמעט כלום | ייתכן שהעמוד טוען את התוכן שלו דינמית (דרך סקריפטים), ולא תמיד אפשר לקרוא זאת. נסו להוסיף כתובת עשירה יותר בתוכן, או העלו את המידע כקובץ במקום. | | ה‑AI Copilot אינו מצליח לענות ממאגר הידע | ודאו ש‑**AI Copilot** ו**מאגר ידע** מופעלים ב[עולם AI](/he/docs/product/ai-world), ושמאגר ידע עם תוכן נבחר עבור השיחה. | ## שאלות נפוצות **האם ה‑AI אי פעם יענה מהאינטרנט או מהידע שלו?** לא. הוא מונחה להשתמש רק בתוכן שהעליתם למאגר הידע שנבחר. אם התשובה אינה שם, הוא אומר "לא נמצא מידע רלוונטי". **האם עסקים אחרים יכולים לראות את התוכן שלי?** לא. כל מאגר ידע שייך לחשבון אחד ומבודד לחלוטין. הקבצים שלכם לעולם אינם עוברים לעסק אחר. **אילו שפות נתמכות?** אפשר להעלות תוכן ולשאול שאלות בעברית או באנגלית. התשובה חוזרת באותה שפה שבה שאלתם. **כמה מאגרי ידע או מקורות אפשר להחזיק?** אפשר ליצור כמה מאגרי ידע ולהוסיף לכל אחד מקורות רבים. קבצים בודדים מוגבלים ל‑50 MB, וסריקת אתר קוראת עד 20 עמודים פנימיים לכל כתובת. **האם אני חייב לחכות שקובץ יסיים להתעבד?** לא. ההעלאות מתעבדות ברקע והעמוד מעדכן את הסטטוס מעצמו. אפשר להמשיך לעבוד ולחזור כשהוא מציג **מוכן**. **מה ההבדל בין מקור לחלק?** **מקור** הוא דבר אחד שהוספתם (קובץ או אתר). **חלק** הוא קטע קטן שהמקור פוצל אליו לצורך חיפוש. מקור אחד הופך בדרך כלל לחלקים רבים. --- # מחסן קבצים מקור: https://docs.teloring.com/he/docs/product/files-warehouse Markdown: https://docs.teloring.com/he/markdown/docs/product/files-warehouse.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z **מחסן הקבצים** הוא מצאי רשומות הקבצים ברמת החשבון, שיכולות נתמכות ב‑Teloring רושמות בזמן שהצוות שלכם עובד. הוא מרכז במקום אחד קבצים מצורפים של לקוחות, קבצים שנציגים שלחו, הקלטות שיחה, מסמכים חתומים, הקלטות קול של סטודיו, תמונות טפסים ונכסים אחרים ששמורים. השתמשו בו כדי לענות על שאלות כמו: - כמה אחסון החשבון שלנו צורך? - אילו קבצים הגיעו מלקוחות? - אילו קבצים הצוות שלנו שלח? - מאיזו שיחה קובץ הגיע? - האם אפשר להוריד קובץ שמור? - אילו קבצים ישנים כדאי להסיר לצמיתות? פתחו את **מחסן הקבצים** ממדור **כלים** בסרגל הצד של Teloring. ![עמוד מחסן הקבצים המלא עם סיכומי החשבון, מסננים, סוגי קבצים מעורבים, קישורי שיחה ופקדי הורדה](pathname:///img/screenshots/he/product/files-warehouse/warehouse-overview.png) :::info מחסן הקבצים הוא **עמוד קטלוג וניהול**. הקבצים מגיעים אליו אוטומטית מחלקים אחרים של Teloring. העמוד אינו מעלה, אינו מציג תצוגה מקדימה, אינו משנה שמות, אינו מארגן בתיקיות ואינו משתף קבצים. ::: ## עובדות מרכזיות | עובדה | משמעות | | --- | --- | | ברמת החשבון | העמוד מציג קבצים שמורים של כל חשבון Teloring, ולא רק קבצים ששייכים לנציג המחובר. | | מצאי אוטומטי | קובץ מתווסף כשיכולת נתמכת ב‑Teloring שומרת אותו. אינכם מוסיפים קבצים מהעמוד הזה. | | החדשים תחילה | הקבצים מוצגים לפי תאריך השמירה, כשהחדשים ביותר בראש. | | 25 קבצים בעמוד | השתמשו ב**הקודם** וב**הבא** מתחת לטבלה כדי לנוע במצאי. | | החיפוש והמסננים פועלים יחד | קובץ חייב להתאים לחיפוש שם הקובץ, לכיוון ולקטגוריה שנבחרו כרגע. | | סיכומי הסיכום הם סיכומי חשבון | **סה"כ אחסון** ו**סה"כ קבצים** מתארים את כל החשבון. הם אינם משתנים כשאתם מסננים את הטבלה. | | קישורי השיחה תלויים בהקשר | קישור מופיע רק כאשר Teloring רשמה מזהה שיחת לקוח יחד עם הקובץ. | | הורדות מצ׳אט פנימי מוגנות | קבצים מצורפים מצ׳אט פרטי בין נציגים אינם ניתנים להורדה מהמחסן. פתחו במקום זאת את הצ׳אט הפנימי שבו הקובץ שותף. | | המחיקה לצמיתות | מחיקת קובץ מסירה את האובייקט השמור. אין סל מיחזור ואין ביטול. | | בידוד חשבונות | משתמש יכול להציג ולנהל רק את רשומות הקבצים ששייכות לחשבון שלו. | ## מי משתמש במחסן הקבצים | תפקיד | שימוש אופייני | | --- | --- | | נציגים | מוצאים קובץ מצורף, חוזרים לשיחת הלקוח שלו, או מורידים קובץ מותר. | | מנהלי צוותים | סוקרים את סוגי הקבצים שעוברים בחשבון ומסירים קבצים נבחרים שכבר אינם נחוצים. | | מנהלי חשבון | עוקבים אחרי סך האחסון, ובעת הצורך מוחקים כל קובץ שמור בחשבון. | :::warning זהו אחסון משותף של החשבון. הסרת קובץ עלולה להפוך אותו ללא זמין בשיחה, בהקלטה, בטופס, בתהליך החתימה או ביכולת אחרת שהשתמשה בו במקור. מחקו רק קבצים שאתם בטוחים שהעסק כבר אינו צריך. ::: ## איך קבצים מגיעים למחסן אין כפתור **העלאה** בעמוד הזה. הקבצים נרשמים אוטומטית כשיכולות נתמכות ב‑Teloring שומרות אותם. דוגמאות נפוצות: | מקור | דוגמה | | --- | --- | | שיחות עם לקוחות | תמונה, וידאו, הודעה קולית, מסמך או קובץ מצורף לאימייל שהתקבלו דרך מסלול רישום נתמך. | | תשובות של נציגים | קובץ נתמך שצורף לשיחה או לאימייל יוצאים. | | שיחות טלפון | שיחה נכנסת או יוצאת שהוקלטה. | | חתימת מסמכים | קובץ PDF שהושלם או נדחה, שנוצר בתהליך החתימה. | | סטודיו | קובץ WAV שהועלה כהקלטה קולית לאוטומציה. | | טפסים | לוגו, רקע או תמונת שאלה שהועלו בבונה הטפסים. | | הגדרות החשבון | לוגו עסקי שמור או נכס דומה של סביבת העבודה. | | צ׳אט פנימי | קובץ פרטי ששותף מנציג אחד לאחר. | לא כל אובייקט ב‑Cloud Storage הוא פריט במחסן. העלאות זמניות, ייצואים שנוצרו, תוכן מוטמע וקבצים שמשמשים רק בתהליך קצר‑מועד עשויים להישמר במקום אחר ולא להופיע כאן. ## מבנה העמוד לעמוד ארבעה אזורים מרכזיים: | אזור | מה יש בו | | --- | --- | | כותרת | שם העמוד, ההסבר, **סה"כ אחסון** ו**סה"כ קבצים**. | | מסננים | חיפוש שם קובץ, כיוון, קטגוריה ו**ניקוי מסננים**. | | סרגל הבחירה | מופיע אחרי שבוחרים שורה אחת לפחות, ומספק פעולות בחירה מרובה ומחיקה. | | טבלת הקבצים | שורה אחת לכל קובץ שמור, ואחריה פקדי חלוקה לעמודים כשיש תוצאות. | ## סיכום האחסון שני כרטיסים בראש העמוד מסכמים את מצאי המחסן המלא של החשבון. | כרטיס | מה זה אומר | | --- | --- | | **סה"כ אחסון** | סכום גדלי הקבצים שנרשמו. ‏Teloring מציגה אותו אוטומטית בבתים, ב‑KB, ב‑MB או ב‑GB. | | **סה"כ קבצים** | מספר רשומות הקבצים ששמורות עבור החשבון. | המספרים האלה אינם מכסת אחסון ואינם מראים כמה מקום נשאר. הם גם נשארים ברמת החשבון כשמחפשים או מסננים את הטבלה. למשל, סינון ל**תמונות** משנה את הטבלה אך לא את שני הכרטיסים. :::note הסיכום מבוסס על גדלי הקבצים שנרשמו ב‑Teloring. רשומה ותיקה ללא גודל שמור יכולה להיספר כקובץ בלי להוסיף לסכום האחסון המוצג. ::: ## חיפוש ומסננים ![מחסן הקבצים עם חיפוש חלקי בשם קובץ, כיוון נכנס, קטגוריית תמונה והשורות המסוננות שהתקבלו](pathname:///img/screenshots/he/product/files-warehouse/warehouse-filters.png) אפשר להשתמש בשלושת המסננים יחד. | פקד | מה הוא עושה | | --- | --- | | **חיפוש קבצים לפי שם…** | מאתר שמות קבצים שמכילים את הטקסט שאתם מקלידים. ההתאמה אינה רגישה לאותיות גדולות/קטנות. החיפוש רץ זמן קצר אחרי שאתם מפסיקים להקליד. | | **כל הכיוונים** | מציג כל כיוון. שנו ל**נכנס**, ל**יוצא** או ל**צ׳אט פנימי** כדי לצמצם את הטבלה. | | **כל הקטגוריות** | מציג כל קטגוריה. שנו ל**תמונה**, ל**וידאו**, ל**מסמך** או ל**אודיו** כדי לצמצם את הטבלה. | | **ניקוי מסננים** | מנקה את החיפוש ואת שתי הרשימות, חוזר לעמוד 1 ומנקה את בחירת הקבצים הנוכחית. | קובץ חייב להתאים לכל פקד פעיל. למשל, חיפוש של `חשבונית`, בחירה ב**נכנס** ובחירה ב**מסמך** מציגים רק מסמכים נכנסים ששם הקובץ השמור שלהם מכיל `חשבונית`. ### כיוון הכיוון מתאר איך הקובץ קשור לחשבון. | כיוון | משמעות | | --- | --- | | **נכנס** ↓ | הקובץ הגיע לעסק, למשל קובץ מצורף מלקוח או הקלטת שיחה נכנסת. | | **יוצא** ↑ | הקובץ יצא מהעסק או הוכן לשימוש יוצא, למשל קובץ מצורף של נציג, PDF חתום, הקלטת סטודיו או הקלטת שיחה יוצאת. | | **צ׳אט פנימי** ↔ | הקובץ פנימי לסביבת העבודה. זה כולל קבצים פרטיים בין נציגים ויכול לכלול נכסים שנוצרו ליכולות פנימיות של Teloring. | הכיוון אינו מספר לכם איזו תיבה או איזה נציג טיפלו בקובץ. השתמשו בקישור השיחה, כשהוא זמין, כדי לפתוח את הקשר הלקוח שלו. ### קטגוריה הקטגוריה מתארת את סוג התוכן הכללי. | קטגוריה | תוכן אופייני | | --- | --- | | **תמונה** | JPEG, PNG, GIF, WebP או תמונה שמורה אחרת. | | **וידאו** | MP4 או וידאו שמור אחר. | | **מסמך** | PDF, מסמך Office, גיליון אלקטרוני, קובץ טקסט, CSV או קובץ מצורף לאימייל. | | **אודיו** | הקלטה קולית, הודעה קולית או הקלטת WAV של סטודיו. | לחלק מהרשומות הייחודיות לספק או הוותיקות יכולה להיות קטגוריה אחרת, כמו הקלטת "לחץ ודבר". הקבצים האלה נשארים גלויים תחת **כל הקטגוריות**, גם אם אין להם בחירה נפרדת ברשימה. ## טבלת הקבצים כל שורה מייצגת רשומת מחסן אחת. | עמודה | מה היא מציגה | | --- | --- | | תיבת בחירה | מוסיפה או מסירה את הקובץ הזה מהבחירה המרובה הנוכחית. | | **תאריך** | מתי רשומת הקובץ נוצרה. הדפדפן מעצב את התאריך והשעה לפי האזור של המשתמש. | | **שם הקובץ** | השם המקורי השמור, עם סמל לקטגוריה שלו. שמות ארוכים מקוצרים; רחפו על השם כדי לראות אותו במלואו. | | **גודל** | הגודל שנרשם בבתים, ב‑KB, ב‑MB או ב‑GB. מקף פירושו שלא נרשם גודל חיובי. | | **כיוון** | **נכנס**, **יוצא**, **צ׳אט פנימי**, או הערך הגולמי ברשומה ותיקה. | | **קטגוריה** | הקטגוריה השמורה, כמו תמונה, וידאו, מסמך או אודיו. | | **שיחה** | קישור `#מזהה-שיחה` כשקיים הקשר של שיחת לקוח; אחרת מקף. | | **הורדה** | כפתור הורדה לקבצים מותרים, או מנעול לקובץ מצורף מוגן מצ׳אט פנימי. | הטבלה לקריאה בלבד, למעט בחירה, הורדה, ניווט לשיחה ומחיקה. כותרות העמודות הן תוויות, ולא כפתורי מיון. ## הורדת קובץ 1. אתרו את הקובץ לפי שמו, כיוונו או הקטגוריה שלו. 2. לחצו על סמל ההורדה בקצה השורה. 3. ‏Teloring יוצרת קישור הורדה פרטי וזמני ומבקשת מהדפדפן להוריד את הקובץ. הקישור שנוצר תקף לכשעה. יצירת קישור אינה הופכת את המחסן או את דלי האחסון לציבוריים. :::note הדפדפן שלכם יכול לפתוח חלק מסוגי הקבצים בלשונית חדשה במקום לשמור אותם מיד. השתמשו בפעולת **הורדה** או **שמירה בשם** של הדפדפן אם זה קורה. ::: ### קבצים נעולים מצ׳אט פנימי סמל מנעול פירושו שהקובץ הגיע מצ׳אט פנימי פרטי. אי אפשר להוריד אותו ממחסן הקבצים שברמת החשבון. ההגבלה הזו מונעת מנציג להשתמש בעמוד מצאי משותף כדי לשלוף קובץ מצורף משיחה בין נציגים שהוא אולי אינו משתתף בה. פתחו את הצ׳אט הפנימי המקורי כדי לצפות בקובץ עם הרשאות המשתתפים הנכונות. ## פתיחת השיחה הקשורה כשעמודת **השיחה** מכילה קישור: 1. לחצו על ה‑`#מזהה-שיחה`. 2. ‏Teloring פותחת את סביבת העבודה של השיחות. 3. כשמזהה הודעה נשמר יחד עם הקובץ, Teloring גם טוענת ומדגישה את ההודעה הספציפית הזו. זו הדרך המהירה ביותר להבין מי שלח קובץ של לקוח, למה הוא נשלח ומה קרה סביבו. מקף בעמודה יכול להיות תקין. למשל, לוגו עסקי, הקלטת סטודיו, תמונת טופס או קובץ מצ׳אט פנימי אינם שייכים לשיחת לקוח. גם רשומות קבצים ותיקות וחלק מהקבצים שנוצרו על ידי אינטגרציות עשויים להיות חסרי הקשר שיחה. ## בחירת קבצים אפשר לבחור קובץ אחד, את העמוד הנוכחי, או את כל מצאי החשבון. ![מחסן הקבצים עם כמה שורות מסומנות וסרגל הבחירה שמציג את מספר הנבחרים, בחירת הכול בעמוד, בחירת כל הקבצים ומחיקת הנבחרים](pathname:///img/screenshots/he/product/files-warehouse/warehouse-selection.png) | שיטת בחירה | איך זה עובד | | --- | --- | | שורה אחת או יותר | סמנו את תיבת הסימון בתחילת כל שורה. | | העמוד הנוכחי | סמנו את תיבת הסימון בכותרת הטבלה, או לחצו **בחירת הכול בעמוד הזה** בסרגל הבחירה. זה בוחר את השורות הגלויות בעמוד הנוכחי של 25 הקבצים. | | כל החשבון | בחרו קודם את העמוד הנוכחי, ואז לחצו **בחירת כל _N_ הקבצים** כשהאפשרות מופיעה. זה מחליף לבחירה ברמת החשבון. | סרגל הבחירה מציג את המספר שנבחר כרגע. בחירות שורה נשארות בתוקף בזמן שאתם עוברים בין עמודי תוצאות ובזמן שאתם משנים מסננים. :::warning **בחירת כל _N_ הקבצים** פירושה כל קובץ במחסן בחשבון — ולא רק השורות שתואמות לחיפוש או למסננים הנוכחיים. אם בכוונתכם להסיר רק תוצאות מסוננות, בחרו את השורות האלה אחת אחת. ::: כדי לבטל בחירה, הסירו את הסימון מהשורות שנבחרו. אם שורות שנבחרו מוסתרות על ידי מסנן או עמוד אחר, לחצו **ניקוי מסננים** או טענו מחדש את עמוד מחסן הקבצים כדי לאפס את הבחירה. ## מחיקת קבצים 1. בחרו את השורות הנדרשות. 2. לחצו **מחיקת הנבחרים** בסרגל הבחירה. 3. קראו את האישור בעיון. 4. לחצו **מחיקת הנבחרים** בחלון האישור. ![אישור המחיקה הצמיתה שמוצג אחרי בחירת קבצים במחסן הקבצים](pathname:///img/screenshots/he/product/files-warehouse/warehouse-delete-confirmation.png) לאחר המחיקה, Teloring טוענת מחדש את הטבלה ומחשבת מחדש את שני סיכומי החשבון. | מצב מחיקה | הרשאה והיקף | | --- | --- | | שורות שנבחרו | מוחקת את קובצי המחסן שנבחרו במפורש. זכרו שבחירה יכולה לכלול שורות שהועברו מעמוד או ממסנן אחר. | | כל החשבון | **למנהלי חשבון בלבד.** מוחקת כל רשומת קובץ ואובייקט שמור בחשבון, כולל קבצים שאינם מוצגים במסננים הנוכחיים. | :::danger אי אפשר לבטל מחיקה. היא מסירה את הקובץ השמור, ולא רק את השורה בטבלה הזו. הודעות ויכולות קיימות יכולות לשמור הפניה לקובץ שנמחק, אבל התוכן עצמו עלול להפסיק להיפתח, להתנגן או להיות זמין להורדה. ::: מחיקות מרובות נרשמות ביומן הלוגים של החשבון, עם מספר הקבצים שנמחקו, מספר הבתים שנמחקו והאם הפעולה כוונה לכל החשבון. ## חלוקה לעמודים מחסן הקבצים מציג 25 שורות בכל פעם. | פקד | שימוש | | --- | --- | | סיכום תוצאות | מציג את טווח השורות הנוכחי, למשל `1–25`. | | **הקודם** | פותח את העמוד הקודם. מושבת בעמוד 1. | | **הבא** | פותח את העמוד הבא. מושבת כאשר Teloring הגיעה לסוף התוצאות שהוחזרו. | שינוי מסנן או חיפוש מחזיר אתכם לעמוד 1. לחיצה על **ניקוי מסננים** גם מנקה את הבחירה שלכם. ## מדריך רכיבים מלא ### כותרת ומסננים | רכיב | שימוש | | --- | --- | | **סה"כ אחסון** | סיכום לקריאה בלבד של הבתים שנרשמו בכל החשבון. | | **סה"כ קבצים** | ספירה לקריאה בלבד של רשומות המחסן בכל החשבון. | | תיבת חיפוש | חיפוש חלקי בשם הקובץ, ללא רגישות לאותיות גדולות/קטנות. | | רשימת הכיוון | מסננת לנכנס, ליוצא, לצ׳אט פנימי או לכל הכיוונים. | | רשימת הקטגוריה | מסננת לתמונה, לוידאו, למסמך, לאודיו או לכל הקטגוריות. | | **ניקוי מסננים** | מאפסת את החיפוש, המסננים, מספר העמוד והבחירה. | ### טבלה | רכיב | שימוש | | --- | --- | | תיבת סימון בכותרת | בוחרת או מנקה את כל השורות בעמוד הנוכחי. | | תיבת סימון בשורה | בוחרת או מנקה קובץ אחד. | | סמל קטגוריה | רמז ויזואלי לתמונה, לוידאו, למסמך, לאודיו או לסוג קובץ אחר. | | תיאור שם מלא | רחפו על שם קובץ מקוצר כדי לקרוא את השם השמור. | | תג כיוון | מציג איך הקובץ קשור לחשבון. | | תג קטגוריה | מציג את קטגוריית התוכן השמורה. | | קישור שיחה | פותח את שיחת הלקוח הקשורה, וכשידוע — את ההודעה הספציפית. | | כפתור הורדה | מבקש כתובת חתומה זמנית ומוריד את הקובץ. | | סמל מנעול | מסביר שקובץ פרטי מצ׳אט פנימי אינו ניתן להורדה כאן. | ### בחירה ומחיקה | רכיב | שימוש | | --- | --- | | מונה נבחרים | מספר השורות שנבחרו, או סך קובצי החשבון במצב בחירה ברמת החשבון. | | **בחירת הכול בעמוד הזה** | בוחרת את כל השורות הגלויות בעמוד הנוכחי. | | **בחירת כל _N_ הקבצים** | מחליפה מבחירת העמוד הנוכחי לכל קובץ במחסן בחשבון. | | **מחיקת הנבחרים** | פותחת את אישור המחיקה הצמיתה. | | סגירת החלון (✕) | סוגרת את האישור בלי למחוק. | | **ביטול** | סוגר את האישור בלי למחוק. | | **מחיקת הנבחרים** באישור | מתחילה את המחיקה הצמיתה ומושבתת בזמן שהבקשה רצה. | ## עבודה נכונה | המלצה | למה זה עוזר | | --- | --- | | חפשו לפני שבוחרים | מקטין את הסיכוי לבחור בטעות קובץ עם שם דומה. | | השתמשו בקישור השיחה לפני מחיקה | מאשר את ההקשר העסקי והלקוחי של הקובץ. | | העדיפו בחירה פרטנית לניקוי מסונן | בחירה ברמת החשבון מתעלמת מהמסננים הפעילים. | | התייחסו להקלטות ולקובצי PDF חתומים כאל רשומות עסקיות | מדיניות השמירה, המשפטית או הרגולטורית שלכם עשויה לחייב אתכם לשמור אותם. | | שמרו על שמות קבצים מקוריים משמעותיים | חיפוש שם הקובץ הוא החיפוש הטקסטואלי היחיד במחסן. | | בדקו שוב את מונה הנבחרים | הבחירות יכולות להישמר כשאתם משנים עמודים או מסננים. | | הגבילו מחיקה ברמת החשבון לתחזוקה מתוכננת | היא מסירה קבצים שנוצרו על ידי יכולות רבות ושונות ב‑Teloring. | ## פתרון תקלות | בעיה | מה לבדוק | | --- | --- | | לא מוצגים קבצים | לחצו **ניקוי מסננים**. אם לחשבון אין קבצים רשומים, הטבלה מציגה בצדק **לא נמצאו קבצים**. | | כרטיסי הסיכום אינם תואמים לשורות המסוננות | צפוי: הכרטיסים תמיד מתארים את כל החשבון, בעוד שהמסננים משפיעים רק על הטבלה. | | קובץ מוכר חסר בחיפוש | ודאו את שם הקובץ השמור, נקו את מסנני הקטגוריה והכיוון, וחפשו עם חלק קצר יותר מהשם. אובייקטי אחסון זמניים או שאינם מאונדקסים אינם מופיעים במחסן. | | אין קישור לשיחה | ייתכן שהקובץ הוא נכס של סביבת העבודה, קובץ מצ׳אט פנימי, או רשומה ותיקה או שנוצרה באינטגרציה ללא הקשר שיחה שמור. | | עמודת ההורדה מציגה מנעול | הפריט הוא קובץ מצורף מוגן מצ׳אט פנימי. פתחו אותו מהשיחה הפנימית המקורית. | | ההורדה פותחת לשונית בדפדפן | השתמשו בפעולת השמירה של הדפדפן. חלק מהדפדפנים מציגים תצוגה מקדימה של תוכן נתמך במקום לשמור מיד. | | ההורדה אומרת שהקובץ אינו זמין | רשומת המחסן יכולה להישאר גם כשהאובייקט שמאחוריה הוסר או לא ניתן לקריאה. בקשו ממנהל לבדוק את מקור הקובץ. | | מחיקת **בחירת כל _N_ הקבצים** נדחית | מחיקת מצאי החשבון כולו דורשת תפקיד של מנהל. | | הטבלה ריקה אחרי מחיקת השורות האחרונות בעמוד | לחצו **ניקוי מסננים** כדי לחזור לעמוד 1 ולטעון מחדש את המצאי. | ## שאלות נפוצות **אפשר להעלות קובץ ממחסן הקבצים?** לא. העלו או צרו את הקובץ ביכולת של Teloring שמשתמשת בו, כמו שיחה, טופס, תהליך סטודיו, הגדרת חשבון או תהליך חתימה. **האם החיפוש קורא את תוכן המסמכים?** לא. הוא מחפש רק בשם הקובץ השמור. השתמשו ב[מאגר הידע](/he/docs/product/knowledge-base) כשאתם רוצים שה‑AI של Teloring יקרא ויענה על שאלות מתוכן המסמכים. **למה המסננים שלי לא שינו את סה"כ אחסון או סה"כ קבצים?** הכרטיסים תמיד מציגים סיכומים ברמת החשבון. המסננים חלים רק על הטבלה. **אפשר למיין לפי תאריך, גודל או שם?** לא. העמוד הנוכחי קבוע לחדשים תחילה; כותרות העמודות אינן אינטראקטיביות. **למה לקובץ אין שיחה?** חלק מהקבצים שייכים לחלקים אחרים של Teloring, וחלק מהרשומות הוותיקות או שנוצרו באינטגרציה אינן כוללות הקשר שיחה. מקף אינו בהכרח אומר שהקובץ שבור. **אפשר להוריד כאן קובץ מצורף מצ׳אט פנימי?** לא. פתחו את הצ׳אט הפנימי שבו הוא שותף, כדי ש‑Teloring תוכל להחיל את הרשאות המשתתפים של אותו צ׳אט. **האם מחיקת שורה רק מסתירה אותה מהמחסן?** לא. היא מסירה את הקובץ השמור עצמו ועלולה להפוך את התוכן ללא זמין בכל מקום שעדיין מפנה אליו. **האם עסק אחר ב‑Teloring יכול לראות את הקבצים שלנו?** לא. נקודות הקצה של המחסן ואיתור הקבצים מוגבלים לחשבון של המשתמש המחובר. --- # נציגים ונציגי AI מקור: https://docs.teloring.com/he/docs/product/agents Markdown: https://docs.teloring.com/he/markdown/docs/product/agents.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z עמוד **הנציגים** הוא ספריית החשבון של האנשים ושל פרופילי ה‑AI האוטונומיים שעובדים על שיחות עם לקוחות ב‑Teloring. השתמשו בו כדי: - להזמין חברי צוות אנושיים ולנהל את הגישה שלהם. - לבחור לכל אדם תפקיד, שפה, אבטחת התחברות וגישה קולית. - לאפשר לאנשים לאפס את הסיסמה שלהם או להעביר את אימייל ההתחברות שלהם — בבטחה, דרך התיבה שלהם. - לשלוח שוב הזמנות, להשבית גישה או למחוק פרופיל. - ליצור נציגי AI ולשלוט באיך הם מדברים, מה הם יודעים, מה הם אוספים ואיך הם מחזירים שיחה לאדם. פתחו **ניהול ← נציגים, צוותים ותפקידים ← נציגים** מסרגל הצד של Teloring. :::tip קיבוץ נציגים אחרי שהנציגים שלכם קיימים, קבצו אותם ל**[צוותים](./teams.md)** — *מכירות*, *תמיכה*, *חיובים* — כדי שאפשר יהיה לנתב שיחה לצוות שלם במקום לאדם אחד. הצוותים הם העמוד השני תחת **נציגים, צוותים ותפקידים**. שדה **המחלקה** בפרופיל של נציג *אינו* צוות. זו תווית טקסט חופשי לתצוגה ולחיפוש בלבד. ::: :::info בידוד חשבונות כל מה שבעמוד הזה שייך אך ורק לחשבון Teloring הנוכחי. נציג או נציג AI שנוצר כאן לעולם אינו גלוי בחשבון אחר. ::: ## נציגים אנושיים ונציגי AI במבט אחד שני הסוגים חיים באותה טבלה, אבל הם פועלים בצורה שונה מאוד. | | נציג אנושי | נציג AI | | --- | --- | --- | | מה זה | אדם שמתחבר ל‑Teloring. | פרופיל שיחה אוטונומי. אין אדם מאחוריו. | | התחברות | אימייל + סיסמה, עם אימות דו‑שלבי אופציונלי באימייל. | אין. אין אימייל, אין סיסמה. | | מה מגדירים | זהות, תפקיד, שפה, אימות דו‑שלבי, מחלקה, הערות, ערוץ קול. | זהות, סגנון כתיבה, ידע, כללים, מטרות, תוצאות, שעות פעילות. | | שיוך שיחה | נבחר בפקד **משויך ל**. | אותו פקד, מסומן בסמל רובוט. | | לאחר השיוך | האדם עונה בסביבת העבודה. | ‏Teloring פותחת סשן AI וה‑AI עונה להודעות נכנסות. | | כיבוי | **השבתה** (הפיך). | הגדרת **הסטטוס** של הפרופיל ל**לא פעיל**. | | מחיקה | כן, מנהל יכול למחוק את הפרופיל. | לא מהעמוד הזה — עדיין אין פעולת מחיקה. | | יכול להצטרף ל[צוות](./teams.md) | כן | כן | | נחשב "מחובר" | כן, כל עוד הוא מחובר ל‑Teloring. | **תמיד מחובר.** נציג AI הוא תוכנה, ולכן הוא לעולם אינו מתנתק. | :::info שתי משמעויות שונות של "מחובר" ההבחנה הזו חשובה ברגע שאתם משתמשים בצוותים, והיא בכוונה: - **שיוך אוטומטי בצוות** מתייחס לנציג AI כאל **מחובר תמיד**, כך שחבר AI יכול לקחת עבודה ב‑3 לפנות בוקר. השתמשו בכלל *רק נציגים אמיתיים* של צוות אם אינכם רוצים בכך. - **יכולות נוכחות** — הנקודה הירוקה בצ׳אט הצוות, מונה "נציגים מחוברים" בצ׳אט באתר, ותנאי **זמינות נציגים** בסטודיו — שואלות *"האם יש שם אדם?"* ולעולם אינן סופרות נציגי AI. ::: ## מי יכול לעשות מה כל חבר מחובר יכול לפתוח את העמוד ולקרוא את הספרייה. כל דבר שמשנה משהו נאכף בשרת. | פעולה | ההרשאה הנדרשת | | --- | --- | | לצפות בספרייה ולחפש בה | **נציגים ← צפייה** | | ליצור נציג אנושי או נציג AI | **נציגים ← יצירה** | | לערוך נציג או פרופיל נציג AI | **נציגים ← עדכון** | | לשנות גישה קולית לכל נציג | **נציגים ← עדכון** | | לשלוח שוב הזמנה | **נציגים ← עדכון** | | להפעיל או להשבית נציג אנושי | **נציגים ← עדכון** | | למחוק פרופיל של נציג | **נציגים ← מחיקה** | | לשנות הגדרות קול של החשבון | **טבעת הערוצים ← עדכון** | | לאפס את הסיסמה **שלהם** | ללא — תמיד מותר | | לאפס סיסמה של **מישהו אחר** | **נציגים ← עדכון** | | לשנות את אימייל ההתחברות **שלהם** | ללא — תמיד מותר | | לשנות את אימייל ההתחברות של **מישהו אחר** | **נציגים ← עדכון** | | לשייך שיחה לנציג אנושי או לנציג AI | **יכול לשייך שיחות** באותה תיבה | | ליצור, לערוך או למחוק [צוות](./teams.md) | **צוותים ← יצירה / עדכון / מחיקה** | ראו **[תפקידים והרשאות](./roles/overview.md)** כדי להבין איך אלה מוענקות. שני כללים חלים על כולם, בכל תפקיד: - אינכם יכולים להשבית או למחוק את **הפרופיל שלכם** כאן. - אף אחד — גם לא מנהל — אינו מקליד סיסמה או כתובת אימייל חדשה עבור מישהו אחר. שניהם תמיד עוברים דרך קישור חד‑פעמי שנשלח לתיבה של הנציג עצמו. ## סקירת העמוד ![עמוד הנציגים עם שורות של נציגים אנושיים ונציגי AI](pathname:///img/screenshots/he/product/agents/agents-overview.png) | רכיב | מה הוא עושה | | --- | --- | | **הוספת נציג AI** | מבקש שם, ואז יוצר את פרופיל ה‑AI ואת שורת הספרייה שלו. | | **הוספת נציג** | פותח את טופס ההזמנה של נציג אנושי. | | **סה"כ נציגים** | כל שורה בחשבון: אנשים פעילים, הזמנות ממתינות, פרופילים לא פעילים ונציגי AI. | | **נציגים פעילים** | שורות שדגל הפעילות הפנימי שלהן דלוק. זה כולל אנשים **ממתינים** ונציגי AI פעילים, ולכן זה יכול להיות גבוה ממספר התוויות הירוקות **פעיל**. קראו את עמודת הסטטוס לקבלת מצב ההצטרפות המדויק. | | **ערוץ קולי** | מתג ברמת החשבון לחיוג בדפדפן של Teloring. הוא חייב להיות דלוק לפני שאפשר להפעיל ערוץ קול עבור אדם מסוים. | | חיפוש | מסנן את הטבלה הטעונה לפי **שם, אימייל, טלפון או מחלקה**. הוא אינו מחפש תפקיד, סטטוס, אימות דו‑שלבי או תאריך יצירה. | | טבלת הנציגים | הספרייה והפעולות בכל שורה. | השינויים הם ברמת החשבון, והטבלה נטענת מחדש אחרי כל פעולה מוצלחת. ## להבין את הטבלה | עמודה | משמעות | | --- | --- | | שם | שם תצוגה, תיאור אופציונלי, תג **אתם** בשורה שלכם, ותג **AI** בשורות של AI. העיגול הצבעוני הוא האות הראשונה, בגוון שנגזר מהשם. | | אימייל | כתובת ההתחברות. שורות AI מציגות **ללא התחברות — נציג AI**. | | טלפון | אופציונלי, מידע בלבד בעמוד הזה. | | מחלקה | תווית טקסט חופשי כמו תמיכה או מכירות. לתצוגה ולחיפוש בלבד — לא [צוות](./teams.md). נציגי AI תמיד מתויקים תחת `AI`. | | תפקיד | ה[תפקיד](./roles/overview.md) שהאדם הזה מחזיק — אחד מהתפקידים של החשבון שלכם. שורות AI מציגות **נציג AI**, שזו תווית ולא תפקיד. | | אימות דו‑שלבי | האם המתג האישי של אותו אדם דלוק. שורות AI מציגות מקף. | | סטטוס | **פעיל**, **ממתין** או **לא פעיל**. | | נוצר | תאריך ושעת היצירה, בפורמט של הדפדפן שלכם. | | פעולות | ראו [פעולות שורה](#row-actions). | ### מה משמעות כל סטטוס | סטטוס | משמעות | האם הוא יכול להתחבר או לקבל עבודה? | | --- | --- | --- | | אדם **פעיל** | רשום ומופעל. | כן. | | אדם **ממתין** | הוזמן, אך עדיין לא בחר סיסמה. | ההתחברות חסומה. הפרופיל עדיין יכול להופיע בבוחרי שיוך, אז הימנעו משיוך עבודה לשורה ממתינה. | | אדם **לא פעיל** | מנהל השבית את הפרופיל. | התחברויות חדשות חסומות. | | נציג AI **פעיל** | מוכן לשיוך. | כן. | | נציג AI **לא פעיל** | סטטוס הפרופיל מושבת. | שיוכים חדשים נדחים. | :::warning השבתה אינה מוציאה מישהו החוצה ההשבתה חוסמת התחברויות חדשות, אבל היא **אינה** מסיימת סשן דפדפן שכבר פתוח. כשהגישה חייבת להיפסק מיד, בטלו גם את הסשנים של אותו אדם ב**הגדרות ← אבטחה והתחברות ← סשנים פעילים**. (מחיקת פרופיל *כן* מבטלת סשנים.) ::: ## פעולות שורה {#row-actions} הסמלים בקצה כל שורה משתנים לפי סוג השורה, הסטטוס שלה והתפקיד שלכם. ![סמלי פעולות בשורה של נציג אנושי](pathname:///img/screenshots/he/product/agents/agent-row-actions.png) | סמל | מופיע על | מה הוא עושה | | --- | --- | --- | | **עריכה** (עיפרון) | כל שורה | אנושי ← טופס הנציג. ‏AI ← עורך פרופיל ה‑AI. השמירה דורשת **נציגים ← עדכון**. | | **שליחה חוזרת של אימייל אישור** (מעטפה) | **נציגים ← עדכון**, על אדם **ממתין** | שולח הזמנה חדשה לשעה אחת ומבטל את הקישור הקודם. | | **איפוס סיסמה** (מנעול) | תמיד בשורה שלכם; בשורה של אחרים עם **נציגים ← עדכון** | שולח באימייל קישור חד‑פעמי לבחירת סיסמה חדשה. ראו [סיסמאות](#passwords). | | **שינוי אימייל** (מעטפה עם חץ) | תמיד בשורה שלכם; בשורה של אחרים עם **נציגים ← עדכון** | מתחיל שינוי של כתובת ההתחברות, שמאושר מהתיבה **הנוכחית**. ראו [שינוי אימייל התחברות](#change-a-sign-in-email). | | **השבתה / הפעלה** | **נציגים ← עדכון**, על מישהו אחר | מכבה או מדליק מחדש את הפרופיל. הפיך. | | **מחיקת נציג** (פח) | **נציגים ← מחיקה**, על מישהו אחר | מסיר את הפרופיל לצמיתות לאחר הקלדת `DELETE`. | איפוס סיסמה ושינוי אימייל הן שתי הפעולות שלעולם אינן דורשות הרשאה — כולם מקבלים אותן עבור השורה **שלהם**. הרחבה של כל אחת מהן למישהו אחר היא **נציגים ← עדכון**. :::note איפוס סיסמה אינו מופיע בשורה **ממתינה** — עדיין אין סיסמה לאפס. השתמשו במקום זאת ב**שליחה חוזרת של אימייל אישור**. ::: --- ## נציגים אנושיים ### הזמנת אדם 1. פתחו **ניהול ← נציגים**. 2. לחצו **הוספת נציג**. 3. מלאו שם ואימייל (שניהם חובה). 4. בחרו את התפקיד ואת שפת ברירת המחדל. 5. אופציונלית הוסיפו טלפון, מחלקה, תיאור, אימות דו‑שלבי והערות. 6. לחצו **יצירת נציג**. ![טופס הוספת נציג](pathname:///img/screenshots/he/product/agents/add-human-agent.png) Teloring יוצרת פרופיל **ממתין** ושולחת באימייל קישור חד‑פעמי להגדרת סיסמה. - הקישור תקף למשך **שעה** וניתן לשימוש **פעם אחת**. - עד שהאדם בוחר סיסמה, השורה שלו נשארת **ממתינה** וההתחברות חסומה. - לא נקבעת סיסמה בטופס הזה. אף אחד בחשבון לעולם אינו רואה או בוחר סיסמה של אדם אחר. - שליחת הזמנה חדשה מבטלת את קישורי ה**הזמנה** הקודמים שלא נוצלו. - אם שליחת האימייל נכשלת, הפרופיל עדיין נוצר. תקנו את הכתובת או את בעיית הדואר והשתמשו ב**שליחה חוזרת של אימייל אישור**. #### מדריך השדות | שדה | חובה | במה הוא שולט | | --- | --- | --- | | שם הנציג | כן | השם שמוצג בכל Teloring: שיוכים, הודעות, רשומות ביומן הלוגים, צ׳אט הצוות. | | אימייל | כן | כתובת ההתחברות. חייבת להיות ייחודית בכל Teloring. בעריכה היא לקריאה בלבד — העבירו אותה עם **שינוי אימייל**. | | טלפון | לא | מספר ליצירת קשר פנימי. פורמט מקומי או בינלאומי. | | תפקיד | לא | אחד מה[תפקידים](./roles/overview.md) של החשבון שלכם. הרשימה היא שלכם, ותיאור התפקיד מופיע מתחת כדי שתוכלו לאשר את הבחירה. ברירת המחדל היא תפקיד **Agent** של החשבון. | | מחלקה | לא | תווית טקסט חופשי, לתצוגה ולחיפוש בלבד. היא **אינה** יוצרת צוות, תור או קבוצת הרשאות. כדי לקבץ נציגים לניתוב, השתמשו ב‑**[צוותים](./teams.md)**. | | שפת ברירת מחדל | לא | אנגלית או עברית. קובעת את שפת סביבת העבודה של האדם ואת השפה של מיילי ההזמנה, האיפוס והאימות הדו‑שלבי שלו. | | תיאור | לא | שורה אחת על תחום האחריות של האדם, שמוצגת מתחת לשמו. | | אימות דו‑שלבי | לא | כשהוא מופעל, ההתחברות דורשת גם קוד שנשלח באימייל. | | שיטת אימות דו‑שלבי | לא | השאירו על **אימייל**. ראו [מה עדיין לא הושלם](#what-is-not-finished-yet). | | הערות | לא | הערות פנימיות. לעולם אינן מוצגות ללקוחות, אבל כל חבר שיכול לפתוח את הפרופיל יכול לקרוא אותן. | | ערוץ קול לנציג הזה | בעריכה בלבד | מפעיל את הסופטפון בדפדפן של האדם הזה, לאחר שערוץ הקול של החשבון פועל. | #### בחירת תפקיד רשימת ה**תפקידים** מכילה את התפקידים של החשבון שלכם. כל חשבון מתחיל בחמישה — **Owner**,‏ **Team Leader**,‏ **Marketing**,‏ **Agent** ו‑**Viewer** — ואפשר לשנות את שמם, את היקפם, לשכפל או למחוק כל אחד מהם למעט Owner. בחירת תפקיד קובעת את כל מה שהאדם יכול להגיע אליו: אילו עמודים, אילו תיבות, ומה מותר לו לעשות בכל אחת. קראו את התיאור מתחת לבוחר אם אתם לא בטוחים, או פתחו **ניהול ← נציגים, צוותים ותפקידים ← תפקידים והרשאות** כדי לראות את הרשת המלאה. | אם האדם הוא… | התחילו מ | | --- | --- | | נציג בקו הראשון שעונה ללקוחות | **Agent** | | מנהל תמיכה שאינו בעל החשבון | **Team Leader** | | עובד על קמפיינים, אוטומציות ודוחות | **Marketing** | | בעל עניין שרוצה רק לוחות בקרה | **Viewer** | | שותף בבעלות על סביבת העבודה | **Owner** | | כל דבר אחר | שכפלו את התפקיד הקרוב ביותר והתאימו אותו | ראו **[תפקידים והרשאות](./roles/overview.md)**. :::warning Owner היא גישה מלאה **Owner** יכול להגיע להכול, כולל חיובים ומחיקת חשבון, ואי אפשר לצמצם את ההרשאות שלו. תנו אותו רק לאנשים שבאמת מחזיקים בסביבת העבודה — אבל תנו אותו לפחות ל**שניים** מהם, כדי שאף אחד לעולם לא יינעל בחוץ. ::: ### עריכת אדם לחצו על העיפרון בשורה של נציג אנושי. אפשר לשנות שם, טלפון, תפקיד, מחלקה, שפת ברירת מחדל, תיאור, אימות דו‑שלבי, הערות וגישה קולית. שדה האימייל לקריאה בלבד כאן בכוונה — ראו למטה. ### סיסמאות {#passwords} סיסמאות נבחרות תמיד רק על ידי האדם עצמו, מקישור חד‑פעמי שנשלח באימייל. יש שלוש דרכים שבהן קישור כזה מונפק. | מסלול | מי מתחיל | השפעה על הסיסמה הנוכחית | | --- | --- | --- | | **הזמנה** (פרופיל חדש / שליחה חוזרת) | מנהל | עדיין אין סיסמה. | | **איפוס סיסמה — השורה שלי** | כל אחד, עבור עצמו | **ממשיכה לעבוד** עד שנבחרת החדשה, כך שאימייל שאבד או מתעכב אינו יכול לנעול אתכם בחוץ. | | **איפוס סיסמה — של מישהו אחר** | מנהל | **מפסיקה לעבוד מיד.** השתמשו בזה כשייתכן שהאישורים נפרצו. | | **שכחתם סיסמה?** בעמוד ההתחברות | כל אחד, בלי להתחבר | זהה לאיפוס עצמי. העמוד עונה באופן זהה בין אם הכתובת קיימת ובין אם לא, כך שאי אפשר להשתמש בו כדי לגלות למי יש חשבון. | כל אחד מהקישורים האלה: - תקף למשך **שעה** ועובד **פעם אחת**; - נשמר רק כגיבוב — הערך האמיתי קיים רק בתוך האימייל; - מבטל את שאר הקישורים שלא נוצלו של האדם **מאותו סוג** (כך שקישור סיסמה חדש כבר אינו מבטל בשקט אישור לשינוי אימייל שממתין); - מפסיק לעבוד אם הפרופיל מושבת או אם הכתובת שלו משתנה בינתיים. בקשות לאיפוס סיסמה מוגבלות בקצב לכל כתובת IP, ובקשות חוזרות לאותה כתובת מווסתות, כך שאי אפשר להציף תיבה אחת. #### כללי הסיסמה סיסמה חדשה חייבת: - להיות באורך **8 תווים** לפחות (ולכל היותר 72 בתים); - להכיל אות **גדולה**; - להכיל אות **קטנה**; - להכיל **ספרה**; - להכיל **תו מיוחד** אחד — כל תו נראה שאינו אות או ספרה. רווחים אינם נחשבים. עמוד קביעת הסיסמה מציג את אותם כללים ובודק אותם תוך כדי ההקלדה. ### שינוי אימייל התחברות {#change-a-sign-in-email} כתובת ההתחברות היא זהות, ולכן העברה שלה היא בכוונה פעולה דו‑שלבית שמאושרת מהתיבה. 1. פתחו את השורה של האדם (או את טופס העריכה) ולחצו **שינוי אימייל**. 2. אשרו. ‏Teloring שולחת קישור אישור **לכתובת הרשומה כרגע** — לעולם לא לחדשה. 3. הנמען פותח את הקישור ומקליד שם את הכתובת החדשה, פעם אחת. 4. רק אז כתובת ההתחברות עוברת. ‏Teloring גם מיידעת את הכתובת הישנה שהיא כבר אינה אימייל ההתחברות. ![דיאלוג אישור שינוי אימייל](pathname:///img/screenshots/he/product/agents/change-email-modal.png) למה זה עובד כך: השליטה בתיבה הקיימת היא מה שמאשר את ההעברה. מנהל — או מישהו שחטף סשן בלוח הבקרה — אינו יכול להשתלט על הזהות של נציג בלי היכולת לקרוא את התיבה שהנציג כבר משתמש בה. הקישור תקף למשך **שעה**, לשימוש חד‑פעמי, ושום דבר אינו משתנה עד שהוא נפתח. ### אימות דו‑שלבי אימות דו‑שלבי אישי נפרד ממתג **אכיפת אימות דו‑שלבי לכל החברים** ברמת החשבון בהגדרות. נדרש קוד כאשר **אחד** מהשניים נכון: - מתג **האימות הדו‑שלבי** האישי של האדם דלוק; - הגדרת האכיפה ברמת החשבון דלוקה. הקוד נשלח באימייל, פג לאחר **5 דקות**, נשמר רק כגיבוב, ומוגבל בקצב ניסיונות. Teloring יכולה גם לבקש קוד כשמישהו מתחבר מדפדפן שהיא לא ראתה קודם, בהתאם להגדרת המכשיר החדש בחשבון שלכם. :::note השאירו את השיטה על **אימייל**. אפשר לשמור את האפשרות **WhatsApp**, אבל כל קוד עדיין נמסר באימייל. ::: ### ערוץ קול ערוץ הקול פועל בשתי רמות, ורמת החשבון קודמת. #### 1. ערוץ קול בחשבון כרטיס **הערוץ הקולי** מפעיל או מכבה את החיוג בדפדפן של Teloring עבור כל החשבון. - דורש **טבעת הערוצים ← עדכון**. - חייב להיות דלוק לפני שאדם כלשהו יכול לקבל אישורי קול. - כיבוי שלו עוצר פתיחה של סשני קול בחשבון. - הכרטיס הוא מתג יחיד. מגבלת השיחות המקבילות של החשבון קיימת בצד השרת ואינה ניתנת לעריכה כאן. #### 2. ערוץ קול לכל אדם פתחו את הפרופיל של אדם והשתמשו ב**ערוץ קול לנציג הזה**. כשאתם מפעילים אותו, Teloring: - מייצרת שלוחת SIP פרטית וסיסמה; - מצפינה את הסיסמה באחסון; - מקצה את השלוחה בשרת הקול של Teloring; - מאפשרת לחלון השיחות של אותו אדם לפתוח סשני קול. אם ההקצאה נכשלת, הפעולה מדווחת שגיאה והמתג חוזר לאחור. **איפוס אישורי הקול** מחליף את סיסמת ה‑SIP, מסיים את סשן הקול הנוכחי ומעדכן את השלוחה שהוקצתה. השתמשו בו אם ייתכן שהאישורים דלפו או שהסופטפון כבר אינו מצליח להירשם. :::note הפקדים האלה מיועדים ל**סופטפונים אנושיים בדפדפן**. נציגי AI לעולם אינם מקבלים אישורי SIP. ::: ### להשבית או למחוק? | בחרו | מתי | מה שורד | | --- | --- | --- | | **השבתה** | חופשה, השעיה, או שלב הפיך בתהליך עזיבה. | הכול. אפשר להדליק את הפרופיל מחדש. | | **מחיקת נציג** | הסרה לצמיתות, אחרי שהגישה והבעלות נבדקו. | שיחות, הודעות, רשומות ביומן הלוגים ושמות שכבר הועתקו לרשומות. | מחיקת פרופיל גם מבטלת את סשני לוח הבקרה של אותו אדם, קישורי הגדרת סיסמה פתוחים, מכשירים מהימנים וטוקני API אישיים. לפני שאתם מוחקים: 1. שייכו מחדש כל שיחה פתוחה שעדיין בבעלותו. 2. בדקו תהליכי סטודיו או תהליכים שנוקבים בשם אותו נציג. 3. **כבו קודם את ערוץ הקול** — מחיקת הפרופיל אינה מבטלת את הקצאת השלוחה הקולית. 4. קבלו את זה שההיסטוריה נשארת, בלי פרופיל חי מאחוריה. --- ## נציגי AI נציג AI מדבר עם הלקוח ישירות. אל תבלבלו אותו עם **AI Copilot**: - **נציג AI** מחזיק בשיחה ועונה ללקוח. - **AI Copilot** רק מייעץ לאדם בפאנל הצדדי. - הם לעולם אינם רצים על אותה שיחה בו‑זמנית. ### יצירת נציג AI 1. פתחו **ניהול ← נציגים**. 2. לחצו **הוספת נציג AI**. 3. הקלידו שם כשתתבקשו, ואשרו. 4. אתרו את השורה החדשה ולחצו על העיפרון שלה כדי לפתוח את עורך הפרופיל. 5. השלימו את הפרופיל **לפני** שאתם מפנים אליו לקוחות אמיתיים. יצירת השורה אינה מצרפת אותה לשום תיבה או שיחה. ### הפעלת נציג AI 1. פתחו שיחה פעילה. 2. פתחו את **משויך ל**. 3. בחרו את נציג ה‑AI (סמל הרובוט). 4. ‏Teloring פותחת סשן AI מ**תמונת מצב** של הפרופיל. 5. השיחה עוברת לתור **נציג AI**, אלא אם תהליך סטודיו עדיין מחזיק בה. 6. ה‑AI שולח את הברכה שלו כשמתאים ועונה להודעות נכנסות מכאן והלאה. מכיוון שכל סשן משתמש בתמונת מצב, עריכת פרופיל משנה רק סשנים **עתידיים**. שיחה שכבר רצה שומרת על ההגדרות שאיתן היא התחילה. :::warning הגדרת פרופיל ל**לא פעיל** חוסמת שיוכים חדשים אך **אינה** עוצרת סשן שכבר רץ. כדי לעצור אחד מיד, שייכו מחדש את השיחה לאדם או חזרה לתור ההמתנה. ::: ### עורך הפרופיל שמונה לשוניות, כפתור **שמירת פרופיל AI** אחד ששומר את כולן יחד. ![לשונית הזהות של נציג AI ושמונה לשוניות העורך](pathname:///img/screenshots/he/product/agents/ai-agent-identity.png) #### זהות | שדה | במה הוא שולט | | --- | --- | | שם | שם השולח שהלקוחות רואים, והשם בספרייה. | | תפקיד | נכנס להוראות של ה‑AI, למשל *מומחה שירות לקוחות*. | | מגדר | אומר ל‑AI באילו צורות התייחסות עצמית להשתמש בשפות עם מגדר. | | סטטוס | **פעיל** מאפשר שיוכים חדשים; **לא פעיל** חוסם אותם. השמירה גם מעדכנת את שורת הספרייה. | | אודות / ביוגרפיה | מסביר את תפקיד ה‑AI ואת העסק שהוא מייצג. חלק מההוראות. | | הערה פנימית | לצוות שלכם בלבד. לעולם אינה נשלחת למודל או ללקוח. | השתמשו בביוגרפיה כדי לתאר אחריות והקשר — לא כדי להקליד מחדש מאגר ידע שלם. #### קול ושפה "קול" כאן פירושו **סגנון כתיבה**. אין לזה קשר לשיחות טלפון. ![לשונית הקול והשפה של נציג AI](pathname:///img/screenshots/he/product/agents/ai-agent-voice.png) | שדה | במה הוא שולט | | --- | --- | | ערכת טון | ידידותי, מקצועי, קליל, רשמי, שובב, אמפתי או תמציתי. | | אורך התשובה | הנחיה לקצר, בינוני או ארוך — לא מגבלת תווים קשיחה. | | שפות מותרות | באילו שפות ה‑AI צריך לענות. החזיקו **Ctrl** (Windows) או **Command** (macOS) כדי לבחור כמה. אל תבחרו אף אחת כדי לתת לו לעקוב אחרי הלקוח. | | גילוי שמדובר ב‑AI | **תמיד**, **אם נשאל** או **לעולם לא**. "לעולם לא" אומר ל‑AI לא לתאר את עצמו כאוטומטי — בדקו זאת מול הכללים שחלים על העסק שלכם. | | חתימה | מתווספת להודעות AI כשהיא אינה כבר שם. | | הודעת ברכה | ההודעה הראשונה, שנשלחת בעת השיוך, אם השיחה לא בורכה כבר על ידי AI. | משתני ברכה: | משתנה | הופך ל | | --- | --- | | `{{customer_name}}` | שם הלקוח או איש הקשר, או "שלום" אם אינו ידוע. | | `{{agent_name}}` | שם נציג ה‑AI. | | `{{conversation_id}}` | מזהה השיחה הנוכחית. | :::note עברית, ערבית ואנגלית הן השפות ש‑Teloring יכולה לזהות באמינות בצד השרת. רוסית, ספרדית וצרפתית מעצבות את ההנחיה אך אינן נאכפות. ::: #### ידע ![לשונית הידע של נציג AI](pathname:///img/screenshots/he/product/agents/ai-agent-knowledge.png) | שדה | במה הוא שולט | | --- | --- | | מאגר ידע | באיזה מאגר ידע של החשבון מחפשים לפני כל תור של ה‑AI. | | מצב עיגון | עד כמה ה‑AI חייב להישאר בתוך מאגר הידע הזה. | | סף ביטחון | עד כמה קטע חייב להיות דומה כדי שיישלף. נמוך הוא הרחב ביותר, גבוה הוא המחמיר ביותר. | | הצגת ציטוטים | מבקש מהמודל לצטט מידע מעוגן. הנחיה, לא פורמט מובטח. | | מצב עיגון | השתמשו בו עבור | | --- | --- | | **מאגר ידע בלבד (מחמיר)** | תשובות מפוקחות או מבוקרות היטב. חייבים לבחור מאגר ידע לפני שאפשר לשמור. | | **מאגר ידע + שפה כללית** | מאגר הידע הוא מקור האמת, אבל ה‑AI רשאי לנסח בצורה טבעית. ברירת מחדל טובה. | | **עוזר פתוח** | תשובות רחבות יותר, עדיין מעדיף הקשר ממאגר הידע כשהוא קיים. | בנו ובדקו את [מאגר הידע](./knowledge-base.md) לפני שאתם עוברים למצב מחמיר. #### כללים ![לשונית הכללים של נציג AI](pathname:///img/screenshots/he/product/agents/ai-agent-rules.png) | שדה | במה הוא שולט | | --- | --- | | נושאים אסורים | נושאים מופרדים בפסיקים שה‑AI אינו רשאי לדון בהם. אם תשובה שנוצרה מכילה אחד מהביטויים המדויקים האלה, Teloring מחליפה אותה במשפט סירוב או מסירה. | | אין להבטיח | התחייבויות מופרדות בפסיקים שה‑AI אינו רשאי לתת, כמו הנחות או תאריכי אספקה שלא אושרו. | | הוראות התנהגות | כללי הפעלה בטקסט חופשי. שמרו אותם קצרים ולא סותרים. | | מקסימום תורות | **נאכף.** מספר תורות הלקוח המרבי לפני שהסשן מסתיים במגבלה. | | מקסימום דקות | **נאכף.** גיל הסשן המרבי, נבדק כשהודעה מעובדת. | | מקסימום הודעות AI רצופות | הנחיה בלבד — ראו [מה עדיין לא הושלם](#what-is-not-finished-yet). | שימו חומר עובדתי במאגר הידע, דרישות איסוף במטרה, וכאן רק כללי התנהגות אמיתיים. :::warning מסנן הנושאים האסורים מחליף תשובה לא בטוחה, אבל החלפת טקסט אינה מזיזה את השיחה. השאירו את סיבת ההסלמה **נושא אסור** מופעלת עם פעולת ניתוב אמיתית. ::: #### מטרה המטרה קובעת אם ה‑AI רק עונה, או גם אוסף מידע ל‑CRM שלכם. ![לשונית המטרה של נציג AI עם יעד שדה ב‑CRM](pathname:///img/screenshots/he/product/agents/ai-agent-goal.png) | מצב | משמעות | להשתמש? | | --- | --- | --- | | **מסירת מידע** | לענות ולעזור. ללא איסוף יזום. | כן — לפרופילים של מידע ותמיכה. | | **קבלת מידע** | מיועד לאיסוף בלבד. | **לא.** הוא אינו מפעיל איסוף (ראו למטה). | | **שניהם** | לענות ללקוח *וגם* לאסוף שדה חובה חסר אחד בכל פעם. | כן — זהו המסלול העובד לכל איסוף. | :::warning בחרו "שניהם" לאיסוף **קבלת מידע** אינו מגיע למצב האיסוף של סביבת הריצה, ולכן פרופיל שמוגדר אליו לעולם אינו מבקש את השדות שלכם. השתמשו ב**שניהם** בכל פעם שה‑AI צריך לאסוף נתונים. ::: ##### הוספת שדה לאיסוף 1. הגדירו את המצב ל**שניהם**. 2. לחצו **הוספת שדה**. 3. **גררו** שדה CRM מהבוחר אל תיבת **שדה היעד** בכרטיס. תיבת היעד היא לקריאה בלבד — הגרירה היא הדרך למלא אותה, והיא גם ממלאת את התווית, את המזהה הפנימי, את סוג הנתונים ואת ערכי הבחירה. 4. התאימו את התווית שהלקוח רואה אם תרצו. 5. בדקו את סוג הנתונים. 6. אופציונלית, כתבו שאלה לדוגמה. 7. קבעו את המתגים. 8. חזרו על כך לכל שדה. | מאפיין | משמעות | | --- | --- | | תווית | השם האנושי, שמשמש לניסוח שאלה טבעית. | | סוג נתונים | טקסט, מספר, אימייל, טלפון, תאריך, בחירה יחידה, בחירה מרובה, בוליאני או קובץ. | | שדה יעד | היכן התשובה נשמרת ב‑CRM. | | שאלה לדוגמה | אופציונלי. השאירו ריק וה‑AI ינסח שאלה משלו מהתווית ומהסוג. | | ערכים מותרים | עבור סוגי בחירה, הערכים המתקבלים. | | חובה | נספר לצורך "כל שדות החובה נאספו". | | לשאול שוב אם ידוע | האם ה‑AI רשאי לשאול שוב כשנראה שהערך כבר ידוע. הנחיה. | | לדרוס אם קיים | כבוי = לעולם אל תחליף ערך CRM שאינו ריק. מופעל = תשובה חדשה יכולה להחליף אותו. | יעדים נתמכים: - `customer.` - `contact.` - `conversation.custom_fields.` :::warning יעדים של אובייקטים מותאמים אינם נשמרים הבוחר מציג גם את האובייקטים המותאמים שלכם (עסקאות, משימות וכן הלאה) כ‑`object..`. סביבת הריצה של ה‑AI אינה כותבת אליהם. הישארו ביעדי לקוח, איש קשר ושיחה. ::: התשובות מאומתות (אימייל, טלפון, מספר, בוליאני וערכי בחירה) לפני השמירה, וכתיבות ללקוח ולשיחה מפעילות את אירועי השינוי הרגילים של סטודיו. :::note יעדי שיחה הם שדות מותאמים שלושת יעדי השיחה כותבים תחת `conversation.custom_fields`. יעד **עדיפות השיחה**, למשל, **אינו** משנה את פקד העדיפות האמיתי בכותרת השיחה. ::: ##### שני מוזרויות בבוחר שכדאי לעקוף - הקלידו את התווית **אחרי** גרירת היעד. הקלדה קודם יכולה להקפיא את המזהה המוסתר אחרי תו אחד. - כשכמה כרטיסי שדה פתוחים, גררו את שדה ה‑CRM בדיוק לכרטיס שאתם מתכוונים אליו; לחיצה עלולה לנחות על הכרטיס הראשון במקום. #### בהצלחה סשן יכול להסתיים בהצלחה כשהלקוח מאשר שהנושא נפתר, או כשכל שדות החובה נאספו והלקוח שותק עד לטיימר המעקב. ![לשונית "בהצלחה" של נציג AI](pathname:///img/screenshots/he/product/agents/ai-agent-on-success.png) | הגדרה | משמעות | | --- | --- | | כל שדות החובה נאספו | מאפשרת לאיסוף שהושלם להפוך להצלחה שקטה לאחר פסק הזמן למעקב. | | הלקוח אישר שנפתר | מאפשרת ל"הכול בסדר" או "תודה" ברור לסגור את הסשן. | | דוגמת הודעת סיום | הנחיה לטון ולכוונה. טקסט הסיום האמיתי נוצר מהשיחה ומשפת הלקוח. | | פעולה | מה קורה אחרי הודעת הסיום. | | פעולה | תוצאה | | --- | --- | | **סיום וסימון כטופל** | מסמנת את השיחה כטופלה ומנקה את השיוך. | | **ללא פעולה** | מסיימת את סשן ה‑AI ואינה משנה דבר נוסף. היזהרו: השיחה יכולה להישאר משויכת ל‑AI ללא סשן חי. | | **החזרה לתור ההמתנה** | מנקה את השיוך כדי שאדם יוכל לקחת אותה. | | **שיוך לנציג אנושי** | משייכת לאדם הפעיל שנבחר. אם אותו אדם כבר אינו תקף, היא הולכת לתור ההמתנה במקום. | #### בכישלון ![לשונית "בכישלון" של נציג AI](pathname:///img/screenshots/he/product/agents/ai-agent-on-fail.png) ##### הלקוח השתתק | הגדרה | משמעות | | --- | --- | | מעקב אחרי דקות | אחרי כל כך הרבה שקט, Teloring מייצרת ושולחת הודעת מעקב. 1–1,440 דקות. | | דוגמת הודעת מעקב | הנחיה עבור אותו מעקב. | | ויתור אחרי דקות נוספות | תקופת חסד אחרי המעקב. 1–1,440 דקות. | | דוגמת סיום ללא מענה | הנחיה להודעת הסיום שנשלחת לפני ביצוע הפעולה. | | פעולה | סימון כטופל, אי‑עשייה, החזרה לתור ההמתנה או שיוך לאדם. | אם כל שדות החובה כבר נאספו, הגעה לזמן המעקב נחשבת ל**הצלחה שקטה** במקום לנטישה. ##### הלקוח סירב או נתקע ה‑AI יכול לדווח שהלקוח אינו מוכן לספק את המידע, או שהאיסוף נכנס למעגלים. בחרו את הפעולה עבור התוצאה הזו. ##### סיבות הסלמה אפשר להגדיר שש סיבות: **ביקש נציג**, **כועס או מתוסכל**, **הזדמנות מכירה**, **סיכון נטישה**, **נושא אסור** ו**ביטחון נמוך**. עבור כל אחת, קבעו אם היא מופעלת, דוגמת הודעת מסירה אופציונלית, ופעולת הניתוב (עם יעד אנושי אם רלוונטי). :::warning מתג כיבוי אינו עוצר זיהוי כיבוי סיבה משבית את **מטפל המסירה** שלה, לא את היכולת של ה‑AI להגיע לתוצאה הזו. סיבה מושבתת יכולה לסיים את הסשן ללא ניתוב כלל. השאירו את הסיבות שחשובות לכם מופעלות, כל אחת עם פעולה מפורשת. ::: #### ערוצים ושעות הלשונית נקראת "ערוצים ושעות", אבל היום היא חושפת רק **שעות פעילות** ו**התנהגות מחוץ לשעות**. אין כאן שליטה לכל תיבה. ![לשונית הערוצים והשעות של נציג AI](pathname:///img/screenshots/he/product/agents/ai-agent-hours.png) | הגדרה | משמעות | | --- | --- | | אזור זמן | אזור זמן בתקן IANA כמו `Asia/Jerusalem` או `Europe/London`. ערך לא תקין נופל חזרה ל‑UTC. | | מתג יום | מסמן את היום הזה כיום פעילות. | | התחלה וסיום | מרווח פעילות אחד לאותו יום, כולל שני הקצוות. | שתי התנהגויות שכדאי להכיר: - **אם כל הימים כבויים, נציג ה‑AI נחשב זמין 24/7.** זה אינו אומר "סגור כל השבוע". - נתמך רק מרווח אחד באותו יום. טווח לילי כמו `22:00–06:00` אינו נחשב למשמרת לילה. | התנהגות מחוץ לשעות | תוצאה | | --- | --- | | לא להגיב | מדלג על תשובת ה‑AI המיידית מחוץ לשעות הפעילות. | | להגיב כרגיל | מריץ את תור ה‑AI הרגיל בכל מקרה. | | להגיב בהודעת "מחוץ לשעות" | שולח את הטקסט הקבוע שלכם למחוץ לשעות במקום תשובה שנוצרה. | :::warning משימת המעקב המתוזמנת אינה בודקת מחדש את שעות הפעילות. פרופיל שמוגדר ל**לא להגיב** עדיין יכול לשלוח מעקב מאוחר יותר, מחוץ לשעות. אל תסתמכו על זה כערובה לשקט מוחלט. ::: ### מה קורה במהלך סשן AI 1. מישהו משייך שיחה פתוחה לנציג AI פעיל. 2. ‏Teloring בודקת שהפרופיל פעיל ומצלמת אותו לתוך סשן. 3. ה‑AI מברך את הלקוח כשמתאים. 4. הודעות נכנסות מהלקוח הולכות לנציג ה‑AI במקום ל‑AI Copilot. 5. בכל תור Teloring מחפשת במאגר הידע, בונה את ההוראות ומריצה את המודל. 6. ה‑AI עונה, שומר שדה שהוגדר, או מדווח על תוצאה סופית. 7. ‏Teloring שולחת את טקסט המעקב, הסיום או המסירה שהפרופיל דורש. 8. הפעולה שהוגדרה מסמנת כטופל, מבטלת שיוך, משייכת לאדם או אינה עושה דבר. הודעות AI נושאות תג של נציג AI. בקשות למודל, פרטי שליפה, תשובות, כשלי ספק ונפילות לגיבוי נרשמים לצורך בדיקה על ידי מנהלי Teloring בכלים פנימיים. ### הגדרות מומלצות **נציג AI לתמיכה** 1. כתבו תפקיד וביוגרפיה ממוקדים. 2. בחרו רק שפות שהתוכן והצוות שלכם באמת תומכים בהן. 3. חברו מאגר ידע שנבדק. 4. התחילו ב**מאגר ידע + שפה כללית**. 5. הוסיפו התחייבויות אסורות וכמה כללי התנהגות קצרים. 6. השאירו את המצב על **מסירת מידע** (או **שניהם** אם הוא צריך לאסוף). 7. שלחו הצלחה ל**סיום וסימון כטופל**. 8. שלחו כישלון והסלמה לתור ההמתנה או לאדם שמנוטר. 9. קבעו שעות פעילות ובדקו את ההתנהגות מחוץ לשעות. 10. הריצו שיחת בדיקה מלאה לפני עלייה לאוויר. **נציג AI לאיסוף לידים** 1. מצב **שניהם**. 2. הוסיפו רק את השדות שהעסק באמת צריך. 3. השתמשו ביעדי לקוח, איש קשר או שיחה. 4. סמנו את הקריטיים כחובה. 5. כבו את **לדרוס אם קיים** עבור שדות שאסור להם להחליף נתונים מאומתים. 6. נתבו איסוף שהושלם לאדם, או סמנו כטופל — לפי מה שתואם לתהליך שלכם. --- ## קיבוץ נציגים לצוותים גם נציגים אנושיים וגם נציגי AI יכולים להיות מקובצים ל**[צוותים](./teams.md)** — העמוד השני תחת **נציגים, צוותים ותפקידים**. צוות מאפשר לשייך שיחה לקבוצה במקום לאדם אחד, והוא משנה מי יכול למשוך שיחה ממתינה עם **קבלת הבא בתור**: | | השפעה על העמוד הזה | | --- | --- | | חברות | נקבעת בעמוד **הצוותים**, לא בטופס הנציג. נציג יכול להיות בכמה צוותים. | | חברים אנושיים מול AI | שניהם מותרים. כלל **רק נציגים אמיתיים** של צוות מוציא נציגי AI ומסיר כאלה שכבר בו. | | שיוך אוטומטי | צוות יכול למסור שיחה לחבר **מחובר** אקראי. נציגי AI נחשבים מחוברים תמיד. | | השבתת נציג | הוא נשמט בשקט מהצוותים בפעם הבאה שצוות נשמר. | | מחיקת נציג | הוא מוסר מכל צוות אוטומטית. | **מחלקה אינה צוות.** זו תווית טקסט חופשי בפרופיל הנציג, לתצוגה ולחיפוש בלבד. חברות בצוות נקבעת בעמוד הצוותים. קראו את המדריך המלא: **[צוותים](./teams.md)**. --- ## מה עדיין לא הושלם {#what-is-not-finished-yet} אלו פערים אמיתיים, ולא דברים שאתם עושים לא נכון. תכננו סביבם. כל פריט למטה אומת מחדש מול הגרסה הנוכחית. | פריט | מה באמת קורה | עשו זאת במקום | | --- | --- | --- | | **שיטת אימות דו‑שלבי: WhatsApp** | נשמרת, אבל כל קוד נשלח באימייל. | השאירו על אימייל. | | הרמז **"אימות דו‑שלבי עדיין אינו פעיל"** מתחת למתג | טקסט מיושן. אימות דו‑שלבי באימייל עובד. | התעלמו מהרמז. | | מצב מטרה **קבלת מידע** ב‑AI | לעולם אינו מגיע למצב האיסוף של סביבת הריצה, ולכן שום דבר אינו נאסף. | השתמשו ב**שניהם**. | | יעדי מטרה של **אובייקטים מותאמים** ב‑AI‏ (`object..`) | מוצעים בבוחר; סביבת הריצה אינה כותבת אליהם. | השתמשו בלקוח, איש קשר או שיחה. | | יעדי **עדיפות / נושא / הערות** של שיחה | כותבים ל‑`conversation.custom_fields`, ולא לפקדי השיחה האמיתיים. | השתמשו בהם רק כנתונים מותאמים. | | סוג נתונים **קובץ** במטרה | שומר טקסט. שום דבר אינו מועלה או נרשם כקובץ ב‑CRM. | אספו קישור, או השתמשו בטופס או בקובץ מצורף. | | **מקסימום הודעות AI רצופות** | נכנס להנחיה בלבד. בשונה ממקסימום תורות ומקסימום דקות, שום דבר אינו אוכף אותו. | התייחסו לזה כרמז. | | מתג **כיבוי** של סיבת הסלמה | משבית את מטפל המסירה, לא את הזיהוי. הסשן יכול להסתיים ללא ניתוב. | השאירו את הסיבות הנחוצות מופעלות, כל אחת עם פעולה. | | גיבוי ההסלמה **"אחר"** | אינו בעורך, ומקודד קשיח לחוסר פעולה. | הגדירו את שש הסיבות הגלויות והימנעו ממסלולים ללא פעולה. | | **תיבות מותרות** לנציג AI | סביבת הריצה מכבדת את ההגדרה, אבל לעורך אין פקד עבורה והוא **מנקה אותה בכל שמירה**, כך שאי אפשר להשתמש בה. | שלטו במקום שבו ה‑AI רץ על ידי שיוך שלו רק שם. | | **לא להגיב** מחוץ לשעות | עוצר תשובות מיידיות; מעקבים מתוזמנים עדיין יוצאים. | אל תתייחסו לזה כשקט מוחלט. | | תיבת השם ב**הוספת נציג AI** | עדיין חלון בקשה רגיל של הדפדפן, בשונה מכל דיאלוג אחר בעמוד. | אין מה לעשות — זה עובד. | | הנתון **נציגים פעילים** | סופר גם אנשים ממתינים וגם נציגי AI פעילים. | קראו את עמודת הסטטוס למצב ההצטרפות האמיתי. | | אנשים **ממתינים** בבוחרי שיוך | הם פעילים מבחינה טכנית, ולכן אפשר לבחור בהם לפני שהם מסיימים להירשם. | אל תשייכו עבודה לשורה ממתינה. | | **השבתה** וסשנים פתוחים | חוסמת התחברויות חדשות בלבד; סשן פתוח ממשיך לעבוד. | בטלו גם את הסשנים שלו ב**הגדרות ← אבטחה והתחברות**. | | מחיקת אדם עם **ערוץ קול מופעל** | השלוחה הקולית אינה מבוטלת. | כבו קודם את ערוץ הקול, ואז מחקו. | | כרטיס **הערוץ הקולי** | הפעלה/כיבוי בלבד; מגבלת השיחות המקבילות היא בצד השרת בלבד. | בקשו מהתמיכה של Teloring לשנות את המגבלה. | | כפתורי ניהול למי שאינו מנהל | חלקם עדיין עשויים להיות מוצגים; השרת דוחה את השינוי. | בקשו ממנהל לבצע זאת. | | **מחיקת נציג AI** | אין פעולת מחיקה לשורה של נציג AI. | הגדירו את **הסטטוס** של הפרופיל ל**לא פעיל**. | מגבלות ייחודיות לצוותים מפורטות ב[מדריך הצוותים](./teams.md#limitations-and-what-to-watch-for). ## פתרון תקלות ### מישהו תקוע במצב ממתין - ודאו שהוא פתח את האימייל האחרון — ההזמנות תקפות ל**שעה**. - לחצו **שליחה חוזרת של אימייל אישור** כדי להנפיק קישור חדש (הישן מפסיק לעבוד). - בדקו סינון דואר זבל ושהכתובת מאויתת נכון. ### מישהו אינו מצליח להתחבר אחרי איפוס סיסמה אם **מנהל** איפס אותה, הסיסמה הישנה הפסיקה לעבוד מיד — עליו להשלים את הקישור החדש ביותר, שתקף לשעה. אם הוא איפס אותה **בעצמו**, הסיסמה הישנה עדיין עובדת עד שהוא מסיים. בכל מקרה, שליחת קישור חדש מבטלת את הקודם, אז ודאו שהוא משתמש באימייל האחרון. ### סיסמה חדשה נדחית היא חייבת לעמוד בכל חמשת הכללים: 8+ תווים, אות גדולה, אות קטנה, ספרה ותו מיוחד אחד. עמוד קביעת הסיסמה מציג איזה כלל נכשל. ### קישור שינוי האימייל אינו מגיע הוא נשלח לכתובת **הרשומה כרגע**, ולא לחדשה. ודאו שאותה תיבה נגישה. אם היא אינה נגישה, מנהל יכול ליצור את הפרופיל הנכון ולהשבית את הישן. ### נציג AI אינו מופיע ב"משויך ל" - ודאו שה**סטטוס** שלו פעיל. - טענו מחדש את השיחה אחרי שמירת הפרופיל. - ודאו שהשיחה עדיין פתוחה. ### נציג AI מתעלם משינויים ששמרתי זה עתה השיחה הרצה משתמשת בתמונת המצב מהרגע שהסשן שלה התחיל. שייכו אותה מחדש, או התחילו שיחה חדשה, כדי לקלוט את הפרופיל החדש. ### ה‑AI אינו אוסף שדה - השתמשו ב**שניהם**, לא ב**קבלת מידע**. - סמנו את השדה כ**חובה** אם חייבים לשאול עליו. - ודאו שהיעד מתחיל בלקוח, באיש קשר או בשיחה — לא באובייקט מותאם. - ודאו שהשיחה משויכת ל‑AI ושהסשן עדיין חי. ### ה‑AI אינו מצליח לענות ממאגר הידע - ודאו שנבחר מאגר ידע. - ודאו שיש בו מקורות שעובדו. - הורידו את סף הביטחון לשליפה רחבה יותר. - שאלו את אותה שאלה בעמוד מאגר הידע לצורך השוואה. - במצב מחמיר, הקשר חסר *אמור* להוביל לסירוב או לתשובה מוגבלת. ### אי אפשר להפעיל ערוץ קול עבור מישהו - הפעילו קודם את **הערוץ הקולי** של החשבון. - ודאו שהפרופיל פעיל. - אם ההקצאה מדווחת שגיאה, שרת הקול דורש טיפול לפני ניסיון נוסף. ## מדריכים קשורים - [צוותים](./teams.md) — קיבוץ נציגים וניתוב שיחות לצוות שלם. - [שיחות](../getting-started/conversations.md) — שיוך ותור נציגי ה‑AI. - [עולם AI](./ai-world.md) — מתגי ה‑AI Copilot ויכולות ה‑AI ברמת החשבון. - [מאגר ידע](./knowledge-base.md) — בנייה ובדיקה של מקורות מעוגנים. - [הגדרות](./settings.md) — אימות דו‑שלבי, אבטחה וביטול סשנים ברמת החשבון. - [תיבת שיחות טלפון](./ring/voice.md) — ערוצי קול והתנהגות שיחות. --- # צוותים מקור: https://docs.teloring.com/he/docs/product/teams Markdown: https://docs.teloring.com/he/markdown/docs/product/teams.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z **צוות** הוא קבוצת נציגים בעלת שם — *מכירות*, *תמיכה*, *חיובים*, *דוברי עברית*. ברגע שצוות קיים, אפשר לשייך שיחה ל**צוות כולו** במקום לבחור אדם אחד. זה פותר את הבעיה היומיומית עם שיוך לפי אדם: כדי לנתב שיחה הייתם צריכים לדעת מי עובד, מי פנוי ומי מטפל בנושא הזה. עם צוותים אתם מנתבים לפי *אחריות* — "זו שיחת מכירות" — ונותנים ל‑Teloring או לצוות עצמו להחליט מי באמת לוקח אותה. הצוותים הם **ברמת החשבון**. כל נציג רואה את אותם צוותים; אין רשימת צוותים לכל נציג. פתחו **ניהול ← נציגים, צוותים ותפקידים ← צוותים** בסרגל הצד. :::info בידוד חשבונות צוותים שייכים אך ורק לחשבון Teloring הנוכחי. צוות שנוצר כאן לעולם אינו גלוי בחשבון אחר, וצוות יכול להכיל רק נציגים מהחשבון הזה. ::: ## עובדות מרכזיות | עובדה | משמעות | | --- | --- | | צוות הוא קבוצת נציגים | גם נציגים אנושיים וגם נציגי AI יכולים להיות חברים. | | ברמת החשבון | לא אישי. כולם עובדים מאותה רשימת צוותים. | | לשיחה יש צוות אחד | שדה **הצוות המשויך** מחזיק צוות אחד, או אף אחד. | | צוות אינו הרשאה | חברות בצוות אינה מעניקה ואינה מגבילה גישה לשום דבר. היא משפיעה רק על ניתוב שיחות. | | צוות אינו מחלקה | שדה **המחלקה** בפרופיל של נציג הוא תווית טקסט חופשי לתצוגה ולחיפוש. הוא אינו יוצר צוות. | | שיוך אוטומטי אופציונלי | צוות יכול למסור שיחה ישירות לחבר **מחובר** אקראי. | | הוא שולט ב"קבלת הבא בתור" | נציג יכול למשוך רק שיחה ממתינה **ללא צוות**, או מצוות **שהוא חבר בו**. | | סטודיו יכול לנתב לצוות | פעולת **שינוי שיחה** יכולה למסור לצוות, וטריגר **שינוי בשיחה** יכול להיות מופעל בשיוך צוות. | | ניתן לדיווח | באנליטיקס יש מקור נתונים **צוותים**, ואפשר לקבץ שיחות לפי **הצוות המשויך**. | | מנוהל בהרשאה | צפייה בצוותים דורשת **צוותים ← צפייה**; יצירה, עריכה ומחיקה דורשות **צוותים ← יצירה / עדכון / מחיקה**. ראו [תפקידים והרשאות](./roles/overview.md). | ## מי יכול לעשות מה | פעולה | ההרשאה הנדרשת | | --- | --- | | לראות את עמוד הצוותים ואת רשימת הצוותים | **צוותים ← צפייה** | | ליצור צוות | **צוותים ← יצירה** | | לערוך צוות | **צוותים ← עדכון** | | למחוק צוות | **צוותים ← מחיקה** | | לשייך שיחה לצוות | **יכול לשייך שיחות** באותה תיבה | | לסנן שיחות לפי צוות | ללא — המסננים רק מצמצמים את מה שאתם כבר רואים | | לנתב לצוות מסטודיו | **סטודיו ← עדכון** | כל מה שמשנה צוות נאכף בשרת. תפקיד ללא ההרשאה אינו רואה את כפתור **הוספת צוות**, וה‑API דוחה את השינוי גם אם מגיעים לכפתור בדרך אחרת. תפקידי ברירת המחדל נותנים ניהול צוותים מלא ל‑**Owner** ול‑**Team Leader**, ונראות לקריאה בלבד ל‑**Marketing**, ל‑**Agent** ול‑**Viewer**. --- ## עמוד הצוותים ![עמוד הצוותים עם רשימת הצוותים ותגי הכללים](pathname:///img/screenshots/he/product/teams/teams-overview.png) | רכיב | מה הוא עושה | | --- | --- | | **הוספת צוות** | פותח את טופס הצוות. דורש **צוותים ← יצירה**. | | **צוותים** (נתון) | כמה צוותים קיימים בחשבון. | | **חברויות בצוותים** (נתון) | המספר הכולל של קישורי נציג לצוות. נציג בשלושה צוותים נספר שלוש פעמים, ולכן זה בדרך כלל גבוה ממספר הנציגים שלכם. | | **צוותים עם שיוך אוטומטי** (נתון) | כמה צוותים מפעילים את כלל השיוך האוטומטי. | | חיפוש | מסנן את הרשימה לפי **שם או תיאור הצוות**. | | רשימת הצוותים | שורה אחת לכל צוות, עם החברים והכללים שלו. | ### להבין את הרשימה | עמודה | משמעות | | --- | --- | | **צוות** | שם הצוות, עם תג ראשי תיבות צבעוני, ומזהה הצוות מתחת (`#3`). המזהה הוא מה שסטודיו וה‑API משתמשים בו. | | **תיאור** | התיאור שלכם, או `—`. רחפו כדי לקרוא תיאור ארוך במלואו. | | **נציגים** | כמה נציגים בצוות. | | **חברים** | עד חמישה עיגולי ראשי תיבות של חברים, ואז `+N`. נציגי AI מוצגים עם סמל 🤖. רחפו על אחד כדי לראות את השם. | | **כללים** | שני תגים שמציגים אם כל כלל מופעל (`✓`, ירוק) או כבוי (`✕`, אפור). | | **פעולות** | ✏️ עריכה ו‑🗑️ מחיקה, מוצגות כשהתפקיד שלכם מעניק **צוותים ← עדכון** ו**צוותים ← מחיקה**. | --- ## יצירת צוות 1. פתחו **ניהול ← נציגים, צוותים ותפקידים ← צוותים**. 2. לחצו **הוספת צוות**. 3. הקלידו **שם צוות**. זה מה שהנציגים בוחרים בשיחה, אז תנו שם ברור: *מכירות*, לא *קבוצה 2*. 4. אופציונלית, כתבו **תיאור** — במה הצוות הזה מטפל. 5. סמנו את הנציגים ששייכים לצוות. 6. קבעו את שני ה**כללים** (ראו למטה). 7. לחצו **יצירת צוות**. ![טופס יצירת צוות עם בוחר הנציגים ושני מתגי הכללים](pathname:///img/screenshots/he/product/teams/create-team.png) ### מדריך השדות | שדה | חובה | מגבלה | במה הוא שולט | | --- | --- | --- | --- | | **שם הצוות** | כן | 100 תווים | השם שמוצג בכל מקום שבו בוחרים צוות. חייב להיות ייחודי בחשבון — ‏Teloring משווה שמות בלי רגישות לאותיות גדולות/קטנות, כך ש‑`Sales` ו‑`sales` מתנגשים. | | **תיאור** | לא | 500 תווים | טקסט חופשי, מוצג ברשימה וכתיאור בריחוף על בוחר הצוות בשיחה. | | **נציגים בצוות הזה** | לא | 500 נציגים | החברים. צוות ללא חברים מותר אך אינו יכול לשייך אוטומטית ואף אחד אינו יכול למשוך את השיחות שלו — ראו [מגבלות](#limitations-and-what-to-watch-for). | | **שיוך אוטומטי לנציג מחובר מהצוות הזה** | לא | — | ראו [כלל 1](#rule-1--auto-assign-to-an-online-agent). | | **רק נציגים אמיתיים (ללא נציגי AI)** | לא | — | ראו [כלל 2](#rule-2--only-real-agents). | חשבון יכול להחזיק עד **200 צוותים**. ### בוחר הנציגים - הקלידו בתיבת החיפוש כדי לסנן לפי **שם או אימייל**. - נציגים שכבר סימנתם צפים לראש הרשימה, כך שרשימה ארוכה נשארת נוחה. - כל שורה מציגה אם הנציג הוא **אנושי** או **AI**. - מופיעים רק נציגים **פעילים**. נציגים שהושבתו נשמטים בשקט בשמירה. - המונה מעל הרשימה מציג כמה נבחרו. נציג יכול להשתייך ל**כמה צוותים** בו‑זמנית. מישהו שנמצא גם ב*מכירות* וגם ב*תמיכה* יכול למשוך שיחות ממתינות משניהם. --- ## שני הכללים ### כלל 1 — שיוך אוטומטי לנציג מחובר {#rule-1--auto-assign-to-an-online-agent} > *כשהצוות נבחר, שייך אוטומטית לנציג מחובר מהצוות הזה.* **כבוי (ברירת מחדל).** שיוך הצוות משאיר את השיחה ללא בעלים. היא יושבת ב**ממתינות בתור** עד שחבר באותו צוות לוקח אותה. **מופעל.** ברגע שהצוות משויך, Teloring בוחרת חבר **מחובר** אחד באקראי ומשייכת אליו את השיחה. היא נכנסת ישירות לתור **שלי** של אותו אדם. | מצב | מה קורה | | --- | --- | | כמה חברים מחוברים | אחד נבחר **באקראי**. | | חבר אחד מחובר | אותו חבר מקבל אותה. | | אף חבר אינו מחובר | אף אחד אינו משויך. השיחה ממתינה בתור עבור הצוות. | | בצוות יש נציג AI והכלל מופעל | נציג ה‑AI יכול להיבחר, כי נציגי AI תמיד מחוברים. | **למה אקראי ולא סבב?** ‏Teloring רצה על שרתים רבים בו‑זמנית. בחירה אקראית אינה דורשת מונה משותף ביניהם, ולכן היא מפזרת עבודה באופן שווה בלי ששרת אחד יצטרך להמתין לאחר. לאורך יום עבודה ההתפלגות מתאזנת. :::info "מחובר" פירושו מחובר ממש עכשיו נציג נחשב מחובר כל עוד Teloring פתוחה אצלו — בדיוק הנקודה הירוקה בצ׳אט הצוות. זה אינו סטטוס שהוא קובע ידנית. סגירת לשונית הדפדפן מפסיקה את החיבור. **נציגי AI תמיד מחוברים.** הם תוכנה, ולכן הם לעולם אינם מתנתקים ואפשר לשייך אליהם אוטומטית בכל שעה, כולל בלילות ובסופי שבוע. השתמשו ב[כלל 2](#rule-2--only-real-agents) אם אינכם רוצים בכך. ::: ### כלל 2 — רק נציגים אמיתיים {#rule-2--only-real-agents} > *כשהצוות נבחר, כלול רק נציגים אמיתיים ולא נציגי AI.* **כבוי (ברירת מחדל).** נציגי AI יכולים להיות חברים ואפשר לשייך אליהם אוטומטית. **מופעל.** הצוות הזה הוא לבני אדם בלבד: - נציגי AI נעלמים מבוחר הנציגים. - כל נציג AI שכבר בצוות **מוסר בשמירה** — הכלל נאכף, לא רק מוצג. - שיוך אוטומטי לעולם לא יבחר נציג AI מהצוות הזה. השתמשו בו לצוותים שחייבים להגיע לאדם: תלונות, הסלמות, חשבונות VIP, וכל דבר עם בדיקה משפטית או חוזית. --- ## שיוך שיחה לצוות יש שלוש דרכים. ### מכותרת השיחה 1. פתחו את השיחה. 2. פתחו את בוחר **הצוות המשויך** (סמל שני האנשים, לצד **משויך ל**). 3. בחרו צוות, או **ללא צוות**. ![בוחר הצוות המשויך בכותרת השיחה](pathname:///img/screenshots/he/product/teams/conversation-team-picker.png) הסימן `⚡` ליד שם צוות אומר שהצוות הזה משייך אוטומטית לחבר מחובר, כך שאתם יודעים לפני הלחיצה אם מישהו יקבל אותה מיד. לאחר מכן Teloring אומרת לכם מה קרה: | הודעה | משמעות | | --- | --- | | *שויכה לדנה מצוות מכירות* | הצוות שייך אוטומטית חבר מחובר. | | *ממתינה בתור עבור מכירות* | הצוות מחזיק בה, אבל אף אחד לא שויך. חבר בצוות המכירות צריך לקחת אותה. | :::note הבוחר מוסתר כשאין לכם צוותים אם עדיין אין צוותים בחשבון, פקד **הצוות המשויך** אינו מופיע כלל. צרו את הצוות הראשון שלכם וטענו מחדש את השיחה. ::: ### מרשימת השיחות לחיצה ימנית על כרטיס שיחה כלשהו ← **שיוך צוות** ← בחרו צוות או **ללא צוות**. נוח למיון מהיר של הצטברות. ### מסטודיו השתמשו בפעולת **שינוי שיחה** עם **התערבות אנושית** מופעלת ו**מסירה אל ← צוות**. ראו [פעולות סטודיו](./studio/actions.md). ### מה השיוך משנה שיוך צוות תמיד עושה שלושה דברים: 1. קובע את **הצוות המשויך** של השיחה. 2. **משחרר את סטודיו.** אם תהליך סטודיו החזיק בשיחה, הוא מפסיק להחזיק בה. שיחה מטופלת על ידי סטודיו *או* על ידי אנשים — לעולם לא שניהם. 3. או משייך חבר מחובר (כלל 1 מופעל, מישהו מחובר) או משאיר אותה ממתינה עבור הצוות. כרטיסי השיחה מציגים צ׳יפ `👥 שם הצוות`, כדי שתראו את הבעלים בזמן סריקת הרשימה. --- ## איך צוותים משנים מי מקבל מה זה החלק ששווה לקרוא בעיון, כי הוא משנה את אופן חלוקת העבודה. ### "קבלת השיחה הבאה" כשנציג לוחץ **קבלת הבא בתור** ברשימת השיחות, Teloring מציעה רק שיחות שמותר לו לקחת: | לשיחה הממתינה יש… | האם הנציג הזה יכול לקחת אותה? | | --- | --- | | **ללא צוות** | כן — כל אחד יכול. | | **צוות שהוא חבר בו** | כן. | | **צוות שהוא אינו חבר בו** | **לא.** היא נשארת לאותו צוות. | כך נציג ב*תמיכה* יכול למשוך שיחות ללא צוות **וגם** שיחות של *תמיכה*, אבל לעולם לא שיחה של *מכירות*. נציג ב**אף צוות** יכול למשוך רק שיחות שאין להן צוות. מבין מה שמותר לו לקחת, כללי ההוגנות הקיימים אינם משתנים: 1. **עדיפות תחילה** — דחוף, ואז גבוה, ואז בינוני, ואז נמוך. 2. **ואז הוותיקה ביותר** (FIFO), כדי שלקוח שממתין לא ייעקף על ידי חדש יותר באותה עדיפות. **דוגמה.** שתי שיחות ממתינות, שתיהן ב*תמיכה*. אחת הגיעה לפני שעה בעדיפות בינונית. אחת הגיעה לפני עשרים דקות בעדיפות גבוהה. נציג תמיכה שלוחץ **קבלת הבא בתור** מקבל את זו **בת עשרים הדקות בעדיפות גבוהה**, כי העדיפות גוברת על הוותק. אם כל מה שממתין שייך לצוותים אחרים, **קבלת הבא בתור** אומרת *אין שיחות שממתינות בתור לצוותים שלכם* במקום לתת להם עבודה של מישהו אחר. ### לשוניות התורים אינן מסוננות לפי צוות **ממתינות בתור** עדיין מציגה וסופרת **כל** שיחה ממתינה, כולל של צוותים אחרים. זה בכוונה: הצוותים שולטים ב*חלוקה הוגנת*, לא בנראות. כל אחד עדיין יכול לראות את התור כולו, לפתוח שיחה של צוות אחר ולקחת אותה ידנית אם צריך — מפקח שמכסה פער, למשל. רק **קבלת הבא בתור** מכבדת גבולות צוות. כדי לראות רק את התור של הצוות שלכם, השתמשו במסנן **הצוות המשויך** שמתואר למטה. ### "שלי" לעולם אינו משתנה **שלי** תמיד אומר *משויך אליי כנציג*. שיחה ששייכת לצוות שלכם אך אין לה בעלים נשארת ב**ממתינות בתור** — היא אינה מופיעה ב**שלי** של אף אחד עד שמישהו באמת לוקח אותה. --- ## צוותים ושדה הנציג יחד {#teams-and-the-agent-field-together} לשיחה יכולים להיות גם צוות **וגם** נציג. ‏Teloring שומרת על עקביות בין השניים, כך שלעולם לא תגיעו למצב שבו שיחה של *מכירות* בבעלות מישהו מחוץ למכירות. | מה אתם עושים | מה Teloring עושה | | --- | --- | | משייכים צוות, לאף אחד עדיין אין בעלות | משייכת אוטומטית חבר מחובר (כלל 1 מופעל) או משאירה ממתינה. | | משייכים נציג ש**כן** בצוות | שניהם נשמרים. | | משייכים נציג ש**אינו** בצוות | **הצוות מנוקה**. תראו את ההודעה *הצוות מכירות הוסר — הנציג החדש אינו חבר בו*. | | מעבירים שיחה בבעלות לצוות שהבעלים אינו חבר בו | **הנציג מנוקה** והשיחה ממתינה בתור עבור הצוות החדש. | | **החזרה לתור** | **הצוות נשמר**. המשמעות היא "מישהו אחר בצוות הזה צריך לקחת את זה", ולכן לצוות נשמרת זכות הקדימה. | | מוחקים את הצוות | כל שיחה שעדיין עליו חוזרת לתור ההמתנה הכללי. | :::tip למה הצוות מנוקה אילו שיחה הייתה יכולה לשבת על *מכירות* בזמן שנציג תמיכה מחזיק בה, אף אחד לא היה יכול לומר מי אחראי, ומכירות לעולם לא היו רואות אותה שוב ב**קבלת הבא בתור**. ניקוי אחד מהשניים שומר על תשובה חד‑משמעית לשאלה "של מי זה?". ::: --- ## סינון שיחות לפי צוות בפאנל מסנני השיחות יש עכשיו שני מדורים חדשים. ![פאנל מסנני השיחות עם מדורי הנציג המשויך והצוות המשויך](pathname:///img/screenshots/he/product/teams/conversation-filters.png) | מסנן | מה הוא מציע | | --- | --- | | **נציג משויך** | כל נציג, ובנוסף צ׳יפ **ללא שיוך** מפורש. יש לו תיבת חיפוש משלו לרשימות ארוכות. | | **צוות משויך** | כל צוות, ובנוסף צ׳יפ **ללא צוות** מפורש. | שניהם מאפשרים בחירה מרובה ומשתלבים עם שאר המסננים. בחירת שני צוותים מציגה שיחות ב**אחד מהם**. שילובים שימושיים: - **צוות משויך = מכירות** + **נציג משויך = ללא שיוך** ← תור המכירות שאיש לא לקח. - **צוות משויך = ללא צוות** ← שיחות שאיש עדיין לא ניתב. - **צוות משויך = מכירות** + לשונית **טופלו** ← מה שמכירות סגרו. --- ## צוותים בסטודיו ### ניתוב לצוות בפעולת **שינוי שיחה**, הפעילו את **התערבות אנושית** וקבעו **מסירה אל** ← **צוות**, ואז בחרו את הצוות. לאחר מכן התהליך מתנהג בדיוק כמו שיוך צוות ידני: ‏סטודיו משחרר את השיחה, והצוות או משייך אוטומטית חבר מחובר או מחזיק אותה בתור ההמתנה עבור חבריו. משתני התהליך האלה הופכים לזמינים: | משתנה | מכיל | | --- | --- | | `conversation.handover_team_id` | מזהה הצוות שהתהליך מסר אליו. | | `conversation.handover_team_name` | שם הצוות. | | `conversation.handover_agent_id` | החבר ששויך אוטומטית, או ריק אם היא ממתינה בתור. | :::warning בחרו את הצוות בבלוק אם **מסירה אל** מוגדר ל**צוות** אך לא נבחר צוות, המסירה נופלת חזרה לתור ההמתנה הרגיל. עורך התהליכים מסמן את הבלוק באזהרה בזמן העריכה, אז תקנו לפני הפרסום. אם הצוות שנבחר **נמחק** בהמשך, הבלוק **נכשל** במקום להחנות את השיחה בצוות שכבר אינו קיים. בדקו את התהליכים שלכם אחרי מחיקת צוות. ::: ### טריגר בשיוך צוות לטריגר **שינוי בשיחה** יש מסנן **שיוך צוות**: | הגדרה | מופעל כאשר | | --- | --- | | **כל צוות** (ברירת מחדל) | כל שינוי. הצוות אינו נלקח בחשבון. | | **צוות שויך (כלשהו)** | לשיחה יש עכשיו צוות. | | **צוות הוסר** | לשיחה כבר אין צוות. | | **צוות ספציפי שויך** | הצוות של השיחה הוא אחד שבחרתם. | תהליכים שנבנו לפני שהצוותים היו קיימים ממשיכים לעבוד ללא שינוי — הם מוגדרים כברירת מחדל ל**כל צוות**. שינויי צוות גם קובעים את `change.type` ל‑`team_assigned` או ל‑`team_unassigned`, בנפרד מ‑`assigned` / `unassigned` ברמת הנציג, כך שתהליך יכול להגיב ל"הועבר למכירות" בלי להיות מופעל בכל שיוך אישי. :::note בחירה ללא צוות ב"צוות ספציפי שויך" **צוות ספציפי שויך** בלי שנבחר דבר לעולם אינו מופעל. בחירה ריקה פירושה "אף צוות אינו תואם" — היא אינה נחשבת ל"כל צוות", כך שטריגר שלא הושלם אינו יכול להיות מופעל על שיוכים שלא ביקשתם. ::: ראו [טריגרים בסטודיו](./studio/triggers.md) ו[פעולות בסטודיו](./studio/actions.md). --- ## צוותים באנליטיקס {#teams-in-analytics} שני דברים נפרדים, ובחירת הנכון מביניהם משנה. ### דיווח על העבודה שצוות טיפל בה השתמשו במקור הנתונים **שיחות** וקבצו לפי **הצוות המשויך**. שם נמצאים הנפח, זמן הפתרון, העדיפות והערוץ. דוגמאות: - שיחות פתוחות לפי צוות. - זמן פתרון ממוצע לפי צוות. - שיחות שמכירות סגרו החודש. - ספירה של צוותים שונים שהיו מעורבים השבוע. מזהי הצוותים מוצגים כ**שמות צוותים** בגרפים, בטבלאות ובבוחרי המסננים. שיחות ללא צוות מקובצות תחת `(ללא)`. ### דיווח על הצוותים עצמם השתמשו במקור הנתונים **צוותים**. הוא עונה על שאלות לגבי מבנה הצוותים שלכם, ולא לגבי שיחות: | שדה | שימוש | | --- | --- | | **צוות** | ספירת צוותים, או קיבוץ לפי צוות. | | **שם הצוות** | קיבוץ או סינון לפי שם. | | **נציגים בצוות** | ממוצע, סכום, מינימום או מקסימום של גודל הצוות. | | **שיוך אוטומטי לנציג מחובר** | פיצול צוותים לפי אם הכלל מופעל. | | **נציגים אנושיים בלבד** | פיצול צוותים לפי אם הכלל מופעל. | | **נוצר על ידי**, **נוצר בתאריך**, **עודכן בתאריך** | מי הקים צוות ומתי. | ראו [אנליטיקס](./analytics.md). --- ## עריכה או מחיקה של צוות ### עריכה לחצו על ✏️ בשורה. אפשר לשנות את השם, התיאור, החברים ושני הכללים. עריכת צוות נכנסת לתוקף **מיד** עבור ניתוב עתידי: - הוספת חבר מאפשרת לו למשוך את השיחות הממתינות של אותו צוות מיד. - הסרת חבר עוצרת אותו ממשיכת שיחות חדשות, אבל **אינה** לוקחת ממנו שיחות שכבר בבעלותו. - הפעלת **רק נציגים אמיתיים** מסירה חברי AI בשמירה. ### מחיקה לחצו על 🗑️ ואשרו. מחיקת צוות: - מסירה את הצוות; - **מנקה את הצוות מכל שיחה שעדיין מחזיקה בו**, כך שאותן שיחות חוזרות לתור ההמתנה הכללי וכל אחד יכול לקחת אותן; - מדווחת כמה שיחות נותקו. היא **אינה** מוחקת נציגים, שיחות או הודעות. :::warning בדקו את סטודיו לפני מחיקה בלוק **שינוי שיחה** שמוסר לצוות שנמחק **ייכשל** בזמן ריצה, וטריגר **שינוי בשיחה** שמסונן לפיו יפסיק להתאים. חפשו את הצוות בתהליכים החיים שלכם לפני שאתם מוחקים אותו. ::: --- ## הגדרות מומלצות **לפי נושא — המקרה הנפוץ** 1. צרו *מכירות*, *תמיכה* ו*חיובים*. 2. שימו כל אדם בצוות או בצוותים שתואמים לעבודה שלו. 3. השאירו את **השיוך האוטומטי** כבוי בהתחלה, כדי שאנשים ימשכו עבודה עם **קבלת הבא בתור** בקצב שלהם. 4. נתבו שיחות נכנסות לצוות, ידנית או מסטודיו. 5. הפעילו את **השיוך האוטומטי** בהמשך עבור הצוות שזקוק למענה ראשון מהיר ביותר. **מענה ראשון מהיר** 1. צרו *קו ראשון* עם כל מי שעונה ראשון. 2. הפעילו **שיוך אוטומטי לנציג מחובר**. 3. נתבו שיחות חדשות לשם מסטודיו. 4. מי שמחובר מקבל אותה מיד; כשאף אחד אינו מחובר היא ממתינה לצוות. **הסלמה שחייבת להגיע לאדם** 1. צרו *הסלמות* עם הנציגים הבכירים שלכם. 2. הפעילו **רק נציגים אמיתיים**. 3. השאירו את **השיוך האוטומטי** כבוי, כדי שאדם יקבל את ההסלמה במכוון. 4. בסטודיו, נתבו את סיבות ההסלמה *כועס או מתוסכל* ו*ביקש נציג* לצוות הזה. **AI ראשון, בני אדם שני** 1. צרו *קו ראשון AI* שמכיל רק את נציג ה‑AI שלכם, עם **שיוך אוטומטי** מופעל. 2. צרו *גיבוי אנושי* עם האנשים שלכם. 3. נתבו שיחות חדשות ל*קו ראשון AI* — ה‑AI תמיד מחובר, ולכן הוא תמיד עונה. 4. בפרופיל נציג ה‑AI, שלחו תוצאות של כישלון והסלמה לאדם. --- ## מגבלות ודברים שכדאי לשים לב אליהם {#limitations-and-what-to-watch-for} אלו מגבלות מוצר אמיתיות היום, לא טעויות מצידכם. | פריט | מה באמת קורה | עשו זאת במקום | | --- | --- | --- | | **מוני תגים של תורים** | **ממתינות בתור** סופרת כל שיחה ממתינה, כולל של צוותים אחרים. המספר יכול להיות גבוה ממה ש**קבלת הבא בתור** באמת תיתן לכם. | השתמשו במסנן **הצוות המשויך** כדי לראות את התור של הצוות שלכם. | | **אין לשונית תור לצוות** | אין לשונית בסרגל הצד ל"השיחות של הצוות שלי". שיחת צוות ללא בעלים יושבת ב**ממתינות בתור**. | סננו לפי **צוות משויך**, או נעצו את שילוב המסננים שאתם משתמשים בו. | | **צוות אחד לשיחה** | שיחה אינה יכולה להשתייך לשני צוותים בו‑זמנית. בחירת צוות שני מחליפה את הראשון. | השתמשו בצוות אחד לצד תוויות לכל דבר חוצה ארגון. | | **אין שעות עבודה ברמת הצוות** | לצוות אין לוח זמנים משלו. | השתמשו בתנאי **שעות פעילות** בסטודיו לפני הניתוב לצוות, או בשעות פעילות בפרופיל של נציג AI. | | **אין עדיפות צוות או שקלול מיומנות** | השיוך האוטומטי הוא אקראי לחלוטין בין החברים המחוברים. אין "תן למי שהכי פחות עמוס" או "העדף את המומחה". | שמרו על צוותים קטנים וממוקדים, או שייכו ידנית במקומות שזה חשוב. | | **צוות ריק** | אפשר לשמור צוות ללא חברים. שיוך שלו פירושו שאף אחד אינו יכול לקבל אותה אוטומטית, ואף אחד אינו יכול למשוך אותה עם **קבלת הבא בתור**. היא יושבת בתור עד שמישהו פותח אותה ידנית או שאתם מתקנים את הצוות. | תמיד הוסיפו לפחות חבר אחד. | | **חברות בצוות אינה הרשאה** | היות חבר בצוות אינו מגביל את מה שנציג יכול לראות או לפתוח. | השתמשו ב[הרשאות ערוצים](./roles/channel-permissions.md) לצורך נראות. הצוותים שולטים בניתוב בלבד. | | **נוצר על ידי / עודכן על ידי** | נרשמים על הצוות עבור יומן הלוגים, אך אינם מוצגים בעמוד הצוותים. | בדקו **ניהול ← יומן לוגים** עבור `team.created`,‏ `team.updated` ו‑`team.deleted`. | --- ## פתרון תקלות ### "קבלת הבא בתור" אומרת שאין שיחות ממתינות, אבל התור מציג שיחות כל מה שממתין שייך לצוותים שאתם לא בהם. ההודעה *אין שיחות שממתינות בתור לצוותים שלכם* מאשרת זאת. בקשו ממנהל להוסיף אתכם לצוות, או פתחו את השיחה מהרשימה ושייכו אותה לעצמכם ידנית. ### שייכתי צוות ואף אחד לא קיבל צפוי כאשר כלל **השיוך האוטומטי** של הצוות כבוי, או שאף חבר לא היה מחובר. בדקו: 1. פתחו את הצוות וודאו ש**שיוך אוטומטי לנציג מחובר** מופעל. 2. ודאו שלפחות חבר אחד מחובר — הנקודה הירוקה בצ׳אט הצוות. 3. אם הצוות הוא **לבני אדם בלבד** והחבר היחיד שלו הוא נציג AI, אף אחד אינו כשיר. ### הצוות נעלם כששייכתי נציג אותו נציג אינו חבר בצוות. ‏Teloring ניקתה את הצוות כדי שלשיחה יהיה בעלים ברור אחד. או שתוסיפו את הנציג הזה לצוות, או שתבחרו נציג שכבר בו. ### הנציג נעלם כששייכתי צוות הבעלים הקודם אינו חבר בצוות החדש, ולכן השיחה חזרה לתור ההמתנה עבור הצוות החדש. שייכו חבר מהצוות החדש אם היא צריכה בעלים מיד. ### נציג AI ממשיך לקבל שיוך אוטומטי בלילה נציגי AI תמיד מחוברים, ולכן הם תמיד כשירים. הפעילו **רק נציגים אמיתיים** עבור אותו צוות, או הסירו ממנו את נציג ה‑AI. ### אני לא מצליח ליצור צוות התפקיד שלכם אינו מעניק **צוותים ← יצירה**, ולכן כפתור **הוספת צוות** מוסתר. בקשו ממישהו עם **תפקידים והרשאות ← עדכון** להוסיף אותה — ראו [תפקידים והרשאות](./roles/overview.md). ### "כבר קיים צוות בשם הזה" השמות ייחודיים לחשבון ומושווים בלי רגישות לאותיות גדולות/קטנות — ‏`Sales` ו‑`sales` מתנגשים. בחרו שם אחר, או ערכו את הצוות הקיים. ### תהליך סטודיו הפסיק לנתב אם התהליך מסר לצוות שנמחק, הבלוק נכשל עכשיו. פתחו את התהליך, בחרו צוות קיים ופרסמו שוב. --- ## מדריכים קשורים - [נציגים ונציגי AI](./agents.md) — יצירת האנשים ופרופילי ה‑AI שיהפכו לחברי צוות. - [שיחות](../getting-started/conversations.md) — שיוך, תורים, **קבלת הבא בתור** ומסננים. - [פעולות סטודיו](./studio/actions.md) — מסירת השיחה לצוות ב**שינוי שיחה**. - [טריגרים בסטודיו](./studio/triggers.md) — מסנן הצוות ב**שינוי בשיחה**. - [אנליטיקס](./analytics.md) — מקור הנתונים **צוותים** והקיבוץ לפי **הצוות המשויך**. - [תפקידים והרשאות](./roles/overview.md) — בקרת גישה, שהצוותים בכוונה *אינם* מספקים. --- # התראות מקור: https://docs.teloring.com/he/docs/product/notifications Markdown: https://docs.teloring.com/he/markdown/docs/product/notifications.md מדור: מדריכי מוצר עודכן לאחרונה: 2026-08-20T20:49:57.000Z ההתראות מודיעות לכם כשמשהו שחשוב לכם קורה ב‑Teloring — שיחה נוחתת על השם שלכם, לקוח משיב, או אוטומציה שבניתם מחליטה שאתם צריכים לדעת. שתי שאלות קובעות הכול: - **על מה** תרצו לקבל עדכון? - **איך** Teloring צריכה לספר לכם? אתם עונים על שתיהן בפרופיל שלכם, והשתיים משתלבות: כל שיטת מסירה שתפעילו חלה על כל סוג התראה שתפעילו. פתחו את **השם שלכם בתחתית סרגל הצד ← הפרופיל שלי ← התראות**, או עברו ישירות ל‑`/dashboard/profile#notifications`. :::info הכול מתחיל כבוי נציג חדש לגמרי אינו מקבל התראות כלל. שום דבר אינו נשלח עד שאתם מפעילים זאת בעצמכם. זה בכוונה — ‏Teloring לעולם אינה מחליטה בשמכם שמשהו מצדיק להפריע לכם. ::: ## עובדות מרכזיות | עובדה | משמעות | | --- | --- | | אישיות, לא ברמת החשבון | ההגדרות שלכם הן שלכם בלבד. הפעלת התראות אימייל אינה מפעילה אותן לעמית, ומנהל אינו יכול לקבוע אותן עבורכם. | | בהסכמה | כל מתג מוגדר כברירת מחדל לכבוי. | | ארבע שיטות מסירה | צליל, אימייל, דחיפה בדפדפן, פעמון ההתראות. | | שלושה סוגי התראות | שיחה ששויכה אליי, הודעה חדשה, התראות סטודיו. | | מתג ראשי אחד | כבו הכול בלחיצה אחת בלי לאבד את הבחירות שלכם. | | סטודיו מכסה את כל השאר | שני הסוגים המובנים הם קיצורי דרך. כל דבר אחר שתדמיינו נבנה עם בלוק סטודיו. | | עובד בכל התיבות | WhatsApp, אימייל, SMS, טלגרם, LINE, צ׳אט באתר, Messenger, פייסבוק, אינסטגרם, TikTok, שיחות טלפון ו‑API. | | מבודדות לחשבון | ההתראות לעולם אינן חוצות בין חשבונות Teloring. | ## מי יכול לעשות מה | פעולה | מי יכול | | --- | --- | | לשנות את הגדרות ההתראות **שלי** | כולם. אין צורך בהרשאה. | | לשנות את הגדרות ההתראות של **מישהו אחר** | **אף אחד.** אין מסך כזה ואין קריאת API כזו. | | לקרוא את פעמון ההתראות של **מישהו אחר** | **אף אחד.** | | לבנות תהליך סטודיו שמתריע לנציגים אחרים | כל מי שיש לו **סטודיו ← יצירה** — ראו [תפקידים והרשאות](./roles/overview.md). | הזהות שלכם מגיעה מהסשן המחובר שלכם, לעולם לא מהעמוד. אין מסך — ואין קריאת API — שמאפשרים לנציג אחד לקרוא או לשנות את ההתראות של נציג אחר. --- ## מסך ההגדרות ![פאנל ההתראות בעמוד הפרופיל, עם המתג הראשי, ארבע שיטות המסירה ושלושת סוגי ההתראות](pathname:///img/screenshots/he/product/notifications/notifications-settings.png) הפאנל יושב בצד של **הפרופיל שלי**, לצד התמונה ושם התצוגה שלכם. יש בו שלושה חלקים: | חלק | מטרה | | --- | --- | | **הפעלת התראות** | המתג הראשי בראש. | | **איך תרצו לקבל אותן?** | ארבע שיטות המסירה. | | **על מה תרצו לקבל התראה?** | שלושת סוגי ההתראות. | השינויים **אינם** חיים עד שאתם לוחצים **שמירה**. האישור מופיע לצד הכפתור. ### המתג הראשי **הפעלת התראות** הוא מתג הפעלה/כיבוי ליכולת כולה. - **כבוי** — אינכם מקבלים דבר, בלי קשר למה שנבחר. שאר הפאנל הופך לאפור. - **מופעל** — השיטות והסוגים שבחרתם נכנסים לתוקף. כיבוי המתג שומר את הבחירות שלכם. הפעילו אותו שוב והכול בדיוק כפי שהשארתם — שימושי לצהריים ממוקדים, לחופשה או ליום השקה רועש. :::tip כיבוי המתג הראשי גם מסיר את רישום הדחיפה של הדפדפן הזה, כך שגם לשונית ברקע מפסיקה לזמזם — לא רק החלקים בתוך היישום. ::: --- ## איך — ארבע שיטות המסירה בחרו אחת או יותר. הן אינן בלעדיות; רוב הנציגים מפעילים את הפעמון בתוספת אמצעי אחד שמושך תשומת לב. ![ארבע שיטות המסירה — צליל, אימייל, דחיפה בדפדפן, פעמון ההתראות — כל אחת עם מתג משלה](pathname:///img/screenshots/he/product/notifications/notifications-how.png) | שיטה | מה מקבלים | מתאימה ביותר ל | | --- | --- | --- | | **צליל** | צליל קצר בדפדפן. ללא טקסט. | לדעת ש*משהו* קרה בזמן שאתם עובדים בלשונית אחרת. | | **אימייל** | הודעה לכתובת ההתחברות שלכם. | תיעוד שאפשר לחפש, להעביר או לקרוא בטלפון. | | **דחיפה בדפדפן** | התראת שולחן עבודה, גם כש‑Teloring אינה הלשונית הפעילה. | לא לפספס דבר בזמן שאתם עובדים ביישומים אחרים. | | **פעמון ההתראות** | רשומה בתפריט הפעמון, עם מונה של לא נקראו. | להשלים פערים על מה שפספסתם. | ### צליל מנגן רמז שמע קצר בדפדפן שלכם. שום דבר אינו מוצג — זה נועד אך ורק ל"הרימו את הראש, משהו קרה". בחרו מתוך עשרה צלילים ולחצו **נגן** כדי לשמוע אחד לפני שאתם מתחייבים. בחירת צליל מהרשימה הנפתחת גם מנגנת אותו מיד. | צליל | אופי | אורך | | --- | --- | --- | | **Chime** *(ברירת מחדל)* | ארפג'ו זכוכיתי בן שלושה צלילים. חמים ולא פולשני. | 1.5 שנ׳ | | **Bell** | פעמון עם זנב ארוך. | 2.2 שנ׳ | | **Ding** | ה"יש לך הודעה" הבהיר הקלאסי. | 1.1 שנ׳ | | **Ping** | צפצוף גבוה וקצר מאוד. האפשרות הכי פחות פולשנית. | 0.5 שנ׳ | | **Pop** | פופ הקשתי רך. | 0.4 שנ׳ | | **Marimba** | שני צלילי עץ. נשמע היטב בחדר עמוס. | 1.4 שנ׳ | | **Alert** | שני צלילים יורדים. נקרא כ"נדרשת תשומת לב". | 1.3 שנ׳ | | **Bubble** | צפצוף עולה של טיפת מים. קליל ושובב. | 0.6 שנ׳ | | **Knock** | דפיקה כפולה רכה. נמוך ושקט — טוב למשרדים פתוחים. | 0.5 שנ׳ | | **Digital** | צפצוף רטרו בן שלושה שלבים. חותך רעש בלי להיות צורמני. | 0.6 שנ׳ | :::note למה הצליל הראשון לפעמים אינו מתנגן דפדפנים חוסמים שמע עד שלחצתם איפשהו בעמוד. אם תטענו את Teloring ותשאירו אותה בלי מגע, ייתכן שהצליל הראשון יהיה שקט. כל לחיצה בכל מקום משחררת אותו לשאר הסשן. ::: ### אימייל שולח את ההתראה לכתובת ההתחברות שלכם מהכתובת **do-not-reply@teloring.com**. ![דוגמה לאימייל התראה של Teloring](pathname:///img/screenshots/he/product/notifications/notifications-email.png) | רכיב | מה הוא מכיל | | --- | --- | | **נושא** | מזהה השיחה בסוגריים, ואז מה קרה — `[#4821] הודעה חדשה בשיחה שלך`. | | **כותרת** | סוג ההתראה במילים. | | **תיבת ההודעה** | טקסט ההתראה, לצד כל פירוט נוסף. | | **שיחה** | מזהה השיחה שוב, כשורה שניתנת לחיפוש. | | **כפתור** | פותח את השיחה (או העמוד) שההתראה מצביעה אליה. | | **כותרת תחתונה** | תזכורת היכן לכבות את המיילים האלה. | שלושה דברים שכדאי לדעת: - **האימייל נכתב בשפת הפרופיל *שלכם***, ולא בשפה של מי שהפעיל אותו. הגדירו אותה תחת **ניהול ← נציגים**. - **מזהה השיחה מופיע בנושא** עבור כל סוג ששייך לשיחה. חפשו בתיבה שלכם `#4821` כדי לשלוף כל התראה על אותה שיחה, ורוב תוכנות הדואר ישרשרו אותן יחד. - **מיילים על הודעה חדשה מוגבלים לאחד לכל שיחה בכל 10 דקות.** ראו [הגנה מפני הצפת אימייל](#email-flood-protection). ### דחיפה בדפדפן התראת שולחן עבודה ממערכת ההפעלה שלכם, שמוצגת גם כש‑Teloring בלשונית ברקע או שחלון אחר בחזית. נתמכת ב‑**Chrome**, ב‑**Edge**, ב‑**Firefox** וב‑**Safari 16.4 ומעלה**. ![התראת דחיפה של Teloring בשולחן העבודה](pathname:///img/screenshots/he/product/notifications/notifications-push.png) ההפעלה דורשת שני שלבים, כי גם הדפדפן שלכם צריך להסכים ולא רק Teloring: 1. לחצו **הפעלה בדפדפן הזה**. הדפדפן שלכם מבקש הרשאה — בחרו **אישור**. 2. הפעילו את המתג **דחיפה בדפדפן** ולחצו **שמירה**. צ׳יפ הסטטוס לצד הכפתור אומר לכם היכן אתם עומדים: | צ׳יפ | משמעות | מה לעשות | | --- | --- | --- | | **לא מופעל בדפדפן הזה** | הדפדפן הזה עדיין לא נרשם. | לחצו **הפעלה בדפדפן הזה**. | | **מופעל בדפדפן הזה** | רשום ומוכן. | כלום. **שליחת דחיפת בדיקה** מופיעה לצידו. | | **חסום על ידי הדפדפן** | אתם (או מישהו) בחרתם *חסימה* בבקשת ההרשאה. | אפשרו התראות לאתר הזה בהגדרות הדפדפן שלכם, ואז טענו מחדש את העמוד. ‏Teloring אינה יכולה לבקש שוב אחרי שחסמתם. | | **הדפדפן הזה אינו תומך בהתראות דחיפה** | דפדפן ישן, או חלון פרטי/גלישה בסתר. | השתמשו בדפדפן נתמך בחלון רגיל. | | **דחיפה בדפדפן אינה מוגדרת בשרת הזה** | לפלטפורמה אין מפתחות דחיפה מותקנים. | פנו למנהל ה‑Teloring שלכם. | :::caution הדחיפה נרשמת לכל דפדפן ולכל מכשיר הפעלה במחשב הנייד במשרד **אינה** מפעילה אותה במחשב הביתי או בדפדפן אחר. חזרו על שלב **הפעלה בדפדפן הזה** בכל מקום שבו אתם עובדים. ‏Teloring זוכרת עד **10** דפדפנים לכל נציג; מעבר לכך הישן ביותר נשמט. ::: #### אם דחיפת בדיקה אומרת שנשלחה אך שום דבר אינו מופיע {#if-a-test-push-says-it-was-sent-but-nothing-appears} Teloring יכולה למסור את ההתראה לדפדפן שלכם, אבל היא אינה יכולה להכריח את מערכת ההפעלה שלכם להציג אותה. כשהאישור אומר שהדחיפה נשלחה ואתם עדיין לא רואים דבר, החסימה נמצאת מחוץ ל‑Teloring: | בדיקה | היכן | | --- | --- | | התראות מאושרות עבור הדפדפן שלכם | **macOS:** הגדרות מערכת ← התראות ← *הדפדפן שלכם*
**Windows:** הגדרות ← מערכת ← התראות | | מצב "נא לא להפריע" / פוקוס כבוי | מרכז הבקרה ב‑macOS, או פאנל ההתראות ב‑Windows | | התראות מאושרות עבור האתר | הגדרות הדפדפן ← הגדרות אתרים ← התראות ← `console.teloring.com` | ### פעמון ההתראות מוסיף את ההתראה לפעמון בסרגל העליון, עם מונה של מה שלא ראיתם. זו השיטה היחידה ששומרת היסטוריה — ראו [פעמון ההתראות](#the-notification-bell) למטה. --- ## על מה — שלושת סוגי ההתראות ![שלושת סוגי ההתראות עם המתגים שלהם](pathname:///img/screenshots/he/product/notifications/notifications-what.png) | סוג | מופעל כאשר | | --- | --- | | **שיחה שויכה אליי** | הנציג המשויך של שיחה הופך להיות אתם. | | **הודעה חדשה בשיחה שאני משויך אליה** | לקוח שולח הודעה לשיחה שכבר בבעלותכם. | | **התראות סטודיו** | תהליך סטודיו שולח לכם התראה במכוון. | ### שיחה שויכה אליי מופעלת בכל פעם ששיחה נוחתת על השם שלכם — **בלי קשר למי או למה שם אותה שם**: - עמית ששייך אותה אליכם ידנית; - פעולה מרובה ברשימת השיחות; - **צוות** ששייך אוטומטית לחבר מחובר; - תהליך **סטודיו** שמסר אותה אליכם; - **נציג AI** שמסר את השיחה לאדם. **היא אינה מופעלת כשאתם משייכים שיחה לעצמכם.** אתם כבר מסתכלים עליה; התראה על הלחיצה שלכם עצמכם היא רעש. ההתראה מספרת לכם את שם הלקוח, מאיזה ערוץ היא הגיעה ומי שייך אותה. לחיצה עליה פותחת את השיחה. ### הודעה חדשה בשיחה שאני משויך אליה מופעלת כש**לקוח** שולח הודעה לשיחה שהנציג המשויך שלה הוא אתם. עובדת בכל סוגי התיבות: WhatsApp, אימייל, SMS, טלגרם, LINE, צ׳אט באתר, Messenger, פייסבוק, אינסטגרם, TikTok ו‑API. היא בכוונה **אינה** מופעלת כאשר: | מצב | למה לא | | --- | --- | | השיחה אינה משויכת | אף אחד עדיין אינו מחזיק בה — אין "אני" להתריע לו. השתמשו בתהליך סטודיו אם תרצו לדעת על תור ההמתנה. | | השיחה שייכת לעמית | אינכם הנציג המשויך. | | השיחה מטופלת על ידי **נציג AI** | נציג AI תופס את מקום הנציג המשויך אך אין לו תיבה לקבלת התראות. | | נציג שולח הודעה | ההתרעות האלה עוסקות במה ש*לקוחות* עושים. | ההתראה כוללת את תחילת ההודעה של הלקוח, כדי שתוכלו לשפוט את הדחיפות בלי לפתוח אותה. :::tip תיבות עמוסות בתיבה עם נפח גבוה הסוג הזה יכול להיות מופעל לעיתים קרובות. נציגים רבים מפעילים אותו רק ב**צליל + פעמון** ומשאירים את האימייל כבוי. לאימייל יש [הגנה מפני הצפה](#email-flood-protection) משלו בדיוק מהסיבה הזו. ::: ### התראות סטודיו מופעלת כשתהליך סטודיו מריץ את הפעולה **שליחת התראת Teloring** ונוקב בכם כנמענים. המתג הזה מכסה את *כל* מה ששני הראשונים אינם מכסים. מכיוון שטקסט ההודעה והטריגר הם באחריותכם לעצב, אין גבול למה שהוא יכול לספר לכם: - נוצר איש קשר עם סטטוס *ליד*; - סף באנליטיקס נחצה; - שיחה ממתינה יותר מדי זמן; - הוגש טופס; - לקוח השיב מחוץ לשעות הפעילות; - מערכת חיצונית קראה ל‑Webhook שלכם. ראו [בניית התראות משלכם עם סטודיו](#build-your-own-notifications-with-studio). :::note הגדרות מתקדמות שני הסוגים הראשונים קיימים כדי שתקבלו משהו שימושי בלי לגעת בסטודיו. אחרי שתרגישו בנוח בסטודיו, נהוג לכבות את שניהם ולהניע הכול מתהליכים במקום — כך אתם שולטים בניסוח, בתזמון ובקהל המדויקים. ::: --- ## איך "על מה" ו"איך" משתלבים שתי הרשימות מוכפלות. כל שיטה שתפעילו חלה על כל סוג שתפעילו. **דוגמה מעובדת.** אתם מפעילים את כל ארבע השיטות, ורק את הסוג **התראות סטודיו**. בסטודיו אתם בונים *"על כל איש קשר חדש שנוצר"* ← **שליחת התראת Teloring** עם הטקסט `איש קשר חדש {{contact.name}} נוצר!` נוצר איש קשר בשם יוסי לוי. אתם מקבלים את כל הארבע בבת אחת: | שיטה | מה קורה | | --- | --- | | **צליל** | הצליל שבחרתם מתנגן. אין טקסט — צליל הוא רק רמז. | | **אימייל** | מגיע אימייל עם *איש קשר חדש יוסי לוי נוצר!* | | **דחיפה בדפדפן** | התראת שולחן עבודה מציגה את אותה שורה. | | **פעמון** | תג הפעמון עולה באחד; הרשומה נקראת *איש קשר חדש יוסי לוי נוצר!* | אילו הפעלתם רק את הפעמון, הייתה מופיעה רק רשומת הפעמון. התהליך מחליט *מה* לומר ו*למי* לספר — **הפרופיל של כל נמען מחליט איך זה מגיע אליו**. --- ## פעמון ההתראות {#the-notification-bell} הפעמון נמצא בסרגל העליון, לצד **התנתקות**, בכל עמוד. ![פעמון ההתראות עם תג של לא נקראו](pathname:///img/screenshots/he/product/notifications/notification-bell.png) ### התג המספר על הפעמון הוא כמה התראות הגיעו **מאז שפתחתם את הרשימה בפעם האחרונה**. הוא מתעדכן בזמן אמת — אין צורך לרענן. כשמשהו מגיע, הפעמון מזדעזע קלות. ### פתיחת הרשימה ![תפריט פעמון ההתראות, עם רשומות שלא נקראו מודגשות](pathname:///img/screenshots/he/product/notifications/notification-bell-open.png) | רכיב | מה הוא עושה | | --- | --- | | **התראות** | כותרת הפאנל. | | **הגדרות** | קופץ למדור ההתראות בפרופיל שלכם. | | הרשימה | **100** ההתראות האחרונות שלכם, החדשות ביותר תחילה. | | רשומה | סמל לפי סוג, טקסט ההתראה, כל פירוט נוסף, וכמה זמן עבר מאז שהגיעה. | | רשומות מודגשות | כל מה שהיה חדש ברגע שפתחתם את הרשימה. | **פתיחת הרשימה מסמנת הכול כנקרא.** זה בכוונה, וכדאי להבין זאת: 1. התג מציג `10`. 2. אתם פותחים את הרשימה. אתם רואים את 100 ההתראות האחרונות, ואותן 10 מודגשות במודגש כדי שתדעו מה חדש. 3. התג מתאפס מיד. 4. תחליפו עמוד או תרעננו, ולפעמון אין תג — אבל פתיחה שלו עדיין מציגה את אותן 100 רשומות, כולן רגילות עכשיו. שום דבר אינו נמחק מקריאה. ההיסטוריה נשארת; רק סימון ה"חדש" מתנקה. כך הפעמון אינו הופך למטלה שצריך לנהל. ### לחיצה על רשומה רשומה שמצביעה למקום כלשהו היא קישור — בדרך כלל לשיחה המעורבת. רשומות ללא יעד (התראת סטודיו שמוגדרת ל*כלום — טקסט בלבד*) הן טקסט רגיל. קישורי התראה תמיד נשארים בתוך Teloring. תהליך אינו יכול לגרום להתראה לקשר לאתר חיצוני. --- ## שליחת בדיקה לעצמכם שני כפתורים מאפשרים לכם לבדוק את ההגדרות בלי לחכות לאירוע אמיתי. | כפתור | היכן | מה הוא עושה | | --- | --- | --- | | **שליחת דחיפת בדיקה** | לצד צ׳יפ הסטטוס של הדחיפה בדפדפן | שולח דחיפה לדפדפן הזה בלבד. מופיע לאחר שהדפדפן הזה נרשם. | | **שליחת בדיקה לעצמי** | לצד **שמירה** | שולח התראה מלאה דרך **ההגדרות השמורות הנוכחיות** שלכם — כל שיטה שהפעלתם. | **שמרו קודם.** שני הכפתורים בודקים את מה ששמור בשרת, ולא את מה שמוצג כרגע על המסך. אם תשנו מתג ותבדקו בלי לשמור, אתם בודקים את ההגדרות הישנות. **שליחת בדיקה לעצמי** דורשת לפחות שיטת מסירה אחת ולפחות סוג אחד מופעלים, אחרת אין מה לשלוח. --- ## בניית התראות משלכם עם סטודיו {#build-your-own-notifications-with-studio} הפעולה **שליחת התראת Teloring** היא בלוק THEN בקבוצת **כלים** בבורר הבלוקים של סטודיו. ![בלוק שליחת התראת Teloring בפאנל המאפיינים של סטודיו](pathname:///img/screenshots/he/product/studio/action-notify-agents.png) בקצרה: | מאפיין | מה הוא עושה | | --- | --- | | **שליחה אל** | נציגים ספציפיים · הנציג המשויך לשיחה הזו · כל חברי צוות. | | **הודעה** | הטקסט שהנציגים רואים. תומך בכל `{{משתנה}}` מבלוקים קודמים. | | **פרטים נוספים** | שורה שנייה אופציונלית. | | **לחיצה על ההתראה פותחת** | את השיחה · כלום · עמוד ספציפי ב‑Teloring. | מדריך מלא, פלטים והתנהגות: **[סטודיו ← פעולות ← שליחת התראת Teloring](./studio/actions.md#send-teloring-notification)**. :::info הנמענים עדיין שולטים במסירה תהליך יכול להחליט *מי* יקבל התראה ו*מה* היא אומרת. הוא לעולם אינו יכול להחליט *כמה בקול*. נציג שההתראות שלו כבויות, או ש**התראות סטודיו** שלו כבויות, אינו מקבל דבר משום תהליך. ::: --- ## מגבלות והתנהגות | התנהגות | ערך | | --- | --- | | התראות שנשמרות ברשימת הפעמון | **100** האחרונות | | שמירת היסטוריית התראות | **30 יום**, ואז נמחקת אוטומטית | | מיילים על הודעה חדשה לכל שיחה | לכל היותר **1 בכל 10 דקות** | | מיילי שיוך ומיילי סטודיו | ללא הגבלת קצב | | דפדפנים רשומים לדחיפה לכל נציג | עד **10**; מעבר לכך הישן ביותר נשמט | | הגנה מפני כפילויות | אותו אירוע אינו יכול להתריע לכם פעמיים בתוך 60 שניות | | אורך טקסט ההתראה | הודעה עד 160 תווים, פרטים עד 600 | ### הגנה מפני הצפת אימייל {#email-flood-protection} נציג עמוס יכול לקבל מאות הודעות מלקוחות ביום. אימייל אחד לכל אחת היה קובר את התיבה שלכם, ולכן Teloring שולחת לכל היותר **אימייל אחד על הודעה חדשה לכל שיחה בכל 10 דקות**. - זה חל **רק** על הסוג *הודעה חדשה*. התראות שיוט והתראות סטודיו לעולם אינן מעוכבות — הן בנפח נמוך ובשליטתכם. - זה **לכל שיחה בנפרד**. הודעות בשלוש שיחות שונות עדיין מייצרות שלושה מיילים. - **שום דבר אחר אינו מושפע.** הצליל, הדחיפה ורשומת הפעמון עדיין מופעלים על כל הודעה. רק האימייל מדולג. חלון הזמן הפעיל מוצג במסך ההגדרות, כך שאימייל חסר לעולם אינו נראה כתקלה. --- ## פרטיות ובידוד | ערובה | איך | | --- | --- | | ההתראות פרטיות לכם | כל התראה נמסרת בערוץ הפרטי שלכם ונשמרת תחת רשומת הנציג שלכם. | | ההגדרות פרטיות לכם | רק הסשן המחובר שלכם יכול לקרוא או לשנות אותן. | | אין דליפה בין חשבונות | נציג בחשבון Teloring אחד לעולם אינו יכול לקבל, או לקרוא, התראה ששייכת לחשבון אחר. | | הקישורים נשארים בתוך Teloring | יעדי ההתראות מוגבלים לעמודי Teloring. קישור חיצוני או קישור סקריפט נדחה. | | הטקסט תמיד עובר בריחה | טקסט ההתראה מוצג כטקסט בכל מקום, כולל באימייל. | | נציגים מושבתים מפסיקים לקבל | השבתת נציג עוצרת את ההתראות שלו מיד. | --- ## פתרון תקלות | תסמין | סיבה סבירה | תיקון | | --- | --- | --- | | שום דבר אינו מגיע | המתג הראשי כבוי, או שלא בחרתם שום סוג. | בדקו את **הפעלת התראות**, ואז לפחות שיטה אחת **וגם** סוג אחד. | | שמרתי אבל שום דבר לא השתנה | השינוי לא נשמר. | לחצו **שמירה** והמתינו לאישור לצד הכפתור. | | אין צליל, אבל הפעמון עובד | עדיין לא בוצעה אינטראקציה עם הדפדפן, או שהלשונית מושתקת. | לחצו בכל מקום בעמוד. ודאו שהלשונית אינה מושתקת (לחיצה ימנית עליה). | | אין דחיפה, כל השאר עובד | הדפדפן הזה אינו רשום, או שמערכת ההפעלה חוסמת. | בדקו את צ׳יפ הסטטוס. אם הוא מציג *מופעל*, ראו [אם דחיפת בדיקה אומרת שנשלחה](#if-a-test-push-says-it-was-sent-but-nothing-appears). | | הדחיפה עבדה ואז נעצרה | הדפדפן זרק את הרישום — זה קורה אחרי ניקוי נתוני אתר. | לחצו **הפעלה בדפדפן הזה** שוב. | | הדחיפה עובדת במכשיר אחד ולא באחר | הדחיפה היא לכל דפדפן ולכל מכשיר. | הריצו **הפעלה בדפדפן הזה** במכשיר האחר. | | אין אימייל על הודעות חדשות, אבל הפעמון עובד | המגבלה של 10 דקות לכל שיחה. | צפוי. ראו [הגנה מפני הצפת אימייל](#email-flood-protection). | | אין אימייל בכלל | האימייל בפרופיל שלכם שגוי, או שהדואר מסונן. | בדקו את הכתובת שלכם תחת **הפרופיל שלי**, ואז את תיקיית דואר הזבל עבור `do-not-reply@teloring.com`. | | התג אינו מתאפס | הרשימה מעולם לא נפתחה, או שהעמוד ישן. | פתחו את הפעמון. | | לא קיבלתי התראה על הודעה חדשה | השיחה אינה משויכת אליכם. | רק הנציג המשויך מקבל התראה. השתמשו בתהליך סטודיו כדי לקבל עדכון על שיחות ללא שיוך. | | לא קיבלתי התראה כשלקחתי שיחה בעצמי | בכוונה. | שיוך עצמי לעולם אינו מתריע. | | תהליך סטודיו לא התריע לאף אחד | לא נמצא נמען, או שלנמענים הסוג כבוי. | בדקו את הפלטים `notification.recipients` ו‑`notification.delivered` של הבלוק. | --- ## קשור - [סטודיו ← פעולות ← שליחת התראת Teloring](./studio/actions.md#send-teloring-notification) — בניית טריגרי התראות משלכם - [שיחות](../getting-started/conversations.md) — שיוך ותור ההמתנה - [צוותים](./teams.md) — ניתוב צוותי, שמניע התראות שיוך - [נציגים](./agents.md) — שפת הפרופיל, שקובעת את שפת האימייל שלכם - [אנליטיקס](./analytics.md) — התראות סף שאפשר לחבר לתהליך התראות --- # Teloring API מקור: https://docs.teloring.com/he/api/ Markdown: https://docs.teloring.com/he/markdown/api/index.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:49:57.000Z Everything an agent can do in the console, your systems can do over HTTPS: conversations across every channel, the CRM behind them, the automations, the knowledge bases, the numbers — and, when you need it, a way to drop one of your own users straight into a specific chat. ``` https://api.teloring.com/v1 ``` ## Five minutes to your first call **1. Create a credential.** In the console, go to **Settings → API** and press **New credential**. Give it a name, choose an expiry (or leave it unlimited), and tick the scopes it needs. Each scope unlocks a whole feature area — grant only what you will use. **2. Copy the client secret.** It is shown once, at creation, and never again. If you lose it, revoke the credential and create another; the client id stays visible forever, so you can always tell which credential is which. **3. Get a token.** ```bash curl -X POST https://api.teloring.com/v1/oauth/token \ -H "Content-Type: application/json" \ -d '{ "client_id": "tlc_811fc5491673d78d047a1085da2e22b7", "client_secret": "tls_9f3c8a21b6d54e7f90a1c2b3d4e5f60718293a4b5c6d7e8f" }' ``` ```json { "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…", "token_type": "Bearer", "expires_in": 3600, "expires_at": "2026-08-20T11:24:31+00:00", "scopes": ["conversations", "messages", "customers"], "account_id": "42" } ``` **4. Call something.** ```bash curl https://api.teloring.com/v1/conversations?status=open \ -H "Authorization: Bearer $ACCESS_TOKEN" ``` **5. Send a message.** ```bash curl -X POST https://api.teloring.com/v1/conversations/387/messages \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{"type": "text", "content": "Thanks — we are on it."}' ``` That is the whole shape of the API. Everything else is more endpoints. ## The things worth knowing up front **There is no account id in any path.** Your token already identifies the account. That is not a convenience — it is what makes reaching another business's data unrepresentable rather than merely forbidden. **Scopes are checked on every request, against live data.** Remove a scope in the console and the very next call fails, without waiting for the token to expire. **This is a server-side API.** No CORS headers are sent, deliberately: a token in browser JavaScript is a token in your page source. Call it from your backend. **Some calls cost money.** Creating an agent takes a seat and may charge the card on file; WhatsApp templates, outbound SMS and signing links cost credits. Every such endpoint says so, in bold, at the top of its description. **Everything you write is audited.** Each mutation is recorded with the credential that made it, so "what changed this?" always has an answer. See [Audit log](/api/list-audit-log). **IP restrictions apply.** If the account limits access by IP under Settings → Security & login, that limit covers the API too — see [IP restrictions](./guide-authentication#ip-restrictions). ## Where to go next | | | | --- | --- | | [Authentication](./guide-authentication) | Tokens, rotation, and what each failure means | | [Scopes](./guide-scopes) | What every scope unlocks, and how to choose | | [Pagination, filtering & errors](./guide-conventions) | The conventions every endpoint follows | | [SSO login](./guide-sso) | Signing your users into the console, standalone or in an iframe | | [Postman collection](./guide-postman) | Import all 115 endpoints and start clicking | Then browse the endpoint reference in the sidebar — every operation has its parameters, request body, response schema and a runnable example. --- # Teloring API מקור: https://docs.teloring.com/he/api/teloring-api Markdown: https://docs.teloring.com/he/markdown/api/teloring-api.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import ApiLogo from "@theme/ApiLogo"; import Heading from "@theme/Heading"; import SchemaTabs from "@theme/SchemaTabs"; import TabItem from "@theme/TabItem"; import Export from "@theme/ApiExplorer/Export"; The Teloring REST API gives your own systems the same reach an agent has in the console: conversations across every channel, the CRM behind them, the automations, the knowledge bases, the numbers, and — when you need it — a way to drop one of your users straight into a specific chat. ## Base URL ``` https://api.teloring.com/v1 ``` Every path in this reference is relative to that. There is no account id in any path: your access token already identifies the account, which is what makes it impossible for a credential to reach somebody else's data. ## Getting started in four steps 1. In the console, go to **Settings → API** and create a credential. Choose its scopes — each one unlocks a whole feature area — and copy the **client secret**. It is shown once and never again. 2. Exchange the client id and secret for an access token: `POST /v1/oauth/token`. Tokens last one hour. 3. Send the token as `Authorization: Bearer ` on every request. 4. Call `GET /v1/oauth/introspect` if anything is unexpected — it tells you which account you are on and exactly which scopes you hold. ## What you should know before you build - **Server-side only.** There are no CORS headers on this API by design. A token in browser JavaScript is a token in your page source. - **Scopes are checked live.** Removing a scope in the console takes effect on the very next request, not when the token expires. - **Some calls cost money.** Creating an agent takes a seat and may charge the card on file. WhatsApp templates, outbound SMS and signing links cost credits. Each of those endpoints says so. - **Rate limit:** 600 requests per minute per credential; 20 per minute per IP on the token endpoint. Cache your token — you need one per hour, not one per request. - **IP restrictions apply here too.** If the account has an IP allow-list set under Settings → Security & login, it governs API calls exactly as it governs sign-in. Calling from an address that is not on it answers `403` with `code: ip_not_allowed` — add your server's outbound IP there. ## Errors Every failure answers in the same shape, with a machine-readable `code` and a `request_id` to quote if you need help: ```json { "error": { "type": "invalid_request_error", "code": "missing_parameter", "message": "'inbox_id' is required.", "param": "inbox_id", "request_id": "req_5f2a91c0e8b74d3a9c1e" } } ```
`Authorization: Bearer `, where the token came from `POST /v1/oauth/token`. Tokens last one hour. A `401` with `code: invalid_token` means fetch a new one.
Security Scheme Type: http
HTTP Authorization Scheme: bearer
Bearer format: JWT

Contact

Teloring support: URL: [https://docs.teloring.com](https://docs.teloring.com)
--- # Authentication מקור: https://docs.teloring.com/he/api/guide-authentication Markdown: https://docs.teloring.com/he/markdown/api/guide-authentication.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:49:57.000Z Teloring uses **OAuth 2.0 client credentials**. You hold a long-lived client id and secret; you exchange them for a short-lived access token; you send that token on every request. ``` client id + secret ──POST /v1/oauth/token──▶ access token (1 hour) │ Authorization: Bearer ────┘ ``` The split is the point. A leaked access token expires by itself within the hour. A leaked secret is revoked in one click, without you redeploying anything. ## Creating a credential **Settings → API → New credential.** You choose four things: | | | | --- | --- | | **Name** | For you. It shows up in the audit log next to everything this credential does, so name it after the integration, not after a person. | | **Expiration** | A date, or unlimited. A date is worth setting for anything temporary — a migration script, a contractor's integration. | | **Scopes** | Which feature areas it may reach. See [Scopes](./guide-scopes). | | **SSO settings** | Only if you ticked the `sso` scope: which agents it may sign in as, and which sites may embed the session. | You get back a **client id** (`tlc_…`, visible forever) and a **client secret** (`tls_…`, shown once). :::warning The secret is shown once It is stored only as a bcrypt hash. Nobody — not an Owner, not Teloring support — can retrieve it afterwards. Lost it? Revoke the credential and create another. ::: ## Getting a token `POST /v1/oauth/token` accepts your credentials three ways. Use whichever your HTTP client makes easiest; they are equivalent.
JSON body ```bash curl -X POST https://api.teloring.com/v1/oauth/token \ -H "Content-Type: application/json" \ -d '{"client_id": "tlc_…", "client_secret": "tls_…"}' ```
Form-encoded (what most OAuth libraries send) ```bash curl -X POST https://api.teloring.com/v1/oauth/token \ -d grant_type=client_credentials \ -d client_id=tlc_… \ -d client_secret=tls_… ```
HTTP Basic (RFC 6749 §2.3.1) ```bash curl -X POST https://api.teloring.com/v1/oauth/token \ -u "tlc_…:tls_…" \ -d grant_type=client_credentials ``` If both a Basic header and body parameters are present, the header wins — a body parameter cannot downgrade it.
### Cache the token One token per hour is the expected pattern. The token endpoint is rate limited to **20 requests per minute per IP**, and ten consecutive failures against one client id lock that client out for fifteen minutes. A minimal client, in the shape most people end up writing: ```python import time, requests class Teloring: BASE = "https://api.teloring.com/v1" def __init__(self, client_id, client_secret): self._id, self._secret = client_id, client_secret self._token, self._expires_at = None, 0 def _auth_header(self): # Refresh a minute early so a request never races the expiry. if not self._token or time.time() > self._expires_at - 60: response = requests.post( f"{self.BASE}/oauth/token", json={"client_id": self._id, "client_secret": self._secret}, timeout=10, ) response.raise_for_status() payload = response.json() self._token = payload["access_token"] self._expires_at = time.time() + payload["expires_in"] return {"Authorization": f"Bearer {self._token}"} def get(self, path, **params): response = requests.get(f"{self.BASE}{path}", headers=self._auth_header(), params=params, timeout=30) if response.status_code == 401: # revoked or edited mid-flight self._token = None response = requests.get(f"{self.BASE}{path}", headers=self._auth_header(), params=params, timeout=30) response.raise_for_status() return response.json() ``` The `401` retry matters more than it looks. Editing a credential's scopes, or revoking it, invalidates outstanding tokens **immediately** — so a token can stop working before its stated expiry, and the correct response is to fetch a new one once, not to crash. ## Using the token ``` Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9… ``` Not sure what a token can do? `GET /v1/oauth/introspect` tells you the account, the credential, and exactly which scopes it holds. It is the fastest way to explain a surprising `403`. ## When authentication fails | Status | `code` | What happened | What to do | | --- | --- | --- | --- | | 400 | `invalid_request` | A credential field was missing | Send both `client_id` and `client_secret` | | 400 | `unsupported_grant_type` | `grant_type` was not `client_credentials` | Only that grant is supported | | 401 | `invalid_client` | Unknown client id, wrong secret, revoked credential, or one past its expiry date | Check the pair; check the credential in Settings → API | | 401 | `missing_token` | No `Authorization: Bearer` header | Add the header | | 401 | `invalid_token` | Token expired, tampered with, or its credential was revoked or edited | Fetch a new token | | 402 | `plan_limit_exceeded` | The account's plan does not include API access | Upgrade the plan | | 403 | `ip_not_allowed` | The account restricts access by IP and yours is not on the list | Add your server's outbound IP under Settings → Security & login | | 429 | `too_many_failed_attempts` | Ten consecutive failures on one client id | Wait fifteen minutes; check the secret | | 429 | `rate_limit_exceeded` | Too many token requests from this IP | Cache the token | :::note One message for every credential failure Unknown client id, wrong secret, revoked and expired all answer the same `401 invalid_client`. Distinguishing them would let somebody enumerate which client ids exist. Our logs record the real reason — quote the `request_id` from the response if you need us to look. ::: ## IP restrictions If the account has an IP allow-list under **Settings → Security & login**, it applies to the API as well as to sign-in. That list is described in the console as "who may access the system", and an integration holding a credential *is* access to the system. When one is set: - `POST /v1/oauth/token` refuses a call from an address that is not on the list and issues no token at all. - Every authenticated request is checked again, not just the token exchange. A token already in hand stops working the moment it is used from a disallowed address — a one-hour window during which a stolen token still worked would be a weaker promise than the one Settings makes. Both answer `403`: ```json { "error": { "type": "permission_error", "code": "ip_not_allowed", "message": "This IP address is not on the account's allow-list. Add it under Settings → Security & login, or call the API from an allowed address.", "details": { "client_ip": "203.0.113.55" }, "request_id": "req_5f2a91c0e8b74d3a9c1e" } } ``` The address we compare is your server's **outbound** IP as it reaches us, which is often not the address of the machine running your code — a NAT gateway, a load balancer or an egress proxy usually sits in between. `details.client_ip` in the error tells you exactly what we saw, so add that. Both single addresses and CIDR ranges are accepted in the console: ``` 198.51.100.7 192.0.2.0/24 ``` An account with an empty list is unrestricted, which is the default. :::caution Serverless and dynamic IPs If your integration runs somewhere with a changing outbound address (most serverless platforms, some CI runners), either give it a static egress IP or leave the allow-list empty. A partially-correct list produces intermittent `403`s that are miserable to debug. ::: ## Rotating a secret There is no in-place rotation, on purpose: a credential that can change its own secret is a credential whose secret can be changed by whoever holds it. The zero-downtime rotation is two credentials: 1. Create a second credential with the same scopes. 2. Deploy the new client id and secret to your integration. 3. Watch **Last used** on the old credential in Settings → API until it stops moving. 4. Revoke the old one. ## Keeping the secret safe - Store it in a secrets manager or an environment variable — never in source control, never in a frontend bundle, never in a URL. - Give each integration its own credential with its own scopes. One shared secret across five systems means a leak anywhere is a leak everywhere, and the audit log cannot tell you which system did what. - Set an expiry on anything temporary. - Revoke immediately if you suspect exposure. Revocation kills outstanding access tokens as well as the secret. --- # Scopes מקור: https://docs.teloring.com/he/api/guide-scopes Markdown: https://docs.teloring.com/he/markdown/api/guide-scopes.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:49:57.000Z A scope is a **whole feature area**, not a verb. Granting `conversations` allows every conversation operation — read, create, update, hold, resolve, delete — because an integration that can read conversations but not resolve them is usually just an integration that will be granted the second half next week. Choose scopes the other way round instead: grant the areas an integration genuinely touches, and leave the rest off. A credential that only syncs customers into a data warehouse should hold `customers` and nothing else. ## The catalog | Scope | Unlocks | | --- | --- | | `conversations` | List, create, update, hold, resolve and delete conversations; read the queue counts; list inboxes; read and write conversation custom attributes | | `messages` | Read a conversation's messages; send text, media, notes and WhatsApp templates; delete a message; list WhatsApp templates | | `customers` | Read, create, update, search and delete customers; list a customer's contacts | | `customer_objects` | Read the object types and manage their records — deals, service calls, tasks and your own | | `analytics` | Read dashboards and run their graphs | | `studio` | Read flows, their blocks and each block's settings | | `ai_world` | Read every AI capability and switch one on or off | | `knowledge_base` | Manage knowledge bases, their sources and the indexed chunks | | `quick_replies` | Read, create, update and delete saved replies | | `forms` | Read forms and their submissions; delete a form | | `documents_signature` | Read documents, upload a PDF, create and revoke signing links | | `account` | Read and update the account's general and invoicing details | | `business_hours` | Manage schedules; read holiday calendars | | `conversation_attributes` | Read the conversation-attribute schema | | `agents_teams` | Manage agents, AI agents and teams; read roles | | `audit_log` | Read the account's audit trail | | `billing` | Read credit balances, the usage price list, transactions and invoices | | `files` | List files with their storage usage; delete files | | `profile` | Read and update any agent's display name, timezone, picture and notification settings | | `notifications` | Read an agent's notification feed and unread count | | `sso` | Create single-use links that sign a chosen agent into the console | ## The four that deserve a second thought **`agents_teams` can spend money.** Creating a human or AI agent takes a seat, and a seat the plan does not have free is a real charge on the card. Grant this only to an integration that genuinely provisions people, and read the warning on [Create a human agent](/api/create-agent). **`documents_signature` can spend credits.** Every signing link costs. The endpoint is safe to retry — a repeat for the same document and contact returns the existing link and charges nothing — but a loop that creates links for a list of contacts spends real money. **`profile` reaches every agent in the account,** addressed by id in the path. It is the right scope for syncing display names or timezones from an HR system, and the wrong one for almost anything else. **`sso` grants nothing on its own.** See below. ## Scopes that carry extra configuration ### `sso` Ticking the scope is step one of two. The credential must also name: - **the agents** it may sign in as — a multi-select in Settings → API. An empty list means the credential can impersonate nobody, which is the safe default when somebody ticks the scope and saves. - **the origins** allowed to embed the resulting session in an iframe, if you plan to embed it. As many as you need, one per line, scheme and host only: ``` https://app.example.com https://portal.example.co.il https://crm.example.com:8443 ``` Removing an agent from that list invalidates every SSO link already issued for them. See [SSO login](./guide-sso). ## Changing scopes later Scopes are editable on an existing credential — that is deliberate, so an integration that grows a feature does not force you to rotate a secret your client has already deployed. The client id and the secret never change. Everything else does: 1. **Settings → API**, press **Edit** on the credential. 2. Tick or untick scopes; adjust the SSO agents and origins. 3. Save. Editing a credential **invalidates its outstanding access tokens.** The next call answers `401 invalid_token`, and the client fetches a new token carrying the new scopes. That is why the client sketch in [Authentication](./guide-authentication) retries once on a `401` — with that in place, a scope change is invisible to a running integration. ## When a scope is missing ```json { "error": { "type": "permission_error", "code": "insufficient_scope", "message": "This credential does not hold the 'conversations' scope. Edit the credential in Settings → API to grant it.", "details": { "required_scope": ["conversations"], "granted_scopes": ["customers", "billing"] }, "request_id": "req_5f2a91c0e8b74d3a9c1e" } } ``` The error names what was needed and what you hold, so it is usually self-diagnosing. `GET /v1/oauth/introspect` answers the same question for a token you already have. ## Scopes are not the only gate Two other things can refuse an otherwise well-scoped request, and it is worth knowing which is which: - **`402 plan_limit_exceeded`** — the account's plan does not include the feature, or a ceiling is full. `GET /v1/billing/plan` lists every limit and feature flag. - **`403 feature_disabled`** — an account-level switch is off. The knowledge base endpoints answer this when the Knowledge Base capability is switched off in AI World, so you can tell "turned off" from "nothing indexed yet". --- # Pagination, filtering & errors מקור: https://docs.teloring.com/he/api/guide-conventions Markdown: https://docs.teloring.com/he/markdown/api/guide-conventions.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:49:57.000Z Learn these once and every endpoint behaves the way you expect. ## Responses **A single resource is returned as itself.** No envelope, nothing to unwrap: ```json { "object": "conversation", "id": "387", "status": "open", "…": "…" } ``` Every resource carries an `object` field naming its type, which is what lets you write one dispatcher over mixed results. **A collection is `data` plus `meta`:** ```json { "data": [ { "object": "conversation", "id": "387" } ], "meta": { "page": 1, "per_page": 25, "count": 25, "total": 155, "total_pages": 7, "has_more": true } } ``` **A delete answers uniformly**, so one handler covers all of them: ```json { "id": "387", "object": "conversation", "deleted": true } ``` Some deletes add a field describing the cascade — `unlinked_contacts` on a customer, `detached_conversations` on a team, `freed_bytes` on a bulk file delete. Read them; they are how you find out a delete did more than you expected. ## Pagination | Parameter | Default | Range | | --- | --- | --- | | `page` | 1 | ≥ 1 | | `per_page` | 25 | 1–100 | `per_page=500` is a `400`, not a silent clamp. A client asking for 500 rows a page has a design assumption worth correcting now rather than discovering in production. **Loop on `has_more`, not on `total`.** `total` is omitted where counting the full result set would cost a second scan; `has_more` is always present. ```python page = 1 while True: result = client.get("/conversations", status="open", page=page, per_page=100) for conversation in result["data"]: handle(conversation) if not result["meta"]["has_more"]: break page += 1 ``` :::tip Polling for changes Do not re-walk a whole collection on a timer. `GET /v1/conversations` takes `updated_after`, so a poll can ask only for what moved: ``` GET /v1/conversations?status=open&updated_after=2026-08-20T09:00:00Z ``` ::: ## Filtering **Repeated values within one filter are OR.** Both forms work, so use whichever your HTTP client produces: ``` ?label=vip&label=urgent ?label=vip,urgent ``` **Different filters are AND.** This finds open, urgent conversations in two inboxes that nobody owns: ``` ?status=open&priority=urgent&inbox_id=3,7&assignee_id=unassigned ``` **Two filters take sentinel values:** `assignee_id=unassigned` for the waiting line, and `team_id=none` for conversations no team owns. **Timestamps are ISO-8601.** `2026-08-20T09:00:00Z` or with an offset. A value that will not parse is a `400` naming the parameter rather than a silently ignored filter. **Unknown enum values are rejected,** and the error lists the accepted ones — `?status=nope` tells you it wants `open`, `pending`, `on_hold` or `resolved`. A filter you mistyped never silently returns everything. ## Errors One shape, everywhere: ```json { "error": { "type": "invalid_request_error", "code": "missing_parameter", "message": "'inbox_id' is required.", "param": "inbox_id", "request_id": "req_5f2a91c0e8b74d3a9c1e" } } ``` Branch on **`code`** — it is stable across releases. `type` groups failures the way you would handle them; `message` is written for a human reading a log. ### Status codes | Status | `type` | Means | | --- | --- | --- | | 400 | `invalid_request_error` | Something about the request is wrong. Fix it; retrying will not help. | | 401 | `authentication_error` | No token, or the token is no longer valid. Fetch a new one and retry once. | | 402 | `plan_limit_error` | Valid and authorised, but a plan ceiling or a locked feature stopped it. | | 403 | `permission_error` | The credential lacks the scope, an account switch is off, or the caller's IP is not on the account's allow-list. | | 404 | `not_found_error` | No such resource in this account. | | 409 | `conflict_error` | Valid, but conflicts with current state — a closed WhatsApp window, a duplicate team name. | | 413 | `invalid_request_error` | The upload is too large. | | 429 | `rate_limit_error` | Slow down. | | 5xx | `api_error` | Our problem. Retry with backoff and quote the `request_id`. | ### Validation detail Where several fields failed at once, the specifics arrive in `details`: ```json { "error": { "type": "invalid_request_error", "code": "validation_failed", "message": "One or more attribute values were rejected.", "details": { "errors": [ "reason_for_contact: 'refund' is not one of the allowed options", "order_number: required" ] } } } ``` ### `request_id` Every response carries one, in the body on errors and in the `X-Request-Id` header always. Quote it when reporting a problem — it is how we find the exact request in our logs. You may also supply your own, and it will be echoed back and used in our logs, which makes correlating with your side trivial: ``` X-Request-Id: my-job-4192-attempt-1 ``` ## Rate limits | | Limit | | --- | --- | | Authenticated requests | 600 per minute, per credential | | `POST /v1/oauth/token` | 20 per minute, per IP | Over the limit is a `429`. Back off exponentially — and if you are hitting the token limit, the fix is to cache the token rather than to retry harder. ## Retries and idempotency Most write endpoints are not idempotent: `POST /v1/customers` twice makes two customers. Where a retry is genuinely safe, it is because the endpoint was built that way and says so: - **`POST /v1/signature/links`** returns the existing link for the same document and contact instead of creating a second one, and does not charge again. `created` in the response says which happened. - **`POST /v1/agents`** rolls the agent back if the seat charge is declined, so a `402` means nothing was created. - **`PATCH`** endpoints are naturally idempotent — sending the same body twice leaves the same state. For everything else, retry a `429` or a `5xx`; do not blind-retry a `400`. ## Timestamps and ids All timestamps are **ISO-8601 in UTC**, and a field that has no value is `null` rather than `""` — so you can tell "never resolved" from "resolved at an unknown time". Ids are **opaque strings**. Some look like numbers (`"387"`), some like hashes (`"kIlBtSS5yQTGeghZmlQ3"`). Store them as strings; never parse or generate one. ## What this API will not do Worth knowing before you plan around it: - **No webhooks in this version.** Poll with `updated_after`. Studio can already call your endpoint on conversation events if you need push today. - **No visual editors.** Studio flows, form layouts and signature field placement are coordinates on a canvas, and a JSON body of pixel offsets is not a contract anybody should have to write. Those stay in the console; this API reads them. - **No browser access.** No CORS headers, deliberately. --- # SSO login מקור: https://docs.teloring.com/he/api/guide-sso Markdown: https://docs.teloring.com/he/markdown/api/guide-sso.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:49:57.000Z Your users already work in your product. SSO login lets them reach Teloring from inside it, without a second password: your backend asks for a link, your user opens it, and they land in the console signed in as a specific agent. Two shapes, for two different jobs: **Full system** — the whole console, exactly as if they had signed in. Use it for a "Open in Teloring" button. **Specific conversation** — one contact's chat and nothing else. No navigation, no conversation list, no dashboard. Use it when your user is looking at a customer in *your* system and wants to message them: open it in an iframe, send the message, close the iframe. ## Before it will work The `sso` scope alone grants nothing. In **Settings → API**, on the credential, you must also set: **Which agents it may sign in as.** A multi-select. An agent not on the list answers `403 agent_not_allowed`, and the error lists who is allowed. An empty list means the credential can impersonate nobody — the safe default when somebody ticks the scope and saves without choosing. **Which origins may embed it,** if you plan to use an iframe. As many as you need, one per line, scheme and host only: ``` https://app.example.com https://portal.example.co.il https://crm.example.com:8443 ``` Both are editable later without rotating the secret. ## Full system ```bash curl -X POST https://api.teloring.com/v1/sso/login \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{"agent_id": "agent_12", "mode": "full"}' ``` ```json { "object": "sso_login", "url": "https://console.teloring.com/sso/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…", "mode": "full", "agent_id": "agent_12", "agent_name": "Dana Levi", "embed": false, "expires_at": "2026-08-20T10:34:31+00:00", "expires_in": 600, "single_use": true } ``` Redirect the browser to `url`. They land on the dashboard, signed in as Dana. ## Specific conversation Identify the contact by `phone` or `email`. Add `inbox_id` when you know which channel to use. ```bash curl -X POST https://api.teloring.com/v1/sso/login \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "agent_id": "agent_12", "mode": "conversation", "contact": { "phone": "+972501234567" }, "inbox_id": "3", "embed": true }' ``` What your user sees depends on what exists, and the API tells you in advance under `target`: | Situation | What opens | | --- | --- | | A conversation with that contact is already open | That conversation, ready to reply | | No conversation, and you passed `inbox_id` | The composer, contact **and** inbox already chosen — only the message is left (or the template, on WhatsApp outside the 24-hour window) | | No conversation, and no `inbox_id` | The composer with the contact chosen; your user picks the inbox | The contact must already exist. An unknown phone or email answers `404 contact_not_found` — create the contact, or start the conversation with `POST /v1/conversations`, which will create it for you. ## Embedding in your own product Set `embed: true` and open the URL in an iframe: ```html ``` Three things happen because you asked for an embed: - The pages are served with `Content-Security-Policy: frame-ancestors` naming **only** the origins you configured. Any other site framing the same URL gets nothing. - The session cookie is issued `SameSite=None; Secure; Partitioned`. Partitioned matters: the cookie lives in *your* site's cookie partition, so it cannot be replayed from anywhere else — which is also what keeps cross-site request forgery closed on an embedded session. - In `conversation` mode, the embedded page posts a message to the parent window when the agent sends something, so you can close the iframe without polling: ```js window.addEventListener('message', (event) => { if (event.origin !== 'https://console.teloring.com') return; if (event.data?.source === 'teloring' && event.data.type === 'message_sent') { closeTeloringPanel(); // your code } }); ``` Requesting `embed: true` with no origins configured answers `400 no_embed_origins` rather than quietly handing you a page no browser will frame. ## How the link is protected A URL that bypasses the login screen is a credential, so it is treated like one. **Ten minutes, one use.** The link expires after ten minutes and is redeemable exactly once. A second attempt — a copied URL, a duplicated tab, a prefetching proxy — answers `409`. Mint one per use; never cache them. **Re-checked at redemption.** The link carries no permissions of its own. When it is opened, the credential is re-read (still active? still holds `sso`? still allows this agent?) and the agent is re-read (still exists? still active?). So removing an agent from the allowlist, or revoking the credential, kills every link already issued — within the ten-minute window, not after it. **Fails closed.** If the one-time-use store is unreachable, redemption is refused rather than allowed. A login-bypass link that silently becomes replayable is worse than one that briefly stops working. **Audited.** Every link minted and every redemption is written to the audit log with the credential, the agent and the mode, so `agent.sso_login` in the audit trail always names who let it happen. ## Handling a link that will not open If the link is expired, already used, or its credential or agent no longer qualifies, the user sees a small Teloring error page — **not** a redirect to the sign-in form. That is deliberate: inside your iframe, a Teloring login form is both useless and confusing to somebody who has no Teloring account of their own. That page says one of four things, and they split into two groups: | What the user sees | HTTP | Cause | Does a new link fix it? | | --- | --- | --- | --- | | You have already opened this link | `409` | The link was redeemed once already — a refresh, a back button, or a second click | Yes | | This sign-in link has expired | `401` | More than 10 minutes passed between minting and opening | Yes | | This sign-in link is no longer authorised | `403` | The credential was revoked, lost the `sso` scope, or the agent was removed from its allow-list | No | | This sign-in link no longer works | `403` | The agent it signs in as was deactivated | No | The first two are the everyday ones, and the page tells the user to go back and open it again — so they resolve themselves as soon as your product mints a new link. The last two are configuration changes on the Teloring side, so the page sends the user to whoever administers the account instead of round a retry loop that cannot succeed. Your integration's job is simply to mint a fresh link. Because they are cheap and single-use, the right pattern is to request one at the moment the user clicks, never to store one. A refresh of your own page should mint a new link rather than reload the iframe's existing URL — that URL is spent, and reloading it is the single most common way to land on the "already opened" page. ## A complete example ```python def open_teloring_chat(agent_id, customer_phone, inbox_id=None): """Return an iframe URL for messaging this customer. Call it per click.""" payload = { "agent_id": agent_id, "mode": "conversation", "contact": {"phone": customer_phone}, "embed": True, } if inbox_id: payload["inbox_id"] = inbox_id response = requests.post( "https://api.teloring.com/v1/sso/login", headers=client._auth_header(), json=payload, timeout=10, ) if response.status_code == 404: # No such contact yet — create the conversation, which creates the # contact, then try again. return None response.raise_for_status() return response.json()["url"] ``` ## Security notes for your side - **Mint links server-side only.** Your `sso` credential must never reach the browser: anyone holding it can sign in as any allow-listed agent. - **Authorise on your side first.** Teloring checks that the *credential* may impersonate the agent. It cannot check that *this particular user of yours* should be allowed to — that is your call, and you must make it before minting. - **Map your users to agents deliberately.** A shared agent id means your audit log says "the API" where it should say a person. - **Keep the origin list tight.** Every origin you add is a site that may frame a signed-in Teloring session. --- # Postman collection מקור: https://docs.teloring.com/he/api/guide-postman Markdown: https://docs.teloring.com/he/markdown/api/guide-postman.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:49:57.000Z Every endpoint in this API, in one importable collection — with the token dance already wired up. Download the collection Direct link, if you prefer to import by URL: ``` https://docs.teloring.com/teloring-api.postman_collection.json ``` ## Setting it up **1. Import.** In Postman: **Import → File** (or **Link**, pasting the URL above). You get a collection called *Teloring API v1.0.0* with one folder per feature area. **2. Fill in two variables.** Open the collection, go to the **Variables** tab, and paste the `client_id` and `client_secret` from **Settings → API** into the *Current value* column. | Variable | Set it to | | --- | --- | | `base_url` | Already set to `https://api.teloring.com/v1` | | `client_id` | Your client id, `tlc_…` | | `client_secret` | Your client secret, `tls_…` | | `access_token` | Leave empty — step 3 fills it in | :::tip Use *Current value*, not *Initial value* Postman shares *Initial value* when you share a collection. Secrets belong in *Current value*, which stays on your machine. ::: **3. Get a token.** Run **Authentication → Get an access token** and press **Send**. Its test script writes the token into the `access_token` variable, and the collection console logs the scopes it came back with. **4. Send anything.** Every other request inherits bearer auth from the collection, so it just works. Tokens last an hour — when requests start answering `401`, run step 3 again. ## Finding your way around The folders match the sidebar of this reference, so an endpoint you read about here is where you would expect it in Postman. - **Path parameters** are Postman variables: a request to `/conversations/:conversation_id` shows a *Path Variables* table under the URL. Fill in the value there. - **Query parameters** are pre-listed and **disabled**. Tick the ones you want — a fresh request sends none of them, which is the sensible default. - **Request bodies** are pre-filled from this reference's examples, so nothing is an empty box. Edit them in place. - **Descriptions** come from the same source as these pages, so the documentation travels with the request. ## A first run, end to end Try these five in order. It is the shortest path from "imported" to "sent a message". 1. **Authentication → Get an access token** — the token lands in the variable. 2. **Authentication → Inspect the current token** — confirms the account and the scopes you actually hold. 3. **Conversations → List inboxes** — note an `id` from the response. 4. **Conversations → Create a conversation** — put that inbox id in `inbox_id` and a real phone number in `contact.phone`. 5. **Messages → Send a message** — put the new conversation's id in the `conversation_id` path variable. ## Keeping it current The collection is **generated from the OpenAPI specification behind this reference**, on every docs build. It cannot describe an endpoint differently from these pages, and it cannot fall behind when endpoints are added. Re-download it after a Teloring release to pick up new endpoints. Postman's **Import → Link** keeps the URL, so a re-import is one click. ## Using the raw specification instead Prefer to generate a client, or import into Insomnia, Bruno, or an API gateway? The OpenAPI 3.1 document is the same source: ``` https://docs.teloring.com/api/openapi.yaml ``` It works with the usual generators — for example: ```bash openapi-generator-cli generate \ -i https://docs.teloring.com/api/openapi.yaml \ -g python \ -o ./teloring-client ``` --- # Account מקור: https://docs.teloring.com/he/api/account Markdown: https://docs.teloring.com/he/markdown/api/account.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z Who this business is, and when it is open. **Scopes:** `account`, `business_hours`, `conversation_attributes` An Israeli account's `billing_country` is locked once billing starts: it determined the VAT on invoices already issued. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Add a source מקור: https://docs.teloring.com/he/api/add-knowledge-base-source Markdown: https://docs.teloring.com/he/markdown/api/add-knowledge-base-source.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Add a source — a URL, or an uploaded file. **URL:** `application/json` with `{"url": "https://…"}`. Set `crawl_inner: true` to follow links within the same site. URLs are validated against private address ranges before the worker fetches them. **File:** `multipart/form-data` with a `file` part. PDFs, Office documents, plain text and images are supported. Returns `202` immediately with the source in `processing`. Poll `GET /v1/knowledge-bases/{kb_id}/sources` for the outcome — a large PDF takes minutes, not seconds. Request --- # Agents & teams מקור: https://docs.teloring.com/he/api/agents-teams Markdown: https://docs.teloring.com/he/markdown/api/agents-teams.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z The people — and the AI — who answer conversations. **Scope:** `agents_teams` ⚠️ **Creating an agent can charge the card on file.** A human or AI agent occupies a seat; if the plan has none free, a prorated charge is taken. A `402` with `code: seat_charge_failed` means nothing was created and a retry is safe. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # AI World מקור: https://docs.teloring.com/he/api/ai-world Markdown: https://docs.teloring.com/he/markdown/api/ai-world.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z Which AI capabilities are switched on for the account. **Scope:** `ai_world` Each item is a plain on/off. Most of them consume AI credits when they run, so treat enabling one as a deliberate act. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Analytics מקור: https://docs.teloring.com/he/api/analytics Markdown: https://docs.teloring.com/he/markdown/api/analytics.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z Dashboards and the graphs on them. **Scope:** `analytics` Graph values are computed on demand, not stored. Fetching them is opt-in (`?include=values`) because it is genuinely expensive — cache the result rather than polling. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Audit log מקור: https://docs.teloring.com/he/api/audit-log Markdown: https://docs.teloring.com/he/markdown/api/audit-log.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z Who did what, including what this API did. **Scope:** `audit_log` Read-only by design. Every write made through this API is recorded with `details.via = "public_api"` and the credential's client id, so an API-driven change is never anonymous. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Authentication מקור: https://docs.teloring.com/he/api/authentication Markdown: https://docs.teloring.com/he/markdown/api/authentication.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z Turning a client id and secret into a one-hour access token. This is the only unauthenticated endpoint in the API, and the only one that reads your client secret. Cache the token you get back and re-request it when it expires or when a call answers `401`. If the account restricts access by IP (Settings → Security & login), that restriction is enforced here as well — a call from an address that is not on the list is refused before any token is issued. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Billing מקור: https://docs.teloring.com/he/api/billing Markdown: https://docs.teloring.com/he/markdown/api/billing.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z Credits, the price list they are spent against, and invoices. Read-only. **Scope:** `billing` Nothing here can spend money or change a plan. Two balances exist and are not interchangeable: `monthly` (included, resets each period, does not roll over) and `topup` (bought, spent only once monthly runs out). ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Delete many files מקור: https://docs.teloring.com/he/api/bulk-delete-files Markdown: https://docs.teloring.com/he/markdown/api/bulk-delete-files.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Delete up to 100 files in one call. Partial success is normal and is reported rather than hidden: `deleted` lists the ids that went and `failed` the ones that did not, with a reason. A file id that does not exist counts as failed — an integration deleting the wrong ids should find out. Request --- # Move the conversation to a different customer מקור: https://docs.teloring.com/he/api/change-conversation-customer Markdown: https://docs.teloring.com/he/markdown/api/change-conversation-customer.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Re-parent this conversation's contact under a different customer. A contact cannot belong to two customers at once, so this moves **all** of that contact's conversations, not just this one. The response reports how many, under `conversations_moved`. Request --- # Queue counts מקור: https://docs.teloring.com/he/api/conversation-counts Markdown: https://docs.teloring.com/he/markdown/api/conversation-counts.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; The numbers behind the inbox sidebar badges, in one call. `assigned` counts open conversations with a human owner — the console shows a per-agent "Mine" badge, which has no meaning for a machine credential. --- # Conversations מקור: https://docs.teloring.com/he/api/conversations Markdown: https://docs.teloring.com/he/markdown/api/conversations.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z The threads between a contact and the business, across every channel. **Scope:** `conversations` A conversation belongs to an **inbox** (the channel it arrived on) and a **contact** (the person on the other end). Its `status` moves between `open`, `pending`, `on_hold` and `resolved`; `on_hold` additionally carries a deadline and is set through its own endpoint. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Get an access token מקור: https://docs.teloring.com/he/api/create-access-token Markdown: https://docs.teloring.com/he/markdown/api/create-access-token.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Exchange a client id and secret for a bearer token that lasts one hour. Credentials may be sent three ways — pick whichever your HTTP client makes easiest. All three are equivalent: - a JSON body (shown below), - a form-encoded body, which is what most OAuth libraries send, - HTTP Basic, with the client id as the username. Basic wins if both are present, so a body parameter cannot downgrade a header. **Cache the token.** One call an hour is the expected pattern; the token endpoint is rate limited to 20 requests per minute per IP, and ten consecutive failures against one client id lock it out for fifteen minutes. Every credential failure — unknown client id, wrong secret, revoked credential, expired credential — answers the same `401 invalid_client`. Telling you which one it was would tell an attacker which client ids exist. Two things are checked before a token is issued: that the account's plan includes API access, and that the calling IP passes the account's IP allow-list if one is set. A blocked address answers `403 ip_not_allowed` and gets no token at all. The first time an account reaches this endpoint, the **API Explorer** achievement becomes collectable in the console. Nothing to do — it unlocks on its own. Request --- # Create a human agent מקור: https://docs.teloring.com/he/api/create-agent Markdown: https://docs.teloring.com/he/markdown/api/create-agent.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Create a human agent. ⚠️ **This may charge the card on file.** An agent occupies a seat; if the plan has none free, a prorated charge is taken for the rest of the billing period, exactly as in the console. Two consequences to design around: - A `402` with `code: seat_charge_failed` means the card was declined and **nothing was created** — the agent is rolled back before the response is written, so a retry is safe. - A `201` may carry a `seat_charge` object saying what was charged. Log it: "why did my invoice go up" is a question an automated provisioning integration will eventually have to answer. Omit `password` and the new agent is emailed a one-time link to set their own — the right choice for a real person. Supply one and the account works immediately, which suits a service account a machine will drive. `role_id` comes from `GET /v1/roles`. Omitted, the account's default Agent role is applied, which is a working least-privilege role rather than no permissions. Request --- # Create an AI agent מקור: https://docs.teloring.com/he/api/create-ai-agent Markdown: https://docs.teloring.com/he/markdown/api/create-ai-agent.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Create an AI agent. ⚠️ **This may charge the card on file** — an AI agent costs a seat exactly as a human one does, with the same `402` / `code: seat_charge_failed` behaviour and the same rollback. Every field the console's AI agent editor offers is accepted and passed through: persona, instructions, model, language, the knowledge bases it may answer from, the inboxes it works in and its hand-off rules. Unknown fields are rejected rather than silently dropped. Request --- # Create a schedule מקור: https://docs.teloring.com/he/api/create-business-hours Markdown: https://docs.teloring.com/he/markdown/api/create-business-hours.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Create a named schedule. `days` maps weekday names to opening periods. A day with no periods is closed. Times are read in the schedule's own `timezone`, falling back to the account's. Request --- # Create a conversation מקור: https://docs.teloring.com/he/api/create-conversation Markdown: https://docs.teloring.com/he/markdown/api/create-conversation.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Open a conversation in an inbox. `inbox_id` is enough on its own — the channel type is read from the inbox, so you never have to keep the two in sync. Get the ids from `GET /v1/inboxes`. Identify the contact either by `contact_id`, or by a `contact` object carrying a `phone` or an `email`. The second form is what an integration usually wants: an unknown phone number creates the contact rather than failing. Pass a `message` object to send the first message in the same call — the same body `POST /v1/conversations/{id}/messages` takes, including `{"type": "template", …}` for WhatsApp. The created message comes back under `initial_message`. **Which inboxes can start a conversation?** Live chat, the API inbox, Instagram DM, Facebook Messenger and TikTok are inbound-only: the customer must write first, because there is no way to address them until they do. Request --- # Create a customer מקור: https://docs.teloring.com/he/api/create-customer Markdown: https://docs.teloring.com/he/markdown/api/create-customer.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Create a customer. Counts against the plan's customer limit — a full account answers `402` with `code: plan_limit_exceeded` rather than silently discarding the record. Creating a customer fires the Studio *customer changed* trigger and writes a journey event, exactly as the console does, so automations react to API-created records the same way. Request --- # Create a record מקור: https://docs.teloring.com/he/api/create-customer-object-record Markdown: https://docs.teloring.com/he/markdown/api/create-customer-object-record.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Create a record under a customer. Field values go in `data`, keyed by the `fields[].key` values from `GET /v1/objects/{object_id}`. They are validated against the object's schema: a missing required field, or a select value outside the list, is a `400` naming the field — with the per-field detail under `error.details.errors` — rather than a record with bad data in it. Creating a record writes a journey event on the customer and fires the Studio *customer record changed* trigger. Request --- # Create a knowledge base מקור: https://docs.teloring.com/he/api/create-knowledge-base Markdown: https://docs.teloring.com/he/markdown/api/create-knowledge-base.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Create an empty knowledge base. Counts against the plan's knowledge-base limit. Request --- # Create a quick reply מקור: https://docs.teloring.com/he/api/create-quick-reply Markdown: https://docs.teloring.com/he/markdown/api/create-quick-reply.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Create a quick reply. `scope` defaults to `account` — a shared snippet is almost always what an integration means. For a personal one, pass `scope: "personal"` **and** the `agent_id` it belongs to; without an owner a personal reply would be invisible to everybody. Bodies may contain merge variables such as `{{contact.name}}`. They are stored verbatim and resolved when an agent inserts the reply. Request --- # Create a signing link מקור: https://docs.teloring.com/he/api/create-signing-link Markdown: https://docs.teloring.com/he/markdown/api/create-signing-link.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Create a signing link for an **active** document. **Costs credits.** Both `customer_id` and `contact_id` are required. The customer is the business the document belongs to; the contact is the person who will sign it — and a signed document that cannot say who signed it is not worth much. **Safe to retry.** Calling this twice for the same document and contact returns the existing link instead of creating a second one, and does not charge again. `created` in the response tells you which happened, and the status code follows it (`201` for a new link, `200` for an existing one). Request --- # Create a single-use sign-in link מקור: https://docs.teloring.com/he/api/create-sso-link Markdown: https://docs.teloring.com/he/markdown/api/create-sso-link.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Mint a link that signs one of your agents straight into the console — no login screen, no password. ### Before it will work The `sso` scope alone grants nothing. In **Settings → API**, the credential must also name: - **the agents** it may sign in as. An agent not on that list answers `403` with `code: agent_not_allowed`, and the error lists who *is* allowed. - **the origins** allowed to embed the session, if you plan to open the link in an iframe. Requesting `embed: true` with none configured answers `400` with `code: no_embed_origins`. ### The two modes **`full`** opens the whole console, exactly as if the agent had signed in. **`conversation`** opens one contact's chat and nothing else — no navigation, no conversation list. Supply the contact by `phone` or `email`. If a conversation with them is already open it is opened; if not, the composer opens with the contact pre-selected. Add `inbox_id` and the inbox is chosen too, leaving only the message to write. This is the mode built for an iframe: open it, send a message, close it. ### The link itself Valid for **ten minutes** and redeemable **once** — a URL that bypasses the login screen is a credential, and a credential in a URL ends up in browser history and referrer headers. Mint one per use; do not cache it. Revocation is immediate: at redemption the credential and the agent are re-checked against live data, so removing an agent from the allowlist kills every link already issued for them. ### Embedding With `embed: true` the resulting pages are served with `frame-ancestors` naming only your configured origins, and the session cookie is issued `SameSite=None; Secure; Partitioned` so it lives in your site's own cookie partition and cannot be replayed from anywhere else. In `conversation` mode the embedded page posts a message to the parent window when the agent sends something, so you can close the iframe without polling: ```js window.addEventListener('message', (event) => { if (event.origin !== 'https://console.teloring.com') return; if (event.data?.source === 'teloring' && event.data.type === 'message_sent') { closeMyIframe(); } }); ``` Request --- # Create a team מקור: https://docs.teloring.com/he/api/create-team Markdown: https://docs.teloring.com/he/markdown/api/create-team.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Create a team. `auto_assign_online: true` makes assigning the team immediately hand the conversation to a random online member — AI agents count as always online. `humans_only: true` keeps AI agents out of the team entirely. Teams are a plan capability: a plan without agent groups answers `402`. Names are unique per account, compared case-insensitively, so a duplicate answers `409`. Request --- # Customer objects מקור: https://docs.teloring.com/he/api/customer-objects Markdown: https://docs.teloring.com/he/markdown/api/customer-objects.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z The mini-CRM: object types and the records filed under each customer. **Scope:** `customer_objects` An **object** is a type — Contacts, Deals, Service Calls, Tasks, plus whatever was defined in the field editor. A **record** is one instance, and every record belongs to exactly one customer. Records can be read per-customer, or account-wide across every customer. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Customers מקור: https://docs.teloring.com/he/api/customers Markdown: https://docs.teloring.com/he/markdown/api/customers.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z The business records contacts belong to. **Scope:** `customers` A **contact** is a channel identity — this phone number on WhatsApp, this email address. A **customer** is the company or household those identities belong to. One customer owns many contacts; a conversation belongs to a contact, and through it to a customer. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Deactivate an agent מקור: https://docs.teloring.com/he/api/delete-agent Markdown: https://docs.teloring.com/he/markdown/api/delete-agent.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Deactivate an agent. They can no longer sign in and stop receiving assignments, but their name and history stay intact — a message has to keep showing who sent it. The seat is released at the next billing cycle. Any SSO permission naming this agent is removed at the same time, which invalidates every SSO link already issued for them. Request --- # Remove a profile picture מקור: https://docs.teloring.com/he/api/delete-agent-avatar Markdown: https://docs.teloring.com/he/markdown/api/delete-agent-avatar.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Removes the picture; the console falls back to the agent's initials. Request --- # Delete an AI agent מקור: https://docs.teloring.com/he/api/delete-ai-agent Markdown: https://docs.teloring.com/he/markdown/api/delete-ai-agent.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Deletes the AI profile and deactivates the agent record fronting it. Conversations it handled keep their history; the seat is released at the next billing cycle. Request --- # Delete a schedule מקור: https://docs.teloring.com/he/api/delete-business-hours Markdown: https://docs.teloring.com/he/markdown/api/delete-business-hours.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Delete a schedule. System schedules cannot be deleted. Studio flows branching on this schedule keep their configuration but stop resolving it, so check your flows before deleting one that is in use. Request --- # Delete a conversation (email inboxes only) מקור: https://docs.teloring.com/he/api/delete-conversation Markdown: https://docs.teloring.com/he/markdown/api/delete-conversation.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Permanently delete a conversation, its messages, notes and stored attachments. **Email inboxes only.** Every other channel keeps an immutable history on purpose: a WhatsApp or SMS thread is a record of what was actually sent to a customer. Email is deletable because an inbox routinely receives mail that should never have been filed at all. A non-email conversation answers `403` with `code: delete_not_permitted`. This cannot be undone. Request --- # Delete a customer מקור: https://docs.teloring.com/he/api/delete-customer Markdown: https://docs.teloring.com/he/markdown/api/delete-customer.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Delete a customer. Contacts and conversations are **unlinked**, not deleted: the message history is a record of what was said to a real person and survives the customer record it happened to be filed under. Object records stored under the customer (deals, service calls…) go with it. The response reports how many contacts and conversations were unlinked. Request --- # Delete a record מקור: https://docs.teloring.com/he/api/delete-customer-object-record Markdown: https://docs.teloring.com/he/markdown/api/delete-customer-object-record.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Deletes the record and removes any cross-object links pointing at it. Request --- # Delete a file מקור: https://docs.teloring.com/he/api/delete-file Markdown: https://docs.teloring.com/he/markdown/api/delete-file.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Delete one file. The stored object goes with it and cannot be recovered. A message that referenced this file keeps its text but loses the attachment — check `conversation_id` on the file first if that matters. Request --- # Delete a form מקור: https://docs.teloring.com/he/api/delete-form Markdown: https://docs.teloring.com/he/markdown/api/delete-form.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Delete a form. Its public link stops working immediately. Submissions already received are **kept** — they are records of what somebody actually told the business, and deleting the form they arrived through does not make them untrue. Pull them with `GET /v1/form-submissions?form_id=…` first if you need them elsewhere. Request --- # Delete a knowledge base מקור: https://docs.teloring.com/he/api/delete-knowledge-base Markdown: https://docs.teloring.com/he/markdown/api/delete-knowledge-base.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Delete a knowledge base and every source and chunk inside it. Irreversible. Any AI agent configured to answer from it keeps its configuration but stops retrieving anything — check `knowledge_base_ids` on your AI agents first. Request --- # Delete a source מקור: https://docs.teloring.com/he/api/delete-knowledge-base-source Markdown: https://docs.teloring.com/he/markdown/api/delete-knowledge-base-source.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Deletes one source and every chunk derived from it. Request --- # Delete a message מקור: https://docs.teloring.com/he/api/delete-message Markdown: https://docs.teloring.com/he/markdown/api/delete-message.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Remove one message from a conversation. There is no equivalent in the console — this is API-only, and it is genuinely destructive. It deletes **our** record of the message, not the copy the customer already received on WhatsApp, SMS or email. Use it to redact something that should never have been stored, not to "unsend". The conversation's message count is corrected and attachments are detached from the Files Warehouse index. Every delete is written to the audit log with the credential that made it. Request --- # Delete a quick reply מקור: https://docs.teloring.com/he/api/delete-quick-reply Markdown: https://docs.teloring.com/he/markdown/api/delete-quick-reply.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Delete a quick reply Request --- # Revoke a signing link מקור: https://docs.teloring.com/he/api/delete-signing-link Markdown: https://docs.teloring.com/he/markdown/api/delete-signing-link.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Revoke a pending signing link. Only `pending` links can be revoked. Once somebody has signed, the link is part of the audit trail of a completed document and cannot be removed — that answers `400` with `code: link_not_pending`. Request --- # Delete a team מקור: https://docs.teloring.com/he/api/delete-team Markdown: https://docs.teloring.com/he/markdown/api/delete-team.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Conversations still assigned to the team are detached and return to the general waiting line rather than becoming unreachable. The response says how many. Request --- # Document signature מקור: https://docs.teloring.com/he/api/document-signature Markdown: https://docs.teloring.com/he/markdown/api/document-signature.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z Documents sent out for signature, and the links people sign them through. **Scope:** `documents_signature` A **document** is an uploaded PDF; it becomes signable once signature fields are placed in the console's editor. A **signing link** is one recipient's invitation to sign one document, and **costs credits**. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Get an invoice download URL מקור: https://docs.teloring.com/he/api/download-invoice Markdown: https://docs.teloring.com/he/markdown/api/download-invoice.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; A short-lived signed URL for one invoice PDF. Minted per call and valid for about an hour, so it is safe to hand to a browser but should never be stored. Fetch a fresh one each time you need the file. Request --- # Files מקור: https://docs.teloring.com/he/api/files Markdown: https://docs.teloring.com/he/markdown/api/files.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z Every file that passed through the account, and how much space it uses. **Scope:** `files` Deleting is destructive: the stored object is removed and a message that referenced it shows a broken attachment afterwards. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Forms מקור: https://docs.teloring.com/he/api/forms Markdown: https://docs.teloring.com/he/markdown/api/forms.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z Forms and their submissions. Read and delete. **Scope:** `forms` Building a form is a visual act with no honest JSON equivalent, so it stays in the console. Pulling submissions into another system is what this API is for. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Get account details מקור: https://docs.teloring.com/he/api/get-account Markdown: https://docs.teloring.com/he/markdown/api/get-account.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Everything on Settings → General, plus the read-only facts: the account id, the plan it is on, when it was created and who owns it. Worth calling once at the start of an integration. `plan` decides whether the rest of this API will work at all — `GET /v1/billing/plan` has the detail. **Scope:** `account` --- # Get an agent מקור: https://docs.teloring.com/he/api/get-agent Markdown: https://docs.teloring.com/he/markdown/api/get-agent.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Get an agent Request --- # Get an agent's profile מקור: https://docs.teloring.com/he/api/get-agent-profile Markdown: https://docs.teloring.com/he/markdown/api/get-agent-profile.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; One agent's personal settings: display name, timezone, language and picture. Request --- # Get an AI agent מקור: https://docs.teloring.com/he/api/get-ai-agent Markdown: https://docs.teloring.com/he/markdown/api/get-ai-agent.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Get an AI agent Request --- # Get one capability מקור: https://docs.teloring.com/he/api/get-ai-feature Markdown: https://docs.teloring.com/he/markdown/api/get-ai-feature.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Get one capability Request --- # Get a conversation מקור: https://docs.teloring.com/he/api/get-conversation Markdown: https://docs.teloring.com/he/markdown/api/get-conversation.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Everything stored about one conversation, including its custom attributes. Request --- # Read a conversation's custom attributes מקור: https://docs.teloring.com/he/api/get-conversation-custom-attributes Markdown: https://docs.teloring.com/he/markdown/api/get-conversation-custom-attributes.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; The attribute values stored on this conversation, with their definitions resolved. Request --- # Get credit balances מקור: https://docs.teloring.com/he/api/get-credits Markdown: https://docs.teloring.com/he/markdown/api/get-credits.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; The account's current credit balances. `monthly_balance` is what remains of this period's included credits and does not roll over; `topup_balance` is the total across every unexpired package. Spending draws down the monthly balance first. --- # Get a customer מקור: https://docs.teloring.com/he/api/get-customer Markdown: https://docs.teloring.com/he/markdown/api/get-customer.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; One customer. Pass `include=contacts` to get its channel identities in the same call. Request --- # Get an object type מקור: https://docs.teloring.com/he/api/get-customer-object Markdown: https://docs.teloring.com/he/markdown/api/get-customer-object.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; One object type and its full field schema. Request --- # Get a record מקור: https://docs.teloring.com/he/api/get-customer-object-record Markdown: https://docs.teloring.com/he/markdown/api/get-customer-object-record.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Get a record Request --- # Get a dashboard מקור: https://docs.teloring.com/he/api/get-dashboard Markdown: https://docs.teloring.com/he/markdown/api/get-dashboard.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; A dashboard with its graphs, and optionally their current values. Without `include=values` this is a cheap metadata read. With it, every graph is executed and gains a `value` object holding the same series and totals the console renders — up to 30 graphs per call, with `values_truncated_after` in the response if the dashboard has more. Running the graphs is genuinely expensive. Cache the result rather than polling it, and prefer a schedule measured in minutes over one measured in seconds. One caveat: a graph filtered to "my conversations" resolves `$AGENT_ID` against the caller, and a machine credential is nobody in particular — such a graph legitimately comes back empty here. Request --- # Get a file מקור: https://docs.teloring.com/he/api/get-file Markdown: https://docs.teloring.com/he/markdown/api/get-file.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; One file's metadata with a short-lived signed `download_url`. The URL expires within the hour and is minted per request — fetch a fresh one rather than storing it. Request --- # Get storage statistics מקור: https://docs.teloring.com/he/api/get-file-stats Markdown: https://docs.teloring.com/he/markdown/api/get-file-stats.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Total files and bytes stored, against the plan's storage quota, broken down by category. The quota comes back with the usage because a number with nothing to measure it against is why an upload starts failing "for no reason". `quota_bytes: null` means the plan has no ceiling. --- # Get a form מקור: https://docs.teloring.com/he/api/get-form Markdown: https://docs.teloring.com/he/markdown/api/get-form.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; One form, including its field definitions. `fields[].id` is the key each answer is stored under in a submission — fetch this once and cache it if you are mapping submissions into another system. Request --- # Get a submission מקור: https://docs.teloring.com/he/api/get-form-submission Markdown: https://docs.teloring.com/he/markdown/api/get-form-submission.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Get a submission Request --- # Get a knowledge base מקור: https://docs.teloring.com/he/api/get-knowledge-base Markdown: https://docs.teloring.com/he/markdown/api/get-knowledge-base.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; One knowledge base with its indexing statistics. Request --- # Get a message מקור: https://docs.teloring.com/he/api/get-message Markdown: https://docs.teloring.com/he/markdown/api/get-message.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Get a message Request --- # Get notification settings מקור: https://docs.teloring.com/he/api/get-notification-settings Markdown: https://docs.teloring.com/he/markdown/api/get-notification-settings.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; How this agent is notified, plus the values each setting accepts. `channels` are the delivery routes (sound, email, push, bell) and `events` are what can trigger one. `available_channels`, `available_events` and `available_sounds` list what this build supports, so you never have to hardcode them. Request --- # Get the current plan מקור: https://docs.teloring.com/he/api/get-plan Markdown: https://docs.teloring.com/he/markdown/api/get-plan.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; The plan this account is on: its ceilings and which features it includes. Worth reading once at the start of an integration. A `402` from anywhere else in this API is explained by exactly one of these numbers or flags. --- # Get a quick reply מקור: https://docs.teloring.com/he/api/get-quick-reply Markdown: https://docs.teloring.com/he/markdown/api/get-quick-reply.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Get a quick reply Request --- # Get a flow with its blocks מקור: https://docs.teloring.com/he/api/get-studio-flow Markdown: https://docs.teloring.com/he/markdown/api/get-studio-flow.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; One flow, with every block and trigger it contains and the settings inside each. `blocks[].settings` is block-specific by design — a *send WhatsApp template* block and a *branch on business hours* block have nothing in common. Use `GET /v1/studio/blocks` as the dictionary. `connections` describes the wiring: which block's output leads to which block's input, and through which handle. On a branching block the handle is what tells you *which* branch, so do not ignore it. Request --- # Get a team מקור: https://docs.teloring.com/he/api/get-team Markdown: https://docs.teloring.com/he/markdown/api/get-team.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; One team, with its members resolved. Request --- # Get the unread count מקור: https://docs.teloring.com/he/api/get-unread-count Markdown: https://docs.teloring.com/he/markdown/api/get-unread-count.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Just the badge number — the cheap call to poll. Request --- # Put a conversation on hold מקור: https://docs.teloring.com/he/api/hold-conversation Markdown: https://docs.teloring.com/he/markdown/api/hold-conversation.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Park a conversation until a deadline. It leaves the active queues and comes back by itself when the timer expires — or sooner, if the customer writes in. The assignment is deliberately left alone: on hold means "come back to me later", so the conversation returns to the same agent. `until` is read in the **account's** timezone (Settings → General), never the caller's, because a deadline is business logic rather than a display preference. Request --- # Inspect the current token מקור: https://docs.teloring.com/he/api/introspect-token Markdown: https://docs.teloring.com/he/markdown/api/introspect-token.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; What this token can do: which account it belongs to and exactly which scopes it holds. Call it first when something is unexpected. Between the account id and the scope list it explains almost every surprising `403`, and it costs nothing. --- # Knowledge base מקור: https://docs.teloring.com/he/api/knowledge-base Markdown: https://docs.teloring.com/he/markdown/api/knowledge-base.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z The documents the AI is allowed to answer from. **Scope:** `knowledge_base` A knowledge base holds **sources** (a file, or a crawled URL), and each source is split into **chunks** — the passages the retriever matches a question against. Ingestion is asynchronous: add a source, then poll until its status reads `ready`. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # List agents מקור: https://docs.teloring.com/he/api/list-agents Markdown: https://docs.teloring.com/he/markdown/api/list-agents.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Every agent in the account, human and AI, with their role. The `id` here is what goes in `assignee_id` on a conversation and in the SSO agent allowlist. Request --- # List AI agents מקור: https://docs.teloring.com/he/api/list-ai-agents Markdown: https://docs.teloring.com/he/markdown/api/list-ai-agents.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; AI agent profiles, with every setting they carry. `agent_id` is the agent record each one fronts — that is what you assign a conversation to. --- # List AI capabilities מקור: https://docs.teloring.com/he/api/list-ai-features Markdown: https://docs.teloring.com/he/markdown/api/list-ai-features.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Every AI capability and whether it is switched on for this account. --- # List submissions מקור: https://docs.teloring.com/he/api/list-all-form-submissions Markdown: https://docs.teloring.com/he/markdown/api/list-all-form-submissions.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Submissions across every form, newest first. Each submission carries the answers twice: `answers` is the flat `{field_id: value}` map most integrations want, and `answers_detail` keeps each answer's label and type so you can render a submission without also fetching the form. Request --- # List audit actions מקור: https://docs.teloring.com/he/api/list-audit-actions Markdown: https://docs.teloring.com/he/markdown/api/list-audit-actions.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; The distinct action names present in this account's log, with counts — so you can build a filter list without hardcoding names that vary by which features the account uses. --- # Read the audit log מקור: https://docs.teloring.com/he/api/list-audit-log Markdown: https://docs.teloring.com/he/markdown/api/list-audit-log.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Audit entries, newest first. `action` accepts a full action (`agent.login`) or a prefix (`agent`), which matches everything in that family. Use `from` and `to` to page through a long history: one call scans a bounded window, so an unfiltered request over a busy year will not return everything — `meta.scan_truncated` tells you when that happened. Anything done through this API carries `details.via = "public_api"` plus the credential's `client_id` and name, and its `agent_id` reads `api:`. Request --- # List business-hours schedules מקור: https://docs.teloring.com/he/api/list-business-hours Markdown: https://docs.teloring.com/he/markdown/api/list-business-hours.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Every named schedule, with the holidays that will next close it. Schedules are what Studio branches on and what reports use to separate "slow reply" from "out of hours". **Scope:** `business_hours` --- # Get the conversation-attribute schema מקור: https://docs.teloring.com/he/api/list-conversation-attributes Markdown: https://docs.teloring.com/he/markdown/api/list-conversation-attributes.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; The account's conversation-attribute schema: the custom fields a conversation can carry. `api_id` is the key you use when writing values at `PATCH /v1/conversations/{id}/custom-attributes`, and `type` decides what a value may be — the write endpoint enforces it. Read-only on purpose. This is a *schema*, and reshaping it from a machine credential would silently invalidate values on conversations that already carry them. **Scope:** `conversation_attributes` --- # List conversations מקור: https://docs.teloring.com/he/api/list-conversations Markdown: https://docs.teloring.com/he/markdown/api/list-conversations.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Conversations in one status bucket, filtered and paginated. `status` defaults to `open`, which also folds in `missed` — a missed call is an open conversation nobody has picked up, not a separate queue. Filters combine with AND; repeated values within one filter combine with OR, and may be sent either repeated (`?label=vip&label=urgent`) or comma-separated (`?label=vip,urgent`). Two filters take sentinel values: `assignee_id=unassigned` finds the waiting line, and `team_id=none` finds conversations no team owns. Fetching a large `status=resolved` set? Add `created_after` / `created_before`. Open buckets stay small; the resolved archive does not. Request --- # List credit transactions מקור: https://docs.teloring.com/he/api/list-credit-transactions Markdown: https://docs.teloring.com/he/markdown/api/list-credit-transactions.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Credit movements, newest first — every spend, top-up and refund, with where the credits came from. Request --- # List a customer's contacts מקור: https://docs.teloring.com/he/api/list-customer-contacts Markdown: https://docs.teloring.com/he/markdown/api/list-customer-contacts.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; The channel identities linked to this customer — what you pass as `contact_id` when starting a conversation. Request --- # List one customer's records מקור: https://docs.teloring.com/he/api/list-customer-object-records Markdown: https://docs.teloring.com/he/markdown/api/list-customer-object-records.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Records of one object type belonging to one customer. Request --- # List object types מקור: https://docs.teloring.com/he/api/list-customer-objects Markdown: https://docs.teloring.com/he/markdown/api/list-customer-objects.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Every object type in the account, with its field definitions. **Start here.** Each object's `id` is what you pass as `object_id` everywhere else, and `fields[].key` is what goes in a record's `data`. The account's own custom objects appear alongside the seeded ones (Contacts, Deals, Service Calls, Tasks, Notes). Request --- # List customers מקור: https://docs.teloring.com/he/api/list-customers Markdown: https://docs.teloring.com/he/markdown/api/list-customers.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Customers in the account, filtered and paginated. `search` is a case-insensitive substring match over name, phone, email, industry and address. When you have an exact identifier, `GET /v1/customers/search` is the better call. Request --- # List a dashboard's graphs מקור: https://docs.teloring.com/he/api/list-dashboard-graphs Markdown: https://docs.teloring.com/he/markdown/api/list-dashboard-graphs.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; The graphs on one dashboard. `?include=values` computes each one. Request --- # List dashboards מקור: https://docs.teloring.com/he/api/list-dashboards Markdown: https://docs.teloring.com/he/markdown/api/list-dashboards.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Every dashboard in the account. `is_default: true` marks the dashboard Teloring seeds for a new account. It is an ordinary dashboard — it can be renamed and rearranged — the flag exists so an integration can find "the main one" without matching on a name that might be in Hebrew. --- # List files מקור: https://docs.teloring.com/he/api/list-files Markdown: https://docs.teloring.com/he/markdown/api/list-files.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Files in the warehouse, newest first — attachments customers sent in, files agents sent out, and uploads from forms and knowledge bases. Request --- # List a form's submissions מקור: https://docs.teloring.com/he/api/list-form-submissions Markdown: https://docs.teloring.com/he/markdown/api/list-form-submissions.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; List a form's submissions Request --- # List forms מקור: https://docs.teloring.com/he/api/list-forms Markdown: https://docs.teloring.com/he/markdown/api/list-forms.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Every form in the account, with its submission count and public URL. Request --- # List holiday calendars מקור: https://docs.teloring.com/he/api/list-holidays Markdown: https://docs.teloring.com/he/markdown/api/list-holidays.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Holiday calendars available to schedules, with their dates for a year. Both kinds are returned: the calendars Teloring maintains (Jewish Israeli holidays, Christian holidays) and any the account added itself. **Scope:** `business_hours` Request --- # List inboxes מקור: https://docs.teloring.com/he/api/list-inboxes Markdown: https://docs.teloring.com/he/markdown/api/list-inboxes.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Every inbox in the account, with the id you pass as `inbox_id`. Provider secrets — access tokens, webhook signing keys, mailbox passwords — are never included. No endpoint on this API returns them. **Scope:** `conversations` or `messages`. Request --- # List invoices מקור: https://docs.teloring.com/he/api/list-invoices Markdown: https://docs.teloring.com/he/markdown/api/list-invoices.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Issued tax invoices, newest first. Only issued documents appear. An invoice still being generated, or parked after a provider rejection, is ours to resolve — it is not a row you should see and wonder about. The PDF is not linked here: download URLs are minted per request and expire. Request --- # List indexed chunks מקור: https://docs.teloring.com/he/api/list-knowledge-base-chunks Markdown: https://docs.teloring.com/he/markdown/api/list-knowledge-base-chunks.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; The indexed passages in a knowledge base — literally what the AI can see. This is the endpoint that lets you audit a knowledge base: if the assistant is answering oddly, the answer is usually visible here. Filter to one source with `source_id`, or pass `include_content=false` for metadata only, which is much cheaper when walking a large base. Embedding vectors are never returned: a thousand floats per chunk, meaningless outside the model that produced them, and they would dwarf every other field. Request --- # List sources מקור: https://docs.teloring.com/he/api/list-knowledge-base-sources Markdown: https://docs.teloring.com/he/markdown/api/list-knowledge-base-sources.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; The sources in a knowledge base, with their ingestion status. `processing` means the worker is still chunking and embedding; `ready` means it can be retrieved from; `failed` means ingestion could not complete. Poll this after adding a source. Request --- # List knowledge bases מקור: https://docs.teloring.com/he/api/list-knowledge-bases Markdown: https://docs.teloring.com/he/markdown/api/list-knowledge-bases.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Every knowledge base in the account. Requires the Knowledge Base AI capability to be switched on. When it is off the endpoint answers `403` with `code: feature_disabled` — deliberately, so a client can tell "switched off" from "nothing indexed yet". --- # List messages מקור: https://docs.teloring.com/he/api/list-messages Markdown: https://docs.teloring.com/he/markdown/api/list-messages.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Messages in a conversation, oldest first by default. Private notes are included. Pass `include_private=false` to get only what the customer actually saw — usually what you want when syncing a transcript somewhere else. Request --- # List an agent's notifications מקור: https://docs.teloring.com/he/api/list-notifications Markdown: https://docs.teloring.com/he/markdown/api/list-notifications.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; The notifications in one agent's bell, newest first. Reading this **never marks anything as read**. In the console, opening the bell is a human deciding they have seen something; a background job polling for new items must not clear that badge out from under the person it belongs to. `meta.unread_count` carries the badge number alongside the page. Request --- # List records across all customers מקור: https://docs.teloring.com/he/api/list-object-records Markdown: https://docs.teloring.com/he/markdown/api/list-object-records.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Every record of one object type, across every customer. This is how you ask "all deals that closed this month" without walking the customer list. Filter on a field's value with `field.=`, for example `?field.stage=Won&field.owner=agent_12`. Comparison is case-insensitive string equality, so select lists and free-text fields behave the same way; use `created_after` / `created_before` for date ranges. This query is served by a Firestore collection-group index. If that index is still building, the endpoint answers `503` with `code: index_required` rather than returning a partial list — fall back to the per-customer endpoint in the meantime. Request --- # List quick replies מקור: https://docs.teloring.com/he/api/list-quick-replies Markdown: https://docs.teloring.com/he/markdown/api/list-quick-replies.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Quick replies in the account. By default this returns the shared (`account`) replies **plus** every agent's personal ones — the full library, which is what a credential managing it wants. Narrow with `scope`, or with `agent_id` for one agent's personal replies. Request --- # List categories מקור: https://docs.teloring.com/he/api/list-quick-reply-categories Markdown: https://docs.teloring.com/he/markdown/api/list-quick-reply-categories.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; The categories quick replies can be filed under. --- # List roles מקור: https://docs.teloring.com/he/api/list-roles Markdown: https://docs.teloring.com/he/markdown/api/list-roles.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; The roles defined in this account, for use as `role_id` when creating or updating an agent. Read-only. Roles decide what a *person* can reach in the console, and editing that matrix from a machine credential is the kind of privilege change that should leave a human's fingerprints on it. --- # List documents מקור: https://docs.teloring.com/he/api/list-signature-documents Markdown: https://docs.teloring.com/he/markdown/api/list-signature-documents.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Every document in the signature library. `status=active` are the ones with signature fields placed, and therefore the only ones a signing link can be created for. `status=draft` still need a pass through the console's editor. Request --- # List signed documents מקור: https://docs.teloring.com/he/api/list-signed-documents Markdown: https://docs.teloring.com/he/markdown/api/list-signed-documents.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Completed and declined signings, newest first. A declined signing carries the reason the signer gave. Request --- # List signing links מקור: https://docs.teloring.com/he/api/list-signing-links Markdown: https://docs.teloring.com/he/markdown/api/list-signing-links.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Signing links. `status=pending` is the waiting-to-sign list. Request --- # List block and trigger types מקור: https://docs.teloring.com/he/api/list-studio-block-types Markdown: https://docs.teloring.com/he/markdown/api/list-studio-block-types.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; The catalog of every block and trigger Studio offers, with each one's settings schema. This describes the platform rather than the account, so it is identical for everybody — fetch it once and cache it. --- # List flows מקור: https://docs.teloring.com/he/api/list-studio-flows Markdown: https://docs.teloring.com/he/markdown/api/list-studio-flows.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Every flow in the account, most recently edited first. `live` flows are running against incoming conversations right now; `draft` have never been published, and `paused` were stopped deliberately. `has_unpublished_changes` tells you a live flow has edits that are not yet in effect. Request --- # List teams מקור: https://docs.teloring.com/he/api/list-teams Markdown: https://docs.teloring.com/he/markdown/api/list-teams.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Every team in the account. `?include=members` adds each team's roster. Request --- # Get the usage price list מקור: https://docs.teloring.com/he/api/list-usage-pricing Markdown: https://docs.teloring.com/he/markdown/api/list-usage-pricing.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; What each metered action costs in credits: an outbound SMS, a WhatsApp template by category, a signing link. Use it to estimate a campaign before running it. Each row's `id` is the same `usage_item_id` that appears on a credit transaction, so costs reconcile after the fact. Request --- # List WhatsApp templates מקור: https://docs.teloring.com/he/api/list-whats-app-templates Markdown: https://docs.teloring.com/he/markdown/api/list-whats-app-templates.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Approved WhatsApp templates for one inbox, with how many body variables each expects. Call it before sending a template: `name` and `body_variable_count` are what you need to build the send. Only templates with `status: approved` can be sent. A non-WhatsApp inbox returns an empty list rather than an error, so a client can call this uniformly. Request --- # Messages מקור: https://docs.teloring.com/he/api/messages Markdown: https://docs.teloring.com/he/markdown/api/messages.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z Reading and sending inside a conversation. **Scope:** `messages` Channels are not interchangeable here. WhatsApp closes a 24-hour window after the customer's last message, after which only approved templates may be sent; TikTok has a 48-hour window and a per-window message cap; voice conversations accept private notes only. Each rule is enforced before the send, with a specific error `code`, rather than surfaced as a provider failure afterwards. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Notifications מקור: https://docs.teloring.com/he/api/notifications Markdown: https://docs.teloring.com/he/markdown/api/notifications.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z An agent's bell feed. **Scope:** `notifications` Read-only, and deliberately non-destructive: reading the feed here does not clear the badge a human has not looked at yet. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Profile מקור: https://docs.teloring.com/he/api/profile Markdown: https://docs.teloring.com/he/markdown/api/profile.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z One agent's personal settings and notification preferences. **Scope:** `profile` Email and password cannot be changed here. Both are identity rather than profile: an email change must be confirmed from the address itself, and a password can only be set by the person who owns it. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Quick replies מקור: https://docs.teloring.com/he/api/quick-replies Markdown: https://docs.teloring.com/he/markdown/api/quick-replies.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z Saved snippets agents insert into a conversation. **Scope:** `quick_replies` `account` replies are shared with everyone; `personal` ones belong to a single agent and are addressed by `agent_id`. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Release a hold מקור: https://docs.teloring.com/he/api/release-conversation-hold Markdown: https://docs.teloring.com/he/markdown/api/release-conversation-hold.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Release a hold early and return the conversation to its queue. Request --- # Search customers מקור: https://docs.teloring.com/he/api/search-customers Markdown: https://docs.teloring.com/he/markdown/api/search-customers.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Find customers by an exact identifier, or by free text. Prefer `phone` or `email`: those are exact, index-backed matches and the natural way to answer "do I already have this company?" before creating a duplicate. `q` falls back to the same substring search the list endpoint uses. At least one of the three is required. Request --- # Send a message מקור: https://docs.teloring.com/he/api/send-message Markdown: https://docs.teloring.com/he/markdown/api/send-message.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Send a message, an internal note, or a WhatsApp template. `type` selects the shape of the request: | `type` | What it sends | Required | | --- | --- | --- | | `text` *(default)* | A plain text message | `content` | | `media` | A file by URL | `content` (an https URL), `content_type` | | `note` | An internal note, never delivered to the customer | `content` | | `template` | An approved WhatsApp template | `template.name` | ### The WhatsApp 24-hour window WhatsApp only accepts free-form messages within 24 hours of the customer's last message. Outside it, this endpoint answers `409` with `code: whatsapp_window_closed` **before** contacting the provider, and the error carries `details.last_customer_message_at` so you can show the operator why. Send a template instead — that is what templates are for. ### Other channel rules - **TikTok** — 48-hour window plus a per-window message cap; text and image only. - **Voice** — private notes only. - **SMS** — costs credits per segment. Insufficient credits answers `402`. - **Templates** — cost credits by category (`utility`, `marketing`, `authentication`). Pass the right one: it decides the price. Request --- # Switch a capability on or off מקור: https://docs.teloring.com/he/api/set-ai-feature Markdown: https://docs.teloring.com/he/markdown/api/set-ai-feature.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Turn one AI capability on or off. Most of these consume AI credits every time they run — check `GET /v1/billing/usage-pricing` before enabling one across a busy account. The response carries `changed`, which is `false` when the capability was already in the requested state. Note that switching a feature on does nothing if the account's plan does not include AI World at all: the plan gate is checked where the feature runs, so `GET /v1/billing/plan` is where that shows up. Request --- # SSO מקור: https://docs.teloring.com/he/api/sso Markdown: https://docs.teloring.com/he/markdown/api/sso.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z Signing one of your agents straight into the console from your own system. **Scope:** `sso` The most powerful thing in this API, and the most tightly controlled. The scope alone grants nothing: the credential must also name the agents it may impersonate, and (for iframe embedding) the origins allowed to frame the session. Links expire in ten minutes and work exactly once. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Studio מקור: https://docs.teloring.com/he/api/studio Markdown: https://docs.teloring.com/he/markdown/api/studio.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z The automations built on the Studio canvas. Read-only. **Scope:** `studio` A flow is a graph of blocks at coordinates, wired through named handles. This API lets you see which flows exist, whether they are live, and how every block is configured. Editing a flow is a visual act and stays in the console. ```mdx-code-block import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; ``` --- # Update account details מקור: https://docs.teloring.com/he/api/update-account Markdown: https://docs.teloring.com/he/markdown/api/update-account.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Update the account's general and invoicing details. **`billing_country` is guarded.** An Israeli account cannot be moved: the country already determined the VAT on invoices that have been issued. Attempting it answers `400` with `code: country_locked`. `billing_country_locked` on the GET tells you in advance. Invoice fields — `business_tax_id`, `business_address`, `business_city`, `business_contact_name` — are audited separately from the rest, because they are printed on legal documents. Request --- # Update an agent מקור: https://docs.teloring.com/he/api/update-agent Markdown: https://docs.teloring.com/he/markdown/api/update-agent.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Update an agent's profile, role or activation state. **Email and password cannot be changed here** — both answer `400` with `code: field_not_editable`. They are identity rather than profile: an email change re-keys the global login index and must be confirmed from the address itself, and a password can only be set by the person who owns it. The account's last Owner cannot be moved off Owner or deactivated. That answers `400` with `code: last_owner` — an account must never be able to lock itself out of its own product. Request --- # Update an agent's profile מקור: https://docs.teloring.com/he/api/update-agent-profile Markdown: https://docs.teloring.com/he/markdown/api/update-agent-profile.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Update display name, timezone, language or contact details. `timezone` is an IANA name such as `Asia/Jerusalem`, and it is validated — a typo is a `400` rather than a profile that silently renders every timestamp in UTC. Email, password and `role_id` are rejected here with `code: field_not_editable`. The first two are identity, not profile; roles belong to `PATCH /v1/agents/{agent_id}` under the `agents_teams` scope. Request --- # Update an AI agent מקור: https://docs.teloring.com/he/api/update-ai-agent Markdown: https://docs.teloring.com/he/markdown/api/update-ai-agent.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Only the fields you send change. Request --- # Update a schedule מקור: https://docs.teloring.com/he/api/update-business-hours Markdown: https://docs.teloring.com/he/markdown/api/update-business-hours.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; System schedules cannot be edited — those answer `403` with `code: system_schedule`. Request --- # Update a conversation מקור: https://docs.teloring.com/he/api/update-conversation Markdown: https://docs.teloring.com/he/markdown/api/update-conversation.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Change assignment, routing, priority, flag, labels, subject or status. Only the fields you send are touched. `status` accepts `open`, `pending` and `resolved`. Moving **to** `on_hold` is not allowed here, because a hold carries a deadline — use `POST /v1/conversations/{id}/hold`. Moving **out** of on-hold by setting another status works and clears the deadline. Two assignments have side effects worth knowing about: - Assigning a **team** whose auto-assign rule is on immediately hands the conversation to a random online member. - Assigning an **AI agent** starts an AI session; the response carries an `assignment` object with its `ai_session_id`. Assigning a human to a conversation an AI is handling ends that session silently — the human takeover the console does. Request --- # Set custom attribute values מקור: https://docs.teloring.com/he/api/update-conversation-custom-attributes Markdown: https://docs.teloring.com/he/markdown/api/update-conversation-custom-attributes.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; A partial merge: attributes you do not mention keep their value. Send `null` for one to clear it. Values are validated against the account's schema (`GET /v1/conversation-attributes`), so an unknown attribute id, or a value outside a select list, is a `400` naming the field rather than bad data stored quietly. Writing an attribute does **not** move the conversation up the queue — filing information is bookkeeping, not a customer interaction. Request --- # Update a customer מקור: https://docs.teloring.com/he/api/update-customer Markdown: https://docs.teloring.com/he/markdown/api/update-customer.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Only the fields you send change. Changing `lifecycle_stage` writes a journey event. Request --- # Update a record מקור: https://docs.teloring.com/he/api/update-customer-object-record Markdown: https://docs.teloring.com/he/markdown/api/update-customer-object-record.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Only the fields present in `data` change. Status transitions write journey events — a deal moving to `Won` or `Lost`, a service call being resolved. Request --- # Update notification settings מקור: https://docs.teloring.com/he/api/update-notification-settings Markdown: https://docs.teloring.com/he/markdown/api/update-notification-settings.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Replace an agent's notification settings. Turning the `push` channel off — or the master `enabled` switch — also deletes that agent's stored browser push subscriptions, so the pushes actually stop rather than the toggle merely looking off. Request --- # Update a quick reply מקור: https://docs.teloring.com/he/api/update-quick-reply Markdown: https://docs.teloring.com/he/markdown/api/update-quick-reply.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Only the fields you send change. Request --- # Update a team מקור: https://docs.teloring.com/he/api/update-team Markdown: https://docs.teloring.com/he/markdown/api/update-team.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Only the fields you send change. Sending `agent_ids` replaces the whole roster. Request --- # Set a profile picture מקור: https://docs.teloring.com/he/api/upload-agent-avatar Markdown: https://docs.teloring.com/he/markdown/api/upload-agent-avatar.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; `multipart/form-data` with an `avatar` part — PNG, JPEG, GIF or WebP, up to 5 MB. The upload is validated by decoding the image, not by trusting its `Content-Type`: a file that merely claims to be a PNG is rejected. The returned `avatar_url` is an authenticated proxy path, never a public Cloud Storage URL — a person's face should not be permanently addressable by anybody who once saw the link. Request --- # Upload a PDF מקור: https://docs.teloring.com/he/api/upload-signature-document Markdown: https://docs.teloring.com/he/markdown/api/upload-signature-document.md מדור: API Reference (English) עודכן לאחרונה: 2026-08-20T20:52:05.000Z import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import ParamsDetails from "@theme/ParamsDetails"; import RequestSchema from "@theme/RequestSchema"; import StatusCodes from "@theme/StatusCodes"; import OperationTabs from "@theme/OperationTabs"; import TabItem from "@theme/TabItem"; import Heading from "@theme/Heading"; import Translate from "@docusaurus/Translate"; Upload a PDF into the signature library. `multipart/form-data` with a `file` part. The document arrives as a **draft**. It cannot be sent for signature until somebody places the signature fields in the console's editor — a signature field is a coordinate on a page, and a JSON body of pixel offsets is not a contract anybody should have to write. That is why this returns `status: "draft"` rather than something immediately usable. Request