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 web y atender los comentarios y el trabajo, 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, projectUrl (la dirección del sitio web) 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. 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_…. Si su aplicación admite el inicio de sesión MCP, puede usar «Iniciar sesión con Notiamo» en lugar de una clave (vea más abajo).
  6. Llame a list_projects (o find_project) para encontrar el proyecto creado para usted: ya usa su projectUrl como dirección. Si la dirección falta o es incorrecta, llame a update_project_address. Después get_install, instale el fragmento y llame a check_install. Use create_workspace y create_project solo cuando el plan tenga espacio (planes de pago o la prueba de Studio); create_project necesita un workspaceId de list_workspaces. Un espacio de trabajo agrupa proyectos, por ejemplo uno por cliente. Un proyecto puede no tener dirección web (omita origin): entonces tiene tareas, trabajos y noticias, pero no widget. Tras la instalación, get_badge da la insignia del pie de página: un pequeño logo de Notiamo para el pie del sitio que abre las herramientas de revisión a quienes revisan y es un simple enlace a Notiamo para los demás, en el idioma del sitio (update_project_language, o language en create_project).
  7. Después trabaje con los comentarios: list_comments, get_comment, reply y set_status. Para ver novedades, pase since a list_comments: una hora UTC terminada en Z (como 2026-10-17T08:00:00Z) o el cursor de su última respuesta. Recibe solo lo que cambió, en un proyecto o, sin projectId, en todos sus proyectos. Guarde el nuevo cursor para la próxima consulta, siga more: true enseguida y elimine duplicados por id: un elemento puede llegar dos veces.
  8. Para otra organización, llame a create_organization con un name: el propietario pasa a ser su administrador y recibe un correo, y la respuesta contiene un nuevo token solo para esa organización. Es gratuita si el propietario no tiene una organización gratuita; si no, necesita un plan: llame a get_payment_link con el nuevo token, o a start_trial para la prueba de Studio de 14 días (una vez por persona; el propietario abre el enlace e introduce una tarjeta). Hay un límite diario; el rechazo indica cuándo puede volver a intentarlo.
  9. Para trasladar un proyecto a otro espacio de trabajo (kind project, projectId, toWorkspaceId), o un espacio de trabajo con sus proyectos a otra organización donde el propietario también es administrador (kind workspace, workspaceId, toOrganizationId), llame a request_move. Todavía no se traslada nada: el propietario recibe un correo y debe confirmar en la página a la que enlaza, en un plazo de 24 horas. Llame a get_move_request para ver el estado: pending, done, cancelled, expired o failed.
  10. Para añadir trabajo que no depende de una página, llame a create_task con un projectId y un title, y opcionalmente text y pageUrl. Para cambiar su redacción, llame a update_task con el taskId y un nuevo title, text o ambos. Ambas cuentan para un límite diario de espacios de trabajo, proyectos y tareas nuevos; la negativa le indica cuándo lo alcanza. list_comments muestra las tareas marcadas con [Task] y acepta type: task o comment.
  11. Los informes de trabajo (Studio, Agency y la prueba) son tareas que un cliente rellena sobre un trabajo terminado: lugar, fecha, cliente final y archivos por fase (before, during, after, other) con pies de foto. Llame a list_job_reports (state ready lista los que le esperan), lea uno con get_comment y responda con role article en su idioma. Solo una persona aprueba: dele el enlace de aprobación o llame a request_approval. Tras la aprobación, responda con role posts y files (los id de los archivos que se usarán). update_file cambia la phase o la caption de un archivo; create_task y update_task aceptan jobReport.
  12. Notas de voz e IA (Studio, Agency y la prueba): get_comment lista cada grabación con un enlace al audio y su transcripción por la IA (y cualquier transcripción posterior, no publicada), cada vídeo de más de unos 20 segundos con sus momentos del vídeo (m:ss–m:ss lo que ocurre), y las descripciones de IA marcadas (AI, not checked) hasta que una persona las revisa. Cuando la IA no pudo procesar un archivo, lo dice con las mismas palabras sencillas que ven las personas, con un código de referencia (AI-…) para soporte. list_plans y get_billing dan los minutos de voz e IA al mes.

No consulte más a menudo que cada pollAfterSeconds segundos. Si recibe rate_limited, espere retryAfter segundos. Un id o secreto incorrecto o desconocido devuelve 404 con {"code":"not_found"}.

Si tu plataforma firma sus solicitudes con Web Bot Auth (firmas de mensajes HTTP, un Signature-Agent con un directorio de claves) y Notiamo confía en ella, el registro y el servidor MCP te cuentan por plataforma y no por dirección, con límites más altos. Las solicitudes sin firma funcionan como antes.

Ejemplo: solicitar una cuenta

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

El plan gratuito

El plan gratuito permite 1 espacio de trabajo, 1 proyecto, 3 personas (miembros del equipo, miembros del cliente e invitaciones pendientes, cada correo contado una vez) y 1 dirección pública por proyecto. Tras el primer comentario público del proyecto, la dirección se puede cambiar una vez. Admite 100 MB de archivos, 5 MB por archivo; por encima de 100 MB, los administradores de la organización reciben dos correos y después se eliminan los archivos más antiguos; los comentarios, las tareas y las respuestas se conservan. Pueden rechazarse subidas para evitar abusos. El vídeo no está incluido: requiere Studio, Agency o la prueba. Un espacio de trabajo y un proyecto 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.
country_blocked403Notiamo no está disponible en el país del que viene la solicitud. El propietario tampoco puede registrarse desde allí.
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 > Agentes de IA > Tokens de agente.
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).
read_only403Esta clave o aplicación es de solo lectura: puede mirar, pero no cambiar. Lo devuelven las herramientas MCP.
permission_missing403Esta clave o aplicación no puede hacer esto. permission nombra el grupo que falta (o full). Lo devuelven las herramientas MCP.

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

Iniciar sesión con Notiamo (OAuth)

En lugar de una clave, un cliente MCP que admite el inicio de sesión puede conectarse con OAuth. Los metadatos del servidor de autorización están en https://my.notiamo.com/.well-known/oauth-authorization-server, y el servidor MCP responde 401 con una cabecera WWW-Authenticate que apunta a los metadatos de su recurso protegido (https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp, RFC 9728), que nombran este servidor. La cabecera sugiere el scope notes replies status tasks. Los clientes se registran solos y usan PKCE (S256), sin secreto de cliente.

Su propietario inicia sesión, elige la organización, qué puede cambiar usted (Trabajar con comentarios está marcado) y los proyectos, y pulsa Permitir. Los scopes son los grupos de permisos de abajo. Su propietario ve la aplicación en Ajustes > Agentes de IA > Aplicaciones conectadas y puede desconectarla en cualquier momento.

Permisos

Leer no necesita permiso. Para cambiar algo, una clave o una aplicación conectada necesita el grupo correspondiente:

notes replies status tasks setup invites billing moves

Solo lectura no tiene ningún grupo. Trabajar con comentarios tiene notes, replies, status y tasks. Completo los tiene todos; invitar a miembros del equipo necesita Completo. Sin el grupo, la herramienta rechaza con permission_missing y nombra el grupo en permission; una clave de solo lectura recibe read_only. Muéstreselo a su propietario: solo él puede dar más acceso.

Pagar

list_plans muestra los planes (los precios están en la página de precios). start_trial inicia la prueba, una vez por persona. 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_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

Más