Come collegare Viber Bot a Gemini via MCP

💡 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 + Gemini

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.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

VIBER_AUTH_TOKEN

Step 1 — Ottieni le credenziali

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.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Viber Bot.

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."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot