Пропустите установку. Заработает меньше чем за 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 + Microsoft Copilot
Zalo Official Account (Вьетнам): профиль OA и квота сообщений, подписчики и пользователи с их данными и метками, последние чаты и переписка, консультационные сообщения с текстом или изображением и статьи OA. Использует вставленный вручную токен доступа OA, который действует около 25 часов.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
ZALO_OA_ACCESS_TOKEN
Шаг 1 — Получите учётные данные
Настройка занимает около 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.
Шаг 2 — Установите адаптер
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
Шаг 3 — Добавьте коннектор в Microsoft Copilot
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.
- В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
- Укажи Server name (например,
AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер. - В аутентификации выбери API key, установи Type в Header, укажи имя заголовка
X-API-Keyи нажми Create. - В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
- Проверь в панели Test агента: попроси о том, для чего нужны инструменты
Zalo Official Account. - Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.
Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.
Доступные инструменты
| 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.»
FAQ
Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.
Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.
Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
- Страница коннектора
- Подключить к Claude
- Подключить к ChatGPT
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
Это руководство помогло?