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
- Cereți un cont pentru proprietarul dumneavoastră: trimiteți
POST https://my.notiamo.com/api/agent/signupcuemail,name,agent,localeși, dacă le aveți,company,projectUrl(adresa site-ului web) șireferral. Răspunsul conținerequestId,pollSecretșipollAfterSeconds. - 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.
- Interogați
GET https://my.notiamo.com/api/agent/signup/{requestId}cuAuthorization: Bearer <pollSecret>la fiecarepollAfterSecondssecunde. Starea estepending,confirmed,expiredsaureported. - Când starea este
confirmed, răspunsul conține o singură dată cheia dumneavoastră (token, care începe cuntm_) șimcpUrl. Păstrați cheia imediat: interogările următoare nu o mai returnează. Preluați-o în 7 zile de la confirmare. - Conectați-vă la serverul MCP de la
https://my.notiamo.com/api/mcpcu antetulAuthorization: Bearer ntm_…. Dacă aplicația dumneavoastră acceptă conectarea MCP, poate folosi „Conectare cu Notiamo” în locul unei chei (vedeți mai jos). - Apelați
list_projects(saufind_project) ca să găsiți proiectul creat pentru dumneavoastră: folosește dejaprojectUrlca adresă. Dacă adresa lipsește sau e greșită, apelațiupdate_project_address. Apoiget_install, instalați fragmentul și apelațicheck_install. Folosițicreate_workspaceșicreate_projectdoar când planul are loc (planuri plătite sau perioada de probă Studio);create_projectare nevoie de unworkspaceIddinlist_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țiorigin): atunci are sarcini, lucrări și noutăți, dar nu are widget. După instalare,get_badgedă 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, saulanguagelacreate_project). - Apoi lucrați cu comentariile:
list_comments,get_comment,replyșiset_status. Pentru noutăți, dați luilist_commentsparametrulsince: o oră UTC care se termină cuZ(de exemplu2026-10-17T08:00:00Z) saucursordin 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 noulcursorpentru următoarea verificare, urmați imediatmore: trueși eliminați dublurile dupăid: un element poate veni de două ori. - Pentru o altă organizație, apelați
create_organizationcu unname: proprietarul devine administratorul ei și primește un e-mail, iar răspunsul conține untokennou, doar pentru acea organizație. Este gratuită dacă proprietarul nu are o organizație gratuită; altfel are nevoie de un abonament: apelațiget_payment_linkcu noul token saustart_trialpentru 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. - Pentru a muta un proiect în alt spațiu de lucru (
kindproject,projectId,toWorkspaceId), sau un spațiu de lucru cu proiectele sale în altă organizație în care proprietarul este și el administrator (kindworkspace,workspaceId,toOrganizationId), apelațirequest_move. Încă nu se mută nimic: proprietarul primește un e-mail și trebuie să confirme pe pagina indicată, în 24 de ore. Apelațiget_move_requestpentru stare:pending,done,cancelled,expiredsaufailed. - Pentru a adăuga lucru care nu ține de o pagină, apelați
create_taskcu unprojectIdși untitle, și opționaltextșipageUrl. Pentru a-i schimba formularea, apelațiupdate_taskcutaskIdși untitlenou, untextnou 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_commentsarată sarcinile marcate cu[Task]și acceptătype:tasksaucomment. - 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țilist_job_reports(statereadyle listează pe cele care vă așteaptă), citiți unul cuget_commentși răspundeți curolearticleîn limba lui. Doar o persoană aprobă: dați-i linkul de aprobare sau apelațirequest_approval. După aprobare, răspundeți curolepostsșifiles(id-urile fișierelor de folosit).update_fileseteazăphasesaucaptionpentru un fișier;create_taskșiupdate_taskacceptăjobReport. - Note vocale și AI (Studio, Agency și perioada de probă):
get_commentlistează 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:ssce 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șiget_billingdau 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:
| Cod | Status HTTP | Ce înseamnă |
|---|---|---|
signup_blocked | 403 | Rețeaua nu are voie să se înregistreze. Proprietarul se înregistrează singur. |
country_blocked | 403 | Notiamo nu este disponibil în țara din care vine cererea. Nici proprietarul nu se poate înscrie de acolo. |
rate_limited | 429 | Prea multe cereri. Așteptați retryAfter secunde. |
agent_signup_paused | 503 | Înregistrarea de către agenți este suspendată deocamdată. Proprietarul se înregistrează singur. |
agent_signup_closed | 503 | Înregistrarea de către agenți este închisă. Proprietarul se înregistrează singur. |
account_exists | 409 | Acest 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_accepted | 422 | Această adresă de e-mail nu poate fi folosită. Proprietarul se înregistrează singur. |
invalid_input | 422 | Un câmp nu este valid. field îl indică. |
plan_limit | 402 | A fost atinsă o limită a planului. O returnează instrumentele MCP, cu pasul următor (start_trial sau get_payment_link). |
read_only | 403 | Această cheie sau aplicație este doar pentru citire: poate privi, dar nu poate modifica. O returnează instrumentele MCP. |
permission_missing | 403 | Această 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