External API Request

​

Cách tạo khối External API Request trong Flow Builder

1. Trong màn hình chỉnh sửa kịch bản, nhấp vào nút + (hoặc nút Create).
2. Rê chuột vào mục Actions $\rightarrow$ chọn Tools $\rightarrow$ chọn External API Request.
3. Một khối hành động mới sẽ xuất hiện trên giao diện thiết kế kịch bản.

​

Hướng dẫn cấu hình chi tiết External API Request

​

1. Phương thức kết nối (Request Method)

• GET: Dùng để tra cứu và lấy dữ liệu từ máy chủ (ví dụ: kiểm tra mã giảm giá, tra cứu tồn kho sản phẩm, lấy trạng thái đơn hàng).
• POST: Dùng để gửi dữ liệu mới tới máy chủ (ví dụ: đẩy thông tin khách hàng tiềm năng sang CRM, tạo đơn hàng mới, ghi nhận lượt đăng ký).
• PUT / PATCH: Dùng để cập nhật dữ liệu đã tồn tại trên máy chủ (ví dụ: đổi địa chỉ giao hàng, cập nhật điểm tích lũy).
• DELETE: Dùng để gửi yêu cầu xóa dữ liệu trên máy chủ.

​

2. Đường dẫn kết nối (Request URL / Endpoint)

​

3. Cấu hình Header (Request Headers)

• Authorization: Bearer YOUR_API_KEY (Xác thực tài khoản API).
• Content-Type: application/json (Khai báo định dạng gửi đi là JSON).

​

4. Dữ liệu gửi đi (Request Body - đối với POST/PUT)

{
  "full_name": "{{full_name}}",
  "phone": "{{phone}}",
  "email": "{{email}}",
  "selected_product": "{{product_code}}"
}

​

5. Xử lý phản hồi trả về (Response Mapping)

​

Cách 1: Ánh xạ lưu vào Custom Field (Response Mapping)

​

Cách 2: Trả về giao diện tương tác động (Dynamic Content)

​

Các ví dụ kịch bản ứng dụng thực tế

​

Ví dụ 1: Tra cứu trạng thái đơn hàng tự động

​

Ví dụ 2: Tự động lưu thông tin khách hàng vào CRM / Google Sheets

• Phương thức: POST
• URL: https://crm.yourcompany.com/api/v1/leads
• Request Body:
  {
    "name": "{{full_name}}",
    "phone": "{{phone}}",
    "email": "{{email}}",
    "source": "ChatbotX Messenger"
  }
  

​

Mẹo thực tiễn và Cảnh báo hệ thống