Your AI Connector Docs

LINE

Połącz własne konto LINE Official Account, aby rozmowy z LINE trafiały do aplikacji, gdzie może na nie odpowiadać Agent AI. Połączenie nawiązuje się poprzez wklejenie danych uwierzytelniających LINE Messaging API (Channel secret + access token) i ustawienie jednego adresu URL webhooka — bez konieczności programowania.


Czym jest integracja z LINE?

Integracja z LINE łączy posiadane przez Ciebie konto LINE Official Account (OA) z platformą przy użyciu oficjalnego interfejsu Messaging API — własnego systemu LINE służącego do automatycznego wysyłania i odbierania wiadomości, zamiast ręcznego wpisywania ich w aplikacji LINE. Twoje czaty 1 na 1 z osobami, które dodały Twoje konto OA do znajomych, stają się dostępne wewnątrz aplikacji, a Agent AI, transmisje (Broadcasts) i współdzielona skrzynka odbiorcza działają w oparciu o nie.

W przeciwieństwie do Telegrama czy WhatsApp Web, jest to oficjalna integracja — korzysta z własnego interfejsu Messaging API firmy LINE, dzięki czemu jest stabilna i zgodna z zasadami LINE. Ponieważ LINE nie posiada przycisku „połącz” jednym kliknięciem dla narzędzi firm trzecich, dane uwierzytelniające swojego konta OA wklejasz raz podczas konfiguracji.

Dostępność. Konta LINE Official Accounts są najpopularniejsze w Japonii, na Tajwanie, w Tajlandii i Indonezji i nie są dostępne w UE. Aby korzystać z tego kanału, musisz posiadać konto LINE Official Account zarejestrowane w obsługiwanym regionie.


Zanim zaczniesz

Utworzysz (lub wykorzystasz) trzy elementy w konsolach LINE. Jest to jednorazowa konfiguracja, która zajmuje około 5 minut.

  1. Konto LINE Official Account (utworzone w LINE Official Account Manager). Jeśli jeszcze go nie masz, zaloguj się za pomocą swojego LINE Business ID i utwórz nowe konto — nadaj mu nazwę i wypełnij krótki formularz.
  2. Kanał Messaging API dla tego konta OA. Najłatwiej włączyć go z poziomu menedżera OA (patrz Krok 1 poniżej) — nie musisz ręcznie tworzyć kanału w konsoli programisty (Developers Console). Po wyświetleniu monitu wybierz istniejącego dostawcę (provider) lub utwórz nowego.
  3. Z tego kanału pobierzesz trzy wartości, które wkleisz do aplikacji:
    • Channel ID (zakładka Basic settings) — opcjonalne, tylko informacyjne
    • Channel secret (zakładka Basic settings)
    • Channel access token — długoterminowy token, który wygenerujesz w zakładce Messaging API

Do standardowego (niezweryfikowanego) konta Official Account nie są wymagane żadne dokumenty firmowe — wystarczy LINE Business ID. Weryfikacja (niebieska odznaka) jest opcjonalna i oferowana tylko w niektórych regionach.


Konfiguracja LINE

Krok 1: Włącz Messaging API dla swojego konta Official Account

  1. Zaloguj się do LINE Official Account Manager (lub najpierw utwórz nowe konto Official Account).
  2. Otwórz swoje konto OA.
  3. Kliknij Settings (w prawym górnym rogu).
  4. W menu ustawień kliknij Messaging API.
  5. Status będzie ustawiony jako Disabled — kliknij, aby go włączyć.
  6. Wybierz dostawcę (provider) dla tego kanału (firmę/programistę, który jest jego właścicielem). Jeśli jeszcze go nie masz, utwórz nowego dostawcę, a następnie potwierdź.

Krok 2: Pobierz dane uwierzytelniające z konsoli programisty (Developers Console)

Włączenie Messaging API tworzy kanał u Twojego dostawcy w LINE Developers Console.

  1. Otwórz konto deweloperskie / dostawcę.
  2. Kliknij kanał Messaging API.
  3. Otwórz kartę Basic settings i skopiuj swój Channel ID oraz Channel secret.
  4. Otwórz kartę Messaging API, wygeneruj (lub wygeneruj ponownie) długoterminowy Channel access token i skopiuj go.

Miej te wartości pod ręką — wkleisz je za chwilę w aplikacji.

