Viber #

Collega il tuo bot Viber in modo che le tue conversazioni Viber confluiscano nell’app e un Agente IA possa rispondere. Puoi connetterti incollando un solo valore (il token di autenticazione del tuo bot) e noi ci occuperemo del resto della configurazione per te.

Cos’è l’integrazione Viber? #

L’integrazione Viber collega un bot Viber di tua proprietà alla piattaforma utilizzando l’API ufficiale per bot di Viber, il sistema proprietario di Viber per inviare e ricevere messaggi automaticamente, invece di doverli digitare a mano. Le conversazioni tra il tuo bot e le persone che lo seguono diventano disponibili all’interno dell’app, dove un Agente IA e una casella di posta condivisa possono gestirle.

Questa è un’integrazione ufficiale, quindi è stabile e conforme alle regole di Viber.

Disponibilità. Viber è utilizzato principalmente nelle Filippine, in Vietnam e in altre parti del Sud-est asiatico, oltre che in Europa dell’Est e in Grecia.

Prima di iniziare #

Hai bisogno di un tuo bot Viber e Viber rilascia bot solo con un piano aziendale a pagamento. Da febbraio 2024, Viber non crea più bot gratuiti. Configuri l’account direttamente con Viber, e tale account e i relativi costi rimangono una questione tra te e Viber. Noi non lo rivendiamo, non applichiamo ricarichi, non tratteniamo commissioni e non possiamo creare il bot per tuo conto.

Al momento della stesura di questo documento, Viber addebita un canone mensile per bot più un costo per messaggio per i messaggi avviati dal tuo bot (vedi Costi di seguito). Verifica le condizioni attuali di Viber al momento della registrazione, poiché i prezzi sono soggetti a modifiche da parte loro.

Non esiste un modulo di registrazione self-service. Viber esamina manualmente ogni richiesta di chatbot e puoi fare domanda in due modi:

• Tramite un partner Viber verificato, che è la strada consigliata da Viber e solitamente la più rapida.
• Direttamente con Viber, inviando un’email a partners@viber.com. Se lavori già con Viber, il tuo account manager aziendale può avviare la procedura al posto tuo.

Una volta approvata la richiesta, firmerai l’accordo di Viber e accetterai i loro termini commerciali, dopodiché il tuo bot verrà creato.

Dopodiché, troverai il suo token nell’app Viber sotto Altro → Impostazioni → Bot → Modifica informazioni → Chiave dell’app. Viber lo chiama chiave dell’app; la loro documentazione API chiama lo stesso valore token di autenticazione, e gli amministratori dei bot possono vederlo anche nel pannello di amministrazione di Viber. Indipendentemente da come sia etichettato, è l’unico valore richiesto da questa app.

Quel token è l’unica cosa di cui hai bisogno da Viber. La configurazione qui richiede circa un minuto.

Configurazione di Viber #

Passaggio 1: Copia il token di autenticazione del tuo bot #

Il posto più rapido per trovarlo è l’app Viber sul tuo telefono.

1. Apri Viber sul telefono il cui account possiede il bot.
2. Vai su Altro → Impostazioni → Bot.
3. Seleziona il tuo bot e tocca Modifica informazioni.
4. Copia il valore mostrato sotto Chiave dell’app. Quello è il token.

Mantieni questo token privato. Chiunque lo possieda può inviare messaggi come se fosse il tuo bot.

Passaggio 2: Connetti Viber nell’app #

1. Nella barra laterale sinistra, fai clic su Impostazioni vicino alla parte inferiore.
2. Nella barra laterale delle Impostazioni, sotto Canali, fai clic su Canali.
3. Trova la scheda Viber e fai clic su Connetti.
4. Incolla il tuo token di autenticazione.
5. Fai clic su Connetti.
6. L’app verifica il token con Viber e mostra “Connesso a: <nome del tuo bot>”.

Non c’è alcun webhook da configurare. A differenza della maggior parte degli altri canali, registriamo tutto con Viber per te come parte della connessione, quindi non c’è nulla da copiare in un’altra console. La schermata di connessione mostra l’indirizzo a cui arrivano i tuoi messaggi solo affinché tu possa condividerlo con l’assistenza, se necessario.

Passaggio 3: Testa il bot #

1. Da un altro telefono, apri Viber e segui il tuo bot (cercalo o usa il suo link).
2. Inviagli un messaggio.
3. Apri l’app e vai su Chat. Il messaggio in arrivo appare nell’elenco delle conversazioni.
4. Se un Agente AI sta gestendo questo canale, vedrai che risponderà automaticamente.

Una volta connesso, il tuo bot Viber viene visualizzato come Connesso nella pagina Canali e l’IA risponde ai messaggi in arrivo.

Chi può contattare il tuo bot #

Questa è la cosa più importante da capire su Viber, ed è diversa da ogni altro canale:

Il tuo bot può inviare messaggi solo alle persone che lo seguono. Qualcuno deve trovare il tuo bot e seguirlo prima che tu possa inviargli qualsiasi cosa. Non c’è modo di inviare messaggi a un utente Viber che non ha prima seguito il tuo bot.

