Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Zalo Official Account con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Zalo Official Account (Vietnam): perfil de la OA y cuota de mensajes, seguidores y usuarios con sus datos y etiquetas, chats y conversaciones recientes, mensajes de consulta con texto o una imagen, y los artículos de la OA. Usa un access token de OA pegado, válido unas 25 horas.
Prueba a pedir
Prompts de ejemplo para Zalo Official Account
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Zalo Official Account, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Zalo Official Account + Cursor
Zalo Official Account (Vietnam): perfil de la OA y cuota de mensajes, seguidores y usuarios con sus datos y etiquetas, chats y conversaciones recientes, mensajes de consulta con texto o una imagen, y los artículos de la OA. Usa un access token de OA pegado, válido unas 25 horas.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
ZALO_OA_ACCESS_TOKEN
Paso 1 — Obtener credenciales
La configuración lleva unos 5 minutos, y el token hay que renovarlo cada día (ver más abajo). Necesitas una Zalo Official Account y un admin de la OA que apruebe los permisos.
- En https://developers.zalo.me crea una app o abre la tuya, vincúlala a tu Official Account y, en Official Account > OA permissions, solicita los grupos de permisos que usa el conector: gestión de la información de la OA, gestión de la información de los usuarios, gestión de los mensajes de los usuarios, envío de mensajes y notificaciones a través de la OA, y gestión de artículos. Un admin de la OA los aprueba.
- Abre Tools > API Explorer (https://developers.zalo.me/tools/explorer), elige tu app, selecciona el tipo de access token OA Access Token, elige la OA, permite los permisos solicitados y copia el access token.
- Pégalo en
ZALO_OA_ACCESS_TOKEN. Se envía en la cabeceraaccess_tokenque exige Zalo. - Instala el conector y ejecuta
zalo_oa_get_oa_infopara comprobarlo.
El token dura unas 25 horas. Zalo solo renueva los access tokens de OA mediante su propio flujo OAuth v4, que AnythingMCP no puede ejecutar para este conector, así que el token se pega. Cuando las llamadas respondan con el error -216 o -220, crea un token nuevo en API Explorer y guárdalo en los ajustes del conector. Si renuevas los tokens en tu propio sistema, puedes escribir cada token nuevo en ZALO_OA_ACCESS_TOKEN a través de la API de AnythingMCP.
Qué lee: el perfil de la OA (nombre, id, verificación, seguidores, paquete de servicio) y su cuota de mensajes; los usuarios que siguen a la OA o han hablado con ella, 50 por página, con filtros por etiqueta, última interacción o condición de seguidor; el nombre, alias, condición de seguidor, fecha de última interacción, etiquetas, notas e información compartida de un usuario; las etiquetas de la OA; los últimos mensajes de todos los chats y los mensajes con un usuario, 10 por llamada; y los artículos y vídeos de la OA con su contenido.
Qué escribe: datos de usuario (alias, tu propio id de cliente e información compartida) y etiquetas: la IA pone una etiqueta a un usuario, creándola si no existe, o se la quita. zalo_oa_send_text envía un texto de consulta, opcionalmente citando el mensaje del usuario, y zalo_oa_send_image un mensaje de consulta con una imagen. Ambos llegan a una persona real, así que la IA muestra el texto y espera tu sí.
Cuándo se puede enviar un mensaje de consulta: solo a un usuario que haya interactuado con la OA en los últimos 7 días. Desde el 1 de enero de 2026, los mensajes de consulta enviados en las 48 horas siguientes a la última interacción del usuario son gratuitos e ilimitados; los posteriores consumen la cuota del paquete de la OA o se cobran. zalo_oa_get_user_quota indica a la IA qué se puede enviar todavía a un usuario. El error -230 o -232 significa que el usuario no ha interactuado lo bastante recientemente, y -213 que el usuario no sigue a la OA.
Desactivada al instalar: zalo_oa_delete_tag, que elimina una etiqueta de la OA y de todos los usuarios que la tienen, y no se puede deshacer.
Formatos: cada respuesta tiene error (0 = éxito) y message, con la carga útil en data; los errores llegan con HTTP 200 y un error negativo. Los id de usuario, de OA y de mensaje son cadenas largas de dígitos. En un mensaje, src es 1 cuando lo envió el usuario y 0 cuando lo envió la OA. Las horas de los mensajes son milisegundos Unix, y user_last_interaction_date va en formato dd/MM/yyyy.
Límites: 4.000 solicitudes por minuto por app, más un límite por OA que depende del paquete de la OA; el error -32 significa que hay que esperar al minuto siguiente. La lista de usuarios llega hasta los primeros 10.000 usuarios.
Errores comunes: -216 o -220 significa un token no válido o caducado (pega uno nuevo), -223 un permiso que la OA no ha concedido a la app, -224 una función que el paquete de la OA no incluye, -201 un parámetro no válido y -211 una cuota agotada.
El conector no envía mensajes de transacción, de promoción ni de plantilla ZNS, ni archivos ni stickers, y no cubre los chats de grupo, las llamadas, la creación de artículos ni la tienda de la OA. Los webhooks se configuran en los ajustes de la app de Zalo.
Paso 2 — Instalar el 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
Paso 3 — Añadir el conector en Cursor
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de
YOUR_MCP_API_KEY. - Guarda el archivo y reinicia Cursor.
- Abre Cursor → Settings → MCP y comprueba que
anythingmcpaparece en la lista y está conectado. - Empieza a chatear: el agente ya puede usar las herramientas de
Zalo Official Account.
Herramientas disponibles
| 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) |
Ejemplos de prompts
- "¿Qué usuarios escribieron a la OA en las últimas 24 horas y qué preguntaron?"
- "Muestra mi conversación con este usuario y redacta una respuesta a su última pregunta."
- "Pon la etiqueta delivery-question a todos los que preguntaron por la entrega esta semana."
- "¿Cuánta cuota de mensajes de consulta le queda a la OA?"
- "Lista los cinco artículos más vistos de la OA."
FAQ
¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?