Notiamo

Notiamo pentru agenți IA

Tot ce îi trebuie unui agent IA ca să deschidă un cont gratuit pentru proprietarul său, să pună widgetul pe un site web și să se ocupe de comentarii și de lucrări, fără browser.

Fluxul

  1. Cereți un cont pentru proprietarul dumneavoastră: trimiteți POST https://my.notiamo.com/api/agent/signup cu email, name, agent, locale și, dacă le aveți, company, projectUrl (adresa site-ului web) și referral. Răspunsul conține requestId, pollSecret și pollAfterSeconds.
  2. Cereți proprietarului să deschidă e-mailul de confirmare trimis de Notiamo și să confirme. Nu se întâmplă nimic până nu o face.
  3. Interogați GET https://my.notiamo.com/api/agent/signup/{requestId} cu Authorization: Bearer <pollSecret> la fiecare pollAfterSeconds secunde. Starea este pending, confirmed, expired sau reported.
  4. Când starea este confirmed, răspunsul conține o singură dată cheia dumneavoastră (token, care începe cu ntm_) și mcpUrl. Păstrați cheia imediat: interogările următoare nu o mai returnează. Preluați-o în 7 zile de la confirmare.
  5. Conectați-vă la serverul MCP de la https://my.notiamo.com/api/mcp cu antetul Authorization: Bearer ntm_…. Dacă aplicația dumneavoastră acceptă conectarea MCP, poate folosi „Conectare cu Notiamo” în locul unei chei (vedeți mai jos).
  6. Apelați list_projects (sau find_project) ca să găsiți proiectul creat pentru dumneavoastră: folosește deja projectUrl ca adresă. Dacă adresa lipsește sau e greșită, apelați update_project_address. Apoi get_install, instalați fragmentul și apelați check_install. Folosiți create_workspace și create_project doar când planul are loc (planuri plătite sau perioada de probă Studio); create_project are nevoie de un workspaceId din list_workspaces. Un spațiu de lucru grupează proiecte, de exemplu câte unul pentru fiecare client. Un proiect poate să nu aibă adresă web (omiteți origin): atunci are sarcini, lucrări și noutăți, dar nu are widget. După instalare, get_badge dă insigna din subsol: un mic logo Notiamo pentru subsolul site-ului, care deschide instrumentele de revizuire pentru cei care revizuiesc și rămâne un simplu link către Notiamo pentru ceilalți, în limba site-ului (update_project_language, sau language la create_project).
  7. Apoi lucrați cu comentariile: list_comments, get_comment, reply și set_status. Pentru noutăți, dați lui list_comments parametrul since: o oră UTC care se termină cu Z (de exemplu 2026-10-17T08:00:00Z) sau cursor din ultimul său răspuns. Primiți doar ce s-a schimbat, într-un proiect sau, fără projectId, în toate proiectele dumneavoastră. Păstrați noul cursor pentru următoarea verificare, urmați imediat more: true și eliminați dublurile după id: un element poate veni de două ori.
  8. Pentru o altă organizație, apelați create_organization cu un name: proprietarul devine administratorul ei și primește un e-mail, iar răspunsul conține un token nou, doar pentru acea organizație. Este gratuită dacă proprietarul nu are o organizație gratuită; altfel are nevoie de un abonament: apelați get_payment_link cu noul token sau start_trial pentru perioada de probă Studio de 14 zile (o dată de persoană; proprietarul deschide linkul și introduce un card). Există o limită zilnică; refuzul spune când puteți încerca din nou.
  9. Pentru a muta un proiect în alt spațiu de lucru (kind project, projectId, toWorkspaceId), sau un spațiu de lucru cu proiectele sale în altă organizație în care proprietarul este și el administrator (kind workspace, workspaceId, toOrganizationId), apelați request_move. Încă nu se mută nimic: proprietarul primește un e-mail și trebuie să confirme pe pagina indicată, în 24 de ore. Apelați get_move_request pentru stare: pending, done, cancelled, expired sau failed.
  10. Pentru a adăuga lucru care nu ține de o pagină, apelați create_task cu un projectId și un title, și opțional text și pageUrl. Pentru a-i schimba formularea, apelați update_task cu taskId și un title nou, un text nou sau ambele. Ambele se numără într-o limită zilnică de spații de lucru, proiecte și sarcini noi; refuzul vă spune când este atinsă. list_comments arată sarcinile marcate cu [Task] și acceptă type: task sau comment.
  11. Rapoartele de lucrare (Studio, Agency și perioada de probă) sunt sarcini pe care un client le completează despre o lucrare terminată: locul, data, clientul final și fișierele pe etape (before, during, after, other) cu descrieri. Apelați list_job_reports (state ready le listează pe cele care vă așteaptă), citiți unul cu get_comment și răspundeți cu role article în limba lui. Doar o persoană aprobă: dați-i linkul de aprobare sau apelați request_approval. După aprobare, răspundeți cu role posts și files (id-urile fișierelor de folosit). update_file setează phase sau caption pentru un fișier; create_task și update_task acceptă jobReport.
  12. Note vocale și AI (Studio, Agency și perioada de probă): get_comment listează fiecare înregistrare cu un link către audio și transcrierea ei de către AI (și orice transcriere ulterioară, nepublicată), fiecare videoclip mai lung de aproximativ 20 de secunde cu momentele din video (m:ss–m:ss ce se întâmplă) și descrierile AI marcate (AI, not checked) până când o persoană le verifică. Când AI nu a putut procesa un fișier, spune asta cu aceleași cuvinte simple pe care le văd oamenii, cu un cod de referință (AI-…) pentru asistență. list_plans și get_billing dau minutele de voce și AI pe lună.

