Hệ thống của bạn gọi Whatsplaid để xác thực tài khoản, quản lý liên hệ, thẻ, trường, cuộc trò chuyện, giỏ hàng, tin nhắn và hỗ trợ con người.
API công khai và tài liệu
Kết nối hệ thống của bạn với Whatsplaid thông qua API, bộ kết nối và webhook.
Sử dụng API công cộng khi hệ thống khác cần kích hoạt Whatsplaid. Sử dụng bộ kết nối bên ngoài khi trợ lý cần truy vấn sản phẩm, đơn hàng hoặc dữ liệu từ hệ thống của bạn trong cuộc trò chuyện. Sử dụng webhook để nhận các sự kiện được ghi nhận trên WhatsApp.
Ba hợp đồng
Chọn hướng tích hợp chính xác.
Tài liệu Swagger tách các luồng để tránh nhầm lẫn giữa các cuộc gọi đến Whatsplaid, các truy vấn do trợ lý thực hiện và các sự kiện gửi đến hệ thống của bạn.
Whatsplaid sẽ gọi hệ thống của bạn để tra cứu sản phẩm, đơn hàng, khách hàng hoặc tình trạng sẵn có theo thời gian thực trong quá trình trò chuyện.
Whatsplaid gửi các sự kiện đến một URL do bạn cung cấp. Sự kiện hiển thị trên bảng điều khiển là lead được ghi lại trong quá trình trò chuyện.
Swagger tại `api.whatsplaid.com/docs/` chứa các sơ đồ, ví dụ, phản hồi dự kiến và các hợp đồng kỹ thuật đầy đủ.
Tham khảo nhanh các endpoints chính.
Chế độ xem này tóm tắt các tính năng xuất hiện trong tài liệu chính thức. Việc triển khai cuối cùng phải tuân theo Swagger.
GET
/store
Trả về dữ liệu tài khoản, cửa hàng thương mại điện tử được kết nối và các mô-đun đang hoạt động.
Account
GET
/modules
Danh sách các mô-đun đang hoạt động, như leads, tư vấn bán hàng, hậu mãi, cơ sở tri thức và giỏ hàng.
Account
GET
/ecommerce/products/search
Tìm kiếm sản phẩm trong các tích hợp gốc đã kết nối, chẳng hạn như Nuvemshop, Wix hoặc Shopify.
Ecommerce
GET
/ecommerce/orders/search
Tìm đơn theo số, email hoặc điện thoại trong các tích hợp gốc đã kết nối.
Ecommerce
POST
/contacts
Tạo hoặc cập nhật liên hệ sử dụng số điện thoại làm khóa chính.
Contacts
PATCH
/contacts/{contactId}/custom-fields
Cập nhật trường tùy chỉnh cho mục tiêu và ngữ cảnh vận hành.
Fields
POST
/messages/send
Gửi tin nhắn văn bản trong cửa sổ hỗ trợ 24 giờ của WhatsApp.
Messaging
POST
/handoffs
Yêu cầu hỗ trợ từ con người bằng cách sử dụng cấu hình hiện tại của công ty.
Handoff
Hợp đồng kỹ thuật
Tài liệu bao gồm API, bộ kết nối bên ngoài và webhooks.
Menu tích hợp của ADMIN sử dụng cùng sự phân tách: Whatsplaid Public API, bộ kết nối bên ngoài để truy vấn trong hệ thống nội bộ và webhook đầu ra cho các lead được thu thập.
Xác thực tài khoản, mô-đun, liên hệ, thẻ, trường tùy chỉnh, tin nhắn, cuộc trò chuyện, giỏ hàng và hỗ trợ con người.
Hệ thống của bạn công khai các endpoint như `/products/search` và `/orders/search` để Whatsplaid truy vấn trong cuộc trò chuyện.
Kết quả mong đợi với `products`, bao gồm ID, tên, mô tả, giá, tình trạng sẵn có, tồn kho, URL và hình ảnh.
Phản hồi mong đợi với `orders`, bao gồm số, trạng thái, thanh toán, vận chuyển, tổng, khách hàng, theo dõi và các mục.
Sự kiện `LEAD_CAPTURE` gửi dữ liệu khách hàng tiềm năng tới URL đã cấu hình. Endpoint phải trả về HTTP 200 hoặc 204.
Sử dụng `Authorization: Bearer` trong các gọi. Không được để lộ token trên giao diện frontend công khai.
Bạn có cần triển khai hoặc xác thực một tích hợp không?
Mở tài liệu tương tác để chuyển đổi giữa `Whatsplaid Public API`, `Custom Data Connector Contract` và `Outgoing Webhooks`.