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
- Solicite una cuenta para su propietario: envíe
POST https://my.notiamo.com/api/agent/signupconemail,name,agent,localey, si los tiene,company,projectUrl(la dirección del sitio web) yreferral. La respuesta incluyerequestId,pollSecretypollAfterSeconds. - Pida al propietario que abra el correo de confirmación que envía Notiamo y que confirme. No ocurre nada hasta que lo haga.
- Consulte
GET https://my.notiamo.com/api/agent/signup/{requestId}conAuthorization: Bearer <pollSecret>cadapollAfterSecondssegundos. El estado espending,confirmed,expiredoreported. - Cuando el estado es
confirmed, la respuesta incluye una sola vez su clave (token, que empieza porntm_) ymcpUrl. Guarde la clave de inmediato: las consultas posteriores ya no la devuelven. Recójala en los 7 días siguientes a la confirmación. - Conéctese al servidor MCP en
https://my.notiamo.com/api/mcpcon la cabeceraAuthorization: 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). - Llame a
list_projects(ofind_project) para encontrar el proyecto creado para usted: ya usa suprojectUrlcomo dirección. Si la dirección falta o es incorrecta, llame aupdate_project_address. Despuésget_install, instale el fragmento y llame acheck_install. Usecreate_workspaceycreate_projectsolo cuando el plan tenga espacio (planes de pago o la prueba de Studio);create_projectnecesita unworkspaceIddelist_workspaces. Un espacio de trabajo agrupa proyectos, por ejemplo uno por cliente. Un proyecto puede no tener dirección web (omitaorigin): entonces tiene tareas, trabajos y noticias, pero no widget. Tras la instalación,get_badgeda 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, olanguageencreate_project). - Después trabaje con los comentarios:
list_comments,get_comment,replyyset_status. Para ver novedades, pasesincealist_comments: una hora UTC terminada enZ(como2026-10-17T08:00:00Z) o elcursorde su última respuesta. Recibe solo lo que cambió, en un proyecto o, sinprojectId, en todos sus proyectos. Guarde el nuevocursorpara la próxima consulta, sigamore: trueenseguida y elimine duplicados porid: un elemento puede llegar dos veces. - Para otra organización, llame a
create_organizationcon unname: el propietario pasa a ser su administrador y recibe un correo, y la respuesta contiene un nuevotokensolo para esa organización. Es gratuita si el propietario no tiene una organización gratuita; si no, necesita un plan: llame aget_payment_linkcon el nuevo token, o astart_trialpara 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. - Para trasladar un proyecto a otro espacio de trabajo (
kindproject,projectId,toWorkspaceId), o un espacio de trabajo con sus proyectos a otra organización donde el propietario también es administrador (kindworkspace,workspaceId,toOrganizationId), llame arequest_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 aget_move_requestpara ver el estado:pending,done,cancelled,expiredofailed. - Para añadir trabajo que no depende de una página, llame a
create_taskcon unprojectIdy untitle, y opcionalmentetextypageUrl. Para cambiar su redacción, llame aupdate_taskcon eltaskIdy un nuevotitle,texto 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_commentsmuestra las tareas marcadas con[Task]y aceptatype:taskocomment. - 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 alist_job_reports(statereadylista los que le esperan), lea uno conget_commenty responda conrolearticleen su idioma. Solo una persona aprueba: dele el enlace de aprobación o llame arequest_approval. Tras la aprobación, responda conrolepostsyfiles(los id de los archivos que se usarán).update_filecambia laphaseo lacaptionde un archivo;create_taskyupdate_taskaceptanjobReport. - Notas de voz e IA (Studio, Agency y la prueba):
get_commentlista 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:sslo 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_plansyget_billingdan 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ódigo | Estado HTTP | Qué significa |
|---|---|---|
signup_blocked | 403 | La red no puede registrarse. El propietario se registra por sí mismo. |
country_blocked | 403 | Notiamo no está disponible en el país del que viene la solicitud. El propietario tampoco puede registrarse desde allí. |
rate_limited | 429 | Demasiadas solicitudes. Espere retryAfter segundos. |
agent_signup_paused | 503 | El registro por agentes está en pausa por ahora. El propietario se registra por sí mismo. |
agent_signup_closed | 503 | El registro por agentes está cerrado. El propietario se registra por sí mismo. |
account_exists | 409 | Este correo ya tiene una cuenta. El propietario inicia sesión y crea una clave en Ajustes > Agentes de IA > Tokens de agente. |
email_not_accepted | 422 | Esta dirección de correo no se puede usar. El propietario se registra por sí mismo. |
invalid_input | 422 | Un campo no es válido. field lo nombra. |
plan_limit | 402 | Se alcanzó un límite del plan. Lo devuelven las herramientas MCP, con el siguiente paso (start_trial o get_payment_link). |
read_only | 403 | Esta clave o aplicación es de solo lectura: puede mirar, pero no cambiar. Lo devuelven las herramientas MCP. |
permission_missing | 403 | Esta 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