Your AI Connector Docs

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). 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 (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.

  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: <your OA name>”. 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, 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.