Notiamo

Notiamo для ИИ-агентов

Всё, что нужно ИИ-агенту, чтобы открыть бесплатный аккаунт для владельца, поставить виджет на сайт и работать с комментариями и заданиями без браузера.

Порядок действий

  1. Запросите аккаунт для вашего владельца: отправьте POST https://my.notiamo.com/api/agent/signup с полями email, name, agent, locale и, если они у вас есть, company, projectUrl (адрес сайта) и referral. В ответе будут requestId, pollSecret и pollAfterSeconds.
  2. Скажите владельцу открыть письмо с подтверждением, которое присылает Notiamo, и подтвердить. Пока он этого не сделает, ничего не происходит.
  3. Опрашивайте GET https://my.notiamo.com/api/agent/signup/{requestId} с Authorization: Bearer <pollSecret> каждые pollAfterSeconds секунд. Статус — pending, confirmed, expired или reported.
  4. Когда статус confirmed, в ответе один раз приходят ваш ключ (token, начинается с ntm_) и mcpUrl. Сохраните ключ сразу: следующие опросы его не возвращают. Заберите его в течение 7 дней после подтверждения.
  5. Подключитесь к MCP-серверу по адресу https://my.notiamo.com/api/mcp с заголовком Authorization: Bearer ntm_…. Если ваше приложение поддерживает вход по MCP, оно может использовать «Вход через Notiamo» (Sign in with Notiamo) вместо ключа (см. ниже).
  6. Вызовите list_projects (или find_project), чтобы найти проект, созданный для вас: его адрес уже взят из вашего projectUrl. Если адрес отсутствует или неверен, вызовите update_project_address. Затем get_install, установите фрагмент и вызовите check_install. Используйте create_workspace и create_project только когда в тарифе есть место (платные тарифы или пробный период Studio); для create_project нужен workspaceId из list_workspaces. Рабочее пространство объединяет проекты, например по одному на клиента. У проекта может не быть веб-адреса (опустите origin): тогда у него есть задачи, работа и новости, но нет виджета. После установки get_badge даёт значок для подвала: небольшой логотип Notiamo для подвала сайта, который открывает инструменты проверки рецензентам и остаётся обычной ссылкой на Notiamo для остальных, на языке сайта (update_project_language или language в create_project).
  7. Затем работайте с комментариями: list_comments, get_comment, reply и set_status. Чтобы узнать о новом, передайте в list_comments значение since: время в UTC, оканчивающееся на Z (например, 2026-10-17T08:00:00Z), или cursor из его последнего ответа. Вы получите только то, что изменилось, по одному проекту или, без projectId, по всем вашим проектам. Сохраните новый cursor для следующей проверки, при more: true сразу запросите дальше и убирайте дубликаты по id: элемент может прийти дважды.
  8. Для ещё одной организации вызовите create_organization с name: владелец становится её администратором и получает письмо, а ответ содержит новый token только для этой организации. Она бесплатна, если у владельца нет бесплатной организации; иначе ей нужен тариф: вызовите get_payment_link с новым токеном или start_trial для 14-дневного пробного периода Studio (один раз на человека; владелец открывает ссылку и вводит карту). Есть дневной лимит; в отказе сказано, когда можно попробовать снова.
  9. Чтобы перенести проект в другое рабочее пространство (kind project, projectId, toWorkspaceId) или рабочее пространство с его проектами в другую организацию, где владелец тоже администратор (kind workspace, workspaceId, toOrganizationId), вызовите request_move. Пока ничего не переносится: владелец получает письмо и должен подтвердить на странице по ссылке в течение 24 часов. Вызовите get_move_request, чтобы узнать статус: pending, done, cancelled, expired или failed.
  10. Чтобы добавить работу, не привязанную к странице, вызовите create_task с projectId и title, а при желании text и pageUrl. Чтобы изменить формулировку, вызовите update_task с taskId и новым title, text или обоими. Оба вызова учитываются в суточном лимите на новые рабочие пространства, проекты и задачи; когда вы его достигнете, в отказе будет сказано, когда можно повторить. list_comments показывает задачи с пометкой [Task] и принимает type: task или comment.
  11. Отчёты о задании (Studio, Agency и пробный период) — это задачи, которые клиент заполняет о выполненной работе: место, дата, конечный заказчик и файлы по фазам (before, during, after, other) с подписями. Вызовите list_job_reports (state ready перечисляет те, что ждут вас), прочитайте один через get_comment и ответьте с role article на его языке. Утверждает только человек: дайте ему ссылку на утверждение или вызовите request_approval. После утверждения ответьте с role posts и files (идентификаторы файлов, которые нужно использовать). update_file задаёт phase или caption файла; create_task и update_task принимают jobReport.
  12. Голосовые заметки и ИИ (Studio, Agency и пробный период): get_comment перечисляет каждую запись со ссылкой на аудио и её расшифровкой от ИИ (и любой более поздней расшифровкой, не опубликованной), каждое видео длиннее примерно 20 секунд с заметками о времени (m:ss–m:ss что происходит) и подписи от ИИ с пометкой (AI, not checked), пока человек их не проверит. Если ИИ не смог обработать файл, об этом сказано теми же простыми словами, что видят люди, с кодом обращения (AI-…) для поддержки. list_plans и get_billing показывают минуты голоса и ИИ в месяц.

