Your AI Connector Docs

ספריית המדיה

ספריית המדיה מאפשרת לבוט ה-AI שלך לשלוח תמונות, סרטונים, קובצי GIF, הודעות קוליות ומסמכי PDF לאיש קשר במהלך שיחה. אתה מעלה את הקבצים פעם אחת, מגדיר לבוט מתי יש לשלוח כל אחד מהם, והבוט בוחר את הקובץ הנכון ברגע הנכון - לדוגמה, שליחת תמונת מוצר כשמישהו שואל “אפשר לראות את זה?”, חוברת PDF כשמישהו מבקש את המחירון המלא, או הודעה קולית קצרה שמדריכה לקוח בתפריט שלך.

חשוב על זה כמדף של קבצים מוכנים לשליחה עבור הבוט שלך. אתה מחליט מה נמצא על המדף ומתי נעשה שימוש בכל פריט.

ספריית המדיה זמינה בכל חשבון כברירת מחדל.


למה להשתמש בספריית מדיה

תשובות מבוססות טקסט בלבד מוגבלות ביכולתן. תמונה, סרטון קצר או הודעה קולית לרוב עונים על שאלה מהר יותר ומשכנעים יותר מאשר פסקה של טקסט.

מה ספריית מדיה מאפשרת לבוט שלך לעשות:

  • שלח תמונת מוצר כאשר איש קשר מבקש לראות משהו
  • שתף תפריט, מחירון או צילום מוצר כתמונה
  • שלח סרטון הדגמה קצר או סרטון הדרכה
  • השב עם GIF כאשר זה מתאים לטון השיחה
  • שלח הודעה קולית או קליפ אודיו למגע אישי ואנושי
  • שלח מסמך PDF - חוברת, מחירון, קטלוג או מסמך תנאים

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


היכן למצוא אותה

בסרגל הצד הראשי, תחת AI Studio, לחצו על Media Library. דף זה מציג את כל הקבצים שהבוט יכול לשלוח בתצוגה אחת לכל החשבון, המקובצים כך שקובץ המשמש במספר מקומות מופיע ככרטיסייה אחת. כל פריט שייך לסוכני ה-AI שלכם אחד או יותר — הכרטיסייה מפרטת לאילו מהם. השתמשו במסנן Show בחלק העליון כדי להציג את הכל או רק את המדיה של סוכן אחד.


איך הבוט מחליט מה לשלוח

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

לדוגמה:

פריט “מתי על הבוט לשלוח זאת?”
תמונה של השמלה הכחולה כאשר לקוח מבקש לראות את הגרסה הכחולה או איך היא נראית
תפריט ארוחת ערב (תמונה) כאשר מישהו שואל איזה אוכל אתם מגישים או מבקש לראות את התפריט
מדריך התקנה (סרטון) כאשר לקוח שואל איך להתקין או איך להתחיל

ככל שההנחיה שלך ברורה יותר, כך התזמון של הבוט יהיה טוב יותר. הנחיות מעורפלות כמו “שלח כשזה רלוונטי” נותנות לבוט פחות כלים לעבודה מאשר “שלח כשלקוח שואל על תמחור עבור התוכנית המקצועית”.


כיצד הבוט יודע מה יש בכל קובץ

כאשר אתה מעלה קובץ, הפלטפורמה מנתחת אותו אוטומטית וכותבת תיאור קצר של תוכנו - היא “מסתכלת” על התמונה או הסרטון שלך, או מתמללת את האודיו שלך. הבוט משתמש בזה יחד עם הנחיית ה"מתי לשלוח" שלך, כך שהוא מבין גם מהו הקובץ וגם מתי להשתמש בו - גם אם התיאור שלך קצר. תוכל לראות את סיכום ה-AI הזה על כל פריט ברשימה (מוצג כ-“AI sees: …”).

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

תיקון תמלול

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

  1. בספריית המדיה שלך, או בלשונית מדיה של הסוכן, לחץ על הפריט כדי לפתוח את העורך שלו.
  2. מצא את השדה תמלול. הוא מציג את הטקסט שנכתב בעת העלאת הקובץ.
  3. תקן את המילים שפורשו לא נכון, ולאחר מכן לחץ על שמור.

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

