Как подключить WATI к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → WATI, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

WATI + Gemini

Управляйте входящими WATI в WhatsApp Business через ИИ: список одобренных шаблонов, поиск, добавление и обновление контактов, история чата с контактом, назначение переписок сотрудникам и отправка шаблонного сообщения. Сессионные, интерактивные и массовые отправки при установке отключены.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

WATI_API_ENDPOINT, WATI_ACCESS_TOKEN

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужен workspace WATI на тарифе Growth или выше, а также его API Endpoint и Access Token.

1. Войдите в WATI и откройте в меню API Docs (в новых workspace это Connector → API).
2. Скопируйте API Endpoint в WATI_API_ENDPOINT в том виде, в каком его показывает WATI, например https://live-mt-server.wati.io/123456, без /api/v1 в конце. Число в конце адреса это ID вашего workspace (tenant).
3. Скопируйте Access Token в WATI_ACCESS_TOKEN без слова Bearer: WATI показывает его как Bearer eyJ..., поэтому вставьте только часть начиная с eyJ.
4. Установите коннектор и запустите wati_list_message_templates: он выведет ваши шаблоны WhatsApp и покажет, что адрес и токен подходят друг к другу.

Только API v1: коннектор работает с API v1 WATI. Более новый API v3 не принимает токен с экрана API Docs, поэтому его дополнительные функции (теги и статусы переписок, каналы, кампании, кредиты) в этот коннектор не входят. Токен отправляется только на ваш API Endpoint и перестаёт работать после смены пароля аккаунта.

Что он читает: ваши шаблоны сообщений с категорией, статусом (APPROVED, PENDING, REJECTED), языком, заголовком, текстом с плейсхолдерами, подвалом и кнопками; ваши контакты с номером WhatsApp, именем, согласием на рассылку, разрешением на рассылки, пользовательскими атрибутами и командами, с фильтром по имени, атрибуту или дате создания; и историю чата с одним контактом, начиная с новых сообщений, со статусом доставки, событиями операторов и тикетов.

Номера: номера WhatsApp указываются в международном формате с кодом страны, без + и пробелов, например 79123456789. Там, где инструмент ждёт контакт, можно передать и ID контакта в WATI. Если в workspace несколько номеров WhatsApp, ИИ может выбрать, с какого бизнес-номера работать.

Шаблоны и 24-часовое окно: по истечении 24 часов после последнего сообщения клиента WhatsApp разрешает только одобренные шаблоны, причём отправить можно лишь шаблоны со статусом APPROVED. Внутри окна разрешены свободный текст и кнопки ответа. Meta берёт плату за шаблонные сообщения за каждый диалог.

Спрашивает перед каждым изменением: wati_send_template_message отправляет один шаблон на один номер, и клиент сразу его получает; wati_add_contact добавляет контакт с именем и пользовательскими атрибутами; wati_update_contact_attributes задаёт атрибуты, например статус заказа или этап лида, и не трогает остальные. Перед каждым из этих действий ИИ показывает номер, шаблон и значения или само изменение и ждёт вашего согласия. wati_assign_operator передаёт чат сотруднику по его email или обратно боту и меняет только общий ящик входящих.

Отключено при установке: wati_send_session_message (свободный текст в открытой 24-часовой сессии), wati_send_interactive_buttons (сообщение с кнопками ответа, до трёх штук) и wati_send_template_broadcast (один шаблон на 1 000 номеров за вызов, каждому получателю приходит сообщение, и за каждого списывается плата). Они напрямую доходят до клиентов, поэтому администратор включает их осознанно, и даже тогда ИИ подтверждает с вами каждую отправку.

Ограничения: около 10 запросов за 10 секунд для контактов и сообщений и от 30 до 100 отправок шаблонов за 10 секунд в зависимости от тарифа. Ответ 429 означает, что нужно подождать несколько секунд и повторить.

Частые ошибки: 401 означает, что токен неверный, истёк или всё ещё начинается с Bearer. 403 означает, что токен или ваш тариф не разрешает этот вызов. 404 обычно указывает на неверный API Endpoint. На некоторые сбои WATI отвечает HTTP 200 и result false, например при неверном номере или неодобренном шаблоне: коннектор превращает их в ошибки с текстом WATI. У контакта, который никогда с вами не переписывался, нет истории чата (Can't find Conversation). Успешная отправка означает, что WATI принял сообщение, а не что оно доставлено.

Коннектор не использует API v3, не создаёт и не удаляет шаблоны, не планирует кампании и рассылки из CSV, не отправляет медиа, файлы, сообщения со списками и CTA, не создаёт чат-боты и сегменты, не настраивает вебхуки, не работает с WhatsApp Pay и не обновляет токен.

Шаг 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 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты WATI.

Доступные инструменты

Примеры запросов

• «Найди контакт Екатерина Смирнова и покажи её последние сообщения с нами в WhatsApp.»
• «Какие из наших одобренных шаблонов подходят для уведомления об отправке заказа и какие значения в них нужно подставить?»
• «Отправь шаблон order_shipped на 79123456789 с именем Дмитрий и номером заказа 4512. Перед отправкой покажи мне всё целиком.»
• «Поставь lead_stage значение qualified для 79261234567 и назначь чат на [email protected].»
• «Выведи контакты, созданные сегодня, у которых город Казань.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT