Mô tả
Trong bài viết này, Bạn sẽ biết:
+ Khóa API là gì? Tìm tài liệu API của SmsMk365.com ở đâu?
+ WebHook là gì? Tìm tài liệu WebHook của SmsMk365.com ở đâu?
+ Hành động (hay Action) là gì? Cách thiết lập Hành động (hay Action) như thế nào?
NỘI DUNG CHI TIẾT
1. Khóa API là gì? Tìm tài liệu API của SmsMk365.com ở đâu?
1.1. Khóa API là gì?
Khóa API (API Key) là một chuỗi ký tự (thường là một đoạn mã gồm chữ và số) được sử dụng để xác thực người dùng, ứng dụng hoặc hệ thống khi gọi đến một API (Giao diện lập trình ứng dụng).
1.2. Mục đích của khóa API:
- Xác thực danh tính người dùng hoặc ứng dụng khi truy cập API.
- Kiểm soát quyền truy cập, phân quyền xem ai được phép gọi API nào.
- Giới hạn tần suất gọi API (rate limiting), để tránh lạm dụng dịch vụ.
- Theo dõi và thống kê lưu lượng sử dụng API từ mỗi người dùng.
- Tạo nhóm, tổ chức danh sách khách hàng từ chính website của bạn mà không cần phải truy cập vào SmsMk365.com.
- Tạo và thực thi các chiến dịch Sms Marketing, WhatsApp Marketing ngay từ chính website của Bạn...
...
1.3. Khóa API có bảo mật không?
- Khóa API giúp kiểm soát truy cập, nhưng không nên dùng khóa API cho các hoạt động cần mức độ bảo mật cao, vì:
- Nó có thể bị lộ nếu nhúng trong frontend (trình duyệt).
- Không mạnh như các phương pháp xác thực OAuth hay JWT.
1.4. Cách tạo khóa API từ SmsMk365.Com
Để tạo khóa API, bạn đi tới khu vực CÔNG CỤ => kích vào menu KHÓA API (1) => Kích vào nút THÊM KHÓA (2) => Trong cửa sổ THÊM KHÓA API hiện ra như Hình 1 bên dưới, bạn nhập thông tin vào đó.

Hình 1: Tạo khóa API từ SmsMk365.Com
* Trong đó:+ Ô Tên (3): Bạn nhập tên cho khóa API để phân biệt với các khóa API khác và để biết khóa API đó dùng cho website nào...
+ Ô Quyền (4): Chọn các quyền mà khóa API đó được quyền thực hiện.
=> Thực hiện xong, bạn nhấn nút LƯU (5) để hoàn thành.
*CHÚ Ý:
+ Để sửa thông tin của một khóa API, thì trong bảng danh sách các khóa API hiện ra như ở Hình 1 bên trên, bạn nhấn vào biểu tượng chiếc BÚT CHÌ ứng với khóa API cần sửa => và tiến hành sửa thông tin của nó.
+ Muốn xóa khóa API nào thì làm tương tự, bằng cách kích vào biểu tượng THÙNG RÁC ứng với khóa API cần xóa.
+ Để website của Bạn sử dụng được khóa API để thực hiện được các thao tác như: Thêm nhóm, tổ chức data khách hàng, tạo chiến dịch sms marketing...ngay tại website của bạn mà không cần truy cập trực tiếp vào SmsMk365.com thì bạn cần phải có một Lập trình viên cứng để lập trình tích hợp khóa API vào website của bạn.
+ Để tìm tài liệu về khóa API, các lệnh liên quan đến nó để tích hợp khóa API vào website của bạn thì bạn có thể tìm nó bằng cách kích vào nút DOCS (6) như ở Hình 1 bên trên. Hoặc đi tới khu vực CÁC TÀI LIỆU => Kích vào menu API là sẽ thấy được tài liệu dành cho API.
2. WebHook là gì? Tìm tài liệu WebHook của SmsMk365.com ở đâu?
2.1. WebHook là gì?
Webhook là một cơ chế cho phép một ứng dụng tự động gửi dữ liệu đến ứng dụng khác ngay khi có sự kiện xảy ra, thay vì phải chờ ứng dụng kia đến hỏi (polling).
Hiểu đơn giản thì Webhook giống như "chuông cửa thông minh" – khi có ai bấm chuông (sự kiện xảy ra), chuông lập tức phát tín hiệu (gửi dữ liệu) đến điện thoại của bạn (máy chủ đích). Bạn không cần phải liên tục mở camera để xem "có ai đứng ngoài cửa chưa" (polling) nữa.
2.1. Ví dụ thực tế:
2.1.1. Ví dụ 1:
Nếu tích hợp WebHook của SmsMk365.Com vào Form đăng ký thành viên trên website của Bạn, khi khách hàng đăng ký vào Form đó thì thông tin của khách hàng tự động nhẩy vào NHÓM KHÁCH HÀNG mà bạn đã chỉ định cho WebHook đó mà không cần phải quay lại SmsMk365.Com để nhập lại thông tin khách hàng vào NHÓM KHÁCH HÀNG đó.
2.1.2. Ví dụ 2:
Khi có tin nhắn mà khách hàng gửi đến điện thoại của bạn thì SmsMk365.Com sẽ nhận được sự kiện đó, thông qua WebHook, nó sẽ gửi thông báo và nội dung tin nhắn đó tới website của bạn qua link website mà bạn chỉ định. Qua đó, bạn có thể phân tích và xử lý thông điệp mà khách hàng gửi cho bạn.
2.3. Cách hoạt động của webhook:
1) Bạn đăng ký một URL (endpoint) với dịch vụ hỗ trợ webhook.
2) Khi sự kiện xảy ra (vd: thanh toán thành công), hệ thống sẽ tự động gửi một HTTP request (thường là POST) tới URL đó.
3) Ứng dụng của bạn xử lý dữ liệu nhận được (ghi log, cập nhật database, gửi email…).
2.4. Cách tạo WebHook từ SmsMk365.Com
Để tạo WebHook, bạn thực hiện theo số thự tự tăng dần ở Hình 2 bên dưới:

