Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Zalo Official Account 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
Zalo Official Account (Vietnam): OA-Profil und Nachrichtenkontingent, Follower und Nutzer mit ihren Details und Labels, letzte Chats und Konversationen, Beratungsnachrichten mit Text oder einem Bild und die Artikel des OA. Nutzt ein eingefügtes OA-Access-Token, das etwa 25 Stunden gilt.
Frag einfach
Beispiel-Prompts für Zalo Official Account
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 → Zalo Official Account klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Zalo Official Account
Zalo Official Account (Vietnam): OA-Profil und Nachrichtenkontingent, Follower und Nutzer mit ihren Details und Labels, letzte Chats und Konversationen, Beratungsnachrichten mit Text oder einem Bild und die Artikel des OA. Nutzt ein eingefügtes OA-Access-Token, das etwa 25 Stunden gilt.
Einrichtung
Die Einrichtung dauert etwa 5 Minuten, und das Token muss jeden Tag erneuert werden (siehe unten). Du brauchst einen Zalo Official Account und einen OA-Admin, der Berechtigungen genehmigt.
- Leg unter https://developers.zalo.me eine App an oder öffne deine, verknüpfe sie mit deinem Official Account und beantrage unter Official Account > OA permissions die Berechtigungsgruppen, die der Connector nutzt: Verwaltung der OA-Informationen, Verwaltung der Nutzerinformationen, Verwaltung der Nutzernachrichten, Senden von Nachrichten und Benachrichtigungen über den OA sowie Artikelverwaltung. Ein OA-Admin genehmigt sie.
- Öffne Tools > API Explorer (https://developers.zalo.me/tools/explorer), wähle deine App, als Access-Token-Typ OA Access Token und den OA, erlaube die beantragten Berechtigungen und kopiere das access token.
- Füge es in
ZALO_OA_ACCESS_TOKENein. Es wird im Headeraccess_tokengesendet, den Zalo verlangt. - Installiere den Connector und rufe
zalo_oa_get_oa_infoauf, um es zu prüfen.
Das Token gilt etwa 25 Stunden. Zalo erneuert OA-Access-Tokens nur über seinen eigenen OAuth-v4-Flow, den AnythingMCP für diesen Connector nicht ausführen kann, deshalb wird das Token eingefügt. Wenn Aufrufe mit Fehler -216 oder -220 antworten, erzeuge im API Explorer ein neues Token und speichere es in den Connector-Einstellungen. Wenn du Tokens in deinem eigenen System erneuerst, kannst du jedes neue Token über die AnythingMCP-API in ZALO_OA_ACCESS_TOKEN schreiben.
Was er liest: das OA-Profil (Name, ID, Verifizierung, Follower, Servicepaket) und sein Nachrichtenkontingent; die Nutzer, die dem OA folgen oder mit ihm geschrieben haben, 50 pro Seite, mit Filtern nach Label, letzter Interaktion oder Follower-Status; Name, Alias, Follower-Status, Datum der letzten Interaktion, Labels, Notizen und geteilte Informationen eines Nutzers; die Labels des OA; die neuesten Nachrichten über alle Chats und die Nachrichten mit einem Nutzer, 10 pro Aufruf; und die Artikel und Videos des OA mit ihrem Inhalt.
Was er schreibt: Nutzerdetails (Alias, deine eigene Kunden-ID und geteilte Informationen) und Labels: Die KI versieht einen Nutzer mit einem Label und legt es an, wenn es fehlt, oder entfernt es wieder. zalo_oa_send_text sendet einen Beratungstext, optional mit einem Zitat der Nachricht des Nutzers, und zalo_oa_send_image eine Beratungsnachricht mit einem Bild. Beide erreichen einen echten Menschen, deshalb zeigt die KI den Text und wartet auf dein Ja.
Wann eine Beratungsnachricht gesendet werden kann: nur an einen Nutzer, der in den letzten 7 Tagen mit dem OA interagiert hat. Ab dem 1. Januar 2026 sind Beratungsnachrichten innerhalb von 48 Stunden nach der letzten Interaktion des Nutzers kostenlos und unbegrenzt; spätere verbrauchen das Kontingent des OA-Pakets oder werden berechnet. zalo_oa_get_user_quota sagt der KI, was an einen Nutzer noch gesendet werden kann. Fehler -230 oder -232 bedeutet, dass der Nutzer nicht kürzlich genug interagiert hat, -213, dass der Nutzer dem OA nicht folgt.
Bei der Installation deaktiviert: zalo_oa_delete_tag, das ein Label aus dem OA und von jedem Nutzer entfernt, der es hat, und sich nicht rückgängig machen lässt.
Formate: Jede Antwort hat error (0 = Erfolg) und message, mit den Nutzdaten in data; Fehler kommen mit HTTP 200 und einem negativen error. Nutzer-, OA- und Nachrichten-IDs sind lange Ziffernfolgen. In einer Nachricht ist src 1, wenn der Nutzer sie gesendet hat, und 0, wenn der OA sie gesendet hat. Nachrichtenzeiten sind Unix-Millisekunden, und user_last_interaction_date ist dd/MM/yyyy.
Limits: 4.000 Anfragen pro Minute und App, dazu ein Limit pro OA, das vom OA-Paket abhängt; Fehler -32 heißt, auf die nächste Minute warten. Die Nutzerliste reicht bis zu den ersten 10.000 Nutzern.
Häufige Fehler: -216 oder -220 bedeutet ein ungültiges oder abgelaufenes Token (füge ein neues ein), -223 eine Berechtigung, die der OA der App nicht gewährt hat, -224 eine Funktion, die das OA-Paket nicht enthält, -201 einen ungültigen Parameter und -211 ein aufgebrauchtes Kontingent.
Der Connector sendet keine Transaktions-, Werbe- oder ZNS-Vorlagennachrichten, keine Dateien oder Sticker und deckt keine Gruppenchats, Anrufe, Artikelerstellung oder den OA-Shop ab. Webhooks werden in den Einstellungen der Zalo-App konfiguriert.
Voraussetzungen: ZALO_OA_ACCESS_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 Zalo Official Account und trage die unter Voraussetzungen aufgelisteten Variablen ein.
Verfügbare Tools
| Tool | What it does |
|---|---|
zalo_oa_get_oa_info | Profile of the Official Account the token belongs to: OA id (oaid), name, description, alias, verification status, OA type, category… |
zalo_oa_get_quota | Message quota of the OA or the app: one row per quota asset with the product type (cs = consultation, transaction), the quota source… |
zalo_oa_get_user_quota | What the OA can still send to one user: the time of the user's last interaction with the OA (last_interaction, Unix milliseconds) and the… |
zalo_oa_list_users | Page through the users who interacted with the OA (followers and people who messaged it) |
zalo_oa_filter_users | Page through the OA's users with filters: by label (tag), by when they last interacted, or by whether they follow the OA |
zalo_oa_get_user | Details of one user: display name, alias, your own customer id (user_external_id), whether the user follows the OA, last interaction date… |
zalo_oa_update_user | Update what the OA stores about a user: the alias, your own customer id (user_external_id, unique per user) and the shared information… |
zalo_oa_list_tags | All labels (tags) defined in the OA, as a list of label names |
zalo_oa_tag_user | Put a label on a user |
zalo_oa_untag_user | Remove a label from one user |
zalo_oa_delete_tag | Delete a label from the OA, which also takes it off every user who has it |
zalo_oa_list_recent_chats | The latest messages across all of the OA's conversations, newest first: sender and recipient ids and names, direction (src 1 = from the… |
zalo_oa_get_conversation | Messages between the OA and one user, newest first, 10 at most per call: message_id (use it as quote_message_id to reply), direction… |
zalo_oa_send_text | Send a consultation (customer care) text message from the OA to a user, optionally as a reply quoting one of the user's messages |
zalo_oa_send_image | Send a consultation message with one image (JPG or PNG, at most 1 MB, best at 16:9) and an optional caption |
zalo_oa_list_articles | The OA's published content: articles (type normal) or videos (type video), with id, title, status, views, shares, creation and update… |
zalo_oa_get_article | One article with its title, author, cover, description, status, comment setting and body blocks (text, images, videos) |
Beispiel-Prompts
- „Welche Nutzer haben dem OA in den letzten 24 Stunden geschrieben, und was haben sie gefragt?“
- „Zeig meine Konversation mit diesem Nutzer und entwirf eine Antwort auf seine letzte Frage.“
- „Versieh alle, die diese Woche nach der Lieferung gefragt haben, mit dem Label delivery-question.“
- „Wie viel Kontingent für Beratungsnachrichten hat der OA noch?“
- „Liste die fünf meistgelesenen Artikel des OA.“
Nächste Schritte
War dieser Guide hilfreich?