# Viber Conectează propriul tău **bot Viber** astfel încât conversațiile tale de pe Viber să ajungă în aplicație și un Agent AI să poată răspunde. Te conectezi lipind o singură valoare (tokenul de autentificare al botului tău), iar noi ne ocupăm de restul configurării pentru tine. --- ## Ce este integrarea Viber? Integrarea Viber conectează un **bot Viber** pe care îl deții la platformă folosind API-ul oficial pentru boți al Viber, sistemul propriu Viber pentru trimiterea și primirea automată a mesajelor, în loc să le scrii manual. Conversațiile dintre botul tău și persoanele care îl urmăresc devin disponibile în interiorul aplicației, iar un Agent AI și o căsuță de primire partajată funcționează pe baza acestora. Aceasta este o integrare **oficială**, deci este stabilă și respectă regulile Viber. > **Disponibilitate.** Viber este utilizat cel mai pe scară largă în Filipine, Vietnam și alte părți din Asia de Sud-Est, precum și în Europa de Est și Grecia. --- ## Înainte de a începe **Ai nevoie de propriul tău bot Viber, iar Viber emite boți doar în cadrul unui plan de afaceri plătit.** Începând cu februarie 2024, Viber nu mai creează boți gratuiți. Configurezi contul direct cu Viber, iar acel cont și taxele aferente rămân între tine și Viber. Noi nu îl revindem, nu adăugăm comisioane și nu oprim o parte din sumă, și nici nu putem crea botul în numele tău. La momentul redactării acestui document, Viber percepe o taxă lunară per bot plus o taxă per mesaj pentru mesajele inițiate de botul tău (vezi [Costuri](#cost) mai jos). Verifică termenii actuali ai Viber atunci când te înregistrezi, deoarece prețurile pot fi modificate de aceștia. Nu există un formular de înregistrare self-service. Viber analizează manual fiecare cerere de chatbot, iar tu poți aplica în două moduri: - **Prin intermediul unui partener Viber verificat**, care este calea recomandată de Viber și, de obicei, cea mai rapidă. - **Direct prin Viber**, trimițând un e-mail la `partners@viber.com`. Dacă lucrezi deja cu Viber, managerul contului tău de afaceri poate iniția acest proces în schimb. Odată ce cererea ta este aprobată, semnezi acordul Viber și accepți termenii lor comerciali, iar botul tău este creat. După aceea, vei găsi token-ul în aplicația Viber la **Mai multe → Setări → Boți → Editează informații → Cheia aplicației tale**. Viber o numește *cheia aplicației* (*app key*); documentația API-ului lor numește aceeași valoare *token de autentificare*, iar administratorii boților o pot vedea și în panoul de administrare Viber. Indiferent de cum este etichetată, aceasta este singura valoare pe care o solicită această aplicație. Acest token este singurul lucru de care ai nevoie de la Viber. Configurarea aici durează aproximativ un minut. --- ## Configurarea Viber ### Pasul 1: Copiază tokenul de autentificare al botului tău Cel mai rapid loc în care o poți găsi este aplicația Viber de pe telefonul tău. 1. Deschide Viber pe telefonul al cărui cont deține botul. 2. Mergi la **Mai multe → Setări → Boți**. 3. Selectează botul tău și atinge **Editează informațiile**. 4. Copiază valoarea afișată sub **Cheia aplicației tale**. Acesta este tokenul. > Păstrează acest token privat. Oricine îl are poate trimite mesaje în numele botului tău. ### Pasul 2: Conectează Viber în aplicație 1. În bara laterală din stânga, dă clic pe **Settings** (Setări) aproape de partea de jos. 2. În meniul din stânga al paginii Settings, sub **Channels** (Canale), dă clic pe **Channels**. 3. Găsește cardul **Viber** și dă clic pe **Connect** (Conectare). 4. Introdu **token-ul de autentificare** (auth token). 5. Dă clic pe **Connect**. 6. Aplicația verifică token-ul cu Viber și afișează **"Connected to: \"**. **Nu există niciun webhook de configurat.** Spre deosebire de majoritatea celorlalte canale, noi înregistrăm totul la Viber pentru tine ca parte a procesului de conectare, așa că nu trebuie să copiezi nimic în altă consolă. Ecranul de conectare afișează adresa la care sosesc mesajele tale doar pentru a o putea partaja cu echipa de asistență dacă vei avea nevoie vreodată. ### Pasul 3: Testează botul 1. De pe un alt telefon, deschide Viber și **urmărește botul tău** (caută-l sau folosește link-ul acestuia). 2. **Trimite-i un mesaj.** 3. Deschide aplicația și mergi la **Chats** (Conversații). Mesajul primit apare în lista de conversații. 4. Dacă un Agent AI gestionează acest canal, vei vedea cum **răspunde automat**. Odată conectat, botul tău Viber apare ca **Connected** (Conectat) pe pagina Channels, iar AI-ul răspunde la mesajele primite. --- ## Cui îi poate trimite mesaje botul tău Acesta este cel mai important aspect de înțeles despre Viber și este diferit față de orice alt canal: **Botul tău poate trimite mesaje doar persoanelor care îl urmăresc.** Cineva trebuie să găsească botul tău și să îl urmărească înainte ca tu să îi poți trimite ceva. Nu există nicio modalitate de a trimite mesaje unui utilizator Viber care nu a urmărit botul tău mai întâi. Dacă cineva nu mai urmărește sau blochează botul tău, nu îi mai poți trimite mesaje până când nu îl urmărește din nou și îți trimite un mesaj. Când se întâmplă acest lucru, aplicația marchează conversația pentru a nu mai încerca, iar orice răspuns pe care îl trimiți apare ca eșuat, cu o explicație, în loc să dispară silențios. Din acest motiv, Viber funcționează foarte bine ca **canal de asistență și răspuns** (cineva îți trimite un mesaj, AI-ul răspunde) și slab ca un canal de contactare inițială (cold-outreach). --- ## Costuri Viber este un canal **gratuit** în aplicație: fără taxă per mesaj și fără taxă lunară de conectare din partea noastră. Costurile tale provin de la **Viber**, pe contul tău propriu: - O **taxă lunară per bot** (aproximativ 100 € la momentul redactării). - **Răspunsurile în cadrul unei conversații inițiate de cineva sunt gratuite și nelimitate.** Aceasta acoperă aproape tot ceea ce face un Agent AI. - **Mesajele inițiate de botul tău**, în afara unei conversații începute de persoana respectivă, sunt taxate per mesaj la o rată care depinde de țara destinatarului. Concluzia practică: răspunsul către oameni nu te costă nimic în afară de taxa lunară. Difuzările și contactările proactive sunt cele care adună costuri. --- ## Mesaje media Fotografiile, videoclipurile, fișierele, stickerele, locațiile și contactele partajate 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 de ieșire sunt **text și imagini** în această versiune. Răspunsurile lungi sunt tăiate automat la limita de 7.000 de caractere a Viber. --- ## Gestionarea sesiunii ### Verificarea stării conexiunii Starea conexiunii tale Viber este afișată pe cardul **Viber** de pe pagina **Channels**: | Status | Semnificație | |---|---| | **Conectat** | Un bot Viber este legat de acest cont | | **Conectat, este necesară o acțiune** | Altceva a preluat controlul botului tău; mesajele nu ajung la noi | | **Neconectat** | Nu este configurată nicio conexiune | Cardul verifică din nou botul de fiecare dată când deschizi pagina Canale. **Un bot Viber poate trimite mesaje într-un singur loc la un moment dat**, așa că, dacă conectezi același bot la un alt instrument, acel instrument preia controlul și mesajele tale nu mai ajung aici, fără nicio avertizare din partea Viber. Aceasta este semnificația stării **"Conectat, este necesară o acțiune"**. Deschide cardul și reconectează-te pentru a prelua controlul înapoi. ### Deconectarea Deschide cardul **Viber** și dă clic pe **Gestionare**, apoi dă clic pe **Deconectare** și confirmă **Eliminare Viber?**. Acest lucru oprește primirea mesajelor botului de către noi și îl elimină din contul tău. Botul tău rămâne al tău. Nimic nu se schimbă în contul tău Viber. --- ## Limitări - **Doar urmăritori.** Botul tău poate trimite mesaje doar persoanelor care îl urmăresc. Vezi [Cui poate trimite mesaje botul tău](#who-your-bot-can-message). - **Ai nevoie de propriul tău bot Viber plătit.** Noi nu putem furniza unul. - **Un bot per conexiune.** Conectează fiecare bot separat; un bot poate fi legat doar la un singur cont. - **Trimitere text + imagine.** AI-ul răspunde cu text și imagini; caruselurile și cardurile complexe (rich cards) nu sunt trimise în această versiune. - **Fără mesaj de bun venit.** Când cineva deschide botul tău pentru prima dată, dar nu l-a urmărit încă, Viber permite un singur salut instantaneu. Această versiune nu trimite unul. Conversația începe când aceștia trimit primul lor mesaj. --- ## Depanare ### Token respins la conectare - Asigură-te că ai copiat valoarea din **Edit Info → Your app key** în aplicația Viber, nu un alt ID. - Verifică dacă botul tău este încă activ în contul tău Viber. - Conectarea verifică, de asemenea, dacă Viber ne poate contacta. Dacă tokenul tău este cu siguranță corect și tot eșuează, așteaptă un minut și încearcă din nou, apoi contactează asistența. ### "Acest bot Viber este deja conectat la un alt cont" Același bot este legat la un cont diferit în aplicație. Deconectează-l mai întâi de acolo sau folosește un bot diferit. ### Botul nu răspunde - Confirmă că pe card apare **Conectat**, nu **Conectat, este necesară o acțiune**. - Confirmă că persoana cu care testezi **a urmărit botul tău**. Viber livrează mesaje doar de la urmăritori. - Verifică dacă un Agent AI este alocat acestui canal. ### Mesajele au încetat să mai ajungă Aceasta este aproape întotdeauna problema preluării controlului descrisă la [Verificarea stării conexiunii](#checking-connection-status): același bot a fost conectat la un alt instrument. Deschide cardul **Viber** și reconectează-te. ### Un răspuns a eșuat cu eroarea "Not Subscribed" Persoana respectivă a încetat să mai urmărească sau a blocat botul tău. Nu îi poți trimite mesaje până când nu îl urmărește din nou și nu îți trimite un mesaj mai întâi. --- ## Cele mai bune practici - **Prioritizează asistența, nu inițierea contactului.** Răspunsurile în cadrul unei conversații începute de cineva sunt gratuite și nelimitate; mesajele pe care le inițiezi tu sunt taxate și ajung doar la urmăritori. - **Fă botul ușor de urmărit.** Pune linkul acestuia pe site-ul tău, în semnătura de e-mail și pe celelalte canale ale tale. Urmărirea este singura cale prin care oamenii pot ajunge la el. - **Păstrează tokenul de autentificare în siguranță.** Oricine îl are poate trimite mesaje în numele botului tău. Regenerează-l în aplicația Viber dacă a fost compromis, apoi reconectează-te aici. - **Nu conecta același bot la două instrumente.** Al doilea va prelua controlul în mod silențios.