Notiamo для ШІ-агентів
Усе, що потрібно ШІ-агентові, щоб відкрити безкоштовний обліковий запис для власника, поставити віджет на сайт і опрацьовувати коментарі та роботу без браузера.
Послідовність
- Попросіть обліковий запис для свого власника: надішліть
POST https://my.notiamo.com/api/agent/signupізemail,name,agent,localeта, якщо вони є,company,projectUrl(адреса сайту) іreferral. Відповідь міститьrequestId,pollSecretіpollAfterSeconds. - Скажіть власникові відкрити лист із підтвердженням, який надішле Notiamo, і підтвердити. Доки він цього не зробить, нічого не станеться.
- Опитуйте
GET https://my.notiamo.com/api/agent/signup/{requestId}ізAuthorization: Bearer <pollSecret>кожніpollAfterSecondsсекунд. Статус:pending,confirmed,expiredабоreported. - Коли статус
confirmed, відповідь один раз містить ваш ключ (token, що починається зntm_) іmcpUrl. Збережіть ключ одразу: наступні опитування його не повертають. Заберіть його протягом 7 днів після підтвердження. - Підключіться до сервера MCP за адресою
https://my.notiamo.com/api/mcpіз заголовкомAuthorization: Bearer ntm_…. Якщо ваш застосунок підтримує вхід через MCP, він може використати «Увійти через Notiamo» замість ключа (див. нижче). - Викличте
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). - Далі працюйте з коментарями:
list_comments,get_comment,replyіset_status. Щоб перевірити новини, передайте вlist_commentsпараметрsince: час UTC із закінченням наZ(наприклад2026-10-17T08:00:00Z) абоcursorз її останньої відповіді. Ви отримаєте лише те, що змінилося, в одному проєкті або, безprojectId, у всіх ваших проєктах. Зберігайте новийcursorдля наступної перевірки, одразу йдіть заmore: trueі прибирайте дублікати заid: елемент може прийти двічі. - Для ще однієї організації викличте
create_organizationзname: власник стає її адміністратором і отримує лист, а відповідь містить новийtokenлише для цієї організації. Вона безкоштовна, якщо у власника немає безкоштовної організації; інакше їй потрібен тариф: викличтеget_payment_linkз новим токеном абоstart_trialдля 14-денного пробного періоду Studio (один раз на людину; власник відкриває посилання і вводить картку). Є денний ліміт; у відмові сказано, коли можна спробувати знову. - Щоб перенести проєкт в інший робочий простір (
kindproject,projectId,toWorkspaceId) або робочий простір з його проєктами в іншу організацію, де власник теж адміністратор (kindworkspace,workspaceId,toOrganizationId), викличтеrequest_move. Поки що нічого не переноситься: власник отримує лист і має підтвердити на сторінці, на яку той посилається, протягом 24 годин. Викличтеget_move_request, щоб дізнатися статус:pending,done,cancelled,expiredабоfailed. - Щоб додати роботу, не прив’язану до сторінки, викличте
create_taskзprojectIdіtitle, а за потребиtextіpageUrl. Щоб змінити формулювання, викличтеupdate_taskзtaskIdі новимtitle,textабо обома. Обидва рахуються в добовий ліміт нових робочих просторів, проєктів і завдань; у відмові сказано, коли ви його досягнете.list_commentsпоказує завдання з позначкою[Task]і приймаєtype:taskабоcomment. - Звіти про завдання (Studio, Agency і пробний період) — це завдання, які клієнт заповнює про виконану роботу: місце, дата, кінцевий замовник і файли за етапами (
before,during,after,other) з підписами. Викличтеlist_job_reports(statereadyпоказує ті, що чекають на вас), прочитайте один черезget_commentі відповідайте зrolearticleйого мовою. Схвалює лише людина: дайте їй посилання на схвалення або викличтеrequest_approval. Після схвалення відповідайте зrolepostsіfiles(ідентифікатори файлів, які треба використати).update_fileзадаєphaseабоcaptionфайлу;create_taskіupdate_taskприймаютьjobReport. - Голосові нотатки та ШІ (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_blocked | 403 | Цій мережі заборонено реєстрацію. Власник реєструється сам. |
country_blocked | 403 | Notiamo недоступний у країні, з якої надійшов запит. Власник теж не може зареєструватися звідти. |
rate_limited | 429 | Забагато запитів. Зачекайте retryAfter секунд. |
agent_signup_paused | 503 | Реєстрацію через агентів поки призупинено. Власник реєструється сам. |
agent_signup_closed | 503 | Реєстрацію через агентів закрито. Власник реєструється сам. |
account_exists | 409 | Для цієї пошти вже є обліковий запис. Власник входить і створює ключ у «Налаштування > ШІ-агенти > Токени агентів». |
email_not_accepted | 422 | Цю адресу пошти не можна використати. Власник реєструється сам. |
invalid_input | 422 | Поле недійсне. field називає його. |
plan_limit | 402 | Досягнуто ліміту тарифу. Повертається інструментами MCP з наступним кроком (start_trial або get_payment_link). |
read_only | 403 | Цей ключ або застосунок лише для читання: він може дивитися, але не змінювати. Повертається інструментами MCP. |
permission_missing | 403 | Цей ключ або застосунок не може цього робити. 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