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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Zalo Official Account. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?