Thiết lập webhook
- 1Mở Cài đặt > Webhook rồi thêm tên và một địa chỉ https công khai.
- 2Chọn các kênh áp dụng, hoặc không chọn kênh nào để áp dụng cho mọi kênh.
- 3Chọn sự kiện: bài đã đăng, khách tiềm năng mà luồng thu thập, luồng đã hoàn tất.
- 4Nhấp Gửi sự kiện thử để gửi mẫu của một sự kiện đến địa chỉ của bạn.
Trong Zapier, Make và n8n
Các ứng dụng PostNimbo cho Zapier, Make và n8n tự đăng ký giúp bạn: bật một trigger sẽ gọi POST /public/v1/webhooks với địa chỉ mà công cụ lắng nghe, và tắt nó sẽ gọi DELETE /public/v1/webhooks/:id. Mã của riêng bạn có thể làm tương tự với khóa API.
Cách gửi
- Một yêu cầu POST với nội dung JSON, tên sự kiện nằm trong header
X-PostNimbo-Event. - Máy chủ của bạn có 10 giây để phản hồi một bài đã đăng và 5 giây để phản hồi một sự kiện luồng. Sự kiện luồng được gửi lại thêm hai lần sau khi hết thời gian chờ, nhận 429 hoặc 5xx; bài đã đăng thì không được gửi lại. Hãy phản hồi nhanh rồi mới xử lý sau.
- Chỉ chấp nhận địa chỉ https công khai, và chuyển hướng cũng phải dẫn đến một địa chỉ công khai.
- Mỗi lần gửi đều được ký bằng secret hiển thị trong cài đặt webhook, trong các header
X-PostNimbo-Timestamp,X-PostNimbo-Signature.
Kiểm tra lần gửi có đúng từ chúng tôi
Tính HMAC-SHA256 của timestamp, một dấu chấm và nội dung gốc bằng secret của bạn, so sánh với header chữ ký theo thời gian hằng định, và từ chối timestamp cũ hơn 5 phút.
const crypto = require('crypto');
// rawBody: the request body exactly as received, before JSON parsing
function fromPostNimbo(rawBody, headers, secret) {
const timestamp = headers['x-postnimbo-timestamp'];
const signature = headers['x-postnimbo-signature'] || '';
if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
const expected =
'sha256=' +
crypto
.createHmac('sha256', secret)
.update(timestamp + '.' + rawBody)
.digest('hex');
return (
signature.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))
);
}Sự kiện
Danh sách tương tự có tại GET /public/v1/webhooks/events, để công cụ có thể hiển thị các trigger và dữ liệu mẫu.
post.publishedA post went live on a channel. Sent once per channel, after the network accepted it, with the post in the array.
Webhooks with no channels get it for every channel; the others only for the channels they list.
[
{
"id": "5b9c3f0e-6d0a-4a59-9b8e-2f1c7a4d2e11",
"content": "<p>Our autumn menu is here.</p>",
"publishDate": "2026-10-26T09:30:00.000Z",
"releaseURL": "https://www.linkedin.com/feed/update/urn:li:share:7000000000000000000",
"state": "PUBLISHED",
"integration": {
"id": "c1d2e3f4-0000-4a00-8000-000000000001",
"name": "Example Bakery",
"providerIdentifier": "linkedin-page",
"picture": "https://example.com/avatar.png",
"type": "social"
}
}
]post.scheduledA post was queued to publish: scheduled (or published now), rescheduled, approved, or edited while scheduled. Sent once per channel, with the same fields as post.published. The next posts of a repeating post do not send it.
Webhooks with no channels get it for every channel; the others only for the channels they list.
[
{
"id": "5b9c3f0e-6d0a-4a59-9b8e-2f1c7a4d2e11",
"content": "<p>Our autumn menu is here.</p>",
"publishDate": "2026-10-26T09:30:00.000Z",
"releaseURL": null,
"state": "QUEUE",
"integration": {
"id": "c1d2e3f4-0000-4a00-8000-000000000001",
"name": "Example Bakery",
"providerIdentifier": "linkedin-page",
"picture": "https://example.com/avatar.png",
"type": "social"
}
}
]post.failedA post could not be published, or its publishing could not be confirmed, and is marked as failed. Sent once per channel, with the same fields as post.published (the reason is shown in PostNimbo).
Webhooks with no channels get it for every channel; the others only for the channels they list.
[
{
"id": "5b9c3f0e-6d0a-4a59-9b8e-2f1c7a4d2e11",
"content": "<p>Our autumn menu is here.</p>",
"publishDate": "2026-10-26T09:30:00.000Z",
"releaseURL": null,
"state": "ERROR",
"integration": {
"id": "c1d2e3f4-0000-4a00-8000-000000000001",
"name": "Example Bakery",
"providerIdentifier": "linkedin-page",
"picture": "https://example.com/avatar.png",
"type": "social"
}
}
]lead.capturedAn automation flow saved an email or phone number someone typed in answer to a question. Sent once per answer.
Webhooks with no channels get it for every channel's flows; the others only for the flows on the channels they list.
{
"event": "lead.captured",
"timestamp": "2026-10-26T09:30:00.000Z",
"runId": "7d3f2a10-5c4e-4f8a-9a61-0e2b3c4d5e6f",
"flow": {
"id": "2a9e7c1b-3d4f-4e5a-8b6c-7d8e9f0a1b2c",
"name": "Autumn menu giveaway"
},
"channel": {
"id": "c1d2e3f4-0000-4a00-8000-000000000001",
"network": "instagram",
"name": "Example Bakery"
},
"contact": {
"id": "4f5e6d7c-8b9a-4c0d-9e1f-2a3b4c5d6e7f",
"name": "Sam Taylor",
"username": "samtaylor",
"email": "sam@example.com",
"phone": "+447700900123",
"tags": [
"giveaway"
],
"fields": {
"postcode": "SW1A 1AA"
}
}
}flow.completedSomeone reached the end of an automation flow. Sent once per run, with the same fields as lead.captured (email and phone are null when not collected).
Webhooks with no channels get it for every channel's flows; the others only for the flows on the channels they list.
{
"event": "flow.completed",
"timestamp": "2026-10-26T09:31:00.000Z",
"runId": "7d3f2a10-5c4e-4f8a-9a61-0e2b3c4d5e6f",
"flow": {
"id": "2a9e7c1b-3d4f-4e5a-8b6c-7d8e9f0a1b2c",
"name": "Autumn menu giveaway"
},
"channel": {
"id": "c1d2e3f4-0000-4a00-8000-000000000001",
"network": "instagram",
"name": "Example Bakery"
},
"contact": {
"id": "4f5e6d7c-8b9a-4c0d-9e1f-2a3b4c5d6e7f",
"name": "Sam Taylor",
"username": "samtaylor",
"email": "sam@example.com",
"phone": null,
"tags": [
"giveaway"
],
"fields": {}
}
}