Nu interogați mai des decât la fiecare pollAfterSeconds secunde. Dacă primiți rate_limited, așteptați retryAfter secunde. Un id sau un secret greșit sau necunoscut returnează 404 cu {"code":"not_found"}.

Dacă platforma ta își semnează cererile cu Web Bot Auth (semnături de mesaje HTTP, un Signature-Agent cu un director de chei) și Notiamo are încredere în ea, înregistrarea și serverul MCP te numără după platformă, nu după adresă, cu limite mai mari. Cererile nesemnate merg ca înainte.

Exemplu: cererea unui cont

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

Planul gratuit

Planul gratuit permite 1 spațiu de lucru, 1 proiect, 3 persoane (membri ai echipei, membri ai clientului și invitații în așteptare, fiecare e-mail numărat o dată) și 1 adresă publică per proiect. După primul comentariu public al proiectului, adresa poate fi schimbată o dată. Cuprinde 100 MB de fișiere, 5 MB pe fișier; peste 100 MB, administratorii organizației primesc două e-mailuri, apoi cele mai vechi fișiere sunt șterse, iar comentariile, sarcinile și răspunsurile rămân. Încărcările pot fi refuzate pentru a opri abuzurile. Video nu este inclus: necesită Studio, Agency sau perioada de probă. Un spațiu de lucru și un proiect există deja când se deschide contul.

În planul gratuit, widgetul afișează o insignă Notiamo.

Păstrați linia de comentariu deasupra etichetei script. Condițiile planului gratuit o cer:

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

O respingere plan_limit arată ce limită a fost atinsă și ce urmează.

Respingeri

Înregistrarea și instrumentele răspund cu un cod. Codurile înregistrării vin cu un status HTTP:

CodStatus HTTPCe înseamnă
signup_blocked403Rețeaua nu are voie să se înregistreze. Proprietarul se înregistrează singur.
country_blocked403Notiamo nu este disponibil în țara din care vine cererea. Nici proprietarul nu se poate înscrie de acolo.
rate_limited429Prea multe cereri. Așteptați retryAfter secunde.
agent_signup_paused503Înregistrarea de către agenți este suspendată deocamdată. Proprietarul se înregistrează singur.
agent_signup_closed503Înregistrarea de către agenți este închisă. Proprietarul se înregistrează singur.
account_exists409Acest e-mail are deja un cont. Proprietarul se autentifică și creează o cheie în Setări > Agenți AI > Tokenuri pentru agenți.
email_not_accepted422Această adresă de e-mail nu poate fi folosită. Proprietarul se înregistrează singur.
invalid_input422Un câmp nu este valid. field îl indică.
plan_limit402A fost atinsă o limită a planului. O returnează instrumentele MCP, cu pasul următor (start_trial sau get_payment_link).
read_only403Această cheie sau aplicație este doar pentru citire: poate privi, dar nu poate modifica. O returnează instrumentele MCP.
permission_missing403Această cheie sau aplicație nu are voie să facă asta. permission numește grupul care lipsește (sau full). O returnează instrumentele MCP.

Arătați respingerile proprietarului dumneavoastră. Nu le ocoliți niciodată.

Conectare cu Notiamo (OAuth)

În locul unei chei, un client MCP care acceptă conectarea se poate conecta cu OAuth. Metadatele serverului de autorizare sunt la https://my.notiamo.com/.well-known/oauth-authorization-server, iar serverul MCP răspunde 401 cu un antet WWW-Authenticate care trimite la metadatele resursei sale protejate (https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp, RFC 9728); acestea numesc acest server. Antetul sugerează scope-ul notes replies status tasks. Clienții se înregistrează singuri și folosesc PKCE (S256), fără secret de client.

Proprietarul dumneavoastră se conectează, alege organizația, ce puteți modifica (Lucru pe comentarii este bifat) și proiectele, apoi apasă Permiteți. Scope-urile sunt grupurile de permisiuni de mai jos. Proprietarul vede aplicația în Setări > Agenți AI > Aplicații conectate și o poate deconecta oricând.

Permisiuni

Citirea nu cere nicio permisiune. Pentru a modifica ceva, o cheie sau o aplicație conectată are nevoie de grupul potrivit:

notes replies status tasks setup invites billing moves

Doar citire nu are niciun grup. Lucru pe comentarii are notes, replies, status și tasks. Complet le are pe toate; invitarea membrilor echipei cere Complet. Fără grup, instrumentul refuză cu permission_missing și numește grupul în permission; o cheie doar pentru citire primește read_only. Arătați-i proprietarului: numai el poate da mai mult acces.

Plata

list_plans arată planurile (prețurile sunt pe pagina de prețuri). start_trial pornește perioada de probă, o singură dată pe persoană. Prețuri

get_payment_link creează un link de plată pe care proprietarul îl deschide și îl plătește. Dumneavoastră nu manipulați niciodată date de card.

Recomandare

Dacă v-a adus aici o insignă sau un link Notiamo, transmiteți codul acestuia în câmpul referral din corpul JSON al înregistrării. Forma ?via=<code> este doar pentru linkul web de înregistrare pe care îl deschid oamenii.

Instrumentele MCP

După conectare puteți apela:

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

Mai mult