# Viber

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

---

## מהי אינטגרציית Viber?

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

זוהי אינטגרציה **רשמית**, לכן היא יציבה ועומדת בכללי Viber.

> **זמינות.** Viber נמצאת בשימוש נרחב ביותר בפיליפינים, בווייטנאם ובחלקים אחרים של דרום-מזרח אסיה, וכן ברחבי מזרח אירופה ויוון.

---

## לפני שמתחילים

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

נכון לזמן כתיבת שורות אלו, Viber גובה תשלום חודשי עבור כל בוט בתוספת תשלום לכל הודעה שהבוט שלך יוזם (ראה [עלות](#cost) להלן). בדוק את התנאים העדכניים של Viber בעת ההרשמה, שכן התמחור שלהם נתון לשינויים מצידם.

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

- **דרך שותף מאומת של Viber**, שזו הדרך ש-Viber ממליצה עליה ובדרך כלל היא המהירה ביותר.
- **ישירות מול Viber**, על ידי שליחת אימייל ל-`partners@viber.com`. אם אתם כבר עובדים עם Viber, מנהל חשבון העסק שלכם יכול להתחיל את התהליך במקומכם.

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

לאחר מכן, תוכל למצוא את האסימון (token) שלו באפליקציית Viber תחת **More → Settings → Bots → Edit Info → Your app key**. Viber מכנה זאת *app key*; התיעוד של ה-API שלהם מכנה את אותו ערך *authentication token*, ומנהלי בוטים יכולים לראות אותו גם בלוח הניהול של Viber. ללא קשר לאופן שבו הוא מסומן, זהו הערך היחיד שאפליקציה זו מבקשת.

האסימון הזה הוא הדבר היחיד שאתם צריכים מ-Viber. ההגדרה כאן לוקחת בערך דקה.

---

## הגדרת Viber

### שלב 1: העתק את אסימון האימות של הבוט שלך

המקום המהיר ביותר למצוא אותו הוא באפליקציית Viber בטלפון שלך.

1. פתחו את Viber בטלפון שחשבונו הוא הבעלים של הבוט.
2. עברו אל **עוד (More) → הגדרות (Settings) → בוטים (Bots)**.
3. בחרו את הבוט שלכם והקישו על **עריכת פרטים (Edit Info)**.
4. העתיקו את הערך שמופיע תחת **מפתח האפליקציה שלך (Your app key)**. זהו האסימון.

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

### שלב 2: חבר את Viber באפליקציה

1. בסרגל הצד השמאלי, לחץ על **Settings** (הגדרות) ליד החלק התחתון.
2. בתפריט הצד של ההגדרות, תחת **Channels** (ערוצים), לחץ על **Channels**.
3. מצא את הכרטיס **Viber** ולחץ על **Connect** (חיבור).
4. הדבק את ה-**auth token** (אסימון האימות) שלך.
5. לחץ על **Connect**.
6. האפליקציה בודקת את האסימון מול Viber ומציגה **"Connected to: <your bot name>"** (מחובר ל: <שם הבוט שלך>).

**אין צורך להגדיר webhook.** בניגוד לרוב הערוצים האחרים, אנחנו רושמים הכל מול Viber עבורך כחלק מתהליך החיבור, כך שאין שום דבר שצריך להעתיק לקונסולה אחרת. מסך החיבור מציג את הכתובת שאליה מגיעות ההודעות שלך רק כדי שתוכל לשתף אותה עם התמיכה אם תזדקק לכך אי פעם.

### שלב 3: בדיקת הבוט

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

לאחר החיבור, בוט ה-Viber שלך יופיע כ-**Connected** (מחובר) בדף הערוצים וה-AI יגיב להודעות נכנסות.

---

## למי הבוט שלך יכול לשלוח הודעות

זהו הדבר החשוב ביותר להבנה לגבי Viber, והוא שונה מכל ערוץ אחר:

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

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

בשל כך, Viber עובד מצוין כ**ערוץ תמיכה ומענה** (מישהו שולח לך הודעה, ה-AI עונה) ופחות טוב כערוץ לפנייה יזומה (cold-outreach).

---

## עלות

Viber הוא ערוץ **חינמי** באפליקציה: אין תשלום לכל הודעה ואין דמי חיבור חודשיים מאיתנו.

העלויות שלך מגיעות מ-**Viber**, בחשבון האישי שלך:

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

השורה התחתונה: מענה לאנשים לא עולה לך דבר מעבר לדמי המנוי החודשיים. שידורים (Broadcasts) ופניות יזומות הם מה שמצטבר לעלות.

---

## הודעות מדיה

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

---

## ניהול סשן (התחברות)

### בדיקת מצב החיבור

סטטוס החיבור ל-Viber מוצג בכרטיס **Viber** בדף **Channels** (ערוצים):

| סטטוס | משמעות |
|---|---|
| **מחובר** | בוט Viber מקושר לחשבון זה |
| **מחובר, נדרשת פעולה** | כלי אחר השתלט על הבוט שלך; הודעות לא מגיעות אלינו |
| **לא מחובר** | לא הוגדר חיבור |

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

### ניתוק

פתח את כרטיס ה-**Viber** ולחץ על **ניהול** (Manage), לאחר מכן לחץ על **ניתוק** (Disconnect) ואשר את **הסרת Viber?** (Remove Viber?). פעולה זו תפסיק את קבלת הודעות הבוט ותסיר אותו מהחשבון שלך. הבוט עצמו נשאר בבעלותך. שום דבר לא משתנה בחשבון ה-Viber שלך.

---

## מגבלות

- **עוקבים בלבד.** הבוט שלך יכול לשלוח הודעות רק לאנשים שעוקבים אחריו. ראה [למי הבוט שלך יכול לשלוח הודעות](#who-your-bot-can-message).
- **עליך להחזיק בבוט Viber בתשלום משלך.** איננו יכולים לספק אחד כזה.
- **בוט אחד לכל חיבור.** חבר כל בוט בנפרד; בוט יכול להיות מקושר לחשבון אחד בלבד.
- **שליחת טקסט + תמונה.** ה-AI משיב בטקסט ובתמונות; קרוסלות וכרטיסים עשירים (rich cards) אינם נשלחים בגרסה זו.
- **ללא הודעת ברוכים הבאים.** כאשר מישהו פותח את הבוט שלך בפעם הראשונה אך טרם עקב אחריו, Viber מאפשרת ברכת שלום מיידית אחת. גרסה זו אינה שולחת הודעה כזו. השיחה מתחילה כאשר הם שולחים את ההודעה הראשונה שלהם.

---

## פתרון בעיות

### אסימון (Token) נדחה בעת החיבור

- ודא שהעתקת את הערך מתוך **עריכת מידע → מפתח האפליקציה שלך** (Edit Info → Your app key) באפליקציית Viber, ולא מזהה אחר.
- בדוק שהבוט שלך עדיין פעיל בחשבון ה-Viber שלך.
- החיבור גם בודק ש-Viber מסוגלת להגיע אלינו. אם האסימון שלך בהחלט נכון וזה עדיין נכשל, המתן דקה ונסה שוב, ולאחר מכן פנה לתמיכה.

### "בוט Viber זה כבר מחובר לחשבון אחר"

אותו בוט מקושר לחשבון אחר באפליקציה. נתק אותו משם תחילה, או השתמש בבוט אחר.

### הבוט לא מגיב

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

### הודעות הפסיקו להגיע

זוהי כמעט תמיד בעיית ההשתלטות המתוארת תחת [בדיקת סטטוס חיבור](#checking-connection-status): אותו בוט חובר לכלי אחר. פתח את כרטיס ה-**Viber** ובצע חיבור מחדש.

### תשובה נכשלה עם השגיאה "Not Subscribed"

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

---

## שיטות עבודה מומלצות

- **התמקד בתמיכה, לא ביצירת קשר יזום.** תשובות בתוך שיחה שמישהו התחיל הן בחינם וללא הגבלה; הודעות שאתה מתחיל כרוכות בתשלום ומגיעות רק לעוקבים.
- **הפוך את הבוט שלך לקל למעקב.** הצב את הקישור שלו באתר שלך, בחתימת האימייל שלך ובערוצים האחרים שלך. מעקב אחריו הוא הדרך היחידה שבה אנשים יכולים להגיע אליו.
- **שמור על אסימון האימות (auth token) שלך מאובטח.** כל מי שמחזיק בו יכול לשלוח הודעות בשם הבוט שלך. צור אותו מחדש באפליקציית Viber אם הוא דלף, ולאחר מכן בצע חיבור מחדש כאן.
- **אל תחבר את אותו בוט לשני כלים.** הכלי השני ישתלט על החיבור בשקט.