Опрашивайте не чаще, чем pollAfterSeconds. Если получите rate_limited, подождите retryAfter секунд. Неверный или неизвестный идентификатор или секрет возвращает 404 с {"code":"not_found"}.

Если ваша платформа подписывает запросы через Web Bot Auth (подписи HTTP-сообщений, Signature-Agent с каталогом ключей) и Notiamo ей доверяет, регистрация и сервер MCP считают вас по платформе, а не по адресу, с более высокими лимитами. Неподписанные запросы работают как раньше.

Пример: запрос аккаунта

curl -X POST https://my.notiamo.com/api/agent/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"owner@example.com","name":"Ada Owner","agent":"my-agent","locale":"en","projectUrl":"https://example.com"}'

Бесплатный тариф

Бесплатный тариф допускает 1 рабочее пространство, 1 проект, 3 человека (члены команды, участники клиента и ожидающие приглашения, каждый e-mail один раз) и 1 публичный адрес на проект. После первого публичного комментария проекта адрес можно изменить один раз. Помещается 100 МБ файлов, по 5 МБ на файл; при превышении 100 МБ администраторы организации получают два письма, затем самые старые файлы удаляются, а комментарии, задачи и ответы остаются. Загрузки могут быть отклонены, чтобы пресечь злоупотребление. Видео не входит: оно требует Studio, Agency или пробного периода. Рабочее пространство и проект уже существуют, когда открывается аккаунт.

В бесплатном тарифе виджет показывает значок Notiamo.

Оставьте строку комментария над тегом script. Условия бесплатного тарифа этого требуют:

<!-- Notiamo (notiamo.com): website feedback. Free plan: keep this line. -->

Отказ plan_limit сообщает, какого лимита вы достигли и что делать дальше.

Отказы

Регистрация и инструменты отвечают кодом. Коды регистрации приходят с HTTP-статусом:

КодHTTP-статусЧто это значит
signup_blocked403Этой сети не разрешена регистрация. Владелец регистрируется сам.
country_blocked403Notiamo недоступен в стране, из которой пришёл запрос. Владелец тоже не может зарегистрироваться оттуда.
rate_limited429Слишком много запросов. Подождите retryAfter секунд.
agent_signup_paused503Регистрация через агентов сейчас приостановлена. Владелец регистрируется сам.
agent_signup_closed503Регистрация через агентов закрыта. Владелец регистрируется сам.
account_exists409У этого e-mail уже есть аккаунт. Владелец входит и создаёт ключ в Настройки > ИИ-агенты > Токены агентов.
email_not_accepted422Этот адрес e-mail использовать нельзя. Владелец регистрируется сам.
invalid_input422Поле недопустимо. Его называет field.
plan_limit402Достигнут лимит тарифа. Возвращается инструментами MCP вместе со следующим шагом (start_trial или get_payment_link).
read_only403Этот ключ или приложение только для чтения: можно смотреть, но не менять. Возвращается инструментами MCP.
permission_missing403Этому ключу или приложению это не разрешено. permission называет недостающую группу (или full). Возвращается инструментами MCP.

Показывайте отказы владельцу. Никогда не обходите их.

Вход через Notiamo (OAuth)

Вместо ключа MCP-клиент, поддерживающий вход, может подключиться через OAuth. Метаданные сервера авторизации находятся по адресу https://my.notiamo.com/.well-known/oauth-authorization-server, а MCP-сервер отвечает 401 с заголовком WWW-Authenticate, который указывает на метаданные защищённого ресурса (https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp, RFC 9728), называющие этот сервер, и предлагает scope notes replies status tasks. Клиенты регистрируются сами и используют PKCE (S256), без секрета клиента.

Ваш владелец входит, выбирает организацию, что вам разрешено менять (отмечено «Работа с отзывами») и проекты, и нажимает «Разрешить». Scope — это группы прав ниже. Владелец видит приложение в Настройки > ИИ-агенты > Подключённые приложения и может отключить его в любой момент.

Права

Для чтения права не нужны. Чтобы что-то менять, ключу или подключённому приложению нужна соответствующая группа:

notes replies status tasks setup invites billing moves

У «Только чтение» групп нет. У «Работа с отзывами» есть notes, replies, status и tasks. У «Полный» есть все; для приглашения членов команды нужен «Полный». Без группы инструмент отказывает с permission_missing и называет группу в permission; ключ только для чтения получает read_only. Покажите это владельцу: только он может дать больше доступа.

Оплата

list_plans показывает тарифы (цены смотрите на странице цен). start_trial запускает пробный период, один раз на человека. Цены

get_payment_link создаёт ссылку на оплату, которую владелец открывает и оплачивает. Вы никогда не работаете с данными карты.

Реферальный код

Если вас сюда привёл значок или ссылка Notiamo, передайте её код в поле referral в JSON-теле запроса регистрации. Вид ?via=<code> предназначен только для веб-ссылки регистрации, которую открывают люди.

Инструменты MCP

После подключения вы можете вызывать:

whoami list_projects find_project list_comments list_activity get_comment reply set_status assign list_team list_people get_account list_plans get_billing start_trial list_workspaces create_workspace create_project update_project_address update_project_language get_install get_badge check_install invite get_payment_link create_organization request_move get_move_request create_task update_task list_job_reports update_file request_approval

Ещё