LINE #

Yhdistä oma LINE Official Account -tilisi, jotta LINE-keskustelusi virtaavat sovellukseen ja tekoälyagentti voi vastata niihin. Yhdistäminen tapahtuu liittämällä LINE Messaging API -tunnistetietosi (Channel secret + access token) ja asettamalla yksi webhook-URL-osoite – koodausta ei tarvita.

Mikä on LINE-integraatio? #

LINE-integraatio yhdistää omistamasi LINE Official Account (OA) -tilin alustaan käyttämällä LINE:n virallista Messaging API -rajapintaa. Se on LINE:n oma järjestelmä viestien automaattiseen lähettämiseen ja vastaanottamiseen, jolloin sinun ei tarvitse kirjoittaa niitä käsin LINE-sovelluksessa. 1-to-1-keskustelusi niiden henkilöiden kanssa, jotka ovat lisänneet OA-tilisi kaveriksi, tulevat saataville sovelluksessa, ja tekoälyagentti, joukkoviestit sekä jaettu postilaatikko toimivat niiden päällä.

Toisin kuin Telegram tai WhatsApp Web, tämä on virallinen integraatio – se käyttää LINE:n omaa Messaging API -rajapintaa, joten se on vakaa ja LINE:n sääntöjen mukainen. Koska LINE:ssa ei ole yhden napsautuksen “yhdistä”-painiketta kolmannen osapuolen työkaluille, liität OA-tilisi tunnistetiedot kerran käyttöönoton aikana.

Saatavuus. LINE Official Account -tilit ovat yleisimpiä Japanissa, Taiwanissa, Thaimaassa ja Indonesiassa, eivätkä ne ole saatavilla EU:ssa. Tarvitset tuetulla alueella rekisteröidyn LINE Official Account -tilin käyttääksesi tätä kanavaa.

Ennen kuin aloitat #

Luot (tai käytät) kolmea asiaa LINE:n omissa konsoleissa. Tämä on kertaluonteinen, noin 5 minuuttia kestävä käyttöönotto.

1. LINE Official Account (luotu LINE Official Account Manager -palvelussa). Jos sinulla ei vielä ole sellaista, kirjaudu sisään LINE Business ID -tunnuksillasi ja luo uusi tili – anna sille nimi ja täytä lyhyt lomake.
2. Messaging API -kanava kyseiselle OA-tilille. Helpoin tapa on ottaa se käyttöön OA Managerin sisällä (katso vaihe 1 alla) – sinun ei tarvitse luoda kanavaa käsin Developers Consolessa ensin. Kun järjestelmä pyytää, valitse olemassa oleva palveluntarjoaja (provider) tai luo uusi.
3. Kyseisestä kanavasta tarvitset kolme arvoa, jotka liität sovellukseen:
   • Channel ID (Basic settings -välilehti) – valinnainen, vain tiedoksi
   • Channel secret (Basic settings -välilehti)
   • Channel access token – pitkäikäinen tunniste, jonka luot Messaging API -välilehdellä

Tavallinen (vahvistamaton) Official Account ei vaadi yritysasiakirjoja – vain LINE Business ID:n. Vahvistus (sininen merkki) on vapaaehtoinen ja sitä tarjotaan vain tietyillä alueilla.

LINE-palvelun käyttöönotto #

Vaihe 1: Ota Messaging API käyttöön virallisella tililläsi #

1. Kirjaudu sisään LINE Official Account Manager -palveluun (tai luo ensin uusi Official Account).
2. Avaa OA-tilisi.
3. Napsauta Settings (oikea yläkulma).
4. Napsauta asetusvalikosta Messaging API.
5. Tila on aluksi Disabled – napsauta ottaaksesi sen käyttöön.
6. Valitse kanavalle palveluntarjoaja (yritys/kehittäjä, joka omistaa sen). Jos sinulla ei vielä ole sellaista, luo uusi palveluntarjoaja ja vahvista valinta.

Vaihe 2: Hae tunnistetiedot Developers Consolesta #

