Um webhook avisa outro sistema sobre cada mudança nos seus projetos, em segundos. Só os admins podem adicionar um.
Adicionar um webhook
- Na barra lateral, abra Configurações › Agentes de IA. Encontre o cartão Webhooks e Slack.
- Cole o Endereço que deve receber os eventos. Ele deve começar com
https://e estar acessível pela internet. - Escolha o Formato:
- JSON, assinado: para o seu próprio código, Zapier, Make, n8n e ferramentas parecidas;
- Webhook de entrada do Slack: uma linha legível por evento em um canal do Slack.
- Clique em Adicionar webhook.


Para JSON, copie o segredo de assinatura agora. Ele não é mostrado de novo.
Publicar no Slack
- No Slack, crie um webhook de entrada para o canal que você quer. O Slack dá um endereço que começa com
https://hooks.slack.com/. - Adicione-o no Notiamo com o formato Webhook de entrada do Slack.
Cada linha diz quem fez o quê, em qual projeto, com um link para o comentário. As linhas do Slack estão em inglês.
O que é enviado
Cada novo comentário, resposta, mudança de status e atribuição, além de edições e respostas excluídas. As notas internas são incluídas e marcadas: os webhooks vão para a agência, não para os clientes.
Uma entrega JSON é um POST com este corpo:
{
"delivery": "a-unique-id",
"events": [
{
"id": 1234,
"event": "comment_created",
"at": "2026-10-14T09:30:00.000Z",
"internal": false,
"viaAgent": false,
"actor": { "name": "Claire Martin" },
"project": { "id": "…", "name": "Main website" },
"comment": { "id": "…", "number": 12, "type": "highlight", "title": null, "text": "…", "page": "/pricing", "url": "https://example.com/pricing", "status": "open", "link": "https://my.notiamo.com/comments/…" }
}
]
}
Os outros nomes de evento são reply_created, status_changed, assigned, comment_edited, reply_edited e reply_deleted. Dependendo do evento, ele também traz reply, status (from e to), assignee ou mentions. Os textos são cortados em 500 caracteres; siga o link para ver o comentário completo.
Um relatório de trabalho que avança envia job.state_changed, com job: from e to (draft, ready, article_waiting, changes_requested, approved ou posts_delivered), commentId e number. Uma volta para draft também é enviada; o Slack a deixa de fora.
Conferir a assinatura
Toda entrega JSON tem dois cabeçalhos:
X-Notiamo-Delivery: o mesmo id dedeliveryno corpo;X-Notiamo-Signature:sha256=seguido do HMAC-SHA256 do corpo bruto, feito com o seu segredo de assinatura.
Calcule o mesmo valor do seu lado e compare. Recuse a requisição se for diferente.
Quando seu servidor não responde
O cartão mostra a última entrega, o código de status que seu servidor respondeu e quantas falhas seguidas houve. O Notiamo tenta de novo: na hora, depois 15, 30 e 45 minutos depois, e então a cada hora. Nada se perde enquanto ele espera. Para parar as entregas, clique em Excluir.
Chaves de API
As chaves de API do Notiamo são as chaves de agente. Elas abrem o servidor MCP em https://my.notiamo.com/api/mcp, que qualquer cliente MCP pode usar para listar, ler, responder, atribuir e atualizar comentários. Crie uma em Configurações › Agentes de IA › Chaves de agente, somente leitura ou total, para todos os projetos ou um. Um cliente MCP que aceita login (OAuth) não precisa de chave. Veja Conectar um agente de IA.
Para obter todos os comentários de um projeto como arquivo, abra a página do projeto e clique em Exportar CSV ou Exportar JSON.