Webhook memberi tahu sistem lain tentang setiap perubahan di proyek Anda, dalam hitungan detik. Hanya admin yang dapat menambahkannya.

Tambah webhook

  1. Di bilah samping, buka Pengaturan › Agen AI. Temukan kartu Webhook dan Slack.
  2. Tempel Alamat yang akan menerima peristiwa. Harus diawali https:// dan dapat dijangkau dari internet.
  3. Pilih Format:
    • JSON, bertanda tangan: untuk kode Anda sendiri, Zapier, Make, n8n, dan alat serupa;
    • Webhook masuk Slack: satu baris yang mudah dibaca per peristiwa di kanal Slack.
  4. Tekan Tambah webhook.

Kartu Webhook dan Slack di Pengaturan › Agen AI: formulir untuk menambah alamat, dan satu webhook dengan pengiriman terakhirnya.Kartu Webhook dan Slack di Pengaturan › Agen AI: formulir untuk menambah alamat, dan satu webhook dengan pengiriman terakhirnya.

Untuk JSON, salin rahasia penandatanganan sekarang. Rahasia ini tidak ditampilkan lagi.

Kirim ke Slack

  1. Di Slack, buat webhook masuk untuk kanal yang Anda inginkan. Slack memberi Anda alamat yang diawali https://hooks.slack.com/.
  2. Tambahkan di Notiamo dengan format Webhook masuk Slack.

Setiap baris menyebut siapa melakukan apa, di proyek mana, dengan tautan ke komentar. Baris Slack berbahasa Inggris.

Apa yang dikirim

Setiap komentar, balasan, perubahan status, dan penugasan baru, ditambah suntingan dan balasan yang dihapus. Catatan internal disertakan dan ditandai: webhook dikirim ke agensi, bukan ke klien.

Pengiriman JSON adalah POST dengan isi seperti ini:

{
  "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/…" }
    }
  ]
}

Nama peristiwa lainnya adalah reply_created, status_changed, assigned, comment_edited, reply_edited, dan reply_deleted. Tergantung peristiwanya, ada juga reply, status (from dan to), assignee, atau mentions. Teks dipotong pada 500 karakter; ikuti link untuk komentar lengkapnya.

Laporan pekerjaan yang berpindah status mengirim job.state_changed, dengan job: from dan to (draft, ready, article_waiting, changes_requested, approved, atau posts_delivered), commentId, dan number. Perpindahan kembali ke draft juga dikirim; Slack tidak menyertakannya.

Periksa tanda tangan

Setiap pengiriman JSON punya dua header:

  • X-Notiamo-Delivery: id yang sama dengan delivery di isi pesan;
  • X-Notiamo-Signature: sha256= diikuti HMAC-SHA256 dari isi mentah, dibuat dengan rahasia penandatanganan Anda.

Hitung nilai yang sama di sisi Anda lalu bandingkan. Tolak permintaan jika berbeda.

Saat server Anda tidak menjawab

Kartu menampilkan pengiriman terakhir, kode status yang dijawab server Anda, dan berapa kali gagal berturut-turut. Notiamo mencoba lagi: seketika, lalu 15, 30, dan 45 menit kemudian, setelah itu setiap jam. Tidak ada yang hilang selama menunggu. Untuk menghentikan pengiriman, tekan Hapus.

Kunci API

Kunci API Notiamo adalah kunci agen. Kunci ini membuka server MCP di https://my.notiamo.com/api/mcp, yang dapat dipakai klien MCP mana pun untuk mendaftar, membaca, membalas, menugaskan, dan memperbarui komentar. Buat satu di Pengaturan › Agen AI › Kunci agen, hanya baca atau penuh, untuk semua proyek atau satu proyek. Klien MCP yang mendukung masuk (OAuth) tidak memerlukan kunci. Lihat Hubungkan agen AI.

Untuk mendapatkan semua komentar sebuah proyek sebagai file, buka halaman proyek lalu tekan Ekspor CSV atau Ekspor JSON.