Messaging API -rajapinnan käyttöönotto luo kanavan palveluntarjoajasi alle LINE Developers Console -palveluun.

1. Avaa kehittäjätili / palveluntarjoaja.
2. Napsauta Messaging API -kanavaa.
3. Avaa Basic settings -välilehti ja kopioi Channel ID ja Channel secret.
4. Avaa Messaging API -välilehti, luo (tai luo uudelleen) pitkäikäinen Channel access token ja kopioi se.

Pidä nämä arvot saatavilla – liität ne sovellukseen seuraavaksi.

Vaihe 3: Yhdistä LINE sovelluksessa #

1. Napsauta vasemmassa sivupalkissa alareunan lähellä olevaa Settings-kohtaa.
2. Napsauta Asetukset-sivupalkin Channels-kohdasta Channels.
3. Etsi LINE-kortti ja napsauta Connect.
4. Voit halutessasi liittää Channel ID -tunnuksesi — se on vain tiedoksi.
5. Liitä Channel secret.
6. Liitä Channel access token.
7. Napsauta Connect.
8. Sovellus vahvistaa tunnistetiedot LINE-palvelun kanssa ja näyttää tekstin “Connected to: <your OA name>”. Jos tunnistetiedot ovat väärät, saat virheilmoituksen — luo uusi pääsytunnus (access token) LINE Developers -konsolissa ja yritä uudelleen.

Vaihe 4: Aseta Webhook URL LINEssa #

Yhdistämisen jälkeen sovellus näyttää Finish setup in LINE -osion, jossa on webhook URL – kopioi se. (Webhook URL on vain verkko-osoite; sen liittäminen LINE-palveluun kertoo LINE:lle, minne uudet viestit lähetetään automaattisesti.) Siirry sitten Messaging API -kanavasi LINE Developers Console -näkymään:

1. Avaa Messaging API -välilehti.
2. Liitä URL-osoite kohtaan Webhook URL.
3. Napsauta Update.
4. Kytke Use webhook -asetus ON-asentoon.

Vaihe 5: Korjaa Official Account Managerin asetukset (tärkeää) #

Oletusarvoisesti LINE OA käsittelee keskustelut ja automaattiset vastaukset itse, mikä estää viestien saapumisen tekoälylle. Palaa LINE Official Account Manager -palveluun, avaa OA-asetuksesi ja määritä seuraavat:

Jos sovellus varoittaa, että tilisi on Chat-tilassa, vaihda se Bot-tilaan tässä – botti ei voi vastaanottaa tai lähettää viestejä ennen kuin teet tämän.

Vaihe 6: Testaa bottia #

1. Lisää Official Account -tilisi kaveriksi toisesta puhelimesta (esim. omasta LINE-sovelluksestasi) ja lähetä sille viesti.
2. Avaa sovellus ja siirry kohtaan Chats – saapuva viesti näkyy keskusteluluettelossa.
3. Jos tekoälyagentti käsittelee tätä kanavaa, näet sen vastaavan automaattisesti testiviestiin.

Kun yhteys on muodostettu, webhook asetettu ja yllä olevat valitsimet oikein, LINE-tilisi näkyy Connected-tilassa Channels-sivulla ja tekoäly vastaa saapuviin viesteihin.

Kustannukset #

LINE on ilmainen kanava sovelluksessa – me emme veloita viestikohtaista maksua emmekä kuukausittaista yhteysmaksua. Huomaa, että LINE:n omilla suunnitelmilla on omat kuukausittaiset rajoituksensa push-viesteille (aktiiviset lähetykset), jotka vaihtelevat alueittain ja tilityypin mukaan. Vastaukset, jotka lähetetään pian sen jälkeen, kun asiakas on lähettänyt sinulle viestin, ovat LINE:ssa ilmaisia; aktiiviset lähetykset/joukkoviestit kuluttavat LINE-suunnitelmasi kiintiötä.

Mediatiedostot #

