# LINE

Conectați propriul **Cont Oficial LINE** astfel încât conversațiile LINE să fie direcționate către aplicație și un Agent AI să poată răspunde. Vă conectați lipind credențialele LINE Messaging API (Channel secret + access token) și setând un URL de webhook — nu este necesară programarea.

---

## Ce este integrarea LINE?

Integrarea LINE conectează un **Cont Oficial LINE (OA)** pe care îl dețineți la platformă folosind API-ul oficial de mesagerie LINE — propriul sistem LINE pentru trimiterea și primirea automată a mesajelor, în loc să le tastați manual în aplicația LINE. Chat-urile 1-la-1 cu persoanele care v-au adăugat OA ca prieten devin disponibile în interiorul aplicației, iar un Agent AI, difuzările și o căsuță de primire partajată funcționează deasupra acestora.

Spre deosebire de Telegram sau WhatsApp Web, aceasta este o integrare **oficială** — folosește propriul API de mesagerie LINE, deci este stabilă și respectă regulile LINE. Deoarece LINE nu are un buton de „conectare” cu un singur clic pentru instrumente terțe, vei lipi credențialele OA-ului tău o singură dată în timpul configurării.

> **Disponibilitate.** Conturile oficiale LINE sunt cele mai comune în Japonia, Taiwan, Thailanda și Indonezia și **nu sunt disponibile în UE**. Ai nevoie de un LINE Official Account înregistrat într-o regiune acceptată pentru a utiliza acest canal.

---

## Înainte de a începe

Vei crea (sau folosi) trei lucruri în consolele LINE. Aceasta este o configurare unică de aproximativ 5 minute.