Krok 3: Połącz LINE w aplikacji

  1. Na lewym pasku bocznym kliknij Settings na dole.
  2. W lewym panelu ustawień, w sekcji Channels, kliknij Channels.
  3. Znajdź kartę LINE i kliknij Connect.
  4. Opcjonalnie wklej swój Channel ID — służy on wyłącznie celom informacyjnym.
  5. Wklej swój Channel secret.
  6. Wklej swój Channel access token.
  7. Kliknij Connect.
  8. Aplikacja zweryfikuje dane uwierzytelniające w LINE i wyświetli komunikat “Connected to: <twoja nazwa OA>”. Jeśli dane są nieprawidłowe, otrzymasz błąd — wygeneruj ponownie token dostępu w konsoli LINE Developers i spróbuj ponownie.

Krok 4: Ustaw adres URL webhooka w LINE

Po połączeniu aplikacja wyświetli sekcję Finish setup in LINE z adresem webhook URL — skopiuj go. (Adres URL webhooka to po prostu adres internetowy; wklejenie go w LINE informuje LINE, gdzie automatycznie przesyłać nowe wiadomości.) Następnie w konsoli LINE Developers dla swojego kanału Messaging API:

  1. Otwórz kartę Messaging API.
  2. Wklej adres URL w polu Webhook URL.
  3. Kliknij Update.
  4. Włącz opcję Use webhook (ON).

Krok 5: Popraw ustawienia w menedżerze konta oficjalnego (Ważne)

Domyślnie konto oficjalne (OA) LINE samodzielnie obsługuje czaty i automatyczne odpowiedzi, co uniemożliwia dotarcie wiadomości do sztucznej inteligencji. Wróć do LINE Official Account Manager, otwórz ustawienia swojego konta OA i ustaw:

Ustawienie Wymagana wartość Dlaczego
Chat On Włącza czat, aby umożliwić przepływ konwersacji (pozwala korzystać z filtra czatu).
Response mode Bot Pozwala API (Twojemu agentowi AI) obsługiwać wiadomości. Tryb “Chat”-only je blokuje.
Response hours / Auto-response messages Off Wyłącza własne automatyczne odpowiedzi LINE, aby AI mogła obsługiwać odpowiedzi (główna przyczyna “podwójnych odpowiedzi”).
Greeting messages Off Zapobiega konkurowaniu automatycznego powitania LINE z AI.
Webhooks On Dzięki temu LINE przekazuje wiadomości do aplikacji.

Jeśli aplikacja ostrzega, że Twoje konto jest w trybie czatu (Chat mode), przełącz je tutaj na tryb bota (Bot mode) — bot nie będzie mógł odbierać ani wysyłać wiadomości, dopóki tego nie zrobisz.

Krok 6: Przetestuj bota

  1. Z innego telefonu (np. własnej aplikacji LINE) dodaj swoje konto oficjalne do znajomych i wyślij do niego wiadomość.
  2. Otwórz aplikację i przejdź do Chats — przychodząca wiadomość pojawi się na liście konwersacji.
  3. Jeśli agent AI obsługuje ten kanał, zobaczysz, jak odpowiada automatycznie na wiadomość testową.

Po połączeniu, ustawieniu webhooka i poprawnym skonfigurowaniu przełączników, Twoje konto LINE będzie widoczne jako Connected na stronie kanałów, a AI będzie odpowiadać na przychodzące wiadomości.


Koszt

LINE jest bezpłatnym kanałem w aplikacji — nie pobieramy opłat za każdą wiadomość ani miesięcznych opłat za połączenie. Pamiętaj, że własne plany LINE mają swoje miesięczne limity wiadomości push (wysyłanych proaktywnie), które różnią się w zależności od regionu i typu konta. Odpowiedzi wysłane krótko po tym, jak klient napisze do Ciebie, są w LINE bezpłatne; proaktywne wysyłki/transmisje wliczają się do limitu Twojego planu LINE.


Wiadomości multimedialne

Przychodzące zdjęcia, filmy, notatki głosowe, pliki, naklejki i lokalizacje są rozpoznawane, dzięki czemu AI wie, że wysłano multimedia (do rozmowy dodawana jest krótka notatka). W tej wersji wychodzące odpowiedzi AI to tekst i obrazy. Długie odpowiedzi są automatycznie przycinane do limitu 5000 znaków LINE.


