Viber Bot über MCP mit Meta Muse 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 + Meta Muse

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

Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.

1. Öffne in Muse Settings → Connectors und wähle Add custom connector.
2. Füge die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
3. Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
4. Bitte Muse im Chat um etwas, wofür es die Viber Bot-Tools braucht.

Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.

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

Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.

Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Microsoft Copilot verbinden