Saapuvat valokuvat, videot, ääniviestit, tiedostot, tarrat ja sijainnit tunnistetaan, jotta tekoäly tietää median lähetyksestä (keskusteluun lisätään lyhyt huomautus). Lähtevät tekoälyvastaukset ovat tässä versiossa tekstiä ja kuvia. Pitkät vastaukset lyhennetään automaattisesti LINE:n 5 000 merkin rajaan.

Istuntojen hallinta #

Yhteyden tilan tarkistaminen #

LINE-yhteytesi tila näkyy Kanavat-sivun LINE-kortissa:

Kortti tarkistaa myös tilisi Chat-tila-asetuksen joka kerta, kun avaat Kanavat-sivun. Jos LINE-tilisi on vaihdettu takaisin Chat-tilaan (mikä estää bottia vastaanottamasta tai lähettämästä viestejä), korttiin ilmestyy keltainen varoitus, joka kehottaa vaihtamaan sen takaisin Bottitilaan LINE Official Account Managerissa – tarkista vaiheen 5 valitsimet siellä, niin varoitus poistuu seuraavalla käynnillä.

Yhteyden katkaiseminen #

Avaa LINE-kortti ja napsauta Hallitse, napsauta sitten avautuvassa paneelissa Katkaise yhteys ja vahvista Poistetaanko LINE?. Tämä poistaa yhteyden meidän puoleltamme. Jotta LINE lopettaa tapahtumien lähettämisen kokonaan, kytke myös Käytä webhookia pois päältä (tai poista webhook-URL) LINE Developers Consolessa.

Rajoitukset #

• Yksi Official Account per yhteys. Yhdistä jokainen OA erikseen; yksi OA voidaan linkittää vain yhdelle tilille.
• Tekstin ja kuvien lähetys. Tekoäly vastaa tekstillä ja kuvilla; monipuolisia “Flex”-/malli-/karuselliviestejä ei lähetetä tässä versiossa.
• Alue. LINE Official Account -tilit eivät ole saatavilla EU:ssa; tarvitset OA-tilin tuetulla alueella (esim. Japani, Taiwan, Thaimaa, Indonesia).
• Vastausaika. LINE:n ilmaisilla välittömillä vastauksilla on lyhyt aikaikkuna; myöhemmin lähetetyt viestit toimitetaan automaattisesti (kiintiöön laskettavina) push-viesteinä.

Vianmääritys #

Tunnistetiedot hylättiin yhdistettäessä #

• Varmista, että loit Messaging API -kanavan (etkä “LINE Login” -kanavaa).
• Luo uusi pitkäikäinen kanavan pääsytunniste (long-lived channel access token) Messaging API -välilehdellä ja liitä uusi arvo.
• Varmista, että kopioit Channel secret -avaimen Basic settings -välilehdeltä (etkä Channel ID -tunnusta).

Botti ei vastaa #

• Varmista, että Webhooks on päällä sekä Developers Consolessa että OA Managerissa.
• Varmista, että Webhook URL vastaa sovelluksessa näkyvää osoitetta.
• Varmista, että Response mode on Bot (ei Chat) OA Managerissa.

Asiakas saa kaksi vastausta #

• Kytke Auto-response messages ja Greeting messages pois päältä OA Managerissa — LINEn sisäänrakennetut automaattivastaukset lähetetään tekoälyn vastausten ohella.

Viestit eivät saavu sovellukseen #

• Varmista, että yhteyshenkilö on lisännyt virallisen tilisi kaveriksi (LINE toimittaa viestejä vain kavereilta).
• Tarkista webhook-URL uudelleen ja varmista, että Use webhook on päällä.

Parhaat käytännöt #

• Viimeistele OA Managerin asetukset (Bot-tila, Webhooks päällä, Greeting + Auto-reply pois päältä) — useimmat asennusongelmat johtuvat näistä.
• Vastaa viipymättä, jotta vastaukset pysyvät LINEn ilmaisessa ikkunassa ja säästät push-kiintiötäsi.
• Pidä pääsytunnisteesi turvassa — kuka tahansa, jolla se on, voi lähettää viestejä virallisen tilisi nimissä. Luo se uudelleen Developers Consolessa, jos se vuotaa.