Bao gồm SMS, cuộc gọi, WhatsApp và email với tên sự kiện chính xác.
WEBHOOK V2 · Mọi sự kiện di động, gửi tới phần mềm của bạn
Biến mọi sự kiện từ thiết bị di động được kết nối thành hành động tức thì.
SMSMobileAPI Webhook V2 gửi các sự kiện HTTPS có cấu trúc tới ứng dụng của bạn khi một SMS được nộp, gửi đi, thất bại hoặc được nhận, khi cuộc gọi di động bị lỡ, đến hoặc đi, và khi có hoạt động WhatsApp hoặc email được hỗ trợ. Cấu hình mọi thứ trực quan từ bảng điều khiển của bạn — không cần vòng lặp truy vấn.
Đọc tài liệu APIChọn sự kiện mà mỗi điểm đến sẽ nhận. Thử nghiệm, tạm dừng, giám sát và xoay khóa ký (signing secret) của nó ngay trong một workspace.
SMSGỌIWANhóm Việt hoá KDEEMAIL OF TRANSLATORS
JSON đã ký
SMSMobileAPIWEBHOOK V2Hàng đợi sự kiện bền bỉ
TRỰC TIẾP
HTTPS POST
Quản lý quan hệ khách hàng (CRM)HỖ TRỢTỰ ĐỘNG HÓAPHÂN TÍCH
Gửi các nhóm sự kiện khác nhau tới các điểm đến HTTPS khác nhau.
Xác thực mọi yêu cầu bằng chữ ký HMAC-SHA256 và dấu thời gian của nó.
Các lỗi tạm thời ở điểm đến sẽ được thử lại mà không chặn các tài khoản khác.
Cách WEBHOOK V2 hoạt động
Từ một sự kiện di động thực tế đến ứng dụng của bạn trong ba bước rõ ràng.
Thiết bị di động được kết nối của bạn và các dịch vụ SMSMobileAPI tạo ra các sự kiện vận hành. Webhook V2 đặt mỗi sự kiện đủ điều kiện vào hàng đợi giao hàng bền bỉ và gửi một payload JSON đã ký tới HTTPS URL mà bạn đã chọn.
- 1
Một sự kiện xảy ra
Một tin nhắn được gửi đi, một thiết bị di động gửi hoặc nhận SMS, một cuộc gọi thay đổi trạng thái, hoặc hoạt động WhatsApp và email được ghi nhận.
- 2
Webhook V2 định tuyến nó
SMSMobileAPI tạo một ID sự kiện ổn định và xếp hàng giao chỉ cho những điểm đến đã đăng ký loại sự kiện đó.
- 3
Phần mềm của bạn phản ứng
Endpoint HTTPS công khai của bạn xác thực chữ ký, lưu ID sự kiện và khởi chạy quy trình làm việc CRM, hỗ trợ, cảnh báo hoặc tự động hóa.
15 LOẠI SỰ KIỆN CHÍNH XÁC
Chỉ đăng ký những sự kiện di động mà quy trình làm việc của bạn cần.
Một điểm đến có thể nhận mọi thứ, hoặc bạn có thể tách biệt hệ thống sản xuất, phân tích và cảnh báo vận hành. Mỗi sự kiện có một tên rõ ràng để ứng dụng của bạn xử lý một cách có thể dự đoán.
SMS
5sms.api.submittedSMS được gửi thông qua API
Một yêu cầu API đã tạo một công việc gửi SMS. Hữu ích để xác nhận rằng yêu cầu đã vào nền tảng.
sms.sentSMS đã gửi
Thiết bị di động được kết nối đã xác nhận hoạt động gửi SMS.
sms.failedSMS thất bại
Thiết bị di động được kết nối trả về lỗi gửi SMS.
sms.receivedSMS đã được nhận
Một thiết bị di động được kết nối đã đồng bộ một SMS đến.
sms.mobile.sentSMS được gửi từ thiết bị di động
Một SMS đã được gửi thủ công từ thiết bị di động được kết nối.
Cuộc gọi
3call.missedCuộc gọi nhỡ
Một cuộc gọi nhỡ đã được đồng bộ từ thiết bị di động được kết nối.
call.incomingCuộc gọi đến
Một cuộc gọi đến đã được đồng bộ từ thiết bị di động được kết nối.
call.outgoingCuộc gọi đi
Một cuộc gọi đi đã được đồng bộ từ thiết bị di động được kết nối.
whatsapp.submittedWhatsApp đã được gửi
Một tác vụ gửi WhatsApp đã được tạo.
whatsapp.sentWhatsApp đã được gửi
Môi trường WhatsApp được kết nối xác nhận tin nhắn đã được gửi.
whatsapp.failedWhatsApp thất bại
Hoạt động gửi WhatsApp đã thất bại.
whatsapp.receivedWhatsApp đã được nhận
Một tin nhắn WhatsApp đã được truy xuất sau khi tài khoản yêu cầu đồng bộ.
whatsapp.voice.transcribedTin nhắn thoại đã được phiên âm
Một tin nhắn thoại WhatsApp hợp lệ được truy xuất đã được chuyển thành văn bản có thể sử dụng.
email.sentEmail đã được gửi
Một yêu cầu gửi email đã được tạo bởi SMSMobileAPI.
email.receivedEmail đã được nhận
Một hộp thư được kết nối đã nhận một email.
Cấu hình mọi thứ bằng giao diện trực quan
Quản lý webhook chuyên nghiệp mà không cần chỉnh sửa tệp cấu hình.
Mở Webhook V2 trong bảng điều khiển SMSMobileAPI, thêm tên điểm đến và HTTPS URL công khai, chọn các sự kiện, sau đó lưu. Bảng điều khiển cung cấp cho bạn các công cụ cần thiết cho vận hành hàng ngày và khắc phục sự cố.
Nhiều điểm đến
Tạo điểm đến chuyên dụng cho CRM, giám sát, phân tích hoặc ứng dụng khách hàng của bạn.
Bộ lọc sự kiện
Chọn chính xác các sự kiện SMS, cuộc gọi, WhatsApp và email mà mỗi URL sẽ nhận.
Kiểm tra gửi
Gửi một sự kiện kiểm tra có kiểm soát trước khi sử dụng điểm đến trong môi trường sản xuất.
Tạm dừng và kích hoạt lại
Dừng một điểm đến ngay lập tức mà không xóa cấu hình của nó.
Xoay vòng bí mật
Tạo khóa ký mới khi quy trình bảo mật của bạn yêu cầu.
Hoạt động gửi
Xem lại các lần gửi đang xếp hàng, đã giao, đang thử lại và thất bại kèm thông tin số lần thử và trạng thái HTTP.
Webhook V23 đang hoạt động
CRM (môi trường sản xuất)
https://crm.example.com/hooks/mobileĐang hoạt độngsms.receivedcall.missedwhatsapp.received
Cảnh báo vận hành
https://ops.example.com/eventsĐang hoạt độngsms.failedwhatsapp.failed
Độ tin cậy theo thiết kế
Được xây dựng để giao hàng đáng tin cậy, độc lập.
Giao webhook là bất đồng bộ. Luồng công việc di động của bạn không chờ phản hồi từ bên thứ ba URL, và một đích thất bại không chặn khách hàng hoặc đích khác.
Hàng đợi bền bỉ
Các sự kiện đủ điều kiện được lưu trữ trước khi gửi nên thời gian ngừng tạm thời của bên nhận không xóa mất sự kiện.
Giao nhận tối thiểu một lần
Một lần gửi có thể được thử lại. Lưu ID sự kiện và chỉ xử lý nó một lần trong ứng dụng của bạn.
Thử lại tăng dần
Các lỗi tạm thời được thử lại với độ trễ tăng dần, cho đến giới hạn thử lại của nền tảng.
Cô lập lỗi
Một điểm cuối chậm hoặc không sẵn có không thể ngăn việc gửi tới các đích không liên quan.
Bảo vệ tự động
Một đích có lỗi kéo dài có thể bị tạm ngưng để bảo vệ hàng đợi và hạ tầng của bạn.
Khả năng giám sát vận hành
Bảng điều khiển và công cụ giám sát webmaster hiển thị trạng thái hàng đợi, kết quả và các lỗi gửi gần đây.
Được ký và có thể xác minh
Xác minh yêu cầu trước khi tin cậy sự kiện.
Mỗi lần gửi bao gồm dấu thời gian, định danh giao hàng, loại sự kiện, khóa idempotency ổn định và chữ ký HMAC-SHA256. Giữ bí mật chữ ký trên máy chủ của bạn, tính chữ ký từ nội dung yêu cầu thô và từ chối các yêu cầu không hợp lệ hoặc đã lỗi thời.
X-SMSMobileAPI-EventLoại sự kiện, ví dụ sms.received.X-SMSMobileAPI-DeliveryĐịnh danh giao hàng duy nhất cho đích này.X-SMSMobileAPI-TimestampUnix timestamp được sử dụng trong quá trình xác minh chữ ký.X-SMSMobileAPI-SignatureChữ ký HMAC-SHA256 để so sánh một cách an toàn.Idempotency-KeyUUID sự kiện ổn định được dùng để ngăn xử lý trùng lặp.Gói sự kiện nhất quán
Một gói tin JSON nhất quán cho mọi kênh.
Gói tin vẫn có cấu trúc dự đoán được trên SMS, cuộc gọi, WhatsApp và email. Đối tượng dữ liệu chứa các trường liên quan đến loại sự kiện, trong khi các định danh cấp cao cho phép bạn định tuyến và loại trùng mỗi lần gửi.
id— định danh sự kiện ổn địnhtype— loại sự kiện chính xácoccurred_at— thời điểm hoạt động xảy radata— thông tin đặc thù theo kênh
{
"id": "whv2_01J...",
"type": "sms.received",
"api_version": "2026-09-22",
"created_at": "2026-09-22T12:00:00Z",
"occurred_at": "2026-09-22T11:59:58Z",
"data": {
"guid": "...",
"from": "+32...",
"message": "Can you call me back?"
}
}Từ sự kiện đến kết quả kinh doanh
Hãy để giao tiếp di động kích hoạt hành động kinh doanh tiếp theo.
Cuộc trò chuyện CRM
Thêm một tin nhắn SMS hoặc WhatsApp nhận được vào liên hệ phù hợp và thông báo cho người phụ trách được giao.
Xử lý cuộc gọi nhỡ
Tạo nhiệm vụ gọi lại, gửi SMS theo dõi hoặc thông báo cho đội trực sau khi có cuộc gọi nhỡ.
Hỗ trợ khách hàng
Mở hoặc cập nhật ticket hỗ trợ khi khách hàng trả lời từ thiết bị di động của họ.
Hoạt động thương mại điện tử
Cập nhật luồng giao tiếp đơn hàng sau khi tin nhắn di động được gửi, xác nhận hoặc thất bại.
Giám sát và cảnh báo
Gửi thông báo giao hàng thất bại hoặc hoạt động cuộc gọi bất thường tới công cụ giám sát và quản lý sự cố của bạn.
Luồng công việc AI và dữ liệu
Cung cấp sự kiện được phép vào luồng phân loại, báo cáo hoặc hỗ trợ mà không phải liên tục truy vấn API.
Ngừng thăm dò để phát hiện thay đổi
Thăm dò gửi yêu cầu lặp lại. Webhook sẽ thông báo cho phần mềm của bạn khi có thay đổi.
Thăm dò tiêu tốn các yêu cầu ngay cả khi không có gì xảy ra và tạo độ trễ giữa các lần kiểm tra. Webhook V2 đẩy sự kiện liên quan tới điểm cuối của bạn, giúp tự động hóa nhanh hơn, đơn giản hơn và dễ mở rộng hơn.
Có sự kiện mới không?Yêu cầu lặp lại · độ trễ tăng
Sự kiện
Thông báo cho tôi khi điều đó xảy ra.Sự kiện liên quan · luồng xử lý ngay lập tứcCâu hỏi thường gặp về Webhook V2
Câu hỏi trước khi kết nối điểm cuối của bạn.
Tôi có cần tạo vòng lặp thăm dò không?＋
Không. Webhook V2 gửi các sự kiện đã đăng ký tới điểm cuối HTTPS công khai của bạn. Bạn vẫn có thể dùng API khi cần truy vấn lịch sử hoặc chi tiết.
Tôi có thể cấu hình nhiều URL webhook không?＋
Có. Bạn có thể tạo nhiều điểm đến và chọn bộ sự kiện khác nhau cho mỗi điểm, trong giới hạn tài khoản được hiển thị trên bảng điều khiển.
Làm sao biết SMS đã thực sự được gửi?＋
Sử dụng sms.api.submitted để biết công việc đã được tạo và sms.sent cho xác nhận do thiết bị di động kết nối báo về. Xem chúng như hai giai đoạn vận hành khác nhau.
Webhook có thể được gửi nhiều hơn một lần không?＋
Có. Webhook V2 sử dụng cơ chế giao nhận ít nhất một lần. Lưu ID sự kiện ổn định hoặc Idempotency-Key và bỏ qua các lần gửi mà bạn đã xử lý.
Điểm cuối của tôi phải trả về gì?＋
Trả về phản hồi 2xx của HTTP sau khi chấp nhận sự kiện một cách an toàn. Việc xử lý có thể tiếp tục bất đồng bộ bên trong ứng dụng của bạn.
Các sự kiện WhatsApp nhận được có được thu thập liên tục không?＋
Không. Việc truy xuất tin nhắn nhận được của WhatsApp tuân theo quy trình đồng bộ dựa trên sự cho phép riêng. Sự kiện whatsapp.received có sẵn sau khi một tin nhắn đủ điều kiện đã được truy xuất.
Sự kiện di động của bạn. Phần mềm của bạn. Hành động của bạn.
Kết nối phần mềm của bạn với hoạt động của thiết bị di động thực tế ngay bây giờ.
Tạo tài khoản hoặc đăng nhập, mở Webhook V2, thêm một điểm đến HTTPS công khai và chọn những sự kiện quan trọng đối với luồng công việc của bạn. Gửi một sự kiện thử nghiệm, xác minh chữ ký và kích hoạt tích hợp.
