# LINE

חבר את **חשבון ה-LINE הרשמי** שלך כדי ששיחות ה-LINE שלך יזרמו לאפליקציה וסוכן בינה מלאכותית יוכל להשיב עליהן. החיבור מתבצע על ידי הדבקת פרטי ה-API של LINE Messaging שלך (סוד הערוץ + אסימון גישה) והגדרת כתובת URL אחת של webhook — ללא צורך בכתיבת קוד.

---

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

אינטגרציית LINE מקשרת **חשבון LINE רשמי (OA)** שבבעלותך לפלטפורמה באמצעות ה-Messaging API הרשמי של LINE — המערכת של LINE לשליחה וקבלה אוטומטית של הודעות, במקום שתצטרך להקליד אותן ידנית באפליקציית LINE. הצ'אטים האישיים שלך עם אנשים שהוסיפו את ה-OA שלך כחבר יהיו זמינים בתוך האפליקציה, וסוכן בינה מלאכותית, שידורים ותיבת דואר נכנס משותפת יפעלו על גביהם.

בניגוד ל-Telegram או WhatsApp Web, זוהי אינטגרציה **רשמית** — היא משתמשת ב-Messaging API של LINE עצמה, לכן היא יציבה ועומדת בכללי LINE. מכיוון של-LINE אין כפתור "חיבור" בלחיצה אחת עבור כלים של צד שלישי, עליך להדביק את פרטי ה-OA שלך פעם אחת במהלך ההגדרה.

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

---

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

תיצור (או תשתמש) בשלושה דברים במסופים של LINE עצמה. מדובר בהגדרה חד-פעמית של כ-5 דקות.

