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» замість ключа (див. нижче).
  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 людини (учасники команди, учасники-клієнти й очікувані запрошення, кожна адреса пошти один раз) і 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Для цієї пошти вже є обліковий запис. Власник входить і створює ключ у «Налаштування > ШІ-агенти > Токени агентів».
email_not_accepted422Цю адресу пошти не можна використати. Власник реєструється сам.
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

Ще