צ'אט מוטמע לאתר (ווידג'ט)

Biz1 צ'אט מוטמע

עדכון אחרון: 2026-06-01

Biz1 צ'אט מוטמע הוא **ווידג'ט צ'אט לאתר** שאתם מוסיפים לאתר שלכם. מבקרים לוחצים על אייקון צ'אט, מזינים את פרטיהם, ושולחים הודעה לעסק שלכם — מבלי להתחבר ל-Biz1.

הצוות שלכם קורא ומשיב מתוך Biz1 (כרטיס לקוח ← לשונית צ'אט).

מה זה

צ'אט מוטמע מציב **בועת צ'אט חי** בכל אתר שאתם שולטים בו — אתר שיווקי, דף נחיתה, חנות מקוונת וכו'.

מבקרים אינם זקוקים לחשבון Biz1. הם רואים חלון צ'אט ידידותי, ממלאים שם / אימייל / טלפון פעם אחת, ומתחילים לשוחח.

שתי דרכים להציע זאת:

| מצב | חוויה |

|------|------------|

| **ווידג'ט צף** | אייקון קטן בפינה; פותח פאנל צ'אט בלחיצה |

| **צ'אט בעמוד מלא** | דף צ'אט ייעודי (קישור או iframe) |

היכן ניתן לראות זאת

| מיקום | מטרה |

|----------|---------|

| **האתר שלכם** | ווידג'ט חי או דף צ'אט שהמבקרים שלכם משתמשים בו |

| **קונפיגורטור הטמעה** | `https://your-domain.com/chat/embed.php` — בחרו אפשרויות והעתיקו קוד |

| **דף בדיקה** | `https://your-domain.com/chat/test.html` — תצוגה מקדימה לפני עלייה לאוויר |

| **Biz1 ← לקוח ← לשונית צ'אט** | היכן שהצוות שלכם רואה ומשיב להודעות מבקרים |

תכונות

למבקרי אתרים

| תכונה | פרטים |

|---------|---------|

| **התחלת צ'אט** | טופס שם, אימייל וטלפון בביקור ראשון |

| **הודעות טקסט** | הודעות צ'אט רגילות |

| **העלאת קבצים** | PDF, Word, תמונות |

| **הודעות קוליות** | מקליט קול מובנה |

| **מצלמה** | צילום תמונה בנייד |

| **ביקורים חוזרים** | הדפדפן זוכר את המבקר למשך כ-30 יום |

| **היסטוריית צ'אט** | הודעות קודמות נטענות בביקור חוזר (כאשר ההיסטוריה מופעלת) |

| **ברכה** | ״שלום {name}״ מוצג מקומית בעת פתיחת הצ'אט |

התאמה אישית (המיתוג שלכם)

| אפשרות | אפשרויות |

|--------|---------|

| **שפה** | English, Hebrew, Arabic, Thai, Burmese |

| **כיוון** | משמאל לימין או מימין לשמאל |

| **צבע** | כל צבע הקסדצימלי עבור כותרת ובועות הודעות מבקרים |

| **מצב ברירת מחדל** | צ'אט פתוח או סגור בעת טעינת הדף |

| **היסטוריה** | טעינת הודעות קודמות בביקור חוזר (מופעל/כבוי) |

מיתוג ברירת המחדל משתמש בצבעי ולוגו Biz1; אתם דורסים את הצבע הראשי עם צבע משלכם.

עבור הצוות שלכם

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

כיצד להגדיר זאת

שלב 1 — קבלו את אסימון ה-API שלכם

1. התחברו ל-Biz1 כ**בעל החשבון**. 2. עברו ל**הגדרות**. 3. בקטע החשבון / פרופיל שלכם, מצאו את **אסימון API**. 4. העתיקו את האסימון — תזדקקו לו בקוד ההטמעה.

> צ'אט מוטמע משתמש באסימון ה-API של חשבונכם. גישת API עשויה לדרוש תוכנית בתשלום — ראו FREE_PLAN_MAP.md.

שלב 2 — בנו את הווידג'ט (מומלץ)

1. פתחו את **`https://your-domain.com/chat/embed.php`** בדפדפן שלכם. 2. הגדירו: - שפה וכיוון - צבע מותג - פתוח או סגור כברירת מחדל - האם לטעון היסטוריה - אסימון ה-API שלכם 3. לחצו על **העתק סקריפט הטמעה**. 4. הדביקו את הסקריפט לקוד ה-HTML של אתרכם, ממש לפני `</body>`.

הקונפיגורטור מספק גם:

- **קישור לתצוגה מקדימה** — פתחו בלשונית חדשה כדי לראות איך זה נראה - **תצוגה מקדימה חיה** — בדקו את הווידג'ט עם ההגדרות שלכם

שלב 3 — ווידג'ט צף (ידני)

אם אתם מעדיפים לכתוב את הקוד בעצמכם, הוסיפו תגית סקריפט אחת:

<script src="https://your-domain.com/chat/chat.php"
  data-lang="en"
  data-direction="ltr"
  data-color="#021225"
  data-default="close"
  data-api_hash_token="YOUR_API_TOKEN"
  data-history="1">
</script>

| מאפיין | משמעות |

|-----------|---------|

| `data-lang` | שפת ממשק משתמש |

| `data-direction` | `ltr` או `rtl` |

| `data-color` | צבע מותג (הקסדצימלי) |

| `data-default` | `open` או `close` בטעינת דף |

| `data-api_hash_token` | אסימון ה-API שלכם מההגדרות |

| `data-history` | `1` = טעינת הודעות קודמות בביקור חוזר |

שלב 4 — צ'אט בעמוד מלא (חלופה)

קשרו ישירות לדף צ'אט במקום לווידג'ט צף:

https://your-domain.com/chat/index.php?lang=en&api_hash_token=YOUR_API_TOKEN

**חשבונות תת-דומיין:** אם אתם משתמשים בתת-דומיין אישי (לדוגמה `yourname.biz1.co.il`), צ'אט בעמוד מלא בדומיינים נתמכים יכול לעבוד **ללא** אסימון:

https://yourname.biz1.co.il/chat/index.php?lang=he&history=1

דומיינים נתמכים: `biz1.co.il`, `bull36.com`, `mastrocrm.com`.

סקריפט ההטמעה הצף תמיד דורש את אסימון ה-API.

שלב 5 — זיהוי מוקדם של מבקר חוזר (אופציונלי)

אם אתם כבר מכירים את הלקוח (לדוגמה, ממערכת ה-CRM שלכם או ממשתמש מחובר באתר שלכם):

<script src="https://your-domain.com/chat/chat.php"
  data-api_hash_token="YOUR_API_TOKEN"
  data-con_id="ENCRYPTED_CONTACT_ID"
  data-name="John Doe"
  data-history="1"
  data-default="open">
</script>

המבקר מדלג על טופס ההקדמה ועובר ישירות לצ'אט.

שלב 6 — בדיקה לפני עלייה לאוויר

1. פתחו את **`https://your-domain.com/chat/test.html`** (או את קישור התצוגה המקדימה מ-embed.php). 2. שלחו הודעת בדיקה. 3. ב-Biz1, פתחו את **כרטיס הלקוח ← לשונית צ'אט** המתאימה ואשרו שההודעה הגיעה. 4. השיבו מ-Biz1 ואשרו שהמבקר רואה זאת (או השתמשו בלחצני הזרקת הבדיקה בדף הבדיקה).

שלב 7 — השבה מ-Biz1

כאשר מבקר משוחח באתר שלכם:

1. רשומת לקוח נוצרת או מותאמת. 2. פתח את הלקוח הזה ב-Biz1. 3. עבור ללשונית **צ'אט**. 4. הקלד את תשובתך.

ניתן גם להשתמש ב**צ'אט שבסרגל הצד** לגישה מהירה.

חווית מבקר (שלב אחר שלב)

ביקור ראשון

1. מבקר נוחת באתר שלך. 2. לוחץ על **אייקון הצ'אט** (בפינה התתחתונה). 3. ממלא **שם, אימייל, טלפון**. 4. שולח ← צ'אט נפתח עם ברכה. 5. שולח הודעות, קבצים או הודעות קוליות.

ביקור חוזר (בתוך כ-30 יום)

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

שפות & RTL

| שפה | קוד | כיוון ברירת מחדל |

|----------|------|-------------------|

| English | `en` | LTR |

| Hebrew | `he` | RTL |

| Arabic | `ar` | RTL |

| Thai | `th` | LTR |

| Burmese | `my` | LTR |

עברית וערבית מזהות אוטומטית RTL אם הכיוון לא מוגדר.

הערת תוכנית

| פריט | תוכנית חינם |

|------|-----------|

| הטמעת צ'אט / אסימון API | בדרך כלל דורש תוכנית בתשלום או גישת API |

**צ'אט הלקוח הליבתי בתוך Biz1** (שם אתה משיב) כלול בחינם. ראה FREE_PLAN_MAP.md.

רשימת בדיקה מהירה

- [ ] העתק **אסימון API** מהגדרות - [ ] הגדר ווידג'ט ב-**`/chat/embed.php`** - [ ] הדבק סקריפט הטמעה באתר שלך - [ ] בדוק ב-**`/chat/test.html`** - [ ] אשר שהודעות מופיעות ב-Biz1 **לקוח ← צ'אט** - [ ] אמן צוות להשיב מלשונית הצ'אט