# 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](https://manager.line.biz) -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](https://manager.line.biz) -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](https://developers.line.biz/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: \"**. 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](https://manager.line.biz) -palveluun, avaa OA-asetuksesi ja määritä seuraavat: | Asetus | Vaadittu arvo | Miksi | |---|---|---| | **Chat** | **On** | Ottaa chatin käyttöön, jotta keskustelu virtaa läpi (mahdollistaa chat-suodattimen käytön). | | **Response mode** | **Bot** | Antaa API:n (tekoälyagenttisi) käsitellä viestit. "Chat"-tila estää viestien kulun. | | **Response hours / Auto-response messages** | **Off** | Poistaa käytöstä LINE:n omat automaattiset vastaukset, jotta tekoäly hoitaa vastaukset (yleisin syy "tuplavastauksiin"). | | **Greeting messages** | **Off** | Estää LINE:n oman automaattisen tervehdysviestin kilpailemisen tekoälyn kanssa. | | **Webhooks** | **On** | Jotta LINE välittää viestit sovellukseen. | > 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: | Tila | Merkitys | |---|---| | **Yhdistetty** | LINE Official Account on linkitetty tähän tiliin | | **Ei yhdistetty** | Yhteyttä ei ole määritetty | 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.