Как подключить Interakt к Microsoft Copilot через MCP

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

Interakt + Microsoft Copilot

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

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

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

INTERAKT_API_KEY

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

Настройка занимает около 2 минут. Нужен аккаунт Interakt на тарифе Growth или выше: доступ к API начинается с него.

1. В Interakt откройте Settings → Developer Setting.
2. Скопируйте Secret Key в INTERAKT_API_KEY точно так, как он показан, без слова Basic впереди. Ключ уже закодирован, и коннектор отправляет его только на api.interakt.ai.
3. Установите коннектор и запустите interakt_list_templates: он выведет ваши шаблоны WhatsApp и подтвердит, что ключ и тариф работают.

Номера телефонов: большинство инструментов принимают номер без кода страны и код страны отдельно, например 9876543210 и +91 (по умолчанию Индия). Инструмент для свободного текста принимает полный номер без +, например 919876543210.

Что он читает: ваши шаблоны WhatsApp с кодовым именем, отображаемым названием, языком, категорией, статусом одобрения, заголовком, текстом с переменными, подвалом и кнопками; клиентов по номеру телефона или ID в Interakt с атрибутами, такими как имя, email, согласие на WhatsApp и ваши собственные атрибуты, а также теги и даты создания и последнего изменения; и клиентов, созданных или изменённых за период, по 100 за раз.

Нет истории сообщений: API Interakt не отдаёт прошлые сообщения и статус доставки, они приходят только в вебхуки Interakt. Поэтому ИИ не может сказать, прочитал ли клиент сообщение.

Спрашивает перед каждым изменением: interakt_upsert_customer создаёт клиента или обновляет клиента с тем же номером (атрибуты объединяются, теги только добавляются и никогда не удаляются), interakt_track_event записывает событие, например Order Placed, в ленту клиента, и это может запустить автоматизации Interakt, которые напишут клиенту, а interakt_assign_chat назначает чат клиента в общем инбоксе сотруднику по email. ИИ показывает клиента и точное изменение и ждёт вашего согласия.

Отключено при установке: interakt_send_template и interakt_send_text. Сообщения сразу доходят до клиента, а за диалог по шаблону Meta берёт плату. Свободный текст можно отправить только в течение 24 часов после последнего сообщения клиента; вне этого окна Interakt его отклоняет, и работает только одобренный шаблон. Шаблону нужно ровно одно значение на каждую переменную ({{1}}, {{2}} и так далее) по порядку, поэтому ИИ сначала читает шаблон и считает их; шаблонам с картинкой или документом в заголовке нужна ещё публичная ссылка на файл. Администратор включает эти инструменты осознанно, и даже тогда ИИ показывает шаблон или текст, номер и значения и ждёт вашего согласия. Успешный ответ означает, что Interakt принял сообщение, а не что оно доставлено.

Ограничения: Interakt допускает 300 запросов в минуту на Growth и 600 на Advanced, а один запрос может весить не больше 32 КБ. После ответа 429 ИИ ждёт минуту и пробует снова.

Частые ошибки: 401 означает, что ключ неверный или в вашем тарифе нет доступа к API: скопируйте Secret Key заново без Basic и проверьте, что у вас Growth или выше. 400 означает отсутствующее или неверное поле, и сообщение Interakt называет его, например "Missing variable values for template's body", если не хватает значения шаблона. 429 означает, что достигнут лимит запросов.

Коннектор не создаёт шаблоны, не запускает кампании, не загружает медиафайлы, не переключается на RCS или SMS и не управляет вебхуками.

Шаг 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 поддерживает.

1. В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
2. Укажи Server name (например, AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер.
3. В аутентификации выбери API key, установи Type в Header, укажи имя заголовка X-API-Key и нажми Create.
4. В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты Interakt.
6. Нажми 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 не подойдёт.

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

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

• «Найдите клиентку +91 98765 43210 и покажите её имя, теги и дала ли она согласие на WhatsApp.»
• «Какие из наших одобренных шаблонов маркетинговые и сколько переменных нужно каждому?»
• «Выведите клиентов, которых вчера добавили или изменили в Interakt.»
• «Запишите событие Order Placed для +91 98765 43210 с заказом номер 1042 на сумму Rs 1,499. Сначала покажите мне.»
• «Назначьте чат Rahul Sharma (+91 99887 76655) на [email protected]. Уточните у меня перед этим.»

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