Notiamo para agentes de IA
Tudo de que um agente de IA precisa para abrir uma conta gratuita para o seu proprietário, colocar o widget em um site e cuidar dos comentários e do trabalho, sem navegador.
O fluxo
- Peça uma conta para o seu proprietário: envie
POST https://my.notiamo.com/api/agent/signupcomemail,name,agent,localee, se tiver,company,projectUrl(o endereço do site) ereferral. A resposta trazrequestId,pollSecretepollAfterSeconds. - Diga ao proprietário para abrir o e-mail de confirmação que o Notiamo envia e confirmar. Nada acontece até ele confirmar.
- Consulte
GET https://my.notiamo.com/api/agent/signup/{requestId}comAuthorization: Bearer <pollSecret>a cadapollAfterSecondssegundos. O status épending,confirmed,expiredoureported. - Quando o status for
confirmed, a resposta traz, uma única vez, a sua chave (token, começando comntm_) emcpUrl. Guarde a chave na hora: as consultas seguintes não a devolvem. Resgate-a em até 7 dias após a confirmação. - Conecte-se ao servidor MCP em
https://my.notiamo.com/api/mcpcom o cabeçalhoAuthorization: Bearer ntm_…. Se o seu app aceita login MCP, ele pode usar Entrar com o Notiamo em vez de uma chave (veja abaixo). - Chame
list_projects(oufind_project) para encontrar o projeto feito para você: ele já usa o seuprojectUrlcomo endereço. Se o endereço estiver ausente ou errado, chameupdate_project_address. Depoisget_install, instale o trecho echeck_install. Usecreate_workspaceecreate_projectsó quando o plano tiver espaço (planos pagos ou o teste do Studio);create_projectprecisa de umworkspaceIddelist_workspaces. Um espaço de trabalho agrupa projetos, por exemplo um por cliente. Um projeto pode não ter endereço web (omitaorigin): então ele tem tarefas, trabalhos e novidades, mas não tem widget. Depois da instalação,get_badgedá o selo do rodapé: um pequeno logótipo Notiamo para o rodapé do site, que abre as ferramentas de revisão aos revisores e é uma simples ligação para o Notiamo para os restantes, no idioma do site (update_project_language, oulanguageemcreate_project). - Depois trabalhe nos comentários:
list_comments,get_comment,replyeset_status. Para ver o que há de novo, passesincealist_comments: um horário UTC terminado emZ(como2026-10-17T08:00:00Z), ou ocursorda última resposta. Você recebe só o que mudou, em um projeto ou, semprojectId, em todos os seus projetos. Guarde o novocursorpara a próxima verificação, sigamore: truena hora e remova duplicados porid: um item pode vir duas vezes. - Para outra organização, chame
create_organizationcom umname: o proprietário passa a ser o administrador e recebe um e-mail, e a resposta traz um novotokensó para essa organização. Ela é gratuita se o proprietário não tiver uma organização gratuita; caso contrário, precisa de um plano: chameget_payment_linkcom o novo token, oustart_trialpara o teste do Studio de 14 dias (uma vez por pessoa; o proprietário abre o link e informa um cartão). Há um limite diário; a recusa diz quando você pode tentar de novo. - Para mover um projeto para outro espaço de trabalho (
kindproject,projectId,toWorkspaceId), ou um espaço de trabalho com seus projetos para outra organização onde o proprietário também é administrador (kindworkspace,workspaceId,toOrganizationId), chamerequest_move. Nada é movido ainda: o proprietário recebe um e-mail e deve confirmar na página indicada, em até 24 horas. Chameget_move_requestpara ver o status:pending,done,cancelled,expiredoufailed. - Para adicionar trabalho que não está ligado a uma página, chame
create_taskcom umprojectIde umtitle, e opcionalmentetextepageUrl. Para mudar o texto, chameupdate_taskcom otaskIde um novotitle,textou os dois. Ambos contam para um limite diário de novos espaços de trabalho, projetos e tarefas; a recusa diz quando você o atinge.list_commentsmostra as tarefas marcadas com[Task]e aceitatype:taskoucomment. - Os relatórios de trabalho (Studio, Agency e o teste) são tarefas que um cliente preenche sobre um serviço feito: local, data, cliente final e arquivos por fase (
before,during,after,other) com legendas. Chamelist_job_reports(statereadylista os que esperam por você), leia um comget_commente responda comrolearticleno idioma dele. Só uma pessoa aprova: dê a ela o link de aprovação ou chamerequest_approval. Depois de aprovado, responda comrolepostsefiles(os ids dos arquivos a usar).update_filedefine aphaseou acaptionde um arquivo;create_taskeupdate_taskaceitamjobReport. - Notas de voz e IA (Studio, Agency e o teste):
get_commentlista cada gravação com um link para o áudio e sua transcrição por IA (e qualquer transcrição posterior, não publicada), cada vídeo com mais de cerca de 20 segundos com notas de tempo (m:ss–m:sso que acontece) e legendas por IA marcadas com(AI, not checked)até uma pessoa conferir. Quando a IA não conseguiu processar um arquivo, ela diz isso com as mesmas palavras simples que as pessoas veem, com um código de referência (AI-…) para o suporte.list_planseget_billinginformam os minutos de voz e IA por mês.
Não consulte mais rápido que pollAfterSeconds. Se receber rate_limited, aguarde retryAfter segundos. Um id ou segredo errado ou desconhecido devolve 404 com {"code":"not_found"}.
Se a sua plataforma assina os pedidos com Web Bot Auth (assinaturas de mensagens HTTP, um Signature-Agent com um diretório de chaves) e o Notiamo confia nela, o cadastro e o servidor MCP contam você pela plataforma e não pelo endereço, com limites maiores. Pedidos sem assinatura funcionam como antes.
Exemplo: pedir uma conta
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"}'O plano gratuito
O plano gratuito permite 1 espaço de trabalho, 1 projeto, 3 pessoas (membros da equipe, membros clientes e convites pendentes, cada e-mail uma vez) e 1 endereço público por projeto. Depois do primeiro comentário público do projeto, o endereço pode ser alterado uma vez. Ele guarda 100 MB de arquivos, 5 MB por arquivo; acima de 100 MB os administradores da organização recebem dois e-mails, depois os arquivos mais antigos são removidos, e comentários, tarefas e respostas ficam. Os envios podem ser recusados para impedir abusos. Vídeo não está incluído: precisa do Studio, do Agency ou do teste. Um espaço de trabalho e um projeto já existem quando a conta é aberta.
O widget mostra um selo do Notiamo no plano gratuito.
Mantenha a linha de comentário acima da tag script. Os termos do plano gratuito exigem isso:
<!-- Notiamo (notiamo.com): website feedback. Free plan: keep this line. -->Uma recusa plan_limit diz qual limite você atingiu e o que fazer em seguida.
Recusas
O cadastro e as ferramentas respondem com um código. Os códigos do cadastro vêm com um status HTTP:
| Código | Status HTTP | O que significa |
|---|---|---|
signup_blocked | 403 | A rede não pode fazer cadastro. O proprietário se cadastra por conta própria. |
country_blocked | 403 | O Notiamo não está disponível no país de onde vem o pedido. O proprietário também não pode se cadastrar a partir de lá. |
rate_limited | 429 | Requisições demais. Aguarde retryAfter segundos. |
agent_signup_paused | 503 | O cadastro por agentes está pausado por enquanto. O proprietário se cadastra por conta própria. |
agent_signup_closed | 503 | O cadastro por agentes está encerrado. O proprietário se cadastra por conta própria. |
account_exists | 409 | Este e-mail já tem uma conta. O proprietário faz login e cria uma chave em Configurações > Agentes de IA > Tokens de agente. |
email_not_accepted | 422 | Este endereço de e-mail não pode ser usado. O proprietário se cadastra por conta própria. |
invalid_input | 422 | Um campo não é válido. field o indica. |
plan_limit | 402 | Um limite do plano foi atingido. Devolvido pelas ferramentas MCP, com o próximo passo (start_trial ou get_payment_link). |
read_only | 403 | Esta chave ou app é somente leitura: pode olhar, mas não alterar. Devolvido pelas ferramentas MCP. |
permission_missing | 403 | Esta chave ou app não pode fazer isto. permission nomeia o grupo que falta (ou full). Devolvido pelas ferramentas MCP. |
Mostre as recusas ao seu proprietário. Nunca as contorne.
Entrar com o Notiamo (OAuth)
Em vez de uma chave, um cliente MCP que aceita login pode se conectar com OAuth. Os metadados do servidor de autorização estão em https://my.notiamo.com/.well-known/oauth-authorization-server, e o servidor MCP responde 401 com um cabeçalho WWW-Authenticate que aponta para os metadados do seu recurso protegido (https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp, RFC 9728), que nomeiam este servidor, e sugere o escopo notes replies status tasks. Os clientes se registram sozinhos e usam PKCE (S256), sem segredo de cliente.
Seu proprietário faz login, escolhe a organização, o que você pode alterar (Trabalhar no feedback vem marcado) e os projetos, e clica em Permitir. Os escopos são os grupos de permissão abaixo. Seu proprietário vê o app em Configurações > Agentes de IA > Aplicativos conectados e pode desconectá-lo a qualquer momento.
Permissões
Ler não exige permissão. Para alterar algo, uma chave ou um app conectado precisa do grupo correspondente:
notes replies status tasks setup invites billing moves
Somente leitura não tem grupo. Trabalhar no feedback tem notes, replies, status e tasks. Total tem todos; convidar membros da equipe exige Total. Sem o grupo, a ferramenta recusa com permission_missing e nomeia o grupo em permission; uma chave somente leitura recebe read_only. Mostre isso ao seu proprietário: só ele pode dar mais acesso.
Pagamento
list_plans mostra os planos (veja a página de preços para os valores). start_trial inicia o teste, uma vez por pessoa. Preços
get_payment_link cria um link de pagamento que o proprietário abre e paga. Você nunca lida com dados de cartão.
Indicação
Se um selo ou link do Notiamo trouxe você até aqui, passe o código dele no campo referral do corpo JSON do cadastro. A forma ?via=<code> serve só para o link de cadastro que as pessoas abrem.
As ferramentas MCP
Depois de conectar, você pode chamar:
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