Hướng dẫn sử dụng External Requests trong chăm sóc khách hàng đa kênh

1. Giới thiệu về Yêu cầu Bên ngoài

Bạn có thể sử dụng các hành động yêu cầu bên ngoài để gọi các giao diện của bên thứ ba và sử dụng các phản hồi từ các giao diện thực tế để giúp bạn thu thập dữ liệu hoặc thực hiện các quy trình tự động tiếp theo.

Ví dụ:

• Thông qua yêu cầu bên ngoài, dữ liệu của khách truy cập (tên người dùng, số điện thoại di động, địa chỉ email và tin nhắn cuối cùng được gửi bởi khách truy cập) được gửi đến URL yêu cầu để đáp ứng mục đích thu thập và phân tích dữ liệu của nền tảng bên thứ ba.
• Thông qua yêu cầu bên ngoài, dữ liệu cụ thể được trả về và các biến tương ứng được tạo ra. Những biến này có thể được sử dụng trong hành động gửi tin nhắn để đáp ứng các yêu cầu phản hồi tự động cụ thể.

1.1 Giao diện API là gì?

API (Giao diện Lập trình Ứng dụng) là một phần quan trọng của ứng dụng. Giao diện là một công cụ cho phép các ứng dụng phần mềm khác nhau giao tiếp và trao đổi dữ liệu với nhau. Ứng dụng cung cấp một điểm vào để vận hành dữ liệu. Điểm vào này có thể là một hàm hoặc phương thức lớp, hoặc một địa chỉ URL hoặc một địa chỉ mạng. Khi khách hàng gọi điểm vào này, ứng dụng sẽ thực hiện thao tác mã tương ứng để hoàn thành chức năng tương ứng cho khách hàng.

1.2 Phương thức Yêu cầu HTTP

Các phương thức HTTP đề cập đến các phương thức được định nghĩa trong giao thức HTTP tiêu chuẩn được sử dụng để giao tiếp giữa máy khách và máy chủ. Những phương thức này xác định cách máy khách thao tác trên tài nguyên máy chủ, từ đó xác định hành vi của giao diện API tương ứng. Các phương thức phổ biến bao gồm:

• GET: Được sử dụng để yêu cầu máy chủ trả về biểu diễn của một tài nguyên cụ thể, thường được sử dụng để lấy dữ liệu. Phương thức GET không ảnh hưởng đến tài nguyên máy chủ và an toàn và idempotent.
  Giả sử bạn đang sử dụng một ứng dụng đọc tin tức và bạn muốn kiểm tra các tiêu đề tin tức hôm nay. Khi bạn mở ứng dụng và nhấp vào nút "Kiểm tra Tin tức", ứng dụng sẽ gửi một yêu cầu GET đến máy chủ để lấy dữ liệu tin tức hôm nay. Sau khi nhận được yêu cầu GET này, máy chủ sẽ trả về dữ liệu chứa các tiêu đề tin tức hôm nay để bạn có thể xem trong ứng dụng.
• POST: Được sử dụng để gửi dữ liệu đến máy chủ, thường được sử dụng để tạo tài nguyên mới hoặc thực hiện các thao tác không idempotent. Yêu cầu POST có thể thay đổi trạng thái của máy chủ hoặc có tác dụng phụ.
  Bây giờ giả sử bạn muốn đăng một bình luận trong cùng một ứng dụng đọc tin tức. Khi bạn đang đọc một tin tức, nhập bình luận của bạn vào hộp bình luận và nhấp vào nút "Đăng Bình luận". Ứng dụng sẽ gửi một yêu cầu POST đến máy chủ để gửi bình luận của bạn. Sau khi nhận được yêu cầu POST, máy chủ sẽ lưu bình luận của bạn vào cơ sở dữ liệu và trả về một phản hồi cho biết bình luận đã được đăng thành công.
