Ủy quyền WhatsApp

Ghép cặp QR của WhatsApp: gọi /auth/qr/start để bắt đầu phiên thiết bị. QR token đến qua account.auth.required và cũng có thể poll qua /auth/qr/check.

1. 1. POST /v1/accounts với provider=whatsapp, auth_mode=qrcode. Tùy chọn truyền provider_data.device_os / device_platform / proxy_config để kiểm soát dấu vết thiết bị hiển thị trên điện thoại.
2. 2. POST /v1/accounts/{account_id}/auth/qr/start để khởi động thiết bị. Trả về status=awaiting_qr_scan, nhưng chuỗi QR đến bất đồng bộ.
3. 3. Nghe sự kiện account.auth.required trên webhook — auth_payload.qr_code là chuỗi để UI render thành mã QR. Cũng có thể polling /auth/qr/check.
4. 4. Sau khi quét, events.PairSuccess (account.auth.succeeded) chứa JID thiết bị, theo sau là events.Connected (account.started). POST /v1/accounts/{account_id}/runtime/start sau đó là no-op.

• provider_data.device_os — Nhãn thiết bị tùy chọn hiển thị trong quá trình ghép cặp. Có thể để trống nếu không cần tên hiển thị riêng.
• provider_data.device_platform — Mã số platform thiết bị (1=CHROME, 2=FIREFOX, 5=SAFARI, 14=IOS_PHONE, 16=ANDROID_PHONE, ...). Phải đi kèm device_os mới có hiệu lực.
• provider_data.proxy_config — Cấu hình định tuyến mạng tùy chọn cho triển khai doanh nghiệp.

Ghép cặp WhatsApp theo số điện thoại: lưu số điện thoại trên tài khoản ngay khi tạo, sau đó nhập verify_code 8 ký tự trên điện thoại (Liên kết thiết bị → Liên kết bằng số điện thoại).

1. 1. POST /v1/accounts với provider=whatsapp, auth_mode=code, và provider_data.phone đặt thành số E.164 (chỉ số). Số điện thoại được lưu trên tài khoản và tự động tái sử dụng cho các thao tác xác thực sau.
2. 2. POST /v1/accounts/{account_id}/auth/start với body rỗng. Số điện thoại đã lưu được dùng lại; response mang verify_code 8 ký tự dưới auth_payload.
3. 3. Hiển thị verify_code cho người dùng. Điện thoại chấp nhận trong khoảng 3 phút — quá thời gian phải khởi động lại luồng.
4. 4. Sau khi ghép cặp xong, events.PairSuccess và events.Connected đến qua webhook giống luồng QR.

• provider_data.phone — Số điện thoại E.164 chỉ số (ví dụ 15551234567 không kèm +). Đặt giá trị này dưới provider_data.phone khi tạo tài khoản; các thao tác xác thực sau sẽ tự động tái sử dụng.