Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте Zalo Official Account одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
Zalo Official Account (Вьетнам): профиль OA и квота сообщений, подписчики и пользователи с их данными и метками, последние чаты и переписка, консультационные сообщения с текстом или изображением и статьи OA. Использует вставленный вручную токен доступа OA, который действует около 25 часов.
Попробуй спросить
Примеры промптов для Zalo Official Account
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Zalo Official Account, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Zalo Official Account
Zalo Official Account (Вьетнам): профиль OA и квота сообщений, подписчики и пользователи с их данными и метками, последние чаты и переписка, консультационные сообщения с текстом или изображением и статьи OA. Использует вставленный вручную токен доступа OA, который действует около 25 часов.
Настройка
Настройка занимает около 5 минут, а токен нужно обновлять каждый день (см. ниже). Нужен Zalo Official Account и администратор OA, который одобряет разрешения.
- На https://developers.zalo.me создайте приложение или откройте своё, привяжите его к своему Official Account и в разделе Official Account > OA permissions запросите группы разрешений, которые использует коннектор: управление информацией OA, управление информацией о пользователях, управление сообщениями пользователей, отправка сообщений и уведомлений через OA и управление статьями. Администратор OA их одобряет.
- Откройте Tools > API Explorer (https://developers.zalo.me/tools/explorer), выберите своё приложение, тип токена доступа OA Access Token и OA, разрешите запрошенные права и скопируйте access token.
- Вставьте его в
ZALO_OA_ACCESS_TOKEN. Он передаётся в заголовкеaccess_token, которого требует Zalo. - Установите коннектор и запустите
zalo_oa_get_oa_info, чтобы проверить его.
Токен действует около 25 часов. Zalo обновляет токены доступа OA только через собственный процесс OAuth v4, который AnythingMCP не может выполнить для этого коннектора, поэтому токен вставляется вручную. Когда вызовы отвечают ошибкой -216 или -220, создайте новый токен в API Explorer и сохраните его в настройках коннектора. Если вы обновляете токены в своей системе, можно записывать каждый новый токен в ZALO_OA_ACCESS_TOKEN через API AnythingMCP.
Что он читает: профиль OA (название, id, верификация, подписчики, пакет услуг) и его квоту сообщений; пользователей, которые подписаны на OA или писали ему, по 50 на страницу, с фильтрами по метке, последнему взаимодействию или статусу подписчика; имя, псевдоним, статус подписчика, дату последнего взаимодействия, метки, заметки и переданную информацию одного пользователя; метки OA; последние сообщения во всех чатах и сообщения с одним пользователем, по 10 за вызов; а также статьи и видео OA с их текстом.
Что он записывает: данные пользователя (псевдоним, ваш собственный id клиента и переданную информацию) и метки: ИИ ставит пользователю метку, создавая её, если её нет, или снимает её. zalo_oa_send_text отправляет консультационный текст, при желании с цитатой сообщения пользователя, а zalo_oa_send_image отправляет консультационное сообщение с одним изображением. Оба доходят до реального человека, поэтому ИИ показывает текст и ждёт вашего «да».
Когда можно отправить консультационное сообщение: только пользователю, который взаимодействовал с OA в последние 7 дней. С 1 января 2026 года консультационные сообщения в течение 48 часов после последнего взаимодействия пользователя бесплатны и не ограничены; более поздние расходуют квоту пакета OA или оплачиваются. zalo_oa_get_user_quota сообщает ИИ, что ещё можно отправить пользователю. Ошибка -230 или -232 означает, что пользователь взаимодействовал слишком давно, а -213 означает, что пользователь не подписан на OA.
Отключено при установке: zalo_oa_delete_tag, который удаляет метку из OA и у всех пользователей, у которых она есть; отменить это нельзя.
Форматы: в каждом ответе есть error (0 = успех) и message, а полезные данные лежат в data; ошибки приходят с HTTP 200 и отрицательным error. Id пользователей, OA и сообщений представляют собой длинные строки из цифр. В сообщении src равен 1, если его отправил пользователь, и 0, если OA. Время сообщений в Unix-миллисекундах, а user_last_interaction_date в формате dd/MM/yyyy.
Лимиты: 4 000 запросов в минуту на приложение плюс лимит на OA, который зависит от пакета OA; ошибка -32 означает, что нужно дождаться следующей минуты. Список пользователей охватывает первые 10 000 пользователей.
Частые ошибки: -216 или -220 означает неверный или истёкший токен (вставьте новый), -223 разрешение, которое OA не выдал приложению, -224 функцию, которая не входит в пакет OA, -201 неверный параметр, а -211 исчерпанную квоту.
Коннектор не отправляет транзакционные, рекламные и шаблонные сообщения ZNS, файлы или стикеры и не охватывает групповые чаты, звонки, создание статей и магазин OA. Webhooks настраиваются в настройках приложения Zalo.
Предварительные требования: ZALO_OA_ACCESS_TOKEN
Локальная установка коннектора
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
Откройте http://localhost:3000/connectors/store, выберите Zalo Official Account и введите переменные, перечисленные в Предварительных требованиях.
Доступные инструменты
| 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) |
Примеры запросов
- «Какие пользователи писали OA за последние 24 часа и о чём они спрашивали?»
- «Покажи мою переписку с этим пользователем и подготовь черновик ответа на его последний вопрос.»
- «Поставь метку delivery-question всем, кто на этой неделе спрашивал о доставке.»
- «Сколько квоты консультационных сообщений осталось у OA?»
- «Выведи пять самых просматриваемых статей OA.»
Следующие шаги
Это руководство помогло?