• PUT: Được sử dụng để cập nhật hoặc thay thế tài nguyên đến máy chủ. Nó thường được sử dụng để thay thế hoàn toàn một tài nguyên được chỉ định hoặc tạo một tài nguyên mới, nhưng yêu cầu máy khách cung cấp một biểu diễn tài nguyên hoàn chỉnh. Yêu cầu PUT nên là idempotent, nghĩa là kết quả của nhiều lần gọi cùng một yêu cầu PUT nên nhất quán.
  Khi bạn chỉnh sửa hồ sơ của mình, bạn có thể sử dụng phương thức PUT. Ví dụ, nếu bạn cập nhật thông tin hồ sơ (như tên, ngày sinh, ảnh đại diện, v.v.) trên một nền tảng mạng xã hội, khi bạn nhấp vào nút "Lưu", máy khách sẽ gửi một yêu cầu PUT đến máy chủ để gửi hồ sơ đã cập nhật đến máy chủ, và máy chủ sẽ sử dụng thông tin này để cập nhật hồ sơ của bạn.
• DELETE: Được sử dụng để yêu cầu máy chủ xóa tài nguyên được chỉ định. Nó thường được sử dụng để xóa tài nguyên được chỉ định. Yêu cầu DELETE nên là idempotent, nghĩa là kết quả của nhiều lần gọi cùng một yêu cầu DELETE nên nhất quán.
  Khi bạn xóa một bài đăng trên một nền tảng mạng xã hội, bạn có thể sử dụng phương thức DELETE. Khi bạn nhấp vào nút "Xóa", máy khách sẽ gửi một yêu cầu DELETE đến máy chủ, yêu cầu xóa bài đăng được chỉ định, và máy chủ sẽ xóa bài đăng và nội dung liên quan của nó.

2. Quy trình Thao tác cho Yêu cầu Bên ngoài

2.1 Thêm Hành động Yêu cầu Bên ngoài

Nhấp vào dấu + ở bên phải > nhấp vào Hành động Yêu cầu Bên ngoài > Hoàn thành thêm.

2.2 Cấu hình Yêu cầu Bên ngoài

2.2.1 Cấu hình URL Yêu cầu (Bắt buộc)

• Nhấp vào Yêu cầu Bên ngoài để mở cửa sổ cấu hình > Chọn phương thức yêu cầu (POST, GET, DELETE) > Điền URL yêu cầu theo nhu cầu.

• Theo nhu cầu, bạn có thể thêm dữ liệu người dùng và gọi URL yêu cầu. Nhấp vào dấu + > nhấp vào dữ liệu bạn muốn chuyển > và hoàn thành thêm. (Tùy chọn)

2.2.2 Điền vào Tham số Headers và Body (Tùy chọn)

• Thêm Headers hoặc Body theo URL yêu cầu. Nhấp vào Thêm > Điền.
• Tương tự, bạn có thể thêm dữ liệu người dùng. Nhấp vào dấu + và chọn dữ liệu người dùng tương ứng theo nhu cầu.

2.2.3 Kiểm tra Yêu cầu

Bạn có thể kiểm tra nội dung bạn vừa điền để xem cuộc gọi có thành công hay dữ liệu phản hồi.

• Nhấp vào Kiểm tra Yêu cầu để bắt đầu kiểm tra.
• Nếu dữ liệu trả về bất thường, bạn có thể sửa đổi dữ liệu, nhấp vào Yêu cầu Lại, và kiểm tra lại.

2.2.4 Sử dụng Ánh xạ Phản hồi

• Bạn có thể sử dụng nội dung được trả về bởi phản hồi bên ngoài, gán nó cho biến tương ứng và sử dụng nó trong hành động gửi tin nhắn.
• Nhấp vào Thêm > Nhập nội dung phản hồi theo yêu cầu (phải được điền theo định dạng đường dẫn JSON) > Điền các biến tương ứng trong tin nhắn sẽ được gửi theo biến được hiển thị sau đó, và việc gửi tin nhắn biến cụ thể tự động tiếp theo có thể được kích hoạt.

Lưu ý: Đối với định dạng đường dẫn Json, vui lòng tham khảo https://goessner.net/articles/JsonPath/, bao gồm một giới thiệu mẫu, như trong Hình 2.

3. Câu hỏi Thường gặp

3.1 Tôi có thể Lấy Dữ liệu của Toàn bộ Dữ liệu không?

Không, bạn chỉ có thể lấy một trong các mục dưới dữ liệu.

3.2 Nhánh có thể Được Xác định Dựa trên Giá trị Trả về của Yêu cầu Bên ngoài không?

Hiện chưa được hỗ trợ. Hiện tại, giá trị trả về của yêu cầu bên ngoài chỉ hỗ trợ gửi tin nhắn.