Se qualcuno smette di seguire o blocca il tuo bot, non potrai inviargli nuovamente messaggi finché non lo seguirà e ti scriverà. Quando ciò accade, l’app contrassegna la conversazione in modo da interrompere i tentativi, e qualsiasi risposta inviata risulterà come non riuscita con una spiegazione, invece di scomparire silenziosamente.

Per questo motivo, Viber funziona molto bene come canale di supporto e risposta (qualcuno ti scrive, l’IA risponde) e male come canale di contatto a freddo.

Costo #

Viber è un canale gratuito nell’app: nessun costo per messaggio e nessuna tariffa di connessione mensile da parte nostra.

I tuoi costi derivano da Viber, sul tuo account personale:

• Una tariffa mensile per bot (circa 100 € al momento della stesura).
• Le risposte all’interno di una conversazione avviata da qualcuno sono gratuite e illimitate. Questo copre quasi tutto ciò che fa un Agente AI.
• I messaggi avviati dal tuo bot, al di fuori di una conversazione iniziata dalla persona, sono addebitati per messaggio a una tariffa che dipende dal paese del destinatario.

La conclusione pratica: rispondere alle persone non ti costa nulla oltre alla tariffa mensile. I broadcast e i follow-up proattivi sono ciò che fa aumentare i costi.

Messaggi multimediali #

Foto, video, file, adesivi, posizioni e contatti condivisi 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 AI in uscita sono testo e immagini in questa versione. Le risposte lunghe vengono automaticamente troncate al limite di 7.000 caratteri di Viber.

Gestione della sessione #

Verifica dello stato della connessione #

Lo stato della tua connessione Viber viene mostrato sulla scheda Viber nella pagina Canali:

La scheda ricontrolla il tuo bot ogni volta che apri la pagina Canali. Un bot Viber può inviare i suoi messaggi in un solo posto alla volta, quindi se colleghi lo stesso bot a un altro strumento, quello strumento prende il sopravvento e i tuoi messaggi smettono di arrivare qui, senza alcun avviso da parte di Viber. È questo che significa “Connesso, azione richiesta”. Apri la scheda e riconnettiti per riprenderne il controllo.

Disconnessione #

Apri la scheda Viber e fai clic su Gestisci, quindi fai clic su Disconnetti e conferma Rimuovere Viber?. Questo interrompe la ricezione dei messaggi del bot da parte nostra e lo rimuove dal tuo account. Il bot rimane di tua proprietà. Non cambia nulla sul tuo account Viber.

Limitazioni #

• Solo follower. Il tuo bot può inviare messaggi solo alle persone che lo seguono. Vedi A chi può inviare messaggi il tuo bot.
• Hai bisogno del tuo bot Viber a pagamento. Non possiamo fornirne uno noi.
• Un bot per connessione. Collega ogni bot separatamente; un bot può essere collegato a un solo account.
• Invio di testo + immagini. L’IA risponde con testo e immagini; in questa versione non vengono inviati caroselli e schede avanzate (rich cards).
• Nessun messaggio di benvenuto. Quando qualcuno apre il tuo bot per la prima volta ma non lo ha ancora seguito, Viber consente un singolo saluto istantaneo. Questa versione non ne invia uno. La conversazione inizia quando inviano il loro primo messaggio.

Risoluzione dei problemi #

Token rifiutato durante la connessione #

• Assicurati di aver copiato il valore da Edit Info → Your app key nell’app Viber, non un ID diverso.
• Verifica che il tuo bot sia ancora attivo sul tuo account Viber.
• La connessione verifica anche che Viber riesca a raggiungerci. Se il tuo token è sicuramente corretto e continua a fallire, attendi un minuto e riprova, quindi contatta l’assistenza.

“Questo bot Viber è già collegato a un altro account” #

Lo stesso bot è collegato a un account diverso nell’app. Disconnettilo prima da lì, oppure usa un bot diverso.

Il bot non risponde #

• Conferma che la scheda mostri Connesso, non Connesso, azione richiesta.
• Conferma che la persona con cui stai effettuando il test abbia seguito il tuo bot. Viber consegna i messaggi solo dai follower.
• Verifica che un Agente IA sia assegnato a questo canale.

I messaggi hanno smesso di arrivare #

Questo è quasi sempre il problema di sostituzione descritto in Verifica dello stato della connessione: lo stesso bot è stato collegato a un altro strumento. Apri la scheda Viber e riconnettiti.

Una risposta non è riuscita con “Non iscritto” #

La persona ha smesso di seguire o ha bloccato il tuo bot. Non puoi inviare loro messaggi finché non lo seguono di nuovo e ti inviano un messaggio per primi.

Best practice #

• Dai priorità all’assistenza, non all’outreach. Le risposte all’interno di una conversazione avviata da qualcuno sono gratuite e illimitate; i messaggi che avvii tu sono a pagamento e raggiungono solo i follower.
• Rendi il tuo bot facile da seguire. Inserisci il suo link sul tuo sito, nella tua firma email e negli altri tuoi canali. Seguirlo è l’unico modo in cui le persone possono raggiungerlo.
• Mantieni il tuo token di autenticazione al sicuro. Chiunque lo abbia può inviare messaggi come il tuo bot. Rigeneralo nell’app Viber se viene compromesso, quindi riconnettiti qui.
• Non collegare lo stesso bot a due strumenti. Il secondo prenderà silenziosamente il sopravvento.