Function loại API

Giới thiệu

Function loại API cho phép người dùng tạo ra các API trung gian để giao tiếp và tự động hóa tương tác với các tài khoản mạng xã hội (như Zalo, Facebook) đã kết nối trên Bizflow Dashboard. Đây là công cụ phù hợp để xây dựng các giải pháp tích hợp, tự động trả lời, thực hiện hàng loạt tác vụ hoặc kết nối đến các hệ thống bên ngoài.

Đặc điểm nổi bật

Tạo API trung gian: Có thể định nghĩa các endpoint để thao tác với tài khoản mạng xã hội mà không phải thao tác trực tiếp với API gốc.
Lựa chọn Action: Các action được hỗ trợ đa dạng theo từng nền tảng (ví dụ: gửi tin nhắn, lấy thông tin hội thoại, kết bạn, v.v.).
Execution Mode:
- Immediate: Thực hiện ngay khi có request đến API này.
- Schedule: Lưu lại request vào hàng đợi để thực hiện theo lịch của Function Schedule (giúp tránh spam, rate limit).
Xác thực an toàn: API chỉ hỗ trợ method POST và sử dụng xác thực Bearer token.
Test API: Có sẵn giao diện test request ngay trên popup tạo/sửa function.

Cách tạo Function loại API

Truy cập: https://dash.bizflow.vn/accounts/<account_pid>/functions.
Nhấp [New Function]
Chọn loại Function: API
Thiết lập các trường thông tin:
- Tên function
- Mô tả (tùy chọn)
- Action: Chọn loại hành động tương tác (gửi tin nhắn, gửi lời mời bạn bè, v.v… tùy theo nền tảng).
- Execution Mode: Immediate/Schedule
Lưu lại để hệ thống khởi tạo endpoint.

[anh-tao-function-api]

Thông tin endpoint API

Sau khi tạo, mỗi function API sẽ có:

Endpoint URL: Được cung cấp ngay trong giao diện function.
Bearer Token: Kèm nút copy để sử dụng gắn vào header cho các request đến endpoint này.
Mô tả tham số: Mỗi action có các trường dữ liệu đầu vào/đầu ra cụ thể, bạn có thể xem chi tiết trong popup function.

Ví dụ:

POST https://public-api.bizflow.vn/functions/xxxxxx
Header: Authorization: Bearer <token>
Content-Type: application/json

Body:
{
    "recipient_id": "zalo_user_id",
    "message": "Xin chào! Đây là phản hồi tự động."
}

Chế độ thực thi

Immediate: Request khi gửi tới sẽ được xử lý ngay trên nền tảng và phản hồi kết quả tức thì.
Schedule: Request sẽ được thêm vào hàng đợi function schedule của account, chạy theo cấu hình số lượng, thời gian, tránh spam và vi phạm giới hạn API.

Test API

Tại popup function API có sẵn form nhập tham số test và nút Test API.
Kết quả trả về giúp kiểm tra nhanh việc tích hợp.

[anh-test-api-function]

Lưu ý

Hệ thống chỉ hỗ trợ method POST cho tất cả các API.
API chỉ hoạt động khi function đang ở trạng thái active.
Bearer Token liên kết với function, bảo mật tuyệt đối.
Có thể bật/tắt function tùy ý, áp dụng tức thời.

Ứng dụng điển hình

Xây dựng bot trả lời tự động tích hợp với CRM, AI/Chatbot ngoài.
Tự động gửi thông báo, chăm sóc khách hàng đa kênh.
Kết nối n8n, Zapier để tạo các quy trình tự động hóa nâng cao.

Nếu cần thêm thông tin hoặc hướng dẫn chi tiết cho từng action, vui lòng liên hệ bộ phận hỗ trợ Bizflow Dashboard.

PreviousFunctions NextFunction loại Schedule

Last updated 10 days ago

POST https://public-api.bizflow.vn/functions/xxxxxx Header: Authorization: Bearer <token> Content-Type: application/json Body: { "recipient_id": "zalo_user_id", "message": "Xin chào! Đây là phản hồi tự động." }