Pour les agents IA — configurer et utiliser Notiamo depuis le code

Le déroulement

Demandez un compte pour votre propriétaire : envoyez POST https://my.notiamo.com/api/agent/signup avec email, name, agent, locale et, si vous les avez, company, siteUrl et referral. La réponse contient requestId, pollSecret et pollAfterSeconds.
Demandez au propriétaire d’ouvrir l’e-mail de confirmation envoyé par Notiamo et de confirmer. Rien ne se passe tant qu’il ne l’a pas fait.
Interrogez GET https://my.notiamo.com/api/agent/signup/{requestId} avec Authorization: Bearer <pollSecret> toutes les pollAfterSeconds secondes (5 actuellement). Le statut est pending, confirmed, expired ou reported.
Quand le statut est confirmed, la réponse contient votre clé (token, commençant par ntm_) et mcpUrl, une seule fois. Conservez la clé immédiatement : les interrogations suivantes ne la renvoient plus. Récupérez-la dans les 7 jours suivant la confirmation.
Connectez-vous au serveur MCP à l’adresse https://my.notiamo.com/api/mcp avec l’en-tête Authorization: Bearer ntm_….
Appelez list_sites (ou find_site) pour trouver le site créé pour vous : il utilise déjà votre siteUrl comme adresse. Si l’adresse est absente ou fausse, appelez update_site_address. Puis get_install, installez l’extrait et appelez check_install. N’utilisez create_client et create_site que si la formule a de la place (formules payantes ou essai Studio) ; create_site demande un clientId obtenu avec list_clients.
Traitez ensuite les commentaires : list_comments, get_comment, reply et set_status.

Interrogez au plus 30 fois par minute pour une même demande. Un identifiant ou un secret faux ou inconnu renvoie 404 avec {"code":"not_found"}.

Exemple : demander un compte

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

La formule gratuite

La formule gratuite autorise 1 client, 1 site, 3 personnes (membres de l’équipe, membres du client et invitations en attente, chaque e-mail compté une fois) et 1 adresse publique par site. Après le premier commentaire public du site, l’adresse peut être changée une fois. Un client et un site existent déjà à l’ouverture du compte.

Sur la formule gratuite, le widget affiche un badge Notiamo.

Gardez la ligne de commentaire au-dessus de la balise script. Les conditions de la formule gratuite l’exigent :

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

Un refus plan_limit indique quelle limite est atteinte et quoi faire ensuite.

Refus

L’inscription et les outils répondent par un code. Les codes d’inscription sont accompagnés d’un statut HTTP :

Code	Statut HTTP	Signification
`signup_blocked`	403	Le réseau n’est pas autorisé à s’inscrire. Le propriétaire s’inscrit lui-même.
`rate_limited`	429	Trop de requêtes. Attendez `retryAfter` secondes.
`agent_signup_paused`	503	L’inscription par des agents est suspendue pour le moment. Le propriétaire s’inscrit lui-même.
`agent_signup_closed`	503	L’inscription par des agents est fermée. Le propriétaire s’inscrit lui-même.
`account_exists`	409	Cet e-mail a déjà un compte. Le propriétaire se connecte et crée une clé dans Paramètres > Clés.
`email_not_accepted`	422	Cette adresse e-mail ne peut pas être utilisée. Le propriétaire s’inscrit lui-même.
`invalid_input`	422	Un champ n’est pas valide. `field` le nomme.
`plan_limit`	402	Une limite de la formule est atteinte. Renvoyé par les outils MCP, avec la suite à donner (`start_trial` ou `get_payment_link`).

Montrez les refus à votre propriétaire. Ne les contournez jamais.

Payer

list_plans affiche les formules (les prix figurent sur la page des tarifs). start_trial lance l’essai, une fois par espace de travail. Tarifs

get_payment_link crée un lien de paiement que le propriétaire ouvre et règle. Vous ne manipulez jamais de données de carte.

Parrainage

Si un badge ou un lien Notiamo vous a amené ici, transmettez son code dans le champ referral du corps JSON de l’inscription. La forme ?via=<code> ne concerne que le lien d’inscription web que les personnes ouvrent.

Les outils MCP

Une fois connecté, vous pouvez appeler :

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 pour les agents IA