Your AI Connector Docs

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). אם עדיין אין לך אחד, התחבר עם ה-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 (או צור חשבון רשמי חדש תחילה).
  2. פתח את ה-OA שלך.
  3. לחץ על Settings (בפינה הימנית העליונה).
  4. בתפריט ההגדרות, לחץ על Messaging API.
  5. הסטטוס מתחיל כ-Disabled — לחץ כדי להפעיל אותו.
  6. בחר את הספק (provider) עבור ערוץ זה (החברה/מפתח שבבעלותו הוא נמצא). אם עדיין אין לך אחד, צור ספק חדש, ולאחר מכן אשר.

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

הפעלת ה-Messaging API יוצרת ערוץ תחת הספק שלך ב-קונסולת המפתחים של LINE.

  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, פתח את הגדרות ה-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 אם הוא דלף.