Zarządzanie sesją

Sprawdzanie statusu połączenia

Status Twojego połączenia z LINE jest widoczny na karcie LINE na stronie Kanały:

Status Znaczenie
Połączono Konto oficjalne LINE jest powiązane z tym kontem
Nie połączono Nie skonfigurowano połączenia

Karta sprawdza również ponownie ustawienie Trybu czatu Twojego konta za każdym razem, gdy otwierasz stronę Kanały. Jeśli Twoje konto LINE zostało przełączone z powrotem na tryb czatu (co uniemożliwia botowi odbieranie lub wysyłanie wiadomości), na karcie pojawi się bursztynowe ostrzeżenie z prośbą o przełączenie go z powrotem na tryb bota w menedżerze kont oficjalnych LINE (LINE Official Account Manager) — sprawdź ponownie przełączniki w kroku 5, a ostrzeżenie zniknie przy następnej wizycie.

Rozłączanie

Otwórz kartę LINE i kliknij Zarządzaj, a następnie kliknij Rozłącz w panelu, który się otworzy, i potwierdź Usunąć LINE?. To usuwa połączenie po naszej stronie. Aby całkowicie zatrzymać wysyłanie zdarzeń przez LINE, wyłącz również opcję Użyj webhooka (lub usuń adres URL webhooka) w konsoli programisty LINE (LINE Developers Console).


Ograniczenia

  • Jedno konto oficjalne na połączenie. Łącz każde konto oficjalne (OA) osobno; konto OA może być powiązane tylko z jednym kontem.
  • Wysyłanie tekstu + obrazów. AI odpowiada tekstem i obrazami; rozbudowane wiadomości typu „Flex”/szablony/karuzele nie są wysyłane w tej wersji.
  • Region. Konta oficjalne LINE nie są dostępne w UE; potrzebujesz konta OA w obsługiwanym regionie (np. Japonia, Tajwan, Tajlandia, Indonezja).
  • Czas odpowiedzi. Bezpłatne natychmiastowe odpowiedzi LINE mają krótkie okno czasowe; wiadomości wysłane później są automatycznie dostarczane jako wiadomości push (wliczane do limitu).

Rozwiązywanie problemów

Odrzucone dane uwierzytelniające podczas łączenia

  • Upewnij się, że utworzono kanał Messaging API (a nie „LINE Login”).
  • Wygeneruj ponownie długoterminowy token dostępu do kanału (long-lived channel access token) na karcie Messaging API i wklej nową wartość.
  • Potwierdź, że skopiowano Channel secret z karty Basic settings (a nie Channel ID).

Bot nie odpowiada

  • Potwierdź, że opcja Webhooks jest włączona (On) zarówno w konsoli programisty (Developers Console), jak i w menedżerze OA (OA Manager).
  • Potwierdź, że Webhook URL jest zgodny z adresem wyświetlanym w aplikacji.
  • Potwierdź, że Tryb odpowiedzi (Response mode) jest ustawiony na Bot (a nie Chat) w menedżerze OA.

Klient otrzymuje dwie odpowiedzi

  • Wyłącz Wiadomości automatyczne (Auto-response messages) oraz Wiadomości powitalne (Greeting messages) w menedżerze OA — wbudowane funkcje automatycznych odpowiedzi LINE są wysyłane równolegle z odpowiedziami AI.

Wiadomości nie docierają do aplikacji

  • Sprawdź, czy użytkownik dodał Twoje konto oficjalne do znajomych (LINE dostarcza wiadomości tylko od znajomych).
  • Sprawdź ponownie adres webhook URL oraz to, czy opcja Use webhook jest włączona.

Dobre praktyki

  • Skonfiguruj przełączniki w menedżerze OA (tryb Bot, włączone Webhooki, wyłączone wiadomości powitalne i automatyczne) — większość problemów z konfiguracją wynika z tych ustawień.
  • Odpowiadaj szybko, aby utrzymać odpowiedzi w darmowym oknie czasowym LINE i oszczędzać limit powiadomień push.
  • Dbaj o bezpieczeństwo tokena dostępu — każdy, kto go posiada, może wysyłać wiadomości w imieniu Twojego konta oficjalnego. Jeśli wycieknie, wygeneruj go ponownie w konsoli programisty (Developers Console).