Tài khoản và tích hợp
Kết nối hệ thống bên ngoài hoặc trợ lý
Tạo khóa Pro hoặc Agency có phạm vi giới hạn, đăng nội dung mới hoặc kết nối trợ lý.
Trước khi bắt đầu
Webhook nhận thông báo tin nhắn đến từ dịch vụ WhatsApp. Thiết lập máy chủ thuộc người vận hành tích hợp. Người dùng bảng điều khiển không cần đổi cài đặt máy chủ. MCP cho phép trợ lý yêu cầu công cụ tài khoản.
Các bước thực hiện
- Với tin nhắn đến, mở Cài đặt và tìm URL webhook (dành cho máy chủ WhatsApp).
- Chọn Sao chép để lấy địa chỉ chính xác cho bản triển khai tài khoản của bạn.
- Nhờ người vận hành cấu hình sự kiện đến cho thiết bị dự định bằng địa chỉ đó.
- Thu xếp tin thử đến từ số của bạn sau khi người vận hành xác nhận sẵn sàng.
- Kiểm tra kết quả mong đợi, như câu trả lời tự động khớp hoặc tin nhóm mới ghi nhận khi Nhật ký được bật.
- Với kết nối trợ lý, đăng nhập qua màn hình ủy quyền mà ứng dụng MCP của bạn mở.
- Kiểm tra ứng dụng được nêu tên và tài khoản trước khi phê duyệt truy cập.
- Để tích hợp gửi ra ngoài, mở Cài đặt → Tích hợp bên ngoài. Tạo khóa có tên cho một tài khoản đã kết nối và các nhóm được chọn rõ ràng. Lưu khóa ngay vì khóa chỉ hiển thị một lần. Sao chép URL cơ sở API.
- Ví dụ: Cấu hình Abacus.AI để tạo nội dung mới tại mỗi thời điểm trong tám lần đăng hằng ngày theo múi giờ America/Sao_Paulo. Gửi mỗi bài đăng đến ba nhóm được phép bằng một Idempotency-Key mới. Chỉ dùng lại khóa đó khi thử lại yêu cầu hoàn toàn giống nhau.
- Bỏ scheduled_at để đưa vào hàng đợi ngay, hoặc dùng dấu thời gian tuyệt đối có -03:00 hay Z (UTC), tối đa 30 ngày tới. Bộ xử lý kiểm tra mỗi phút; scheduled_at là thời điểm sớm nhất đủ điều kiện xử lý, không bảo đảm chuyển đến chính xác từng giây.
- Kiểm tra trạng thái tác vụ và kết quả của từng nhóm trước khi thử lại. Chỉ hủy các lần gửi chưa được phát đi. Thu hồi khóa bị lộ trong Cài đặt, rồi tạo và lưu khóa thay thế; tác vụ cũ không tiếp tục với khóa mới.
Ví dụ cụ thể
Các yêu cầu có giá trị giữ chỗ; thay ID và chọn ngày trong tương lai trước khi gửi. Những yêu cầu này sẽ đăng tin nhắn thật. curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'
Cách kiểm tra kết quả
Việc tiếp nhận tác vụ và kết quả đã tiếp nhận của từng nhóm xác nhận cổng đã tiếp nhận. Chúng không xác nhận đã chuyển đến hay đã đọc. Tác vụ hẹn giờ có thể bị chặn nếu quyền truy cập, khóa, tài khoản hoặc quyền nhóm thay đổi.
Điều cần biết
- Trợ lý có thể đọc bản ghi được cung cấp và gửi văn bản khi yêu cầu. Xem hướng dẫn công cụ trợ lý trước khi yêu cầu gửi.
- Dùng bảng điều khiển cho thao tác chỉnh sửa không có qua MCP.
- Quyền dùng API có trong gói Pro và Agency theo tháng hoặc năm. Starter cần nâng cấp. Khóa chỉ cho phép dùng tài khoản và nhóm đã chọn; thay tài khoản WhatsApp sẽ chặn việc gửi. Tuyệt đối không chia sẻ thông tin xác thực máy chủ.
- Văn bản hỗ trợ 4.096 ký tự; chú thích hỗ trợ 1.024 ký tự. Tải JPEG, PNG hoặc WebP tối đa 5 MiB qua các trường multipart payload và image. Không chấp nhận URL hình ảnh từ xa.
- Tác vụ mới trả về HTTP 202. Thử lại yêu cầu giống hệt với cùng Idempotency-Key sẽ trả về tác vụ ban đầu với HTTP 200; nội dung khác dùng cùng khóa sẽ trả về 409. Hết thời gian chờ sau khi phát đi có thể dẫn đến kết quả chưa xác nhận; đừng tự động gửi lại bằng khóa khác.
Vấn đề thường gặp
- Hiện tượng
- Không có trả lời hoặc bản ghi mới sau thử nghiệm.
- Cách xử lý
- Kiểm tra kết nối thiết bị và quy tắc hoặc cài đặt Nhật ký liên quan, rồi nhờ người vận hành xác minh cấu hình sự kiện đến.
- Kết quả mong đợi
- Tính năng cấu hình đúng có thể xử lý sự kiện mới phù hợp.
- Hiện tượng
- Trợ lý không ủy quyền được hoặc hiển thị tài khoản khác.
- Cách xử lý
- Trở lại đăng nhập và chọn tài khoản dự định; báo lỗi ủy quyền lặp lại cho người vận hành.
- Kết quả mong đợi
- Màn hình ủy quyền và bản ghi trả về thuộc đúng tài khoản.
Nhận thêm trợ giúp
Cung cấp tính năng và lỗi hiển thị cho người vận hành. Không đưa thông tin xác thực máy chủ vào cuộc trò chuyện trợ lý.