Hình 2: Cách tạo WebHook từ SmsMk365.Com
* Trong đó:+ Ô Tên (9): Nhập tên của WebHook để phân biệt với các WebHook khác.
+ Ô Nhận sự kiện (10): Chọn sự kiện cần bắt cho WebHook.
+ Ô URL (11): Nhập link trên website của bạn để lấy thông tin ngay khi WebHook bắt được. Bạn cần nhờ lập trình viên xử lý URL này cho bạn.
=> Sau khi thiết lập xong thì bạn kích vào nút LƯU (12) để hoàn thành.
2.5. Làm thế nào để lấy tài liệu về WebHook của SmsMk365.com?
Để tìm tài liệu về WebHook, các lệnh liên quan đến nó để tích hợp WebHook vào website của bạn thì bạn có thể tìm nó bằng cách kích vào nút DOCS (13) như ở Hình 2 bên trên. Hoặc đi tới khu vực CÁC TÀI LIỆU => Kích vào menu WEBHOOKS là sẽ thấy được tài liệu dành cho WEBHOOK.
3. Hành động (hay Action) là gì? Cách thiết lập Hành động (hay Action) như thế nào?
3.1. Hành động (hay Action) là gì?
Trong SMS Marketing hay WhatsApp Marketing, Hành động (hay Action) là Việc hệ thống tự động phản hồi lại tin nhắn của khách hàng khi tin nhắn của khách hàng chứa các từ khóa thỏa mãn điều kiện mà Bạn quy định với hành động.
🧠 Hiểu đơn giản:
Khi Khách hàng gửi cho bạn tin nhắn mà bên trong nó có từ liên quan tới Bảng giá hay Giá của sản phẩm là bao nhiêu? Thì lập tức phần mềm sẽ tự động gửi tới cho khách hàng thông tin chi tiết về bảng giá.
=> Như vậy, Hành động ở đây là Phần mềm tự động Gửi Bảng giá tới cho khách hàng khi trước đó Khách hàng gửi tin nhắn cho bạn có chứa từ "Bảng giá"...
3.2. Mục đích của SMS Action:
- Chăm sóc khách hàng tự động
- Tăng tỷ lệ chuyển đổi (conversion)
- Nuôi dưỡng mối quan hệ dài hạn
- Tiết kiệm thời gian cho đội sales/marketing
3.3. Cách tạo Hành Động/Action trong SmsMk365.Com
3.3.1. Tạo Hành động/Action với Hook
Bạn đi tới khu vực CÔNG CỤ => kích menu HÀNH ĐỘNG (14) => Kích vào nút HOOK (15) => Trong cửa sổ mới mở ra, bạn nhập thông tin vào cho nó.

Hình 3: Tạo Hành Động với WebHook
3.3.2. Tạo Hành động (Action) tự động phản hồi tin nhắn
Bạn đi tới khu vực CÔNG CỤ => kích menu HÀNH ĐỘNG (21) => Kích vào nút TỰ ĐỘNG TRẢ LỜI (22) => Trong cửa sổ mới mở ra, bạn nhập thông tin vào cho nó.

Hình 4: Tạo Hành động tự động trả lời tin nhắn
Ghi chú
*Mọi thắc mắc, Bạn vui lòng liên hệ với ĐẠI LÝ ĐỘC QUYỀN CỦA CHÚNG TÔI TẠI VIỆT NAM theo Số Hotline/Zalo: 0945.062.863 hoặc qua Form LIÊN HỆ để được hỗ trợ giải đáp trong thời gian sớm nhất.