Notiamo

Notiamo para agentes de IA

Todo lo que un agente de IA necesita para abrir una cuenta gratuita para su propietario, poner el widget en un sitio y atender los comentarios, sin navegador.

El flujo

  1. Solicite una cuenta para su propietario: envíe POST https://my.notiamo.com/api/agent/signup con email, name, agent, locale y, si los tiene, company, siteUrl y referral. La respuesta incluye requestId, pollSecret y pollAfterSeconds.
  2. Pida al propietario que abra el correo de confirmación que envía Notiamo y que confirme. No ocurre nada hasta que lo haga.
  3. Consulte GET https://my.notiamo.com/api/agent/signup/{requestId} con Authorization: Bearer <pollSecret> cada pollAfterSeconds segundos (5 por ahora). El estado es pending, confirmed, expired o reported.
  4. Cuando el estado es confirmed, la respuesta incluye una sola vez su clave (token, que empieza por ntm_) y mcpUrl. Guarde la clave de inmediato: las consultas posteriores ya no la devuelven. Recójala en los 7 días siguientes a la confirmación.
  5. Conéctese al servidor MCP en https://my.notiamo.com/api/mcp con la cabecera Authorization: Bearer ntm_….
  6. Llame a list_sites (o find_site) para encontrar el sitio creado para usted: ya usa su siteUrl como dirección. Si la dirección falta o es incorrecta, llame a update_site_address. Después get_install, instale el fragmento y llame a check_install. Use create_client y create_site solo cuando el plan tenga espacio (planes de pago o la prueba de Studio); create_site necesita un clientId de list_clients.
  7. Después trabaje con los comentarios: list_comments, get_comment, reply y set_status.

Consulte como máximo 30 veces por minuto por solicitud. Un id o secreto incorrecto o desconocido devuelve 404 con {"code":"not_found"}.

Ejemplo: solicitar una cuenta

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

El plan gratuito

El plan gratuito permite 1 cliente, 1 sitio, 3 personas (miembros del equipo, miembros del cliente e invitaciones pendientes, cada correo contado una vez) y 1 dirección pública por sitio. Tras el primer comentario público del sitio, la dirección se puede cambiar una vez. Un cliente y un sitio ya existen cuando se abre la cuenta.

En el plan gratuito, el widget muestra una insignia de Notiamo.

Conserve la línea de comentario encima de la etiqueta script. Las condiciones del plan gratuito lo exigen:

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

Un rechazo plan_limit indica qué límite se alcanzó y qué hacer a continuación.

Rechazos

El registro y las herramientas responden con un código. Los códigos del registro llevan un estado HTTP:

CódigoEstado HTTPQué significa
signup_blocked403La red no puede registrarse. El propietario se registra por sí mismo.
rate_limited429Demasiadas solicitudes. Espere retryAfter segundos.
agent_signup_paused503El registro por agentes está en pausa por ahora. El propietario se registra por sí mismo.
agent_signup_closed503El registro por agentes está cerrado. El propietario se registra por sí mismo.
account_exists409Este correo ya tiene una cuenta. El propietario inicia sesión y crea una clave en Ajustes > Claves.
email_not_accepted422Esta dirección de correo no se puede usar. El propietario se registra por sí mismo.
invalid_input422Un campo no es válido. field lo nombra.
plan_limit402Se alcanzó un límite del plan. Lo devuelven las herramientas MCP, con el siguiente paso (start_trial o get_payment_link).

Muestre los rechazos a su propietario. No los eluda nunca.

Pagar

list_plans muestra los planes (los precios están en la página de precios). start_trial inicia la prueba, una vez por espacio de trabajo. Precios

get_payment_link crea un enlace de pago que el propietario abre y paga. Usted nunca maneja datos de tarjeta.

Recomendación

Si una insignia o un enlace de Notiamo le trajo aquí, indique su código en el campo referral del cuerpo JSON del registro. La forma ?via=<code> es solo para el enlace de registro web que abren las personas.

Las herramientas MCP

Una vez conectado, puede llamar a:

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

Más