כדאי לדעת:

  • התמלול נשמר כפסקה קצרה אחת של עד 300 תווים. הקלטה ארוכה יותר נקטעת באורך זה, לכן שמור את החלק שמסביר לבוט על מה ההקלטה.
  • לתמונות, סרטונים ומסמכים יש את אותו שדה, שנקרא מה הבוט רואה בקובץ זה. ערוך אותו כאשר התיאור האוטומטי שגוי או מפספס משהו חשוב.
  • באפשרותך לרוקן את השדה. במקרה כזה, הבוט יסתמך אך ורק על הכותרת שלך ועל ההנחיה “מתי לשלוח”.
  • השדה מופיע בעת עריכת פריט קיים. העלאה חדשה תמיד מתחילה עם הטקסט האוטומטי.

מדיה במעקבים (Follow-Ups)

אחד המקומות השימושיים ביותר עבור מדיה הוא מעקב (follow-up) - התזכורת האוטומטית שהבוט שולח כאשר איש קשר שהשיב קודם לכן משתתק לזמן מה. הודעה קולית קצרה, סרטון מהיר או קליפ מסוג “אתה עדיין שם?” לרוב מחזירים אדם לשיחה הרבה יותר טוב מאשר עוד שורת טקסט.

כדי להשתמש בזה, כתבו הוראת “מתי לשלוח” המתארת מצב של מעקב, לדוגמה:

פריט “מתי על הבוט לשלוח זאת?”
הודעה קולית לחידוש קשר בעת ביצוע מעקב עם מישהו שהשתתק לזמן מה
GIF של “אתה עדיין שם?” אם איש קשר מפסיק להשיב באמצע שיחה

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

רוצה קובץ ספציפי בהמשך טיפול מסוים? הערת “מתי לשלוח” מתארת מצב, כך שהבוט מחליט מתי הוא מתאים; הוא לא יודע איזה מספר המשך טיפול מופעל. כדי לשלוח את ההודעה הקולית בדיוק בתזכורת השנייה ואת תמונת התמחור בשלישית, יש להצמיד את הפריטים לשלבים אלו בשלב ה-Follow-ups של הסוכן במקום זאת: ראה צירוף פריט מדיה להמשך טיפול ספציפי.

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

כמה דברים שכדאי לדעת:

  • זה עובד גם עבור מעקבים מהירים (התזכורות המוקדמות) וגם עבור מחזורי מעקב ארוכים של מספר ימים - ב-WhatsApp Web, אינסטגרם, מסנג’ר וטלגרם.
  • ב-WhatsApp Business API, מעקבי מדיה יכולים להישלח רק כל עוד חלון ה-24 שעות פתוח. לאחר מכן, וואטסאפ מאפשרת רק תבניות שאושרו מראש, לכן מעקבים מאוחרים יותר שם יישארו מבוססי טקסט בלבד.
  • אותה מכסת שליחה לכל שיחה חלה גם כאן, כך שהבוט לא יחזור על אותו קובץ במעקבים שונים אלא אם תעלו את המגבלה על אותו פריט.

איך להוסיף מדיה

  1. בסרגל הצד הראשי, לחץ על AI Studio.
  2. לחץ על Media Library.
  3. לחץ על הכפתור + Add media.
  1. תחת הוספה לסוכנים, סמן את הסוכן/ים שאליהם הפריט צריך להשתייך. ניתן לצרף פריט ליותר מסוכן אחד, וניתן לחפש ברשימה או למיין אותה לפי אחרונים, שם או פעילים תחילה.
  2. לחץ כדי לבחור קובץ (תמונה, וידאו, GIF, אודיו או PDF) מהמכשיר שלך. עבור אודיו, ניתן גם לעבור ל-הקלטת הודעה קולית ולהקליט אחת ישירות באפליקציה במקום להעלות. אם תוסיף אודיו, תוכל לבחור אם הוא יישלח כ-הודעה קולית (בועת קול מוקלט) או כ-קובץ אודיו רגיל.
  3. הקלד כותרת קצרה כדי שתוכל לזהות את הפריט מאוחר יותר (למשל “תמונת שמלה כחולה”).
  4. בשדה מתי על הבוט לשלוח זאת?, תאר את הסיטואציה בשפה פשוטה.
  1. לחץ על הוספת מדיה. הפריט יופיע ברשימת המדיה שלך ויהיה זמין באופן מיידי לבוט בכל סוכן שאליו צירפת אותו.

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

העליתם כבר קובץ ואתם רוצים לעשות בו שימוש חוזר בסוכן אחר? במקום להעלות אותו שוב, פתחו את הפריט ולחצו על Assign, ואז בחרו את הסוכן/סוכנים הנוספים. הקובץ עצמו לא משוכפל — אתם פשוט מוסיפים סוכן נוסף לאותו פריט מדיה.

מה למלא

