# 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](https://manager.line.biz)). 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](https://manager.line.biz) (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](https://developers.line.biz/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: \"**. 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](https://manager.line.biz), 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).