Về webhook

Subiz sử dụng webhooks để thông báo cho bạn biết một sự kiện đã xảy ra trong tài khoản.

Webhook rất hữu dụng để đồng bộ dữ liệu của bạn trên Subiz sang CRM riêng.

Webhook là gì

Webhook lắng nghe các sự kiện xảy ra trong tài khoản subiz rồi gửi chi tiết sự kiện sang máy chủ của bạn.

Ví dụ:

• Khi một người dùng mới vào website, Webhook thông báo sang cho server của bạn.
• Khi một người dùng facebook gửi tin nhắn lên fanpage. Webhook chuyển tin nhắn này tới server của bạn.
• Khi tư vấn viên cập nhật thông tin của khách hàng trên subiz. Webhook gửi thông tin này sang server của bạn.

Bạn cần chuẩn bị những gì?

Để sử dụng được tính năng webhook, bạn phải

1. Sở hữu một máy chủ HTTP công khai trên internet.
2. Xử lý gói tin nhận được từ webhook (biết code).

Bạn có thể tự dựng máy chủ vật lý hoặc thuê máy chủ ảo. Khi tạo dựng được máy chủ, bạn cần cung cấp một đường dẫn URL (endpoint) để nhận dữ liệu từ subiz. Thông thường URL sẽ có dạng https://example.com/webhooks hoặc http://192.123.233.244/webhook.

Subiz sẽ gửi dữ liệu sang endpoint này với một định dạng đã được quy chuẩn, bạn cần phải hiểu định dạng này và biết cách lấy được những thông tin mình quan tâm. (Định dạng sẽ được mô tả chi tiết ở phần sau)

Ví dụ về một gói dữ liệu subiz sẽ gửi sang:

// JSON
{
  "events": [
    {
      "id": "evqwjalnhlrkwyvuspdfmwzlv",
      "account_id": "acpxkgumifuoofoosble",
      "created": 1608883792973,
      "type": "message_sent",
      "by": { "id": "bbqvwqeofekbxyvlmj", "type": "agent" },
      "data": {
        "message": {
          "conversation_id": "csqwjalnenqynheyql",
          "text": "Rất vui được gặp bạn!",
          "format": "plaintext",
          "integration_id": "acpxkgumifuoofoosble.subizv4.subikon"
        }
      }
    }
  ]
}

Xây dựng endpoint nhận webhook