שאלות נפוצות
האם המשתמשים צריכים להתקין משהו?
לא. המשתמשים פשוט מדביקים תג script אחד ל-HTML שלהם — ללא חבילות npm, ללא שלבי בנייה, ללא תלויות. תכונות נוספות נטענות אוטומטית מאותו origin.
האם הוא יתנגש עם ה-CSS שלי?
לא. הווידג׳ט מרונדר בתוך Shadow DOM, ומבודד לחלוטין את הסגנונות שלו מהעמוד שלכם.
האם הוא תומך באפליקציות עמוד יחיד (React, Vue, Next.js)?
כן. הסקריפט נטען פעם אחת ונשמר בין שינויי מסלול. עבור React/Next.js, מקמו את הסקריפט ב-root layout שלכם.
// app/layout.tsx (App Router)
import Script from 'next/script';
import { ReactNode } from 'react';
export default function RootLayout({ children }: { children: ReactNode }) {
return (
<html lang="en">
<body>
{children}
<Script id="respondo-init" strategy="afterInteractive">
{`
window.Respondo = window.Respondo || {};
Respondo.init = Respondo.init || function(c) { window.RespondoAIConfig = c; };
Respondo.q = Respondo.q || [];
Respondo.identify = Respondo.identify || function(d) { Respondo.q.push(['identify', d]); };
Respondo.init({
agentId: 'YOUR_AGENT_ID',
channelId: 'YOUR_CHANNEL_ID'
});
`}
</Script>
<Script src="https://api.respondo.ai/widget/widget.js" strategy="afterInteractive" />
</body>
</html>
);
}מה קורה כאשר שיחה נפתרת?
הודעה חדשה לאחר הפתרון פותחת אוטומטית שיחת המשך המקושרת לקודמת (מוצגת כ-"Continued from #N" בתיבת הפניות שלכם). הקשר כמו שפה והתמליל הקודם עוברים הלאה, והמבקר רואה צ׳אט רציף אחד. אם חבר צוות טיפל בשיחה שנפתרה, שיחת ההמשך מנותבת חזרה לצוות שלכם במקום ל-AI; אחרת ה-AI מטפל בה.
כיצד הווידג׳ט נטען?
הווידג׳ט נטען באופן אסינכרוני (async), כך שהוא לעולם אינו חוסם את רינדור העמוד. חבילת הליבה היא ~180KB (~50KB ב-gzip); תכונות אופציונליות (קמפיינים, סיורי מוצר) נטענות כנתחים עצלים נפרדים לאחר עיגון הווידג׳ט, כך שרינדור העמוד הראשוני לעולם אינו נחסם.
כיצד ההסלמה עובדת?
המשתמשים יכולים ללחוץ על כפתור "Talk to human", להקליד ביטוי המבקש אדם, או שה-AI מעביר את השיחה בעצמו כשאינו יכול לענות מתוך בסיס הידע שלכם. לאחר ההסלמה, ה-AI מפסיק להגיב וכל הודעות ההמשך מועברות לצוות התמיכה שלכם. ראו את הסעיף הסלמה והעברה לפרטים.
האם המשתמשים יכולים להמשיך לשוחח עם ה-AI לאחר ההסלמה?
כן. הווידג׳ט מציג כפתור "Continue with AI" המאפשר למשתמש לבטל את ההסלמה ולחדש את שיחת ה-AI.
מאגר ידע וסריקת אתר#
למה סריקת האתר שלי חסומה?
„חסומה” פירושו שהאתר — או שכבת ההגנה שלו (Cloudflare, WAF, תוסף נגד בוטים) — דחה את הסורק שלנו: דף הפתיחה או robots.txt החזירו בכל ניסיון שגיאת גישה או אתגר „בודקים את הדפדפן שלך”, או ש-robots.txt אוסר במפורש על הסורק שלנו. דפים שיובאו קודם נשארים שלמים, וסנכרון מחדש ייכשל באותו אופן עד שהאתר יאפשר לנו להיכנס. בקשו מבעל האתר לאשר את ה-User-Agent RespondoAI-Crawler (המחרוזת המלאה: Mozilla/5.0 (compatible; RespondoAI-Crawler/1.0; +https://respondo.ai/bot)) בהגדרות ההגנה — ב-Cloudflare זה תחת Security → WAF → Custom rules — ואם הסיבה היא robots.txt, להוסיף כלל היתר עבור User-agent: RespondoAI-Crawler. Respondo אינה מפרסמת כתובת IP קבועה של הסורק — אשרו לפי User-Agent; אם השגיאה המוצגת במקור מציינת כתובת IP, אשרו גם אותה. אם אי אפשר לשנות את האתר, הוסיפו את אותו תוכן כקבצים או כטקסט מודבק במקום זאת.
הסריקה הסתיימה אך מצאה רק דפים בודדים
אנחנו מגלים דפים ממפת האתר (שורת Sitemap: ב-robots.txt או מיקומים נפוצים כמו /sitemap.xml) ועל ידי מעקב אחר קישורים מכתובת ההתחלה — עד עומק של 10 קישורים ועד 5,000 דפים למקור. מיובאים רק דפים באותו אתר ותחת הנתיב של כתובת ההתחלה: סריקה שמתחילה ב-https://example.com/help מדלגת על /blog, לכן התחילו מהשורש או הוסיפו נתיבים לכלול. דפים שאף קישור או מפת אתר לא מצביעים אליהם, דפים ש-robots.txt אוסר ודפים מאחורי התחברות לא יימצאו. דפים כמעט זהים (גרסאות להדפסה, וריאציות עם פרמטרי מעקב) ממוזגים לאחד. דפים שהתוכן שלהם מצויר כולו ב-JavaScript מזוהים ומעובדים באמצעות מנגנון גיבוי מבוסס דפדפן, ולכן מספר דפים נמוך מעיד בדרך כלל על בעיית היקף או מפת אתר, לא על עיבוד.
איך מגבילים את הסריקה לחלק אחד של האתר?
פתחו את Advanced בחלון הוספת האתר ומלאו את Only crawl paths starting with (סרוק רק נתיבים שמתחילים ב) ו/או Skip paths starting with (דלג על נתיבים שמתחילים ב) — נתיב אחד בכל שורה, עד 50 בכל שדה. ההתאמה נעשית לפי מקטעי נתיב שלמים: /docs תואם ל-/docs ול-/docs/getting-started, אך לא ל-/docs-archive; לוכסן סופי מתעלמים ממנו, ואפשר להדביק כתובת URL מלאה — רק הנתיב שלה ישמש. כללי דילוג גוברים על כללי הכללה. אותם כללים חלים על מפת האתר ועל כל סנכרון מחדש עתידי של אותו מקור.
באיזו תדירות Respondo סורקת מחדש את האתר שלי?
לכל מקור אתר יש תזמון Auto-refresh בפאנל הדפים שלו: Off (כבוי), Daily (כל 24 שעות) או Weekly (כל 7 ימים). סריקה מתוזמנת היא תוספתית: דפים שה-lastmod שלהם במפת האתר ישן מהסריקה הקודמת מדולגים, דפים שלא השתנו אינם מאונדקסים מחדש, דפים שהשתנו מאונדקסים מחדש ודפים שנעלמו מוסרים. לרענון מיידי, השתמשו ב-Re-sync בתפריט המקור או ב-Re-sync all בדף Knowledge.
„לא הצלחנו לקרוא את האתר הפעם” — מה קרה?
זהו הכשל הכללי: האתר לא הגיב בזמן, הדומיין לא נפתר, השרת החזיר שגיאה, בדף הפתיחה לא היה טקסט קריא, או שהכתובת לא נמצאה. הפירוט מוצג במקור. ודאו שכתובת ה-URL נפתחת בחלון גלישה פרטי, שאין שגיאת הקלדה בדומיין ושדף הפתיחה הוא דף תוכן אמיתי ולא מסך התחברות. רשתות חברתיות ופלטפורמות הודעות (Facebook, Instagram, LinkedIn, X, YouTube ודומיהן) אי אפשר לייבא כלל — הן נדחות עוד לפני תחילת הסריקה. הדפים הקיימים שלכם נשמרים; מקור מתוזמן ינסה שוב בריצה הבאה, ואחרת סנכרנו מחדש ברגע שהאתר שוב נגיש.
מה המשמעות של „אינדקס החיפוש שלנו מלא” ו„לא הצלחנו לאנדקס את המקור הזה”?
שתי ההודעות מופיעות לאחר שהתוכן נקרא בהצלחה. האינדקס מלא פירושו שבאינדקס החיפוש שאליו מועתק המקור הזה אין מקום בצד של Respondo — מגבלה של Respondo, לא בעיה בתוכן שלכם. הדפים שמורים, כל מה שכבר אונדקס ממשיך לענות, הצוות שלנו מקבל הודעה אוטומטית והמקור יאונדקס ברגע שיתפנה מקום; סנכרון מחדש לפני כן ייכשל באותו אופן. לא הצלחנו לאנדקס את המקור הזה פירושו שבניית אינדקס החיפוש נכשלה הפעם — שגיאה זמנית בצד שלנו; הנתונים הקיימים שלמים והמשימה מנוסה שוב אוטומטית. אם אחת מההודעות נמשכת, השתמשו ב„שאלה ל-Copilot” על השגיאה.
האם דפים ארוכים נענים רק מתחילתם?
לא. כל דף שנסרק מפוצל למקטעים חופפים של כ-1,600 תווים, כל אחד מאונדקס בנפרד עם כותרת הדף מצורפת, כך שתשובה יכולה להגיע מכל חלק של מאמר ארוך. הציטוטים עדיין מציגים קישור אחד לכל דף. דפים שיובאו לפני השינוי הזה מפוצלים מחדש בסנכרונים הבאים שלהם.
איך מקבלים עזרה בשגיאת סריקה?
לכל שגיאת סריקה או אינדוקס בדף Knowledge מצורף כפתור שאלה ל-Copilot. הוא פותח את Copilot עם השגיאה מצורפת, ו-Copilot עונה מתוך תיעוד העזרה של Respondo עצמה בצעדים קונקרטיים למקרה שלכם. העזרה הזו חינמית — היא לא נספרת בבקשות ה-AI שלכם. אם הצעדים לא פותרים את הבעיה, פשוט אמרו זאת — „זה לא עזר” מספיק. Copilot יציע אז כרטיס שמעביר את הבעיה לצוות Respondo: הכרטיס מפרט בדיוק מה יישלח, שום דבר לא יוצא עד שתאשרו, והתשובה שלהם תגיע באותו שרשור Copilot. אם אי אפשר להעביר מכאן, Copilot יאמר זאת במפורש במקום לשתוק.
הודעות שלא מגיעות ללקוח#
תשובה מסומנת „Not delivered” — מה זה אומר, ובמה מתחילים?
לכל הודעה יוצאת בתיבת הדואר הנכנס יש מחוון מסירה: Queued (בתור — תשובות שנכתבו בזו אחר זו מאוחדות ויוצאות כמייל אחד תוך דקות ספורות), Sending… (בשליחה), Sent (נשלח), Delivered (נמסר), או כישלון באדום. הכישלונות מגיעים בשלוש צורות: Not delivered — הערוץ סירב להודעה; Bounced, עם תת-סוג ההקפצה לצידו — שרת הדואר של הנמען דחה את המייל; ו-Marked as spam — הנמען דיווח עליה. רחפו מעל התווית או לחצו עליה: החלונית מציגה את הניסוח של הספק עצמו, כולל אבחון ה-SMTP הגולמי של הקפצה. לצידה יופיעו עד שתי פעולות — Retry / Send again (שליחה חוזרת), ששולחת את ההודעה מחדש באמת, ו-Ask Copilot (שאלה ל-Copilot), שפותחת את Copilot עם השגיאה מצורפת. אם אין כפתור שליחה חוזרת בכלל, הכתובת חסומה ושליחה נוספת תיכשל באותו אופן. Sent או Delivered שמופיע לצידם N files not delivered פירושו שהטקסט הגיע אבל קובץ מצורף לא — הערוץ הזה לא יכול היה לשאת את הקובץ.
למה המייל שלי לא הגיע ללקוח?
ארבעה דברים שונים, והתווית מבחינה ביניהם. הקפצה קבועה פירושה שהכתובת אינה קיימת או מסרבת לקבל דואר — אין כפתור שליחה חוזרת, והכתובת נכנסת לרשימת החסימה. הקפצה זמנית היא תיבה מלאה או תקלה חולפת בשרת המקבל; Send again מוצע ובדרך כלל עובד מאוחר יותר. הקפצה שהאבחון שלה מזכיר SPF, DKIM, DMARC או 5.7.515 היא סיפור אחר: מערכת הדואר של הנמען דחתה את ההודעה מפני שדומיין השליחה שלכם נכשל בבדיקת האימות. תשובה חדשה תוקפץ בדיוק באותו אופן עד שהדומיין יתוקן, אז ענו בינתיים בערוץ אחר ותקנו את רשומות ה-DNS של ערוץ המייל ב-Settings → Channels. ולבסוף, Marked as spam פירושו שהנמען לחץ „דיווח על ספאם”: הכתובת נחסמת ואנחנו מפסיקים לשלוח אליה. דוח קמפיין יכול להציג בנוסף The email provider rejected this message — סירוב קבוע עוד לפני שהמייל יצא, בדרך כלל דומיין שליחה לא מאומת או כתובת פגומה — וגם The email provider rejected our credentials, שהיא בעיית הגדרה של סביבת העבודה ולא משהו שקשור לאיש הקשר המסוים הזה.
מהי רשימת החסימה, ואיך מוציאים ממנה כתובת?
זו רשימה, פרטית לסביבת העבודה שלכם, של כתובות מייל שאליהן Respondo מסרבת לשלוח. כתובת נכנסת אליה כשהודעה מוקפצת הקפצה קשה (דחייה קבועה), כשמישהו מדווח על אחד המיילים שלכם כספאם, או כשהיא נחסמת ידנית. הקפצות רכות לעולם אינן חוסמות כתובת. כל עוד החסימה פעילה, מסירות קמפיין אליה מדולגות עם This address is blocked after an earlier bounce or complaint, ותשובה מתיבת הדואר הנכנס נדחית עוד לפני שהיא יוצאת. רק הנמען האמיתי של ההודעה נחסם אי פעם — הודעת הקפצה אינה יכולה לחסום כתובת שרירותית. אין מסך לרשימה הזו בלוח הבקרה: בעלים או מנהל יכולים לקרוא אותה עם GET https://api.respondo.ai/api/v1/integrations/email/suppressions ולהסיר רשומה אחת עם DELETE https://api.respondo.ai/api/v1/integrations/email/suppressions/<email>, או לבקש מהתמיכה של Respondo לעשות זאת. שחררו הקפצה קשה רק כשאתם יודעים שהתיבה אכן תוקנה — שליחה חוזרת לכתובת מתה פוגעת במוניטין של הדומיין שלכם.
WhatsApp לא מקבל את התשובה שלי — חלון 24 השעות
WhatsApp מאפשר לעסק לשלוח הודעות חופשיות רק בתוך 24 שעות מההודעה האחרונה של הלקוח; אחרי זה Meta דוחה כל שליחה עם שגיאה 131047. Respondo עוקב אחרי החלון הזה לכל אדם בנפרד, וכשהוא יודע שהחלון פג הוא עוצר את התשובה לפני השליחה. כשאין ל-Respondo שום תיעוד של חלון — איש קשר מיובא, או מספר שמעולם לא כתב לכם — הוא אינו חוסם: ההודעה יוצאת ל-Meta ו-Meta מחליטה. יש בדיוק שתי דרכים להמשיך. לחכות שהלקוח יכתוב שוב — ההודעה שלו פותחת את החלון ל-24 שעות נוספות והתשובה שלכם עוברת — או לשלוח template (תבנית) שאושר על ידי Meta. אי אפשר לשלוח תבניות מחלון כתיבת ההודעה בשיחה. נהלו אותן ב-Outbound → WhatsApp templates: Sync מושך את מה שכבר רשום על המספר שלכם, New template מגיש תבנית ל-Meta, והבדיקה שלה נמשכת יום או יותר. אחר כך שלחו תבנית מאושרת דרך קמפיין outbound המכוון לאיש הקשר הזה. תבנית מגיעה גם לאנשים בתוך החלון וגם למי שמחוצה לו, אבל רק כל עוד הסטטוס שלה הוא approved.
„That channel is disconnected” / „That channel is not connected”
Disconnected (מנותק) פירושו שהאינטגרציה קיימת אך אינה פעילה עוד — אסימון הגישה שלה בוטל או פג, או שמישהו ניתק אותה. Not connected (לא מחובר) פירושו שמאחורי נקודת הקשר של אותו אדם אין אינטגרציה בכלל. את שניהם מתקנים ב-Settings → Channels, שם ערוצים מנותקים מקובצים תחת כותרת משלהם עם כפתור Reconnect בכל כרטיס; חברו מחדש ואז נסו לשלוח את ההודעה שוב. שני מקרים שכנים נראים דומים אך אינם זהים: ערוץ מייל שדומיין השליחה שלו אינו מאומת אינו יכול לעבור ל-Live ואינו שולח דבר עד שיאושרו DKIM ו-SPF, וערוץ לקבלה בלבד מסרב להודעות יוצאות מעצם התכנון, ולכן Retry שם לעולם לא יצליח.
„No channel to reach this person on” / „No email address on this contact”
שניהם מופיעים בדוח המסירה של קמפיין ולא בתיבת הדואר הנכנס. הראשון פירושו שאף נקודת קשר של איש הקשר לא התאימה לערוצים שהקמפיין שולח בהם; אם נקודת הקשר היחידה שלו נמצאת בערוץ לקבלה בלבד, זה מדווח בנפרד כדילוג מכוון. השני פירושו שהקמפיין שולח מייל ולאיש הקשר אין כתובת רשומה. ל-Telegram יש גרסה משלו: אם האדם מעולם לא כתב לבוט שלכם אין שיחה שאפשר לכתוב אליה, כי ה-Bot API אוסר על בוט לכתוב ראשון — הוא זה שצריך לשלוח את ההודעה הראשונה. תקנו זאת על ידי הוספת הכתובת החסרה לאיש הקשר, הרחבת הערוצים שהקמפיין מכוון אליהם, או מתן אפשרות לקמפיין ליפול חזרה למייל.
איש הקשר ביטל את המנוי — מה מותר לי לשלוח?
They had already unsubscribed פירושו שעל איש הקשר מסומן ביטול הסכמה גלובלי — שנקבע דרך קישור ביטול המנוי באחד המיילים שלכם, הגיע עם ייבוא, או שונה על ידי חבר צוות. קמפיינים וסדרות מדלגים על אנשי קשר כאלה בכל ערוץ, לא רק במייל, והמסירה נרשמת כדילוג ולא ככישלון. תשובה אישית של חבר צוות בתוך שיחה במכוון אינה נחסמת בגללו: ביטול הסכמה נוגע לדיוור המוני, ומענה לאדם שכתב אליכם הוא החלטה אנושית. המצב מוצג על איש הקשר בתור Outbound: Subscribed / Unsubscribed (מנוי / ביטל מנוי), אפשר לסנן את רשימת אנשי הקשר לפיו, וכפתור Re-subscribe (חידוש מנוי) בכרטיס איש הקשר מבטל אותו — השתמשו בו רק אם האדם ביקש זאת.
כמה פעמים אתם מנסים שוב, והאם בטוח ללחוץ על Retry?
תשובה מתיבת הדואר הנכנס מועברת לתור שמבצע עד חמישה ניסיונות, בהמתנה של כ-3, 10, 30 ו-30 דקות ביניהם. רק כשלים חולפים מנוסים שוב — פסקי זמן, חיבורים שנדחו, מגבלות קצב, שגיאות שרת של הספק עצמו. סירוב קבוע (כתובת לא ידועה, דומיין שליחה לא מאומת, אישורי גישה שנדחו) מסומן ככישלון מיד, כי חזרה תחזיר בדיוק את אותה תשובה. מסירות קמפיין רצות בתור נפרד עם עד שישה ניסיונות והמתנות קצרות יותר — 5 שניות, 30 שניות, 2 דקות, 10 דקות; כשאלה נגמרים, המסירה נסגרת עם Delivery kept failing and was stopped after several attempts במקום להישאר תקועה ב„queued” לנצח. ללחוץ על Retry ידנית זה בטוח. הכפתור פועל רק על הודעה שנמצאת באמת במצב כישלון, ובמייל הוא קודם שואל את הספק מה עלה בגורל ההודעה המקורית: אם המייל הזה כן יצא, השורה מתהפכת ל„נמסר” במקום לשלוח עותק שני, ושליחה חוזרת אמיתית יוצאת עם מפתח אידמפוטנטיות חדש. במקומות שבהם עותק שני יהיה שגוי — הקפצה קשה, תלונת ספאם, שליחה שעדיין בדרך — הכפתור אינו קיים או שהניסיון נדחה בציון הסיבה.
הסיבה עדיין לא ברורה — איך מקבלים עזרה?
לכל הודעה שנכשלה מצורף כפתור Ask Copilot (שאלה ל-Copilot). הוא פותח את Copilot כשהשגיאה, הערוץ והשיחה מצורפים, ו-Copilot עונה מתוך תיעוד העזרה של Respondo עצמה בצעדים לאותו כישלון בדיוק. העזרה הזו חינמית — היא לא נספרת בבקשות ה-AI שלכם. אם הצעדים לא פותרים את הבעיה, פשוט אמרו זאת — „זה לא עזר” מספיק. Copilot יציע אז כרטיס שמעביר את הבעיה לצוות Respondo: הכרטיס מפרט בדיוק מה יישלח, שום דבר לא יוצא עד שתאשרו, והתשובה שלהם תגיע באותו שרשור Copilot. אם אי אפשר להעביר מכאן, Copilot יאמר זאת במפורש במקום לשתוק.