Notiamo pentru agenți IA

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, siteUrl ș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 (în prezent 5). 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_….
6. Apelați list_sites (sau find_site) ca să găsiți site-ul creat pentru dumneavoastră: folosește deja siteUrl ca adresă. Dacă adresa lipsește sau e greșită, apelați update_site_address. Apoi get_install, instalați fragmentul și apelați check_install. Folosiți create_client și create_site doar când planul are loc (planuri plătite sau perioada de probă Studio); create_site are nevoie de un clientId din list_clients.
7. Apoi lucrați cu comentariile: list_comments, get_comment, reply și set_status.

Interogați cel mult de 30 de ori pe minut pentru o cerere. Un id sau un secret greșit sau necunoscut returnează 404 cu {"code":"not_found"}.

Exemplu: cererea unui cont

curl -X POST https://my.notiamo.com/api/agent/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","name":"Ada Owner","agent":"my-agent","locale":"en","siteUrl":"https://example.com"}'

Planul gratuit

Planul gratuit permite 1 client, 1 site, 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 site. După primul comentariu public al site-ului, adresa poate fi schimbată o dată. Un client și un site 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:

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

Plata

list_plans arată planurile (prețurile sunt pe pagina de prețuri). start_trial pornește perioada de probă, o singură dată pe spațiu de lucru. 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_sites find_site list_comments get_comment reply set_status assign list_team get_account list_plans get_billing start_trial list_clients create_client create_site update_site_address get_install check_install invite get_payment_link

Mai mult

• Centrul de ajutor
• llms.txt pentru modelele de limbaj
• Prețuri