1. **חשבון LINE רשמי** (שנוצר ב-[מנהל החשבונות הרשמיים של LINE](https://manager.line.biz)). אם עדיין אין לך אחד, התחבר עם ה-LINE Business ID שלך ו**צור חשבון חדש** — תן לו שם ומלא את הטופס הקצר.
2. **ערוץ Messaging API** עבור אותו OA. הדרך הקלה ביותר היא להפעיל אותו מתוך מנהל ה-OA (ראה שלב 1 להלן) — אינך צריך ליצור את הערוץ ידנית בקונסולת המפתחים תחילה. כשתתבקש, בחר **ספק (provider)** קיים או צור אחד חדש.
3. מאותו ערוץ, תצטרך שלושה ערכים שתדביק באפליקציה:
   - **מזהה ערוץ (Channel ID)** (לשונית הגדרות בסיסיות) — אופציונלי, למידע בלבד
   - **סוד ערוץ (Channel secret)** (לשונית הגדרות בסיסיות)
   - **אסימון גישה לערוץ (Channel access token)** — אסימון ארוך טווח שאתה מנפיק בלשונית **Messaging API**

אין צורך במסמכים עסקיים עבור חשבון רשמי סטנדרטי (לא מאומת) — רק ב-LINE Business ID. אימות (התג הכחול) הוא אופציונלי ומוצע רק באזורים מסוימים.

---

## הגדרת LINE

### שלב 1: הפעלת ה-Messaging API עבור החשבון הרשמי שלך

1. התחבר ל-[מנהל החשבונות הרשמיים של LINE](https://manager.line.biz) (או צור חשבון רשמי חדש תחילה).
2. פתח את ה-OA שלך.
3. לחץ על **Settings** (בפינה הימנית העליונה).
4. בתפריט ההגדרות, לחץ על **Messaging API**.
5. הסטטוס מתחיל כ-**Disabled** — לחץ כדי להפעיל אותו.
6. בחר את ה**ספק (provider)** עבור ערוץ זה (החברה/מפתח שבבעלותו הוא נמצא). אם עדיין אין לך אחד, **צור ספק חדש**, ולאחר מכן אשר.

### שלב 2: קבלת פרטי הגישה מ-Developers Console

הפעלת ה-Messaging API יוצרת ערוץ תחת הספק שלך ב-[קונסולת המפתחים של LINE](https://developers.line.biz/console/).

1. פתח את **חשבון המפתח / הספק**.
2. לחץ על **ערוץ ה-Messaging API**.
3. פתח את לשונית **Basic settings** והעתק את ה-**Channel ID** וה-**Channel secret** שלך.
4. פתח את לשונית **Messaging API**, הנפק (או צור מחדש) **Channel access token** ארוך טווח, והעתק אותו.

> שמור את הערכים האלה בהישג יד — תדביק אותם באפליקציה מיד.

### שלב 3: חיבור LINE באפליקציה

1. בסרגל הצד השמאלי, לחץ על **Settings** (הגדרות) ליד החלק התחתון.
2. בסרגל הצד של ההגדרות, תחת **Channels** (ערוצים), לחץ על **Channels**.
3. מצא את הכרטיס **LINE** ולחץ על **Connect** (התחבר).
4. באופן אופציונלי, הדבק את ה-**Channel ID** שלך — למידע בלבד.
5. הדבק את ה-**Channel secret** שלך.
6. הדבק את ה-**Channel access token** שלך.
7. לחץ על **Connect**.
8. האפליקציה מאמתת את פרטי הגישה מול LINE ומציגה **"Connected to: \<your OA name\>"**. אם פרטי הגישה שגויים, תקבל שגיאה — הנפק מחדש את אסימון הגישה (access token) ב-LINE Developers Console ונסה שוב.


### שלב 4: הגדרת ה-Webhook URL ב-LINE

לאחר החיבור, האפליקציה תציג מקטע **Finish setup in LINE** (סיום הגדרה ב-LINE) עם **webhook URL** — העתק אותו. (כתובת ה-webhook היא פשוט כתובת אינטרנט; הדבקתה ב-LINE מורה ל-LINE לאן לשלוח הודעות חדשות באופן אוטומטי.) לאחר מכן, ב-**LINE Developers Console** עבור ערוץ ה-Messaging API שלך:

1. פתח את לשונית **Messaging API**.
2. הדבק את הכתובת ב-**Webhook URL**.
3. לחץ על **Update**.
4. העבר את **Use webhook** למצב **ON**.

### שלב 5: תיקון הגדרות ה-Official Account Manager (חשוב)

כברירת מחדל, OA של LINE מטפל בצ'אטים וב*תגובות אוטומטיות* בעצמו, מה שמונע מהודעות להגיע לבינה המלאכותית. חזור ל-[מנהל החשבונות הרשמיים של LINE](https://manager.line.biz), פתח את הגדרות ה-OA שלך והגדר:

| הגדרה | ערך נדרש | למה |
|---|---|---|
| **Chat** | **On** | מפעיל צ'אט כדי שהשיחה תזרום דרכו (מאפשר להשתמש במסנן הצ'אט). |
| **Response mode** | **Bot** | מאפשר ל-API (סוכן הבינה המלאכותית שלך) לטפל בהודעות. מצב "Chat" בלבד בולע אותן. |
| **Response hours / Auto-response messages** | **Off** | משבית את התגובות האוטומטיות של LINE כדי שהבינה המלאכותית תטפל בתגובות במקום זאת (הסיבה מס' 1 ל"תגובות כפולות"). |
| **Greeting messages** | **Off** | מונע מברכת ה-Auto-greeting של LINE להתחרות בבינה המלאכותית. |
| **Webhooks** | **On** | כדי ש-LINE תעביר הודעות לאפליקציה. |

> אם האפליקציה מזהירה שחשבונך נמצא ב-**Chat mode**, העבר אותו ל-**Bot mode** כאן — הבוט לא יוכל לקבל או לשלוח הודעות עד שתעשה זאת.

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

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

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

---

## עלות

LINE הוא ערוץ **חינמי** באפליקציה — אין חיוב לכל הודעה ואין דמי חיבור חודשיים מאיתנו. שים לב של**תוכניות של LINE עצמה** יש מגבלות חודשיות משלהן על הודעות *דחיפה* (שליחה יזומה), המשתנות לפי אזור וסוג חשבון. תגובות שנשלחות זמן קצר לאחר שלקוח שולח לך הודעה הן בחינם ב-LINE; שליחות יזומות/שידורים נספרים כחלק מהמכסה של תוכנית ה-LINE שלך.

---

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

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

---

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

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

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

| סטטוס | משמעות |
|---|---|
| **מחובר** | חשבון LINE רשמי מקושר לחשבון זה |
| **לא מחובר** | לא הוגדר חיבור |

הכרטיס גם בודק מחדש את הגדרת **מצב הצ'אט** (Chat mode) של החשבון שלך בכל פעם שאתה פותח את דף הערוצים. אם חשבון ה-LINE שלך הוחזר למצב צ'אט (מה שמונע מהבוט לקבל או לשלוח הודעות), תופיע אזהרה בצבע ענבר על הכרטיס, המנחה אותך להחזיר אותו ל-**מצב בוט** (Bot mode) ב-LINE Official Account Manager — בדוק שוב את המתגים בשלב 5 שם, והאזהרה תיעלם בביקור הבא.

### ניתוק

פתח את כרטיס ה-**LINE** ולחץ על **Manage**, לאחר מכן לחץ על **Disconnect** בחלונית שנפתחת ואשר את **Remove LINE?**. פעולה זו מסירה את החיבור מהצד שלנו. כדי להפסיק לחלוטין את שליחת האירועים מ-LINE, כבה גם את **Use webhook** (או מחק את כתובת ה-URL של ה-webhook) ב-LINE Developers Console.

---

## מגבלות

- **חשבון רשמי אחד לכל חיבור.** חבר כל OA בנפרד; ניתן לקשר OA לחשבון אחד בלבד.
- **שליחת טקסט + תמונה.** ה-AI משיב בטקסט ובתמונות; הודעות עשירות מסוג "Flex"/תבניות/קרוסלה אינן נשלחות בגרסה זו.
- **אזור.** חשבונות LINE Official אינם זמינים באיחוד האירופי; עליך להחזיק ב-OA באזור נתמך (למשל יפן, טייוואן, תאילנד, אינדונזיה).
- **תזמון תשובות.** לתשובות המיידיות החינמיות של LINE יש חלון זמן קצר; הודעות שנשלחות מאוחר יותר נשלחות אוטומטית כהודעות push (הנספרות במכסה).

---

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

### אישורי התחברות נדחו בעת החיבור

- ודא שיצרת ערוץ **Messaging API** (ולא "LINE Login").
- הנפק מחדש **long-lived channel access token** בכרטיסיית ה-Messaging API והדבק את הערך החדש.
- ודא שהעתקת את ה-**Channel secret** מכרטיסיית הגדרות בסיסיות (Basic settings) (ולא את ה-Channel ID).

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

- ודא שהאפשרות **Webhooks** מוגדרת כ-**On** גם ב-Developers Console וגם ב-OA Manager.
- ודא שכתובת ה-**Webhook URL** תואמת לזו שמוצגת באפליקציה.
- ודא ש-**Response mode** מוגדר כ-**Bot** (ולא Chat) ב-OA Manager.

### הלקוח מקבל שתי תשובות

- כבה את **Auto-response messages** ו-**Greeting messages** ב-OA Manager — הודעות התגובה האוטומטיות המובנות של LINE נשלחות במקביל ל-AI.

### הודעות לא מגיעות לאפליקציה

- ודא שאיש הקשר **הוסיף את החשבון הרשמי שלך כחבר** (LINE מעבירה הודעות רק מחברים).
- בדוק שוב את כתובת ה-webhook וודא שהאפשרות **Use webhook** מופעלת.

---

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

- **השלם את הגדרות ה-OA Manager** (מצב Bot, Webhooks מופעל, Greeting + Auto-reply כבויים) — רוב בעיות ההגדרה נובעות מכך.
- **השב במהירות** כדי לשמור על תגובות בתוך חלון הזמן החינמי של LINE ולחסוך במכסת ה-push שלך.
- **שמור על ה-access token שלך מאובטח** — לכל מי שיש לו גישה אליו יכול לשלוח הודעות בשם החשבון הרשמי שלך. הנפק אותו מחדש ב-Developers Console אם הוא דלף.