Viber Bot über MCP mit ChatGPT verbinden

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

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.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

VIBER_AUTH_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten, sobald du einen Bot hast.

1. 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.
2. 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.
3. Füge es in VIBER_AUTH_TOKEN ein, installiere den Connector und rufe viber_get_account_info auf, um es zu prüfen.
4. 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.

Schritt 2 — Adapter 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

Schritt 3 — Connector in ChatGPT hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

ChatGPT fügt MCP-Server als Plugins auf seiner Seite Plugins hinzu, im Web und in den kostenpflichtigen Tarifen. Den Entwicklermodus brauchst du dafür nicht mehr. In einem Business-Workspace dürfen das nur Admins und Owner; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.

1. Geh zu chatgpt.com/plugins, klicke auf Add und dann auf Add custom MCP server.
2. Gib einen Namen ein, z. B. Name: Viber Bot.
3. Trag unter Connection als Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein und lass Authentication auf OAuth.
4. Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an und erlaubst den Zugriff.
5. Installiere das neue Plugin unter deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.

Verfügbare Tools

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

FAQ

Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; den Free-Tarif führt OpenAI nicht auf.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden