Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Zalo Official Account con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
AnythingMCP è nella directory dei connettori di Claude: aggiungilo a Claude con un clic (si apre in una nuova scheda), poi accedi e scegli quali server MCP può usare Claude.
In breve
Zalo Official Account (Vietnam): profilo dell'OA e quota di messaggi, follower e utenti con dettagli ed etichette, chat e conversazioni recenti, messaggi di consulenza con testo o un'immagine, e gli articoli dell'OA. Usa un token di accesso dell'OA incollato, valido circa 25 ore.
Prova a chiedere
Prompt di esempio per Zalo Official Account
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Zalo Official Account, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Zalo Official Account + Claude
Zalo Official Account (Vietnam): profilo dell'OA e quota di messaggi, follower e utenti con dettagli ed etichette, chat e conversazioni recenti, messaggi di consulenza con testo o un'immagine, e gli articoli dell'OA. Usa un token di accesso dell'OA incollato, valido circa 25 ore.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
ZALO_OA_ACCESS_TOKEN
Step 1 — Ottieni le credenziali
La configurazione richiede circa 5 minuti, e il token va rinnovato ogni giorno (vedi sotto). Ti servono uno Zalo Official Account e un admin dell'OA che approvi i permessi.
- Su https://developers.zalo.me crea un'app o apri la tua, collegala al tuo Official Account e, in Official Account > OA permissions, richiedi i gruppi di permessi usati dal connettore: gestione delle informazioni dell'OA, gestione delle informazioni degli utenti, gestione dei messaggi degli utenti, invio di messaggi e notifiche tramite l'OA, e gestione degli articoli. Un admin dell'OA li approva.
- Apri Tools > API Explorer (https://developers.zalo.me/tools/explorer), scegli la tua app, seleziona il tipo di token di accesso OA Access Token, scegli l'OA, consenti i permessi richiesti e copia l'access token.
- Incollalo in
ZALO_OA_ACCESS_TOKEN. Viene inviato nell'headeraccess_tokenrichiesto da Zalo. - Installa il connettore ed esegui
zalo_oa_get_oa_infoper verificarlo.
Il token dura circa 25 ore. Zalo rinnova i token di accesso dell'OA solo tramite il proprio flusso OAuth v4, che AnythingMCP non può eseguire per questo connettore, quindi il token va incollato. Quando le chiamate rispondono con l'errore -216 o -220, crea un nuovo token in API Explorer e salvalo nelle impostazioni del connettore. Se rinnovi i token in un tuo sistema, puoi scrivere ogni nuovo token in ZALO_OA_ACCESS_TOKEN tramite l'API di AnythingMCP.
Cosa legge: il profilo dell'OA (nome, id, verifica, follower, pacchetto di servizio) e la sua quota di messaggi; gli utenti che seguono l'OA o ci hanno scritto, 50 per pagina, con filtri per etichetta, ultima interazione o stato di follower; nome, alias, stato di follower, data dell'ultima interazione, etichette, note e informazioni condivise di un utente; le etichette dell'OA; gli ultimi messaggi di tutte le chat e i messaggi con un utente, 10 per chiamata; e gli articoli e i video dell'OA con il loro contenuto.
Cosa scrive: i dettagli degli utenti (alias, il tuo id cliente e le informazioni condivise) e le etichette: l'AI applica un'etichetta a un utente, creandola se manca, oppure la rimuove. zalo_oa_send_text invia un testo di consulenza, facoltativamente citando il messaggio dell'utente, e zalo_oa_send_image un messaggio di consulenza con un'immagine. Entrambi raggiungono una persona reale, quindi l'AI mostra il testo e aspetta il tuo sì.
Quando si può inviare un messaggio di consulenza: solo a un utente che ha interagito con l'OA negli ultimi 7 giorni. Dal 1° gennaio 2026 i messaggi di consulenza entro 48 ore dall'ultima interazione dell'utente sono gratuiti e illimitati; quelli successivi usano la quota del pacchetto dell'OA o sono a pagamento. zalo_oa_get_user_quota dice all'AI cosa si può ancora inviare a un utente. L'errore -230 o -232 significa che l'utente non ha interagito abbastanza di recente, -213 che l'utente non segue l'OA.
Disattivato all'installazione: zalo_oa_delete_tag, che rimuove un'etichetta dall'OA e da ogni utente che la ha, e non si può annullare.
Formati: ogni risposta ha error (0 = successo) e message, con il payload in data; gli errori arrivano con HTTP 200 e un error negativo. Gli id di utenti, OA e messaggi sono lunghe stringhe di cifre. In un messaggio, src è 1 quando l'ha inviato l'utente e 0 quando l'ha inviato l'OA. Gli orari dei messaggi sono millisecondi Unix, e user_last_interaction_date è dd/MM/yyyy.
Limiti: 4.000 richieste al minuto per app, più un limite per OA che dipende dal pacchetto dell'OA; l'errore -32 significa attendere il minuto successivo. L'elenco degli utenti arriva ai primi 10.000 utenti.
Errori comuni: -216 o -220 significa un token non valido o scaduto (incollane uno nuovo), -223 un permesso che l'OA non ha concesso all'app, -224 una funzione non inclusa nel pacchetto dell'OA, -201 un parametro non valido, e -211 una quota esaurita.
Il connettore non invia messaggi transazionali, promozionali o template ZNS, file o sticker, e non copre chat di gruppo, chiamate, creazione di articoli o lo shop dell'OA. I webhook si configurano nelle impostazioni dell'app Zalo.
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 Claude
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 mostraYOUR_SERVER_ID.
Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.
- In Claude apri Customize → Connectors.
- Clicca + e poi Add custom connector.
- Inserisci un nome, ad esempio
Zalo Official Account, e l'URL del server MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add. - Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.
Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.
Tool disponibili
| 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) |
Esempi di prompt
- "Quali utenti hanno scritto all'OA nelle ultime 24 ore, e cosa hanno chiesto?"
- "Mostra la mia conversazione con questo utente e prepara una bozza di risposta alla sua ultima domanda."
- "Applica l'etichetta delivery-question a tutti quelli che hanno chiesto della consegna questa settimana."
- "Quanta quota di messaggi di consulenza resta all'OA?"
- "Elenca i cinque articoli più visti dell'OA."
FAQ
Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Prossimi passi
- Landing del connettore
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
- Collegare a Microsoft Copilot
Questa guida ti è stata utile?