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

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: <your OA name>”. 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, apri le impostazioni del tuo OA e imposta:

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:

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.