Viber Bot su MCP: messaggi, caroselli e broadcast da qualsiasi agente AI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Viber Bot, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Viber Bot

Invia messaggi Viber da un bot Viber tramite la Viber REST Bot API: testo con tastiere, immagini, video, file, link, contatti, posizioni, sticker e caroselli rich media, broadcast fino a 300 iscritti, dettagli e stato online degli iscritti, e il webhook del bot. Token di autenticazione del bot.

Setup

La configurazione richiede circa 5 minuti, una volta che hai un bot.

1. Ti serve un bot Viber esistente. Dal 5 febbraio 2024 Viber crea nuovi bot solo a condizioni commerciali: fai richiesta tramite Rakuten Viber o uno dei suoi partner ufficiali (vedi https://developers.viber.com/docs/api/rest-bot-api/). I vecchi bot gratuiti continuano a funzionare.
2. Copia il token di autenticazione del bot (app key): nell'app Viber, come admin del bot, in More > Settings > Bots > Edit Info > Your app key, oppure nel Viber Admin Panel.
3. Incollalo in VIBER_AUTH_TOKEN, installa il connettore ed esegui viber_get_account_info per verificarlo.
4. Viber consente a un bot di scrivere agli utenti solo dopo che è stato impostato un webhook. Se il tuo bot non ne ha ancora uno, impostalo con viber_set_webhook: l'URL deve rispondere alla verifica di Viber con HTTP 200 e avere un certificato di una CA attendibile.

Il connettore invia; non riceve. Viber consegna i messaggi e gli eventi in arrivo solo al webhook del bot, un endpoint HTTPS pubblico di tua proprietà.

Chi può ricevere messaggi: solo gli utenti iscritti al bot. Un utente si iscrive scrivendo al bot o toccando iscriviti, e può annullare l'iscrizione in qualsiasi momento. Non esiste un'API per elencare gli iscritti: i loro user id arrivano al webhook, quindi l'id a cui l'AI invia deve provenire da lì. L'invio a chiunque altro fallisce con receiverNotSubscribed (6) o receiverNotRegistered (5). Scrivere alle persone tramite numero di telefono è un prodotto diverso e a pagamento (Viber Business Messages) e non fa parte del connettore.

Cosa invia: a un singolo iscritto, testo fino a 7.000 caratteri (facoltativamente con una tastiera di pulsanti di risposta), immagini, video, file, link, schede contatto, posizioni, sticker e caroselli rich media di schede con immagini e pulsanti. Ogni invio richiede lo user id del destinatario e un nome mittente di massimo 28 caratteri. viber_broadcast_message invia lo stesso messaggio a fino a 300 iscritti per chiamata, inserisce il nome o l'id di ciascun destinatario dove il testo lo richiede, ed elenca i destinatari che non l'hanno ricevuto.

Cosa legge: l'account del bot con il suo webhook, i tipi di evento e il numero di iscritti; nome, paese, lingua, dispositivo e versione di Viber di un iscritto (al massimo due volte per utente in 12 ore); e lo stato online di fino a 100 iscritti. Può anche impostare o rimuovere il webhook; rimuoverlo chiude agli utenti la chat 1 a 1 del bot.

Conferma prima dell'invio: ogni messaggio raggiunge una persona reale, e i bot commerciali pagano i messaggi al di fuori di una sessione aperta dall'utente. L'AI mostra il testo e i destinatari e aspetta il tuo sì.

Formati: ogni risposta ha status (0 = ok) e status_message, e qualsiasi altro stato torna come errore. Un messaggio inviato restituisce message_token. billing_status da 0 a 4 significa non addebitato, 5 un messaggio addebitato al di fuori di una sessione. Gli orari sono millisecondi Unix.

Limiti: una richiesta deve restare sotto i 30 KB. Le immagini sono JPEG, PNG o GIF statiche fino a 1 MB su iOS (3 MB su Android) con l'estensione nell'URL, i video MP4 fino a 26 MB e 180 secondi, i file fino a 50 MB (gli eseguibili vengono rifiutati). I broadcast consentono 500 richieste in 10 secondi. freeMessagesExceeded (23) o noBalance (24) significa che i messaggi gratuiti mensili o il saldo sono esauriti.

Errori comuni (status): 2 token non valido, 5 destinatario non su Viber, 6 destinatario non iscritto, 7 bot bloccato, 9 bot sospeso, 10 nessun webhook impostato, 11 versione di Viber del destinatario troppo vecchia, 12 troppe richieste, 21 paese non supportato.

Il connettore non riceve né legge i messaggi in arrivo, non elenca gli iscritti e non invia messaggi a numeri di telefono.

Prerequisiti: VIBER_AUTH_TOKEN

Installazione locale del connettore

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Apri http://localhost:3000/connectors/store, scegli Viber Bot e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Quanti iscritti ha il mio bot Viber, e quale webhook usa?"
• "Invia all'iscritto 01234567890A== il testo: Il tuo ordine è stato spedito. Aggiungi i pulsanti di risposta Sì e No."
• "Invia in broadcast i nostri orari di apertura del weekend a questi 120 id di iscritti, poi dimmi quali invii sono falliti."
• "Quali di questi 20 iscritti sono online in questo momento?"
• "Invia un carosello di tre prodotti, ciascuno con un'immagine, un prezzo e un pulsante Acquista che apre la pagina del prodotto."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT