Webhook Trạng Thái Chiến dịch

Hướng dẫn xây dựng webhook nhận trạng thái tin nhắn

🌐 URL Webhook

Bạn cần cung cấp URL Webhook cho chúng tôi để nhận trạng thái tin nhắn.

Ví dụ URL:

https://your-domain.com/webhook

---

📦 Cấu Trúc Dữ Liệu Gửi Đến Webhook

• Phương thức gửi: GET

• Timeout: 2 giây

• Tham số trạng thái chiến dịch:

Tham Số	Ý Nghĩa	Kiểu Dữ Liệu
type	Trạng thái chiến dịch: • approved - Được duyệt • reject - Bị từ chối	String
campaign_code	Mã chiến dịch	String
note	Ghi chú (nếu có)	String / Null

• Tham số chi tiết chiến dịch:

Tham số	Ý nghĩa	Kiểu dữ liệu
type	result có kết quả chiến dịch	String
campaign_code	Mã chiến dịch	String
link	URL chứa file csv chi tiết chiến dịch	String

• Cấu trúc file csv:

Tham số	Ý nghĩa	Kiểu dữ liệu
phone	Số điện thoại	String
telco	Nhà mạng	String
msg	Nội dung tin nhắn	String
msg_count	Số bản tin	String
status	Trạng thái	String
error_desc	Mô tả lỗi	String / Null

Ví dụ CURL:

curl -X GET https://your-domain.com/webhook?type=reject&campaign_code=fbfacf73-2628-43b7-a9a4-c7ce149eb316&note=noi dung khong hop le

curl -X GET https://your-domain.com/webhook?type=reject&campaign_code=fbfacf73-2628-43b7-a9a4-c7ce149eb316&url=https://static.yoursales.vn/report/fbfacf73-2628-43b7-a9a4-c7ce149eb316.csv

✅ Phản hồi

• HTTP Code: 200 OK
• Webhook trả về HTTP_CODE 200 là thành công
• Danh sách mã lỗi: Tại đây

---

🛡️ Bảo Mật Webhook

• Xác thực IP: Chỉ chấp nhận IP whitelist từ hệ thống chúng tôi.

---

📌 Ghi chú

• Nếu gọi webhook thất bại chúng tôi sẽ gọi lại 5 lần. Lần 1 cách 5s, lần 2 cách 10s, cách lần còn lại là 300s
• Thời gian webhook phản hồi phải nhỏ hơn 2s. Nếu vượt quá 2s thì xem như thất bại

---