# LINE Koppel je eigen **LINE Official Account** zodat je LINE-gesprekken in de app binnenkomen en een AI-agent kan antwoorden. Je koppelt dit door je LINE Messaging API-inloggegevens (Channel secret + access token) te plakken en één webhook-URL in te stellen — programmeren is niet nodig. --- ## Wat is de LINE-integratie? De LINE-integratie koppelt een **LINE Official Account (OA)** waarvan je de eigenaar bent aan het platform met behulp van de officiële Messaging API van LINE — het eigen systeem van LINE om automatisch berichten te verzenden en ontvangen, in plaats van dat je ze handmatig in de LINE-app typt. Je 1-op-1 chats met mensen die je OA als vriend hebben toegevoegd, worden beschikbaar in de app, en een AI-agent, Broadcasts en een gedeelde inbox werken hier bovenop. In tegenstelling tot Telegram of WhatsApp Web is dit een **officiële** integratie — het maakt gebruik van de eigen Messaging API van LINE, dus het is stabiel en voldoet aan de regels van LINE. Omdat LINE geen "verbinden"-knop met één klik heeft voor tools van derden, plak je de inloggegevens van je OA eenmalig tijdens de configuratie. > **Beschikbaarheid.** LINE Official Accounts komen het meest voor in Japan, Taiwan, Thailand en Indonesië, en zijn **niet beschikbaar in de EU**. Je hebt een LINE Official Account nodig dat is geregistreerd in een ondersteunde regio om dit kanaal te gebruiken. --- ## Voordat je begint Je maakt (of gebruikt) drie dingen in de eigen consoles van LINE. Dit is een eenmalige configuratie van ongeveer 5 minuten. 1. Een **LINE Official Account** (aangemaakt in de [LINE Official Account Manager](https://manager.line.biz)). Als je er nog geen hebt, log dan in met je LINE Business ID en **maak een nieuw account aan** — geef het een naam en vul het korte formulier in. 2. Een **Messaging API-kanaal** voor dat OA. De makkelijkste manier is om dit in te schakelen vanuit de OA Manager (zie stap 1 hieronder) — je hoeft het kanaal niet eerst handmatig aan te maken in de Developers Console. Kies bij de prompt een bestaande **provider** of maak een nieuwe aan. 3. Drie waarden uit dat kanaal die je in de app plakt: - **Channel ID** (tabblad Basic settings) — optioneel, alleen ter informatie - **Channel secret** (tabblad Basic settings) - **Channel access token** — een langdurig token dat je uitgeeft op het tabblad **Messaging API** Er zijn geen bedrijfsdocumenten vereist voor een standaard (niet-geverifieerd) Official Account — alleen een LINE Business ID. Verificatie (het blauwe vinkje) is optioneel en wordt slechts in sommige regio's aangeboden. --- ## LINE instellen ### Stap 1: Schakel de Messaging API in voor je Official Account 1. Log in op de [LINE Official Account Manager](https://manager.line.biz) (of maak eerst een nieuw Official Account aan). 2. Open je OA. 3. Klik op **Settings** (rechterbovenhoek). 4. Klik in het instellingenmenu op **Messaging API**. 5. De status staat standaard op **Disabled** — klik om het in te schakelen. 6. Kies de **provider** voor dit kanaal (het bedrijf/de ontwikkelaar die eigenaar is). Als je er nog geen hebt, **maak een nieuwe provider aan** en bevestig. ### Stap 2: Haal je inloggegevens op uit de Developers Console Het inschakelen van de Messaging API maakt een kanaal aan onder je provider in de [LINE Developers Console](https://developers.line.biz/console/). 1. Open het **developer account / provider**. 2. Klik op het **Messaging API-kanaal**. 3. Open het tabblad **Basic settings** en kopieer je **Channel ID** en **Channel secret**. 4. Open het tabblad **Messaging API**, geef een langdurig **Channel access token** uit (of genereer het opnieuw) en kopieer dit. > Houd deze waarden bij de hand — je plakt ze zo meteen in de app. ### Stap 3: LINE verbinden in de app 1. Klik in de linkerzijbalk onderaan op **Settings**. 2. Klik in de linker kolom van Settings onder **Channels** op **Channels**. 3. Zoek de **LINE**-kaart en klik op **Connect**. 4. Plak optioneel je **Channel ID** — dit is enkel ter informatie. 5. Plak je **Channel secret**. 6. Plak je **Channel access token**. 7. Klik op **Connect**. 8. De app valideert de inloggegevens bij LINE en toont **"Connected to: \"**. Als de inloggegevens onjuist zijn, krijg je een foutmelding — vraag het toegangstoken opnieuw aan in de LINE Developers Console en probeer het opnieuw. ### Stap 4: De Webhook URL instellen in LINE Na het koppelen toont de app een sectie **Finish setup in LINE** met een **webhook URL** — kopieer deze. (Een webhook-URL is simpelweg een webadres; door dit in LINE te plakken, vertel je LINE waar automatisch nieuwe berichten naartoe gestuurd moeten worden.) Vervolgens in de **LINE Developers Console** voor je Messaging API-kanaal: 1. Open het tabblad **Messaging API**. 2. Plak de URL in **Webhook URL**. 3. Klik op **Update**. 4. Zet **Use webhook** op **ON**. ### Stap 5: De instellingen van de Official Account Manager corrigeren (Belangrijk) Standaard handelt een LINE OA chats en *automatische antwoorden* zelf af, waardoor berichten de AI niet bereiken. Ga terug naar de [LINE Official Account Manager](https://manager.line.biz), open je OA-instellingen en stel het volgende in: | Instelling | Vereiste waarde | Waarom | |---|---|---| | **Chat** | **On** | Schakelt chat in zodat het gesprek doorloopt (zodat je het chatfilter kunt gebruiken). | | **Response mode** | **Bot** | Laat de API (je AI-agent) berichten afhandelen. De modus "Chat"-only slokt ze op. | | **Response hours / Auto-response messages** | **Off** | Schakelt de eigen automatische antwoorden van LINE uit zodat de AI de antwoorden afhandelt (de nummer 1 oorzaak van "dubbele antwoorden"). | | **Greeting messages** | **Off** | Voorkomt dat de eigen automatische begroeting van LINE concurreert met de AI. | | **Webhooks** | **On** | Zodat LINE berichten doorstuurt naar de app. | > Als de app waarschuwt dat je account in **Chat-modus** staat, schakel deze dan hier over naar **Bot-modus** — de bot kan geen berichten ontvangen of versturen totdat je dit doet. ### Stap 6: De bot testen 1. Voeg vanaf een andere telefoon (bijv. je eigen LINE-app) je Official Account toe als vriend en **stuur een bericht**. 2. Open de app en ga naar **Chats** — het inkomende bericht verschijnt in de gesprekkenlijst. 3. Als een AI-agent dit kanaal beheert, zul je zien dat deze **automatisch antwoordt** op het testbericht. Zodra de koppeling is gemaakt met de webhook ingesteld en de bovenstaande schakelaars correct staan, wordt je LINE-account weergegeven als **Connected** op de pagina Channels en reageert de AI op inkomende berichten. --- ## Kosten LINE is een **gratis** kanaal in de app — er zijn geen kosten per bericht en geen maandelijkse verbindingskosten van onze kant. Let op: de **eigen abonnementen van LINE** hebben hun eigen maandelijkse limieten voor *push*-berichten (proactieve verzendingen), die variëren per regio en accounttype. Antwoorden die kort na een bericht van een klant worden verzonden, zijn gratis op LINE; proactieve/broadcast-verzendingen tellen mee voor het quotum van je LINE-abonnement. --- ## Mediaberichten Inkomende foto's, video's, spraakberichten, bestanden, stickers en locaties worden herkend, zodat de AI weet dat er media is verzonden (er wordt een korte notitie aan het gesprek toegevoegd). Uitgaande AI-antwoorden zijn in deze versie **tekst en afbeeldingen**. Lange antwoorden worden automatisch ingekort tot de limiet van 5.000 tekens van LINE. --- ## Sessiebeheer ### Verbindingsstatus controleren Je LINE-verbindingsstatus wordt weergegeven op de **LINE**-kaart op de **Kanalen**-pagina: | Status | Betekenis | |---|---| | **Verbonden** | Een LINE Official Account is gekoppeld aan dit account | | **Niet verbonden** | Geen verbinding ingesteld | De kaart controleert ook elke keer dat je de pagina Kanalen opent opnieuw de instelling **Chatmodus** van je account. Als je LINE-account is teruggeschakeld naar de Chatmodus (waardoor de bot geen berichten meer kan ontvangen of verzenden), verschijnt er een oranje waarschuwing op de kaart waarin je wordt gevraagd om terug te schakelen naar de **Botmodus** in de LINE Official Account Manager — controleer de schakelaars in Stap 5 daar opnieuw en de waarschuwing verdwijnt bij het volgende bezoek. ### Verbinding verbreken Open de **LINE**-kaart en klik op **Beheren**, klik vervolgens op **Verbinding verbreken** in het paneel dat wordt geopend en bevestig **LINE verwijderen?**. Dit verwijdert de verbinding aan onze kant. Om volledig te stoppen met het verzenden van events door LINE, schakel je ook **Webhook gebruiken** uit (of verwijder je de webhook-URL) in de LINE Developers Console. --- ## Beperkingen - **Eén Official Account per verbinding.** Verbind elk OA afzonderlijk; een OA kan slechts aan één account worden gekoppeld. - **Tekst + afbeelding verzenden.** De AI antwoordt met tekst en afbeeldingen; uitgebreide "Flex"/template/carrousel-berichten worden in deze versie niet verzonden. - **Regio.** LINE Official Accounts zijn niet beschikbaar in de EU; je hebt een OA nodig in een ondersteunde regio (bijv. Japan, Taiwan, Thailand, Indonesië). - **Antwoordtijd.** De gratis directe antwoorden van LINE hebben een kort tijdsvenster; berichten die later worden verzonden, worden automatisch afgeleverd als (quotum-tellende) push-berichten. --- ## Probleemoplossing ### Inloggegevens afgewezen bij het verbinden - Zorg ervoor dat je een **Messaging API**-kanaal hebt aangemaakt (niet "LINE Login"). - Vraag een nieuw **langdurig kanaaltoegangstoken** (long-lived channel access token) aan op het Messaging API-tabblad en plak de nieuwe waarde. - Controleer of je het **Channel secret** hebt gekopieerd van het tabblad Basisinstellingen (niet het Channel ID). ### Bot antwoordt niet - Controleer of **Webhooks** is ingeschakeld (**On**) in zowel de Developers Console als de OA Manager. - Controleer of de **Webhook URL** overeenkomt met degene die in de app wordt getoond. - Controleer of de **Antwoordmodus** (Response mode) is ingesteld op **Bot** (niet Chat) in de OA Manager. ### Klant ontvangt twee antwoorden - Schakel **Automatische antwoordberichten** en **Welkomstberichten** uit (**Off**) in de OA Manager — de ingebouwde automatische antwoorden van LINE worden tegelijk met de AI verstuurd. ### Berichten komen niet aan in de app - Controleer of de contactpersoon **je officiële account als vriend heeft toegevoegd** (LINE bezorgt alleen berichten van vrienden). - Controleer de webhook-URL opnieuw en of **Webhooks gebruiken** is ingeschakeld. --- ## Best practices - **Voltooi de instellingen in de OA Manager** (Bot-modus, Webhooks aan, Welkomst- + Automatisch antwoord uit) — de meeste installatieproblemen komen hier vandaan. - **Antwoord snel** om antwoorden binnen het gratis venster van LINE te houden en je push-quotum te sparen. - **Houd je toegangstoken veilig** — iedereen die erover beschikt, kan berichten versturen namens je officiële account. Vraag een nieuw token aan in de Developers Console als het uitlekt.