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
- Solicite una cuenta para su propietario: envíe
POST https://my.notiamo.com/api/agent/signupconemail,name,agent,localey, si los tiene,company,siteUrlyreferral. 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 (5 por ahora). 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_…. - Llame a
list_sites(ofind_site) para encontrar el sitio creado para usted: ya usa susiteUrlcomo dirección. Si la dirección falta o es incorrecta, llame aupdate_site_address. Despuésget_install, instale el fragmento y llame acheck_install. Usecreate_clientycreate_sitesolo cuando el plan tenga espacio (planes de pago o la prueba de Studio);create_sitenecesita unclientIddelist_clients. - Después trabaje con los comentarios:
list_comments,get_comment,replyyset_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ódigo | Estado HTTP | Qué significa |
|---|---|---|
signup_blocked | 403 | La red no puede registrarse. El propietario se registra por sí mismo. |
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 > Claves. |
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). |
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