Per gli agenti IA — configurare e usare Notiamo dal codice

Il flusso

Richieda un account per il suo proprietario: invii POST https://my.notiamo.com/api/agent/signup con email, name, agent, locale e, se li ha, company, siteUrl e referral. La risposta contiene requestId, pollSecret e pollAfterSeconds.
Chieda al proprietario di aprire l’e-mail di conferma inviata da Notiamo e di confermare. Finché non lo fa, non succede nulla.
Interroghi GET https://my.notiamo.com/api/agent/signup/{requestId} con Authorization: Bearer <pollSecret> ogni pollAfterSeconds secondi (al momento 5). Lo stato è pending, confirmed, expired o reported.
Quando lo stato è confirmed, la risposta contiene una sola volta la sua chiave (token, che inizia con ntm_) e mcpUrl. Conservi subito la chiave: le interrogazioni successive non la restituiscono più. La ritiri entro 7 giorni dalla conferma.
Si colleghi al server MCP all’indirizzo https://my.notiamo.com/api/mcp con l’intestazione Authorization: Bearer ntm_….
Chiami list_sites (o find_site) per trovare il sito creato per Lei: usa già il Suo siteUrl come indirizzo. Se l’indirizzo manca o è sbagliato, chiami update_site_address. Poi get_install, inserisca lo snippet e chiami check_install. Usi create_client e create_site solo quando il piano ha spazio (piani a pagamento o prova Studio); create_site richiede un clientId da list_clients.
Poi lavori sui commenti: list_comments, get_comment, reply e set_status.

Interroghi al massimo 30 volte al minuto per richiesta. Un id o un segreto sbagliato o sconosciuto restituisce 404 con {"code":"not_found"}.

Esempio: richiedere un account

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

Il piano gratuito

Il piano gratuito consente 1 cliente, 1 sito, 3 persone (membri del team, membri del cliente e inviti in sospeso, ogni e-mail contata una volta) e 1 indirizzo pubblico per sito. Dopo il primo commento pubblico del sito, l’indirizzo può essere cambiato una volta. Un cliente e un sito esistono già quando l’account viene aperto.

Nel piano gratuito il widget mostra un badge Notiamo.

Mantenga la riga di commento sopra il tag script. Le condizioni del piano gratuito lo richiedono:

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

Un rifiuto plan_limit indica quale limite è stato raggiunto e cosa fare dopo.

Rifiuti

La registrazione e gli strumenti rispondono con un codice. I codici della registrazione sono accompagnati da uno stato HTTP:

Codice	Stato HTTP	Significato
`signup_blocked`	403	La rete non può registrarsi. Il proprietario si registra da sé.
`rate_limited`	429	Troppe richieste. Attenda `retryAfter` secondi.
`agent_signup_paused`	503	La registrazione da parte degli agenti è sospesa per ora. Il proprietario si registra da sé.
`agent_signup_closed`	503	La registrazione da parte degli agenti è chiusa. Il proprietario si registra da sé.
`account_exists`	409	Questa e-mail ha già un account. Il proprietario accede e crea una chiave in Impostazioni > Chiavi.
`email_not_accepted`	422	Questo indirizzo e-mail non può essere usato. Il proprietario si registra da sé.
`invalid_input`	422	Un campo non è valido. `field` lo indica.
`plan_limit`	402	È stato raggiunto un limite del piano. Restituito dagli strumenti MCP, con il passo successivo (`start_trial` o `get_payment_link`).

Mostri i rifiuti al suo proprietario. Non li aggiri mai.

Pagare

list_plans mostra i piani (i prezzi sono nella pagina dei prezzi). start_trial avvia la prova, una volta per spazio di lavoro. Prezzi

get_payment_link crea un link di pagamento che il proprietario apre e paga. Lei non gestisce mai dati di carte.

Segnalazione

Se l’ha portata qui un badge o un link di Notiamo, indichi il suo codice nel campo referral del corpo JSON della registrazione. La forma ?via=<code> serve solo per il link di registrazione web che le persone aprono.

Gli strumenti MCP

Dopo il collegamento può chiamare:

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

Notiamo per gli agenti IA