שדה מה לכתוב
קובץ התמונה, הסרטון, ה-GIF, קובץ השמע/הודעה הקולית או ה-PDF שברצונך שהבוט יוכל לשלוח
כותרת תווית קצרה לעיון אישי (איש הקשר לעולם לא יראה זאת)
מתי על הבוט לשלוח זאת? תיאור ברור של המצב שאמור להפעיל פריט זה
מספר פעמים מרבי לשליחה לשיחה כמה פעמים הבוט רשאי לשלוח קובץ זה לאותו איש קשר. ברירת המחדל היא 1, כך שהבוט לא יחזור על אותו קובץ בפני אנשים. הגדל ערך זה אם יש צורך לשלוח את הקובץ שוב.
מה על הבוט לומר בעת השליחה? אופציונלי. הודעה מוצעת עבור המקרים שבהם הבוט שולח פריט זה. הבוט משתמש בה כהנחיה ומנסח אותה באופן טבעי בהקשר (הוא לא יקריא אותה בצורה רובוטית). השאר ריק כדי לתת לבוט להחליט. אם ברצונך במילים מדויקות, כתוב משהו כמו “say exactly: Let me send you a quick voice note.”

שדות אלו הם הערות עבור הבוט, ולא הודעות עבור איש הקשר שלך

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

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

קבצים נתמכים ומגבלות

  • תמונות: JPG, PNG, GIF, WebP
  • וידאו: MP4, MOV, WebM
  • אודיו: MP3, OGG, WAV, M4A (שליחה כהודעה קולית או כקובץ אודיו רגיל)
  • מסמכים: PDF
  • גודל מקסימלי: 10 MB לקובץ
  • לכל סוכן: עד 50 פריטים

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


עריכה והסרה של מדיה

  • כדי לשנות את הכותרת של פריט או את ההנחיה מתי לשלוח שלו, לחץ על הפריט וערוך את השדות, ולאחר מכן שמור. (עריכת ההנחיה אינה דורשת העלאה מחדש של הקובץ.)
  • כדי לתקן תמלול שבו מילה פורשה לא נכון, או את התיאור של מה שהבוט רואה בקובץ, ערוך את השדה הזה באותו עורך. ראה תיקון תמלול.
  • כדי להסיר פריט, לחץ על סמל המחיקה (פח האשפה) שמופיע עליו. הקובץ וההנחיה שלו יוסרו והבוט יפסיק לשלוח אותו.
  • כדי להחליף את הקובץ עצמו, מחק את הפריט והוסף אחד חדש.

אילו ערוצים יכולים לקבל מדיה

רוב הערוצים יכולים לקבל מדיה, אך לא כולם:

ערוץ תמיכה במדיה
WhatsApp (Business & Web) תמונות, וידאו, GIF, הודעות קוליות, אודיו, מסמכי PDF
Facebook Messenger תמונות, וידאו, הודעות קוליות, אודיו, מסמכי PDF
Instagram תמונות, וידאו, הודעות קוליות
Telegram תמונות, וידאו, אודיו (כקובץ, לא כהודעה קולית), מסמכי PDF
LINE תמונות בלבד
SMS לא נתמך (טקסט בלבד)

כמה דברים שכדאי לזכור:

  • SMS לא יכול לקבל מדיה. בשיחות SMS הבוט פשוט לא יציע פריטי מדיה.
  • Instagram לא יכול לקבל מסמכים. בשיחת אינסטגרם הבוט לא ישלח קבצי PDF - הוא יענה בטקסט במקום זאת.
  • קבצי GIF עוברים אופטימיזציה אוטומטית בעת ההעלאה כדי שיוכלו להנפיש ב-WhatsApp. בערוצים אחרים מסוימים, GIF עשוי להופיע כתמונה סטטית.
  • חלון 24 השעות של WhatsApp חל גם על מדיה. אם עבר זמן רב מדי מאז שהאיש קשר שלח לכם הודעה לאחרונה, WhatsApp עלולה לחסום כל הודעה - כולל מדיה - עד שהם ישיבו שוב.

