Đang tải dữ liệu
Vui lòng đợi...

Quay lại 871 Lượt xem
Khóa API, Webhook và Hành Động hay Flows với SmsMK365.com

Khóa API, Webhook và Hành Động hay Flows với SmsMK365.com

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 đó.

Tạo khóa API từ SmsMk365.Com

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:

Cách tạo WebHook từ SmsMk365.Com

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ó.

Tạo Hành Động với WebHook

Hình 3: Tạo Hành Động với WebHook

* Trong đó:
+ ô Tên (16): Nhập Tên cho Hành động để phân biệt với Hành động khác.
+ ô Nguồn (17): Chọn TIN NHẮN nếu muốn bắt hành động với kênh SMS, chọn WhatsApp nếu muốn bắt hành động với kênh WhatsApp.
+ ô Biến cố (18): Chọn ĐANG GỬI để khi Hệ thống tiến hành gửi SMS thì nó sẽ gửi thông tin tới cho WebHook. Chọn KHI NHẬN để khi khách hàng gửi tin cho Bạn thì phần mềm sẽ tự động gửi thông tin liên quan đến tin nhắn đó cho WebHook.
+ ô Cấu trúc liên kết (19): Bạn thay thế link http://someremoteurl.com/test.php bằng link WebHook trên website của Bạn (Bạn cần nhờ Lập trình viên xử lý lập trình để nhận dữ liệu ứng với link này).
=> Thiết lập xong, Bạn nhấn nút LƯU (20) để hoàn thành.
=> Như vậy tùy vào Nguồn (17) và Biến cố (18) mà mỗi khi gửi tin hoặc nhận tin thì phần mềm sẽ tự động truyền các thông tin liên quan tới WebHook cho bạn. Các dữ liệu truyền tới WebHook phụ thuộc vào các MÃ NGẮN mà bạn đưa vào với Link WebHook của bạn tương tụ ví dụ ở ô Cấu trúc liên kết (19).

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ó.

Tạo Hành động tự động trả lời tin nhắn

Hình 4: Tạo Hành động tự động trả lời tin nhắn

* Trong đó, bạn lưu ý:
+ ô Tên (23): Nhập Tên của Hành động để phân biệt với các Hành động khác.
+ ô Nguồn (24):  Chọn giá trị TIN NHẮN để hành động với kênh gửi sms. Chọn WHATSAPP để hành động với kênh gửi tin WhatsApp.
+ ô Điều kiện so sánh (25): Chọn giá trị ứng với điều kiện so sánh mà bạn muốn.
+ ô Thiết bị di động (26): Chọn điện thoại mà bạn muốn dùng để thực hiện Hành động.
+ ô Từ khóa kích hoạt hành động (27): Bạn nhập các từ khóa đáp ứng Điều kiện so sánh (25), để khi Nhận được tin nhắn từ khách hàng, nếu nó chứa từ khóa đó và thỏa mãn điều kiện so sánh thì Phần mềm tự động phản hồi lại khách hàng với Nội dung mà Bạn tổ chức ở Ô TIN NHẮN PHẢN HỒI (29) và Phần mềm sẽ sử dụng KHE CẮM SIM (28) để gửi tin nhắn cho khách hàng.
=> Thực hiện xong thì Bạn nhấn nút LƯU (30) để hoàn thành.




Ghi chú
  • Ở phiên bản mới menu được chuyển sang dạng menu Dọc

  • *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.

    Bài Viết liên quan
    Back To Top