Um webhook avisa outro sistema sobre cada mudança nos seus projetos, em segundos. Só os admins podem adicionar um.

Adicionar um webhook

  1. Na barra lateral, abra Configurações › Agentes de IA. Encontre o cartão Webhooks e Slack.
  2. Cole o Endereço que deve receber os eventos. Ele deve começar com https:// e estar acessível pela internet.
  3. 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.
  4. Clique em Adicionar webhook.

O cartão Webhooks e Slack em Configurações › Agentes de IA: o formulário para adicionar um endereço e um webhook com sua última entrega.O cartão Webhooks e Slack em Configurações › Agentes de IA: o formulário para adicionar um endereço e um webhook com sua última entrega.

Para JSON, copie o segredo de assinatura agora. Ele não é mostrado de novo.

Publicar no Slack

  1. 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/.
  2. 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 de delivery no 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.