טיפים לתוצאות הטובות ביותר

  1. כתבו את ההנחיה “מתי לשלוח” כאילו אתם מתדרכים חבר צוות חדש. תארו את הרגע המדויק - “כאשר לקוח מבקש לראות תמונות של הדירה” - ולא רק את הנושא.
  2. מטרה אחת לכל פריט. העלו פריטים נפרדים למצבים נפרדים במקום קובץ אחד שאתם מקווים שיכסה הכל.
  3. שמרו על קבצים קטנים ומהירים לטעינה. תמונה דחוסה או סרטון קצר מגיעים מהר יותר ונראים טוב יותר בצ’אט מאשר קובץ ענק.
  4. השתמשו בכותרות ברורות וניתנות לזיהוי. כאשר הספרייה שלכם גדלה, כותרות טובות מקלות על מציאה ועדכון של הפריט הנכון.
  5. בצעו בדיקה ב-Try Out. לאחר הוספת מדיה, השתמשו בלשונית ה-Try Out של הסוכן כדי לבדוק שהבוט בוחר את הפריט הנכון בזמן הנכון לפני העלייה לאוויר. התמונה, הסרטון, האודיו או המסמך יופיעו ישירות בצ’אט הבדיקה, בדיוק במקום שבו איש הקשר יקבל אותם.

שיחות בדיקה ישנות עשויות להציג “תצוגה מקדימה של מדיה פגה”. צ’אט הבדיקה הוא ארגז חול - שום הודעה אמיתית לא יוצאת מהחשבון שלכם - והתצוגות המקדימות של המדיה נשארות לצפייה למשך 7 ימים. אם תחזרו לשיחת בדיקה ישנה מאוחר יותר, תצוגה מקדימה שפגה תציג הערה קטנה במקום; פשוט בקשו מהבוט שוב כדי לראות אותה מחדש. שיחות אמיתיות אינן מושפעות: אנשי קשר מקבלים את הקובץ בפועל, שאינו פג תוקף.

מספר קבצים עבור אותו הדבר. הבוט בדרך כלל בוחר את הפריט הטוב ביותר לרגע נתון, לכן חמש תמונות עם אותה הערה של “מתי על הבוט לשלוח זאת?” בדרך כלל אומרות שתמונה אחת בלבד תישלח. אם קבוצה שייכת יחד (כל התמונות של מוצר אחד, תפריט מלא), ציינו זאת בהוראות הסוכן, לדוגמה “כשמישהו שואל על כיסא הגינה, שלח את כל תמונות כיסא הגינה”, ותנו לכל תמונה הערה שמציינת את שם המוצר. הבוט ישלח אז את כל הקבוצה בתגובה אחת.

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


קבצים מהכלים שלך

ספרייה מכילה עד 50 פריטים לכל סוכן. אם תמונות המוצרים, התפריטים או דפי המפרט שלך כבר נמצאים במערכת משלך (מסד נתונים, חנות, CRM), אינך צריך להעלות אותם לכאן. חבר את המערכת הזו לסוכן כ-פונקציה מותאמת אישית או כ-שרת MCP שמחזיר קישור ישיר לקובץ, והבוט ישלח את הקובץ עצמו במקום להדביק את הקישור.

איך זה עובד:

  1. איש הקשר מבקש משהו, לדוגמה “אפשר לראות את שמן הזית?”
  2. הבוט קורא לכלי שלך, והתוצאה מכילה קישור לקובץ כגון https://yourstore.com/images/olive-oil.jpg
  3. הבוט שולח את הקובץ הזה לאיש הקשר כתמונה, סרטון, קובץ שמע או מסמך אמיתי, עם כיתוב קצר בשפתו של איש הקשר

מה הקישור צריך להיות:

  • קישור ישיר לקובץ שמתחיל ב-https://. קישור לדף אינטרנט (דף מוצר) אינו קובץ; הבוט ישתף אותו כקישור רגיל במקום זאת.
  • תמונות: JPG, PNG, WebP, GIF. וידאו: MP4, MOV, WebM, 3GP. שמע: MP3, OGG, M4A, AAC, WAV. מסמכים: PDF, Word, Excel, PowerPoint, CSV
  • עד 16 MB לכל קובץ
  • נגיש ללא התחברות. קישור שדורש סיסמה או שכבר פג תוקפו לא ניתן לשליחה.

טוב לדעת:

  • הבוט שולח רק קישורים שהוחזרו מהכלים שלך באותה שיחה. קישור שאיש קשר מקליד, או כזה שהבוט ימציא, לעולם לא יישלח כקובץ.
  • הקובץ מועתק בעת שליחתו, כך שאיש הקשר שומר אותו גם אם הקישור שלך יפוג מאוחר יותר.
  • כל קישור לקובץ נשלח לכל היותר פעם אחת לכל שיחה.
  • אותן מגבלות ערוץ חלות כמו על פריטי ספרייה, ראה אילו ערוצים יכולים לקבל מדיה.
  • בלשונית נסה זאת (Try Out) של הסוכן, הקובץ מוצג בצ’אט הבדיקה, ושום דבר לא נשלח לאף אחד.

שליחת מדיה בעצמך

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


צעדים הבאים