Notiamo

Notiamo dla agentów AI

Wszystko, czego agent AI potrzebuje, by otworzyć darmowe konto dla właściciela, umieścić widżet na stronie i obsłużyć komentarze oraz pracę, bez przeglądarki.

Przebieg

  1. Poproś o konto dla właściciela: wyślij POST https://my.notiamo.com/api/agent/signup z email, name, agent, locale i, jeśli je masz, company, projectUrl (adres strony) oraz referral. Odpowiedź zawiera requestId, pollSecret i pollAfterSeconds.
  2. Powiedz właścicielowi, aby otworzył e-mail z potwierdzeniem, który wysyła Notiamo, i potwierdził. Dopóki tego nie zrobi, nic się nie dzieje.
  3. Odpytuj GET https://my.notiamo.com/api/agent/signup/{requestId} z Authorization: Bearer <pollSecret> co pollAfterSeconds sekund. Status to pending, confirmed, expired lub reported.
  4. Gdy status to confirmed, odpowiedź zawiera Twój klucz (token, zaczynający się od ntm_) i mcpUrl, jednorazowo. Zapisz klucz od razu: późniejsze odpytania go nie zwracają. Odbierz go w ciągu 7 dni od potwierdzenia.
  5. Połącz się z serwerem MCP pod https://my.notiamo.com/api/mcp z nagłówkiem Authorization: Bearer ntm_…. Jeśli Twoja aplikacja obsługuje logowanie MCP, może użyć Sign in with Notiamo zamiast klucza (patrz niżej).
  6. Wywołaj list_projects (lub find_project), aby znaleźć projekt utworzony dla Ciebie: używa już Twojego projectUrl jako adresu. Jeśli adresu brakuje lub jest błędny, wywołaj update_project_address. Potem get_install, zainstaluj fragment kodu i check_install. Używaj create_workspace i create_project tylko wtedy, gdy plan ma miejsce (plany płatne lub okres próbny Studio); create_project wymaga workspaceId z list_workspaces. Przestrzeń robocza grupuje projekty, na przykład po jednym na klienta. Projekt może nie mieć adresu internetowego (pomiń origin): wtedy ma zadania, prace i nowości, ale nie ma widżetu. Po instalacji get_badge daje odznakę w stopce: małe logo Notiamo do stopki strony, które recenzentom otwiera narzędzia recenzji, a dla pozostałych jest zwykłym linkiem do Notiamo, w języku strony (update_project_language albo language w create_project).
  7. Potem pracuj nad komentarzami: list_comments, get_comment, reply i set_status. Aby sprawdzić nowości, przekaż since do list_comments: czas UTC kończący się na Z (taki jak 2026-10-17T08:00:00Z) albo cursor z ostatniej odpowiedzi. Dostajesz tylko to, co się zmieniło, w jednym projekcie albo, bez projectId, we wszystkich Twoich projektach. Zachowaj nowy cursor na następne sprawdzenie, od razu obsłuż more: true i usuwaj duplikaty według id: pozycja może przyjść dwa razy.
  8. Dla kolejnej organizacji wywołaj create_organization z name: właściciel zostaje jej administratorem i dostaje e-mail, a odpowiedź zawiera nowy token tylko dla tej organizacji. Jest bezpłatna, jeśli właściciel nie ma darmowej organizacji; w przeciwnym razie wymaga planu: wywołaj get_payment_link z nowym tokenem albo start_trial dla 14-dniowego okresu próbnego Studio (raz na osobę; właściciel otwiera link i podaje kartę). Jest dzienny limit; odmowa mówi, kiedy można spróbować ponownie.
  9. Aby przenieść projekt do innej przestrzeni roboczej (kind project, projectId, toWorkspaceId) albo przestrzeń roboczą z jej projektami do innej organizacji, w której właściciel też jest administratorem (kind workspace, workspaceId, toOrganizationId), wywołaj request_move. Nic jeszcze się nie przenosi: właściciel dostaje e-mail i musi potwierdzić na stronie z linku, w ciągu 24 godzin. Wywołaj get_move_request, aby poznać status: pending, done, cancelled, expired lub failed.
  10. Aby dodać pracę niezwiązaną ze stroną, wywołaj create_task z projectId i title, a opcjonalnie text i pageUrl. Aby zmienić jej treść, wywołaj update_task z taskId i nowym title, text lub oboma. Oba liczą się do dziennego limitu nowych przestrzeni roboczych, projektów i zadań; odmowa mówi, kiedy go osiągniesz. list_comments pokazuje zadania oznaczone [Task] i przyjmuje type: task lub comment.
  11. Raporty z zadań (Studio, Agency i okres próbny) to zadania, które klient wypełnia o wykonanej pracy: miejsce, data, klient końcowy i pliki według etapu (before, during, after, other) z podpisami. Wywołaj list_job_reports (state ready wymienia te, które czekają na Ciebie), przeczytaj jeden przez get_comment i odpowiedz z role article w jego języku. Zatwierdza tylko człowiek: daj mu link do zatwierdzenia albo wywołaj request_approval. Po zatwierdzeniu odpowiedz z role posts i files (identyfikatory plików do użycia). update_file ustawia phase lub caption pliku; create_task i update_task przyjmują jobReport.
  12. Notatki głosowe i AI (Studio, Agency i okres próbny): get_comment wymienia każde nagranie z linkiem do dźwięku i jego transkrypcją przez AI (oraz każdą późniejszą transkrypcję, nieopublikowaną), każde wideo dłuższe niż około 20 sekund z notatkami czasowymi (m:ss–m:ss co się dzieje) oraz podpisy AI oznaczone (AI, not checked), dopóki człowiek ich nie sprawdzi. Gdy AI nie mogło przetworzyć pliku, mówi o tym tymi samymi prostymi słowami, które widzą ludzie, z kodem odniesienia (AI-…) dla wsparcia. list_plans i get_billing podają minuty głosu i AI miesięcznie.

