Notiamo

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

  1. 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, projectUrl (l’adresse du site web) et referral. La réponse contient requestId, pollSecret et pollAfterSeconds.
  2. 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.
  3. Interrogez GET https://my.notiamo.com/api/agent/signup/{requestId} avec Authorization: Bearer <pollSecret> toutes les pollAfterSeconds secondes. Le statut est pending, confirmed, expired ou reported.
  4. 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.
  5. Connectez-vous au serveur MCP à l’adresse https://my.notiamo.com/api/mcp avec l’en-tête Authorization: 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).
  6. Appelez list_projects (ou find_project) pour trouver le projet créé pour vous : il utilise déjà votre projectUrl comme adresse. Si l’adresse est absente ou fausse, appelez update_project_address. Puis get_install, installez l’extrait et appelez check_install. N’utilisez create_workspace et create_project que si la formule a de la place (formules payantes ou essai Studio) ; create_project demande un workspaceId obtenu avec list_workspaces. Un espace de travail regroupe des projets, par exemple un par client. Un projet peut n’avoir aucune adresse web (omettez origin) : il a alors des tâches, des réalisations et des actualités, mais pas de widget. Après l’installation, get_badge donne 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, ou language dans create_project).
  7. Traitez ensuite les commentaires : list_comments, get_comment, reply et set_status. Pour voir les nouveautés, passez since à list_comments : une heure UTC terminée par Z (par exemple 2026-10-17T08:00:00Z), ou le cursor de sa dernière réponse. Vous ne recevez que ce qui a changé, sur un projet ou, sans projectId, sur tous vos projets. Gardez le nouveau cursor pour la prochaine vérification, suivez more: true tout de suite et dédoublonnez par id : un élément peut revenir deux fois.
  8. Pour une autre organisation, appelez create_organization avec un name : le propriétaire en devient l’administrateur et reçoit un e-mail, et la réponse contient un nouveau token pour cette organisation uniquement. Elle est gratuite si le propriétaire n’a pas d’organisation gratuite, sinon elle nécessite une formule : appelez get_payment_link avec le nouveau token, ou start_trial pour 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.
  9. Pour déplacer un projet vers un autre espace de travail (kind project, projectId, toWorkspaceId), ou un espace de travail et ses projets vers une autre organisation dont le propriétaire est aussi admin (kind workspace, workspaceId, toOrganizationId), appelez request_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. Appelez get_move_request pour le statut : pending, done, cancelled, expired ou failed.
  10. Pour ajouter un travail qui ne concerne pas une page, appelez create_task avec un projectId et un title, et en option text et pageUrl. Pour changer sa formulation, appelez update_task avec le taskId et un nouveau title, un nouveau text ou 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_comments affiche les tâches marquées [Task] et accepte type : task ou comment.
  11. 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. Appelez list_job_reports (state ready liste ceux qui vous attendent), lisez-en un avec get_comment, et répondez avec role article dans sa langue. Seule une personne valide : donnez-lui le lien de validation ou appelez request_approval. Une fois l’article validé, répondez avec role posts et files (les identifiants des fichiers à utiliser). update_file change la phase ou la caption d’un fichier ; create_task et update_task acceptent jobReport.
  12. Notes vocales et IA (Studio, Agency et l’essai) : get_comment liste 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:ss ce 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_plans et get_billing donnent 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 :

CodeStatut HTTPSignification
signup_blocked403Le réseau n’est pas autorisé à s’inscrire. Le propriétaire s’inscrit lui-même.
country_blocked403Notiamo 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_limited429Trop de requêtes. Attendez retryAfter secondes.
agent_signup_paused503L’inscription par des agents est suspendue pour le moment. Le propriétaire s’inscrit lui-même.
agent_signup_closed503L’inscription par des agents est fermée. Le propriétaire s’inscrit lui-même.
account_exists409Cet 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_accepted422Cette adresse e-mail ne peut pas être utilisée. Le propriétaire s’inscrit lui-même.
invalid_input422Un champ n’est pas valide. field le nomme.
plan_limit402Une limite de la formule est atteinte. Renvoyé par les outils MCP, avec la suite à donner (start_trial ou get_payment_link).
read_only403Cette clé ou application est en lecture seule : elle peut regarder mais pas modifier. Renvoyé par les outils MCP.
permission_missing403Cette 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

Pour aller plus loin