# LINE Collega il tuo **LINE Official Account** in modo che le tue conversazioni LINE confluiscano nell'app e un Agente AI possa rispondere. Puoi connetterti incollando le credenziali della Messaging API di LINE (Channel secret + access token) e impostando un URL webhook: non è richiesta alcuna programmazione. --- ## Cos'è l'integrazione LINE? L'integrazione LINE collega un **LINE Official Account (OA)** di tua proprietà alla piattaforma utilizzando la Messaging API ufficiale di LINE, il sistema proprietario di LINE per inviare e ricevere messaggi automaticamente, invece di digitarli manualmente nell'app LINE. Le tue chat 1-a-1 con le persone che hanno aggiunto il tuo OA come amico diventano disponibili all'interno dell'app, e un Agente AI, le trasmissioni e una casella di posta condivisa funzioneranno su di esse. A differenza di Telegram o WhatsApp Web, questa è un'integrazione **ufficiale**: utilizza la Messaging API di LINE, quindi è stabile e conforme alle regole di LINE. Poiché LINE non dispone di un pulsante "connetti" con un clic per strumenti di terze parti, incollerai le credenziali del tuo OA una sola volta durante la configurazione. > **Disponibilità.** I LINE Official Account sono più comuni in Giappone, Taiwan, Thailandia e Indonesia e **non sono disponibili nell'UE**. Per utilizzare questo canale è necessario un LINE Official Account registrato in una regione supportata. --- ## Prima di iniziare Creerai (o utilizzerai) tre elementi nelle console di LINE. Si tratta di una configurazione una tantum di circa 5 minuti. 1. Un **LINE Official Account** (creato nel [LINE Official Account Manager](https://manager.line.biz)). Se non ne hai ancora uno, accedi con il tuo LINE Business ID e **crea un nuovo account**: dagli un nome e compila il breve modulo. 2. Un canale **Messaging API** per quell'OA. Il modo più semplice è abilitarlo dall'interno dell'OA Manager (vedi il Passaggio 1 di seguito): non è necessario creare il canale manualmente nella Developers Console. Quando richiesto, scegli un **provider** esistente o creane uno nuovo. 3. Da quel canale, tre valori che incollerai nell'app: - **Channel ID** (scheda Basic settings): facoltativo, solo informativo - **Channel secret** (scheda Basic settings) - **Channel access token**: un token a lunga durata che emetti nella scheda **Messaging API** Non sono richiesti documenti aziendali per un Official Account standard (non verificato): basta un LINE Business ID. La verifica (il badge blu) è facoltativa e offerta solo in alcune regioni. --- ## Configurazione di LINE ### Passaggio 1: Abilita la Messaging API per il tuo Official Account 1. Accedi al [LINE Official Account Manager](https://manager.line.biz) (o crea prima un nuovo Official Account). 2. Apri il tuo OA. 3. Fai clic su **Settings** (angolo in alto a destra). 4. Nel menu delle impostazioni, fai clic su **Messaging API**. 5. Lo stato inizierà come **Disabled**: fai clic per abilitarlo. 6. Scegli il **provider** per questo canale (l'azienda/sviluppatore che lo possiede). Se non ne hai ancora uno, **crea un nuovo provider**, quindi conferma. ### Passaggio 2: Ottieni le tue credenziali dalla Developers Console L'abilitazione della Messaging API crea un canale sotto il tuo provider nella [LINE Developers Console](https://developers.line.biz/console/). 1. Apri l'**account sviluppatore / provider**. 2. Fai clic sul canale **Messaging API**. 3. Apri la scheda **Basic settings** e copia il tuo **Channel ID** e **Channel secret**. 4. Apri la scheda **Messaging API**, emetti (o rigenera) un **Channel access token** a lunga durata e copialo. > Tieni questi valori a portata di mano: li incollerai nell'app tra poco. ### Passaggio 3: Connetti LINE nell'app 1. Nella barra laterale sinistra, fai clic su **Settings** vicino alla parte inferiore. 2. Nella barra laterale delle impostazioni, sotto **Channels**, fai clic su **Channels**. 3. Trova la scheda **LINE** e fai clic su **Connect**. 4. Facoltativamente, incolla il tuo **Channel ID** — solo a scopo informativo. 5. Incolla il tuo **Channel secret**. 6. Incolla il tuo **Channel access token**. 7. Fai clic su **Connect**. 8. L'app convalida le credenziali con LINE e mostra **"Connected to: \"**. Se le credenziali sono errate, riceverai un errore: riemetti il token di accesso nella LINE Developers Console e riprova. ### Passaggio 4: Imposta la Webhook URL in LINE Dopo la connessione, l'app mostra una sezione **Finish setup in LINE** con un **webhook URL**: copialo. (Un URL webhook è semplicemente un indirizzo web; incollarlo in LINE indica a LINE dove inviare automaticamente i nuovi messaggi.) Quindi, nella **LINE Developers Console** per il tuo canale Messaging API: 1. Apri la scheda **Messaging API**. 2. Incolla l'URL in **Webhook URL**. 3. Fai clic su **Update**. 4. Imposta **Use webhook** su **ON**. ### Passaggio 5: Correggi le impostazioni del Official Account Manager (Importante) Per impostazione predefinita, un LINE OA gestisce le chat e le *risposte automatiche* autonomamente, il che impedisce ai messaggi di raggiungere l'AI. Torna nel [LINE Official Account Manager](https://manager.line.biz), apri le impostazioni del tuo OA e imposta: | Impostazione | Valore richiesto | Perché | |---|---|---| | **Chat** | **On** | Attiva la chat in modo che la conversazione fluisca (ti consente di utilizzare il filtro chat). | | **Response mode** | **Bot** | Consente all'API (il tuo Agente AI) di gestire i messaggi. La modalità "Chat"-only li blocca. | | **Response hours / Auto-response messages** | **Off** | Disabilita le risposte automatiche di LINE in modo che l'AI gestisca le risposte (la causa n. 1 di "doppie risposte"). | | **Greeting messages** | **Off** | Impedisce al saluto automatico di LINE di competere con l'AI. | | **Webhooks** | **On** | In modo che LINE inoltri i messaggi all'app. | > Se l'app avvisa che il tuo account è in **Chat mode**, passa alla **Bot mode** qui: il bot non può ricevere o inviare messaggi finché non lo fai. ### Passaggio 6: Testa il bot 1. Da un telefono diverso (ad esempio la tua app LINE), aggiungi il tuo Official Account come amico e **inviagli un messaggio**. 2. Apri l'app e vai su **Chats**: il messaggio in arrivo appare nell'elenco delle conversazioni. 3. Se un Agente AI sta gestendo questo canale, vedrai che **risponderà automaticamente** al messaggio di prova. Una volta connesso con il webhook impostato e gli interruttori sopra corretti, il tuo account LINE apparirà come **Connected** nella pagina Channels e l'AI risponderà ai messaggi in arrivo. --- ## Costo LINE è un canale **gratuito** nell'app: non ci sono costi per messaggio né canoni di connessione mensili da parte nostra. Tieni presente che i **piani di LINE** hanno i propri limiti mensili sui messaggi *push* (invii proattivi), che variano in base alla regione e al tipo di account. Le risposte inviate poco dopo che un cliente ti ha scritto sono gratuite su LINE; gli invii proattivi/broadcast contano ai fini della quota del tuo piano LINE. --- ## Messaggi multimediali Foto, video, note vocali, file, adesivi e posizioni in arrivo vengono riconosciuti in modo che l'IA sappia che è stato inviato del materiale multimediale (una breve nota viene aggiunta alla conversazione). Le risposte dell'IA in uscita sono **testo e immagini** in questa versione. Le risposte lunghe vengono automaticamente troncate al limite di 5.000 caratteri di LINE. --- ## Gestione della sessione ### Verifica dello stato della connessione Lo stato della tua connessione LINE viene mostrato sulla scheda **LINE** nella pagina **Canali**: | Stato | Significato | |---|---| | **Connesso** | Un account ufficiale LINE è collegato a questo account | | **Non connesso** | Nessuna connessione configurata | La scheda ricontrolla anche l'impostazione **Modalità chat** del tuo account ogni volta che apri la pagina Canali. Se il tuo account LINE è stato riportato alla Modalità chat (che impedisce al bot di ricevere o inviare messaggi), sulla scheda apparirà un avviso color ambra che ti invita a ripristinare la **Modalità bot** nel LINE Official Account Manager: ricontrolla gli interruttori del Passaggio 5 in quella sezione e l'avviso scomparirà alla visita successiva. ### Disconnessione Apri la scheda **LINE** e fai clic su **Gestisci**, quindi fai clic su **Disconnetti** nel pannello che si apre e conferma **Rimuovere LINE?**. Questo rimuove la connessione dal nostro lato. Per interrompere completamente l'invio di eventi da parte di LINE, disattiva anche **Usa webhook** (o elimina l'URL del webhook) nella console per sviluppatori LINE. --- ## Limitazioni - **Un Official Account per connessione.** Collega ogni OA separatamente; un OA può essere collegato a un solo account. - **Invio di testo + immagini.** Il bot AI risponde con testo e immagini; i messaggi avanzati "Flex"/template/carousel non sono inviati in questa versione. - **Regione.** Gli Official Account di LINE non sono disponibili nell'UE; è necessario un OA in una regione supportata (ad es. Giappone, Taiwan, Thailandia, Indonesia). - **Tempistica di risposta.** Le risposte istantanee gratuite di LINE hanno una breve finestra temporale; i messaggi inviati successivamente vengono consegnati automaticamente come messaggi push (conteggiati nella quota). --- ## Risoluzione dei problemi ### Credenziali rifiutate durante la connessione - Assicurati di aver creato un canale **Messaging API** (non "LINE Login"). - Genera nuovamente un **token di accesso al canale a lunga durata** nella scheda Messaging API e incolla il nuovo valore. - Conferma di aver copiato il **Channel secret** dalla scheda Basic settings (non il Channel ID). ### Il bot non risponde - Conferma che **Webhooks** sia impostato su **On** sia nella Developers Console che nell'OA Manager. - Conferma che il **Webhook URL** corrisponda a quello mostrato nell'app. - Conferma che la **Modalità di risposta** sia impostata su **Bot** (non Chat) nell'OA Manager. ### Il cliente riceve due risposte - Disattiva (**Off**) i **Messaggi di risposta automatica** e i **Messaggi di benvenuto** nell'OA Manager: le risposte automatiche integrate di LINE vengono inviate insieme a quelle dell'IA. ### I messaggi non arrivano nell'app - Verifica che il contatto abbia **aggiunto il tuo Account Ufficiale come amico** (LINE consegna i messaggi solo dagli amici). - Ricontrolla l'URL del webhook e che l'opzione **Use webhook** sia attiva. --- ## Best practice - **Completa le impostazioni nell'OA Manager** (modalità Bot, Webhooks attivi, messaggi di benvenuto e risposta automatica disattivati): la maggior parte dei problemi di configurazione deriva da queste. - **Rispondi tempestivamente** per mantenere le risposte entro la finestra gratuita di LINE e conservare la tua quota di push. - **Mantieni il tuo token di accesso al sicuro**: chiunque lo possieda può inviare messaggi come il tuo Account Ufficiale. Generalo nuovamente nella Developers Console in caso di fuga di dati.