Notiamo pour les agents IA
Tout ce dont un agent IA a besoin pour ouvrir un compte gratuit pour son propriétaire, poser le widget sur un site web et traiter les commentaires et le travail, sans navigateur.
Le déroulement
- Demandez un compte pour votre propriétaire : envoyez
POST https://my.notiamo.com/api/agent/signupavecemail,name,agent,localeet, si vous les avez,company,projectUrl(l’adresse du site web) etreferral. La réponse contientrequestId,pollSecretetpollAfterSeconds. - 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}avecAuthorization: Bearer <pollSecret>toutes lespollAfterSecondssecondes. Le statut estpending,confirmed,expiredoureported. - Quand le statut est
confirmed, la réponse contient votre clé (token, commençant parntm_) etmcpUrl, 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/mcpavec l’en-têteAuthorization: Bearer ntm_…. Si votre application gère la connexion MCP, elle peut utiliser « Se connecter avec Notiamo » au lieu d’une clé (voir plus bas). - Appelez
list_projects(oufind_project) pour trouver le projet créé pour vous : il utilise déjà votreprojectUrlcomme adresse. Si l’adresse est absente ou fausse, appelezupdate_project_address. Puisget_install, installez l’extrait et appelezcheck_install. N’utilisezcreate_workspaceetcreate_projectque si la formule a de la place (formules payantes ou essai Studio) ;create_projectdemande unworkspaceIdobtenu aveclist_workspaces. Un espace de travail regroupe des projets, par exemple un par client. Un projet peut n’avoir aucune adresse web (omettezorigin) : il a alors des tâches, des réalisations et des actualités, mais pas de widget. Après l’installation,get_badgedonne le badge de pied de page : un petit logo Notiamo pour le pied de page du site, qui ouvre les outils de relecture pour les relecteurs et reste un simple lien vers Notiamo pour les autres, dans la langue du site (update_project_language, oulanguagedanscreate_project). - Traitez ensuite les commentaires :
list_comments,get_comment,replyetset_status. Pour voir les nouveautés, passezsinceàlist_comments: une heure UTC terminée parZ(par exemple2026-10-17T08:00:00Z), ou lecursorde sa dernière réponse. Vous ne recevez que ce qui a changé, sur un projet ou, sansprojectId, sur tous vos projets. Gardez le nouveaucursorpour la prochaine vérification, suivezmore: truetout de suite et dédoublonnez parid: un élément peut revenir deux fois. - Pour une autre organisation, appelez
create_organizationavec unname: le propriétaire en devient l’administrateur et reçoit un e-mail, et la réponse contient un nouveautokenpour cette organisation uniquement. Elle est gratuite si le propriétaire n’a pas d’organisation gratuite, sinon elle nécessite une formule : appelezget_payment_linkavec le nouveau token, oustart_trialpour l’essai Studio de 14 jours (une fois par personne ; le propriétaire ouvre le lien et saisit une carte). Il y a une limite quotidienne ; le refus indique quand vous pouvez réessayer. - Pour déplacer un projet vers un autre espace de travail (
kindproject,projectId,toWorkspaceId), ou un espace de travail et ses projets vers une autre organisation dont le propriétaire est aussi admin (kindworkspace,workspaceId,toOrganizationId), appelezrequest_move. Rien n’est encore déplacé : le propriétaire reçoit un e-mail et doit confirmer sur la page vers laquelle il renvoie, dans les 24 heures. Appelezget_move_requestpour le statut :pending,done,cancelled,expiredoufailed. - Pour ajouter un travail qui ne concerne pas une page, appelez
create_taskavec unprojectIdet untitle, et en optiontextetpageUrl. Pour changer sa formulation, appelezupdate_taskavec letaskIdet un nouveautitle, un nouveautextou les deux. Les deux comptent dans une limite quotidienne de nouveaux espaces de travail, projets et tâches ; le refus vous indique quand elle est atteinte.list_commentsaffiche les tâches marquées[Task]et acceptetype:taskoucomment. - Les rapports de chantier (Studio, Agency et l’essai) sont des tâches qu’un client remplit sur un chantier terminé : lieu, date, client final et fichiers par phase (
before,during,after,other) avec des légendes. Appelezlist_job_reports(statereadyliste ceux qui vous attendent), lisez-en un avecget_comment, et répondez avecrolearticledans sa langue. Seule une personne valide : donnez-lui le lien de validation ou appelezrequest_approval. Une fois l’article validé, répondez avecrolepostsetfiles(les identifiants des fichiers à utiliser).update_filechange laphaseou lacaptiond’un fichier ;create_tasketupdate_taskacceptentjobReport. - Notes vocales et IA (Studio, Agency et l’essai) :
get_commentliste chaque enregistrement avec un lien vers l’audio et sa transcription par l’IA (et toute transcription ultérieure, non publiée), chaque vidéo de plus de 20 secondes environ avec ses repères dans la vidéo (m:ss–m:ssce qui se passe), et les légendes IA marquées(AI, not checked)tant qu’une personne ne les a pas vérifiées. Quand l’IA n’a pas pu traiter un fichier, il le dit avec les mêmes mots simples que voient les personnes, avec un code de référence (AI-…) pour le support.list_plansetget_billingdonnent les minutes de voix et d’IA par mois.
N’interrogez pas plus souvent que toutes les pollAfterSeconds secondes. Si vous recevez rate_limited, attendez retryAfter secondes. Un identifiant ou un secret faux ou inconnu renvoie 404 avec {"code":"not_found"}.
Si votre plateforme signe ses requêtes avec Web Bot Auth (signatures de messages HTTP, un Signature-Agent avec un répertoire de clés) et que Notiamo lui fait confiance, l’inscription et le serveur MCP vous comptent par plateforme et non par adresse, avec des limites plus hautes. Les requêtes non signées marchent comme avant.
Exemple : demander un compte
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"}'La formule gratuite
La formule gratuite autorise 1 espace de travail, 1 projet, 3 personnes (membres de l’équipe, membres du client et invitations en attente, chaque e-mail compté une fois) et 1 adresse publique par projet. Après le premier commentaire public du projet, l’adresse peut être changée une fois. Elle contient 100 Mo de fichiers, 5 Mo par fichier ; au-delà de 100 Mo, les administrateurs de l’organisation reçoivent deux e-mails, puis les fichiers les plus anciens sont supprimés, et les commentaires, tâches et réponses restent. Des envois peuvent être refusés pour lutter contre les abus. La vidéo n’est pas incluse : elle demande Studio, Agency ou l’essai. Un espace de travail et un projet 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. |
country_blocked | 403 | Notiamo n’est pas disponible dans le pays d’où vient la demande. Le propriétaire ne peut pas non plus s’inscrire depuis ce pays. |
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 > Agents IA > Jetons d’agent. |
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). |
read_only | 403 | Cette clé ou application est en lecture seule : elle peut regarder mais pas modifier. Renvoyé par les outils MCP. |
permission_missing | 403 | Cette clé ou application n’a pas le droit de faire cela. permission nomme le groupe manquant (ou full). Renvoyé par les outils MCP. |
Montrez les refus à votre propriétaire. Ne les contournez jamais.
Se connecter avec Notiamo (OAuth)
Au lieu d’une clé, un client MCP qui gère la connexion peut se connecter avec OAuth. Les métadonnées du serveur d’autorisation sont à l’adresse https://my.notiamo.com/.well-known/oauth-authorization-server, et le serveur MCP répond 401 avec un en-tête WWW-Authenticate qui renvoie aux métadonnées de sa ressource protégée (https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp, RFC 9728) ; celles-ci nomment ce serveur. L’en-tête propose le scope notes replies status tasks. Les clients s’enregistrent eux-mêmes et utilisent PKCE (S256), sans secret client.
Votre propriétaire se connecte, choisit l’organisation, ce que vous pouvez modifier (Travail sur les retours est coché) et les projets, puis clique sur Autoriser. Les scopes sont les groupes de permissions ci-dessous. Votre propriétaire voit l’application dans Paramètres > Agents IA > Applications connectées et peut la déconnecter à tout moment.
Permissions
Lire ne demande aucune permission. Pour modifier quelque chose, une clé ou une application connectée a besoin du groupe correspondant :
notes replies status tasks setup invites billing moves
Lecture seule n’a aucun groupe. Travail sur les retours a notes, replies, status et tasks. Complet les a tous ; inviter des membres de l’équipe demande Complet. Sans le groupe, l’outil refuse avec permission_missing et nomme le groupe dans permission ; une clé en lecture seule reçoit read_only. Montrez-le à votre propriétaire : lui seul peut donner plus d’accès.
Payer
list_plans affiche les formules (les prix figurent sur la page des tarifs). start_trial lance l’essai, une fois par personne. 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_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