Notiamo

Notiamo voor AI-agents

Alles wat een AI-agent nodig heeft om een gratis account voor zijn eigenaar te openen, de widget op een website te zetten en de reacties en het werk af te handelen, zonder browser.

De werkwijze

  1. Vraag een account aan voor je eigenaar: stuur POST https://my.notiamo.com/api/agent/signup met email, name, agent, locale en, als je ze hebt, company, projectUrl (het adres van de website) en referral. Het antwoord bevat requestId, pollSecret en pollAfterSeconds.
  2. Vraag de eigenaar de bevestigingsmail te openen die Notiamo stuurt en te bevestigen. Er gebeurt niets totdat hij dat doet.
  3. Vraag GET https://my.notiamo.com/api/agent/signup/{requestId} op met Authorization: Bearer <pollSecret> elke pollAfterSeconds seconden. De status is pending, confirmed, expired of reported.
  4. Als de status confirmed is, bevat het antwoord eenmalig je sleutel (token, beginnend met ntm_) en mcpUrl. Bewaar de sleutel meteen: latere verzoeken geven hem niet meer terug. Haal hem binnen 7 dagen na de bevestiging op.
  5. Maak verbinding met de MCP-server op https://my.notiamo.com/api/mcp met de header Authorization: Bearer ntm_…. Ondersteunt je app MCP-inloggen, dan kan hij in plaats van een sleutel Inloggen met Notiamo gebruiken (zie hieronder).
  6. Roep list_projects (of find_project) aan om het project te vinden dat voor je is gemaakt: het gebruikt je projectUrl al als adres. Ontbreekt het adres of klopt het niet, roep dan update_project_address aan. Daarna get_install, installeer het snippet en check_install. Gebruik create_workspace en create_project alleen als het abonnement ruimte heeft (betaalde abonnementen of de Studio-proefperiode); create_project heeft een workspaceId uit list_workspaces nodig. Een werkruimte groepeert projecten, bijvoorbeeld één per klant. Een project mag geen webadres hebben (laat origin weg): dan heeft het taken, werk en nieuws, maar geen widget. Na de installatie geeft get_badge de footerbadge: een klein Notiamo-logo voor de footer van de site, dat voor reviewers de reviewtools opent en voor alle anderen een gewone link naar Notiamo is, in de taal van de site (update_project_language, of language bij create_project).
  7. Werk daarna aan de reacties: list_comments, get_comment, reply en set_status. Om op nieuws te controleren geef je since mee aan list_comments: een UTC-tijd die op Z eindigt (zoals 2026-10-17T08:00:00Z), of de cursor uit het laatste antwoord. Je krijgt alleen wat er veranderd is, voor één project of, zonder projectId, voor al je projecten. Bewaar de nieuwe cursor voor de volgende controle, volg more: true meteen en ontdubbel op id: een item kan twee keer komen.
  8. Voor een andere organisatie roep je create_organization aan met een name: de eigenaar wordt de beheerder en krijgt een e-mail, en het antwoord bevat een nieuw token voor alleen die organisatie. Ze is gratis als de eigenaar geen gratis organisatie heeft, anders is een abonnement nodig: roep get_payment_link aan met het nieuwe token, of start_trial voor de Studio-proefperiode van 14 dagen (één keer per persoon; de eigenaar opent de link en voert een kaart in). Er is een daglimiet; de weigering zegt wanneer je het opnieuw kunt proberen.
  9. Om een project naar een andere werkruimte te verplaatsen (kind project, projectId, toWorkspaceId), of een werkruimte met haar projecten naar een andere organisatie waar de eigenaar ook beheerder is (kind workspace, workspaceId, toOrganizationId), roep je request_move aan. Er verplaatst nog niets: de eigenaar krijgt een e-mail en moet binnen 24 uur bevestigen op de pagina waarnaar die linkt. Roep get_move_request aan voor de status: pending, done, cancelled, expired of failed.
  10. Om werk toe te voegen dat niet aan een pagina is gebonden, roep je create_task aan met een projectId en een title, en eventueel text en pageUrl. Om de tekst te wijzigen, roep je update_task aan met de taskId en een nieuwe title, text of beide. Beide tellen mee voor een dagelijkse limiet op nieuwe werkruimtes, projecten en taken; de weigering vertelt je wanneer je die bereikt. list_comments toont taken met de markering [Task] en neemt type: task of comment.
  11. Jobrapporten (Studio, Agency en de proefperiode) zijn taken die een klant invult over een afgeronde klus: plaats, datum, eindklant en bestanden per fase (before, during, after, other) met bijschriften. Roep list_job_reports aan (state ready toont de rapporten die op je wachten), lees er een met get_comment en antwoord met role article in zijn taal. Alleen een mens keurt goed: geef hem de goedkeuringslink of roep request_approval aan. Antwoord na goedkeuring met role posts en files (de id's van de te gebruiken bestanden). update_file stelt de phase of caption van een bestand in; create_task en update_task nemen jobReport.
  12. Spraaknotities en AI (Studio, Agency en de proefperiode): get_comment toont elke opname met een link naar de audio en de transcriptie door AI (en elke latere transcriptie, niet geplaatst), elke video van meer dan ongeveer 20 seconden met tijdnotities (m:ss–m:ss wat er gebeurt), en AI-bijschriften gemarkeerd met (AI, not checked) totdat een mens ze controleert. Kon AI een bestand niet verwerken, dan zegt het dat in dezelfde duidelijke woorden die mensen zien, met een referentiecode (AI-…) voor support. list_plans en get_billing geven de spraak- en AI-minuten per maand.

Vraag niet vaker op dan pollAfterSeconds. Krijg je rate_limited, wacht dan retryAfter seconden. Een onjuiste of onbekende id of geheim geeft 404 met {"code":"not_found"}.

Als je platform zijn verzoeken ondertekent met Web Bot Auth (HTTP-berichthandtekeningen, een Signature-Agent met een sleutelmap) en Notiamo het vertrouwt, tellen aanmelden en de MCP-server je per platform in plaats van per adres, met hogere limieten. Niet-ondertekende verzoeken werken zoals eerst.

Voorbeeld: een account aanvragen

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

Het gratis abonnement

Het gratis abonnement staat 1 werkruimte, 1 project, 3 mensen (teamleden, klantleden en openstaande uitnodigingen, elk e-mailadres één keer) en 1 openbaar adres per project toe. Na de eerste openbare reactie op het project kan het adres één keer worden gewijzigd. Het bevat 100 MB aan bestanden, 5 MB per bestand; boven 100 MB krijgen de beheerders van de organisatie twee e-mails, daarna worden de oudste bestanden verwijderd, en reacties, taken en antwoorden blijven staan. Uploads kunnen worden geweigerd om misbruik te voorkomen. Video zit er niet bij: daarvoor is Studio, Agency of de proefperiode nodig. Een werkruimte en een project bestaan al wanneer het account wordt geopend.

De widget toont in het gratis abonnement een Notiamo-badge.

Laat de commentaarregel boven de script-tag staan. De voorwaarden van het gratis abonnement eisen dat:

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

Een weigering met plan_limit vertelt je welke limiet je hebt bereikt en wat je daarna moet doen.

Weigeringen

Aanmelden en de tools antwoorden met een code. De codes bij het aanmelden komen met een HTTP-status:

CodeHTTP-statusWat het betekent
signup_blocked403Het netwerk mag zich niet aanmelden. De eigenaar meldt zich zelf aan.
country_blocked403Notiamo is niet beschikbaar in het land waar het verzoek vandaan komt. De eigenaar kan zich daar ook niet aanmelden.
rate_limited429Te veel verzoeken. Wacht retryAfter seconden.
agent_signup_paused503Aanmelden door agents is voorlopig gepauzeerd. De eigenaar meldt zich zelf aan.
agent_signup_closed503Aanmelden door agents is gesloten. De eigenaar meldt zich zelf aan.
account_exists409Dit e-mailadres heeft al een account. De eigenaar logt in en maakt een sleutel aan bij Instellingen > AI-agents > Agenttokens.
email_not_accepted422Dit e-mailadres kan niet worden gebruikt. De eigenaar meldt zich zelf aan.
invalid_input422Een veld is niet geldig. field noemt het.
plan_limit402Een abonnementslimiet is bereikt. Teruggegeven door de MCP-tools, met de volgende stap (start_trial of get_payment_link).
read_only403Deze sleutel of app is alleen-lezen: hij kan kijken maar niet wijzigen. Teruggegeven door de MCP-tools.
permission_missing403Deze sleutel of app mag dit niet doen. permission noemt de ontbrekende groep (of full). Teruggegeven door de MCP-tools.

Toon weigeringen aan je eigenaar. Omzeil ze nooit.

Inloggen met Notiamo (OAuth)

In plaats van een sleutel kan een MCP-client die inloggen ondersteunt verbinden met OAuth. De metadata van de autorisatieserver staat op https://my.notiamo.com/.well-known/oauth-authorization-server, en de MCP-server antwoordt met 401 en een WWW-Authenticate-header die naar de metadata van zijn beschermde bron wijst (https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp, RFC 9728), die deze server noemt, en stelt de scope notes replies status tasks voor. Clients registreren zichzelf en gebruiken PKCE (S256), zonder client secret.

Je eigenaar logt in, kiest de organisatie, wat je mag wijzigen (Aan feedback werken is aangevinkt) en de projecten, en klikt op Toestaan. De scopes zijn de rechtengroepen hieronder. Je eigenaar ziet de app bij Instellingen > AI-agents > Gekoppelde apps en kan hem op elk moment loskoppelen.

Rechten

Lezen vraagt geen recht. Om iets te wijzigen heeft een sleutel of gekoppelde app de bijbehorende groep nodig:

notes replies status tasks setup invites billing moves

Alleen-lezen heeft geen groep. Aan feedback werken heeft notes, replies, status en tasks. Volledig heeft ze allemaal; teamleden uitnodigen vraagt Volledig. Zonder de groep weigert de tool met permission_missing en noemt de groep in permission; een alleen-lezen sleutel krijgt read_only. Toon het aan je eigenaar: alleen hij kan meer toegang geven.

Betalen

list_plans toont de abonnementen (zie de prijzenpagina voor de prijzen). start_trial start de proefperiode, één keer per persoon. Prijzen

get_payment_link maakt een betaallink die de eigenaar opent en waarmee hij betaalt. Je krijgt nooit kaartgegevens te zien.

Verwijzing

Als een Notiamo-badge of -link je hier bracht, geef dan de code ervan mee in het veld referral van de JSON-body van de aanmelding. De vorm ?via=<code> is alleen voor de aanmeldlink die mensen openen.

De MCP-tools

Na het verbinden kun je aanroepen:

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

Meer