Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Viber Bot mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
Viber-Nachrichten von einem Viber-Bot über die Viber REST Bot API senden: Text mit Tastaturen, Bilder, Videos, Dateien, Links, Kontakte, Standorte, Sticker und Rich-Media-Karussells, Broadcasts an bis zu 300 Abonnenten, Abonnentendetails und Online-Status sowie der Webhook des Bots. Authentifizierungstoken des Bots.
Frag einfach
Beispiel-Prompts für Viber Bot
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Viber Bot klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Viber Bot
Viber-Nachrichten von einem Viber-Bot über die Viber REST Bot API senden: Text mit Tastaturen, Bilder, Videos, Dateien, Links, Kontakte, Standorte, Sticker und Rich-Media-Karussells, Broadcasts an bis zu 300 Abonnenten, Abonnentendetails und Online-Status sowie der Webhook des Bots. Authentifizierungstoken des Bots.
Einrichtung
Die Einrichtung dauert etwa 5 Minuten, sobald du einen Bot hast.
- Du brauchst einen bestehenden Viber-Bot. Seit dem 5. Februar 2024 legt Viber neue Bots nur noch zu kommerziellen Bedingungen an: Bewirb dich über Rakuten Viber oder einen seiner offiziellen Partner (siehe https://developers.viber.com/docs/api/rest-bot-api/). Ältere kostenlose Bots funktionieren weiter.
- Kopiere das Authentifizierungstoken des Bots (App Key): in der Viber-App als Admin des Bots unter More > Settings > Bots > Edit Info > Your app key oder im Viber Admin Panel.
- Füge es in
VIBER_AUTH_TOKENein, installiere den Connector und rufeviber_get_account_infoauf, um es zu prüfen. - Viber lässt einen Bot Nutzern erst schreiben, wenn ein Webhook gesetzt ist. Hat dein Bot noch keinen, setz einen mit
viber_set_webhook: Die URL muss Vibers Prüfung mit HTTP 200 beantworten und ein Zertifikat einer vertrauenswürdigen CA haben.
Der Connector sendet; er empfängt nicht. Viber liefert eingehende Nachrichten und Ereignisse nur an den Webhook des Bots, einen eigenen öffentlichen HTTPS-Endpunkt.
Wer Nachrichten empfangen kann: nur Nutzer, die den Bot abonniert haben. Ein Nutzer abonniert, indem er dem Bot schreibt oder auf Abonnieren tippt, und kann jederzeit wieder abbestellen. Es gibt keine API, die Abonnenten auflistet: Ihre User-IDs kommen am Webhook an, deshalb muss die ID, an die die KI sendet, von dort stammen. Senden an jemand anderen schlägt mit receiverNotSubscribed (6) oder receiverNotRegistered (5) fehl. Menschen per Telefonnummer anzuschreiben ist ein anderes, kostenpflichtiges Produkt (Viber Business Messages) und nicht Teil des Connectors.
Was er sendet: an einen Abonnenten Text mit bis zu 7.000 Zeichen (optional mit einer Tastatur aus Antwort-Buttons), Bilder, Videos, Dateien, Links, Kontaktkarten, Standorte, Sticker und Rich-Media-Karussells aus Karten mit Bildern und Buttons. Jeder Versand braucht die User-ID des Empfängers und einen Absendernamen mit höchstens 28 Zeichen. viber_broadcast_message sendet dieselbe Nachricht an bis zu 300 Abonnenten pro Aufruf, setzt den Namen oder die ID jedes Empfängers ein, wo der Text danach verlangt, und listet die Empfänger, die sie nicht bekommen haben.
Was er liest: das Bot-Konto mit Webhook, Ereignistypen und Anzahl der Abonnenten; Name, Land, Sprache, Gerät und Viber-Version eines Abonnenten (höchstens zweimal pro Nutzer in 12 Stunden); und den Online-Status von bis zu 100 Abonnenten. Er kann außerdem den Webhook setzen oder entfernen; das Entfernen schließt für Nutzer den Einzelchat mit dem Bot.
Bestätigung vor dem Senden: Jede Nachricht erreicht einen echten Menschen, und kommerzielle Bots zahlen für Nachrichten außerhalb einer Sitzung, die der Nutzer geöffnet hat. Die KI zeigt Text und Empfänger und wartet auf dein Ja.
Formate: Jede Antwort hat status (0 = ok) und status_message, und jeder andere Status kommt als Fehler zurück. Eine gesendete Nachricht liefert message_token. billing_status 0 bis 4 bedeutet nicht berechnet, 5 eine berechnete Nachricht außerhalb einer Sitzung. Zeiten sind Unix-Millisekunden.
Limits: Eine Anfrage muss unter 30 KB bleiben. Bilder sind JPEG, PNG oder statisches GIF bis 1 MB unter iOS (3 MB unter Android) mit der Dateiendung in der URL, Videos MP4 bis 26 MB und 180 Sekunden, Dateien bis 50 MB (ausführbare Dateien werden abgelehnt). Broadcasts erlauben 500 Anfragen in 10 Sekunden. freeMessagesExceeded (23) oder noBalance (24) heißt, die monatlichen Gratisnachrichten oder das Guthaben sind aufgebraucht.
Häufige Fehler (status): 2 ungültiges Token, 5 Empfänger nicht bei Viber, 6 Empfänger hat nicht abonniert, 7 Bot blockiert, 9 Bot gesperrt, 10 kein Webhook gesetzt, 11 Viber-Version des Empfängers zu alt, 12 zu viele Anfragen, 21 Land nicht unterstützt.
Der Connector empfängt und liest keine eingehenden Nachrichten, listet keine Abonnenten auf und sendet keine Nachrichten an Telefonnummern.
Voraussetzungen: VIBER_AUTH_TOKEN
Connector lokal installieren
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
Öffne http://localhost:3000/connectors/store, wähle Viber Bot und trage die unter Voraussetzungen aufgelisteten Variablen ein.
Verfügbare Tools
| Tool | What it does |
|---|---|
viber_get_account_info | Details of the bot account: id, name, uri, icon, category, country, the webhook URL and its event_types, and subscribers_count |
viber_get_user_details | Details of one subscribed user: name, avatar, country, language, primary device OS, device type, Viber and API version |
viber_get_online | Online status of up to 100 subscribed users. online_status: 0 online, 1 offline (with last_online in Unix ms), 2 hidden by the user, 3 try… |
viber_send_text | Send a text message (up to 7,000 characters) to one subscribed user, optionally with a keyboard of reply buttons |
viber_send_picture | Send a picture (JPEG, PNG or static GIF from a URL) with a caption to one subscribed user |
viber_send_video | Send an MP4 video (H.264, up to 26 MB and 180 seconds) from a URL to one subscribed user |
viber_send_file | Send a file (up to 50 MB, from a URL) to one subscribed user, e.g. a PDF invoice |
viber_send_url | Send a link (up to 2,000 characters) to one subscribed user; Viber shows a preview |
viber_send_contact | Send a contact card (name and phone number) to one subscribed user |
viber_send_location | Send a location pin (latitude and longitude) to one subscribed user |
viber_send_sticker | Send a Viber sticker by its numeric sticker id to one subscribed user |
viber_send_rich_media | Send a rich media message (a carousel of cards with images, text and buttons) to one subscribed user |
viber_broadcast_message | Send the same message to up to 300 subscribed users in one call |
viber_set_webhook | Set the bot's webhook, the HTTPS endpoint where Viber delivers incoming messages and events |
viber_remove_webhook | Remove the bot's webhook |
Beispiel-Prompts
- „Wie viele Abonnenten hat mein Viber-Bot, und welchen Webhook nutzt er?“
- „Schick dem Abonnenten 01234567890A== den Text: Deine Bestellung wurde versandt. Füge die Antwort-Buttons Ja und Nein hinzu.“
- „Schick unsere Öffnungszeiten am Wochenende als Broadcast an diese 120 Abonnenten-IDs und sag mir danach, bei welchen es fehlgeschlagen ist.“
- „Welche dieser 20 Abonnenten sind gerade online?“
- „Sende ein Karussell mit drei Produkten, jedes mit Bild, Preis und einem Kaufen-Button, der die Produktseite öffnet.“
Nächste Schritte
War dieser Guide hilfreich?