1. Un **Cont Oficial LINE** (creat în [LINE Official Account Manager](https://manager.line.biz)). Dacă nu aveți unul încă, conectați-vă cu LINE Business ID-ul dvs. și **creați un cont nou** — dați-i un nume și completați formularul scurt.
2. Un **canal Messaging API** pentru acel OA. Cea mai simplă cale este să îl activați din interiorul OA Manager (consultați Pasul 1 de mai jos) — nu trebuie să creați canalul manual în Developers Console mai întâi. Când vi se solicită, alegeți un **furnizor** existent sau creați unul nou.
3. Din acel canal, trei valori pe care le veți lipi în aplicație:
   - **Channel ID** (fila Basic settings) — opțional, doar informativ
   - **Channel secret** (fila Basic settings)
   - **Channel access token** — un token cu durată lungă de viață pe care îl emiteți în fila **Messaging API**

Nu sunt necesare documente de afaceri pentru un cont oficial standard (neverificat) — doar un LINE Business ID. Verificarea (insigna albastră) este opțională și oferită doar în anumite regiuni.

---

## Configurarea LINE

### Pasul 1: Activează Messaging API pentru contul tău oficial

1. Conectați-vă la [LINE Official Account Manager](https://manager.line.biz) (sau creați mai întâi un Cont Oficial nou).
2. Deschideți OA-ul dvs.
3. Faceți clic pe **Settings** (colțul din dreapta sus).
4. În meniul de setări, faceți clic pe **Messaging API**.
5. Starea începe ca **Disabled** — faceți clic pentru a o activa.
6. Alegeți **furnizorul** pentru acest canal (compania/dezvoltatorul care îl deține). Dacă nu aveți unul încă, **creați un furnizor nou**, apoi confirmați.

### Pasul 2: Obține credențialele din Developers Console

Activarea Messaging API creează un canal sub furnizorul dvs. în [LINE Developers Console](https://developers.line.biz/console/).

1. Deschideți **contul de dezvoltator / furnizorul**.
2. Faceți clic pe **Messaging API channel**.
3. Deschideți fila **Basic settings** și copiați **Channel ID** și **Channel secret**.
4. Deschideți fila **Messaging API**, emiteți (sau regenerați) un **Channel access token** cu durată lungă de viață și copiați-l.

> Păstrați aceste valori la îndemână — le veți lipi în aplicație imediat.

### Pasul 3: Conectează LINE în aplicație

1. În bara laterală din stânga, faceți clic pe **Settings** (Setări) în partea de jos.
2. În meniul din stânga al paginii Settings, sub **Channels** (Canale), faceți clic pe **Channels**.
3. Găsiți cardul **LINE** și faceți clic pe **Connect** (Conectare).
4. Opțional, lipiți **Channel ID** (ID-ul canalului) — doar cu scop informativ.
5. Lipiți **Channel secret** (Secretul canalului).
6. Lipiți **Channel access token** (Tokenul de acces al canalului).
7. Faceți clic pe **Connect** (Conectare).
8. Aplicația validează acreditările cu LINE și afișează **"Connected to: \<numele OA dvs.\>"** (Conectat la: ...). Dacă acreditările sunt incorecte, veți primi o eroare — emiteți din nou tokenul de acces în LINE Developers Console și încercați din nou.


### Pasul 4: Setează URL-ul Webhook în LINE

După conectare, aplicația afișează o secțiune **Finish setup in LINE** cu un **webhook URL** — copiați-l. (Un URL de webhook este doar o adresă web; lipirea acestuia în LINE îi spune lui LINE unde să trimită automat mesaje noi.) Apoi, în **LINE Developers Console** pentru canalul dvs. Messaging API:

1. Deschideți fila **Messaging API**.
2. Lipiți URL-ul în **Webhook URL**.
3. Faceți clic pe **Update**.
4. Activați **Use webhook** (**ON**).

### Pasul 5: Corectează setările din Official Account Manager (Important)

În mod implicit, un LINE OA gestionează singur chat-urile și *răspunsurile automate*, ceea ce împiedică mesajele să ajungă la AI. Reveniți în [LINE Official Account Manager](https://manager.line.biz), deschideți setările OA și setați:

| Setare | Valoare necesară | De ce |
|---|---|---|
| **Chat** | **On** | Activează chat-ul astfel încât conversația să treacă prin el (vă permite să utilizați filtrul de chat). |
| **Response mode** | **Bot** | Permite API-ului (Agentului dvs. AI) să gestioneze mesajele. Modul "Chat"-only le blochează. |
| **Response hours / Auto-response messages** | **Off** | Dezactivează răspunsurile automate proprii LINE, astfel încât AI-ul să gestioneze răspunsurile (cauza nr. 1 a "răspunsurilor duble"). |
| **Greeting messages** | **Off** | Previne salutul automat propriu LINE să concureze cu AI-ul. |
| **Webhooks** | **On** | Astfel încât LINE să redirecționeze mesajele către aplicație. |

> Dacă aplicația vă avertizează că contul dvs. este în **Chat mode**, comutați-l la **Bot mode** aici — botul nu poate primi sau trimite mesaje până când nu faceți acest lucru.

### Pasul 6: Testează botul

1. De pe un alt telefon (de exemplu, propria aplicație LINE), adăugați Contul Oficial ca prieten și **trimiteți-i un mesaj**.
2. Deschideți aplicația și mergeți la **Chats** — mesajul primit apare în lista de conversații.
3. Dacă un Agent AI gestionează acest canal, veți vedea cum **răspunde automat** la mesajul de test.

Odată conectat cu webhook-ul setat și comutatoarele de mai sus corecte, contul dvs. LINE apare ca **Connected** pe pagina Channels, iar AI-ul răspunde la mesajele primite.

---

## Costuri

LINE este un canal **gratuit** în aplicație — nu există nicio taxă per mesaj și nicio taxă lunară de conectare din partea noastră. Rețineți că **planurile proprii LINE** au propriile limite lunare pentru mesajele *push* (trimiteri proactive), care variază în funcție de regiune și tipul de cont. Răspunsurile trimise la scurt timp după ce un client vă trimite un mesaj sunt gratuite pe LINE; trimiterile proactive/difuzările contează în cota planului dvs. LINE.

---

## Mesaje media

Fotografiile, videoclipurile, notele vocale, fișierele, stickerele și locațiile primite sunt recunoscute, astfel încât AI-ul să știe că a fost trimis conținut media (o scurtă notă este adăugată în conversație). Răspunsurile AI trimise sunt **text și imagini** în această versiune. Răspunsurile lungi sunt scurtate automat la limita de 5.000 de caractere a LINE.

---

## Gestionarea sesiunii

### Verificarea stării conexiunii

Starea conexiunii tale LINE este afișată pe cardul **LINE** de pe pagina **Canale**:

| Status | Semnificație |
|---|---|
| **Conectat** | Un cont oficial LINE este legat de acest cont |
| **Neconectat** | Nu este configurată nicio conexiune |

Cardul verifică, de asemenea, setarea **Mod chat** a contului tău de fiecare dată când deschizi pagina Canale. Dacă contul tău LINE a fost comutat înapoi în Mod chat (ceea ce împiedică botul să primească sau să trimită mesaje), pe card va apărea un avertisment de culoare chihlimbar care îți va solicita să îl comuți înapoi în **Mod bot** în LINE Official Account Manager — verifică din nou comutatoarele de la Pasul 5 de acolo, iar avertismentul va dispărea la următoarea vizită.

### Deconectarea

Deschideți cardul **LINE** și faceți clic pe **Gestionare**, apoi faceți clic pe **Deconectare** în panoul care se deschide și confirmați **Eliminați LINE?**. Aceasta elimină conexiunea din partea noastră. Pentru a opri complet LINE din a trimite evenimente, dezactivați și **Utilizare webhook** (sau ștergeți URL-ul webhook-ului) în Consola pentru dezvoltatori LINE.

---

## Limitări

- **Un singur cont oficial per conexiune.** Conectați fiecare OA separat; un OA poate fi legat la un singur cont.
- **Trimitere text + imagine.** AI-ul răspunde cu text și imagini; mesajele de tip "Flex"/șabloane/carusel nu sunt trimise în această versiune.
- **Regiune.** Conturile oficiale LINE nu sunt disponibile în UE; aveți nevoie de un OA într-o regiune acceptată (de ex. Japonia, Taiwan, Thailanda, Indonezia).
- **Timpul de răspuns.** Răspunsurile instantanee gratuite ale LINE au o fereastră de timp scurtă; mesajele trimise ulterior sunt livrate automat ca mesaje push (contorizate în cotă).

---

## Depanare

### Credențiale respinse la conectare

- Asigură-te că ai creat un canal **Messaging API** (nu „LINE Login”).
- Emite din nou un **token de acces de canal cu durată lungă de viață** în fila Messaging API și inserează noua valoare.
- Confirmă că ai copiat **Secretul canalului** din fila Setări de bază (nu ID-ul canalului).

### Botul nu răspunde

- Confirmă că **Webhooks** este activat (**On**) atât în Developers Console, cât și în OA Manager.
- Confirmă că **URL-ul Webhook** corespunde cu cel afișat în aplicație.
- Confirmă că **Modul de răspuns** este setat pe **Bot** (nu Chat) în OA Manager.

### Clientul primește două răspunsuri

- Dezactivează (**Off**) **Mesajele de răspuns automat** și **Mesajele de întâmpinare** în OA Manager — răspunsurile automate integrate ale LINE sunt trimise simultan cu cele ale AI-ului.

### Mesajele nu ajung în aplicație

- Verifică dacă persoana de contact **a adăugat Contul tău Oficial ca prieten** (LINE livrează mesaje doar de la prieteni).
- Verifică din nou URL-ul webhook și faptul că **Utilizare webhook** este activat.

---

## Cele mai bune practici

- **Finalizează comutatoarele din OA Manager** (modul Bot, Webhooks activate, Mesaje de întâmpinare + Răspuns automat dezactivate) — majoritatea problemelor de configurare provin de aici.
- **Răspunde prompt** pentru a menține răspunsurile în fereastra gratuită LINE și pentru a conserva cota de mesaje push.
- **Păstrează tokenul de acces în siguranță** — oricine îl are poate trimite mesaje în numele Contului tău Oficial. Emite-l din nou în Developers Console dacă acesta este compromis.