Nie odpytuj szybciej niż pollAfterSeconds. Jeśli dostaniesz rate_limited, poczekaj retryAfter sekund. Błędny lub nieznany identyfikator albo sekret zwraca 404 z {"code":"not_found"}.

Jeśli twoja platforma podpisuje żądania przez Web Bot Auth (podpisy wiadomości HTTP, Signature-Agent z katalogiem kluczy) i Notiamo jej ufa, rejestracja i serwer MCP liczą cię według platformy, a nie adresu, z wyższymi limitami. Niepodpisane żądania działają jak wcześniej.

Przykład: poproś o konto

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"}'

Plan darmowy

Plan darmowy pozwala na 1 przestrzeń roboczą, 1 projekt, 3 osoby (członkowie zespołu, członkowie klienta i oczekujące zaproszenia, każdy e-mail raz) i 1 publiczny adres na projekt. Po pierwszym publicznym komentarzu projektu adres można zmienić raz. Mieści 100 MB plików, 5 MB na plik; po przekroczeniu 100 MB administratorzy organizacji dostają dwa e-maile, potem najstarsze pliki są usuwane, a komentarze, zadania i odpowiedzi zostają. Przesyłanie może być odrzucane, by powstrzymać nadużycia. Wideo nie jest wliczone: wymaga Studio, Agency lub okresu próbnego. Przestrzeń robocza i projekt już istnieją, gdy konto się otwiera.

W planie darmowym widżet pokazuje plakietkę Notiamo.

Zachowaj linię komentarza nad znacznikiem script. Wymaga tego regulamin planu darmowego:

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

Odmowa plan_limit mówi, jakiego limitu dotyczy i co zrobić dalej.

Odmowy

Rejestracja i narzędzia odpowiadają kodem. Kody rejestracji przychodzą ze statusem HTTP:

KodStatus HTTPCo oznacza
signup_blocked403Ta sieć nie może się rejestrować. Właściciel rejestruje się sam.
country_blocked403Notiamo nie jest dostępne w kraju, z którego pochodzi żądanie. Właściciel też nie może się stamtąd zarejestrować.
rate_limited429Zbyt wiele żądań. Poczekaj retryAfter sekund.
agent_signup_paused503Rejestracja przez agentów jest na razie wstrzymana. Właściciel rejestruje się sam.
agent_signup_closed503Rejestracja przez agentów jest zamknięta. Właściciel rejestruje się sam.
account_exists409Ten e-mail ma już konto. Właściciel loguje się i tworzy klucz w Ustawienia > Agenci AI > Tokeny agentów.
email_not_accepted422Tego adresu e-mail nie można użyć. Właściciel rejestruje się sam.
invalid_input422Pole jest nieprawidłowe. Nazywa je field.
plan_limit402Osiągnięto limit planu. Zwracane przez narzędzia MCP, z następnym krokiem (start_trial lub get_payment_link).
read_only403Ten klucz lub ta aplikacja jest tylko do odczytu: może patrzeć, ale nie zmieniać. Zwracane przez narzędzia MCP.
permission_missing403Ten klucz lub ta aplikacja nie może tego zrobić. permission nazywa brakującą grupę (lub full). Zwracane przez narzędzia MCP.

Pokazuj odmowy swojemu właścicielowi. Nigdy ich nie obchodź.

Sign in with Notiamo (OAuth)

Zamiast klucza klient MCP, który obsługuje logowanie, może połączyć się przez OAuth. Metadane serwera autoryzacji są pod https://my.notiamo.com/.well-known/oauth-authorization-server, a serwer MCP odpowiada 401 z nagłówkiem WWW-Authenticate, który wskazuje metadane chronionego zasobu (https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp, RFC 9728), nazywające ten serwer, i sugeruje zakres notes replies status tasks. Klienci rejestrują się sami i używają PKCE (S256), bez sekretu klienta.

Twój właściciel loguje się, wybiera organizację, co możesz zmieniać (Praca z opiniami jest zaznaczona) i projekty, i klika Zezwól. Zakresy to grupy uprawnień poniżej. Twój właściciel widzi aplikację w Ustawienia > Agenci AI > Połączone aplikacje i może ją odłączyć w każdej chwili.

Uprawnienia

Czytanie nie wymaga uprawnień. Aby coś zmienić, klucz lub połączona aplikacja potrzebuje odpowiedniej grupy:

notes replies status tasks setup invites billing moves

Tylko odczyt nie ma grupy. Praca z opiniami ma notes, replies, status i tasks. Pełny ma wszystkie; zapraszanie członków zespołu wymaga Pełny. Bez grupy narzędzie odmawia z permission_missing i nazywa grupę w permission; klucz tylko do odczytu dostaje read_only. Pokaż to swojemu właścicielowi: tylko on może dać więcej dostępu.

Płatność

list_plans pokazuje plany (ceny na stronie z cennikiem). start_trial rozpoczyna okres próbny, raz na osobę. Cennik

get_payment_link tworzy link do płatności, który właściciel otwiera i płaci. Nigdy nie obsługujesz danych karty.

Polecenie

Jeśli trafiłeś tu przez plakietkę lub link Notiamo, przekaż jego kod w polu referral ciała JSON rejestracji. Forma ?via=<code> jest tylko dla linku do rejestracji, który otwierają ludzie.

Narzędzia MCP

Po połączeniu możesz wywołać:

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

Więcej