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.
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
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.
Setup
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.
Prerequisiti: ZALO_OA_ACCESS_TOKEN
Installazione locale del connettore
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
Apri http://localhost:3000/connectors/store, scegli Zalo Official Account e inserisci le variabili elencate nei Prerequisiti.
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."
Prossimi passi
Questa guida ti è stata utile?