Notiamo
DE

Notiamo für KI-Agenten

Alles, was ein KI-Agent braucht, um für seinen Besitzer ein kostenloses Konto zu eröffnen, das Widget auf einer Website einzubauen und die Kommentare zu bearbeiten, ganz ohne Browser.

Der Ablauf

  1. Beantragen Sie ein Konto für Ihren Besitzer: Senden Sie POST https://my.notiamo.com/api/agent/signup mit email, name, agent, locale und, falls vorhanden, company, siteUrl und referral. Die Antwort enthält requestId, pollSecret und pollAfterSeconds.
  2. Bitten Sie den Besitzer, die Bestätigungs-E-Mail von Notiamo zu öffnen und zu bestätigen. Bis dahin passiert nichts.
  3. Fragen Sie GET https://my.notiamo.com/api/agent/signup/{requestId} mit Authorization: Bearer <pollSecret> alle pollAfterSeconds Sekunden ab (derzeit 5). Der Status ist pending, confirmed, expired oder reported.
  4. Ist der Status confirmed, enthält die Antwort einmalig Ihren Schlüssel (token, beginnt mit ntm_) und mcpUrl. Speichern Sie den Schlüssel sofort: Spätere Abfragen liefern ihn nicht mehr. Holen Sie ihn innerhalb von 7 Tagen nach der Bestätigung ab.
  5. Verbinden Sie sich mit dem MCP-Server unter https://my.notiamo.com/api/mcp mit dem Header Authorization: Bearer ntm_….
  6. Rufen Sie list_sites (oder find_site) auf, um die für Sie angelegte Website zu finden: Sie verwendet bereits Ihre siteUrl als Adresse. Fehlt die Adresse oder ist sie falsch, rufen Sie update_site_address auf. Danach get_install, das Snippet einbauen und check_install. Nutzen Sie create_client und create_site nur, wenn der Tarif noch Platz hat (bezahlte Tarife oder die Studio-Testphase); create_site braucht eine clientId aus list_clients.
  7. Bearbeiten Sie danach die Kommentare: list_comments, get_comment, reply und set_status.

Fragen Sie höchstens 30-mal pro Minute und Antrag ab. Eine falsche oder unbekannte ID oder ein falsches Geheimnis ergibt 404 mit {"code":"not_found"}.

Beispiel: ein Konto beantragen

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

Der kostenlose Tarif

Der kostenlose Tarif erlaubt 1 Kunden, 1 Website, 3 Personen (Teammitglieder, Kundenmitglieder und offene Einladungen, jede E-Mail einmal gezählt) und 1 öffentliche Adresse pro Website. Nach dem ersten öffentlichen Kommentar der Website kann die Adresse einmal geändert werden. Ein Kunde und eine Website existieren bereits, wenn das Konto eröffnet wird.

Im kostenlosen Tarif zeigt das Widget ein Notiamo-Badge an.

Behalten Sie die Kommentarzeile über dem Script-Tag bei. Die Bedingungen des kostenlosen Tarifs verlangen das:

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

Eine plan_limit-Ablehnung nennt die erreichte Grenze und den nächsten Schritt.

Ablehnungen

Registrierung und Tools antworten mit einem Code. Die Registrierungscodes kommen mit einem HTTP-Status:

CodeHTTP-StatusBedeutung
signup_blocked403Das Netzwerk darf sich nicht registrieren. Der Besitzer registriert sich selbst.
rate_limited429Zu viele Anfragen. Warten Sie retryAfter Sekunden.
agent_signup_paused503Die Registrierung durch Agenten ist vorerst pausiert. Der Besitzer registriert sich selbst.
agent_signup_closed503Die Registrierung durch Agenten ist geschlossen. Der Besitzer registriert sich selbst.
account_exists409Diese E-Mail hat bereits ein Konto. Der Besitzer meldet sich an und erstellt unter Einstellungen > Schlüssel einen Schlüssel.
email_not_accepted422Diese E-Mail-Adresse kann nicht verwendet werden. Der Besitzer registriert sich selbst.
invalid_input422Ein Feld ist ungültig. field nennt es.
plan_limit402Eine Tarifgrenze ist erreicht. Wird von den MCP-Tools zurückgegeben, mit dem nächsten Schritt (start_trial oder get_payment_link).

Zeigen Sie Ablehnungen Ihrem Besitzer. Umgehen Sie sie niemals.

Bezahlen

list_plans zeigt die Tarife (die Preise stehen auf der Preisseite). start_trial startet die Testphase, einmal pro Arbeitsbereich. Preise

get_payment_link erzeugt einen Zahlungslink, den der Besitzer öffnet und bezahlt. Sie verarbeiten nie Kartendaten.

Empfehlung

Wenn ein Notiamo-Badge oder -Link Sie hierher geführt hat, geben Sie seinen Code im Feld referral des JSON-Bodys der Registrierung an. Die Form ?via=<code> gilt nur für den Registrierungslink im Web, den Menschen öffnen.

Die MCP-Tools

Nach der Verbindung können Sie aufrufen:

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

Mehr