Trong Developers > Credentials, tạo một token cho tích hợp messages:write. Sao chép token khi tạo, lưu trữ trong backend và cấu hình kết nối WhatsApp trên bảng điều khiển trước khi gửi.
Nhà phát triển API
API để kết nối WhatsApp với hệ thống và ứng dụng của bạn.
Tích hợp CRM, ERP, ứng dụng và hệ thống nội bộ với WhatsApp bằng REST API của WPP Marketing. Gửi văn bản và media, truy vấn tin nhắn và theo dõi trạng thái giao hàng qua webhooks. Cũng sử dụng MCP để tích hợp luồng của bạn với Official API. Tìm hiểu về MCP.
Khi nào sử dụng
Sử dụng Messaging API khi hệ thống của bạn cần gửi tin nhắn WhatsApp.
Sử dụng CRM của bạn để khởi tạo liên hệ, ERP của bạn để gửi cập nhật hoặc ứng dụng của bạn để thông báo cho khách hàng. L logic khi nào gửi nằm trong hệ thống của bạn; API thực hiện gửi qua kết nối đã cấu hình trên tài khoản. Đối với các tự động hóa thương mại sẵn có, sử dụng Events API.
Sử dụng POST /send-text cho văn bản hoặc POST /send-media cho phương tiện. Trên kết nối chính thức, văn bản và hình ảnh sử dụng mẫu đã cấu hình; âm thanh, video và tài liệu yêu cầu tin nhắn nhận từ khách hàng trong vòng 24 giờ qua.
HTTP 200 cho biết chấp nhận, không phải giao hàng. Với messages:read, sử dụng GET /messages và kiểm tra các trạng thái có sẵn cho kênh.
Đăng ký URL HTTPS và bật sự kiện trong bảng điều khiển. Sử dụng webhooks:read để truy vấn các lần thử tại GET /webhooks; endpoint này liệt kê các lần giao hàng, không đăng ký subscriptions.
Từ token đến lần gửi đầu tiên được bao gồm.
Trên máy chủ của bạn, thay SEU_TOKEN bằng thông tin xác thực và số bằng người nhận được ủy quyền cho thử nghiệm. Sử dụng một khóa duy nhất cho mỗi lần gửi và chỉ tái sử dụng cùng một khóa khi lặp lại cùng một yêu cầu.
Kiểm tra trạng thái HTTP và nội dung phản hồi. Đối với 401, kiểm tra token và tính hợp lệ của nó; đối với 403, xác minh phạm vi (scopes) và điều kiện tài khoản. Đối với 409, kiểm tra xem khóa đã được dùng với nội dung khác chưa. Đối với 429, tôn trọng Retry-After trước khi thử lại.
Sau đó kiểm tra GET /messages với messages:read hoặc theo dõi các webhook đã cấu hình. Xác nhận giao hàng phụ thuộc vào phản hồi của kênh.
cURLPOST /send-text
curl --request POST 'https://api.wppmarketing.com/send-text' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: pedido-10231-aviso-1' \
--data '{"number":"5511999999999","body":"Olá! Seu pedido foi atualizado."}'Văn bản, phương tiện, lịch sử và theo dõi các lần gửi.
Sử dụng các endpoint REST để tích hợp WhatsApp vào ứng dụng của bạn. API của WPP Marketing sử dụng kết nối được cấu hình trong tài khoản; để hoạt động với Official WhatsApp API, hãy cấu hình kết nối đó trong bảng điều khiển. Xem OpenAPI để biết định dạng, phạm vi, giới hạn và phản hồi của từng thao tác.
POST
/send-text
Gửi tin nhắn văn bản đến một số WhatsApp.
Texto
POST
/send-media
Gửi hình ảnh, âm thanh, video hoặc tài liệu qua URL HTTPS công khai, theo định dạng và điều kiện kết nối. Âm thanh sử dụng cùng endpoint này.
Mídia
GET
/messages
Xem lịch sử tin nhắn đã gửi kèm trạng thái và phân trang.
Histórico
GET
/webhooks
Kiểm tra các lần gửi webhook theo sự kiện, kết quả HTTP, số lần thử và phân trang.
Webhooks
DOC
Swagger / OpenAPI
Tài liệu tương tác với hợp đồng, ví dụ, trường bắt buộc và phản hồi dự kiến.
Docs
Phân tách kỹ thuật
Chọn tính năng phù hợp cho từng giai đoạn của tích hợp.
Gửi tin nhắn bằng Messaging API, kích hoạt tự động hóa thương nghiệp bằng Events API và nhận phản hồi qua webhooks. Ứng dụng của bạn có thể kết hợp các tính năng này theo luồng cần thiết.
Kết nối chính thức là kênh liên lạc; API của WPP Marketing là giao diện mà hệ thống của bạn sử dụng. Xem yêu cầu tại API chính thức của WhatsApp và cùng tồn tại.
Hệ thống của bạn gọi WPP Marketing để gửi tin nhắn văn bản hoặc đa phương tiện và để truy vấn lịch sử tin nhắn và các lần giao webhook.
Hệ thống của bạn gửi các sự kiện thương mại như đơn hàng được tạo, thanh toán được duyệt, vận chuyển hoặc giỏ hàng bị bỏ quên.
Hiểu các sự kiện và tự động hóa có sẵnWPP Marketing gửi các sự kiện chuẩn hóa về tạo, giao, đọc và lỗi đến URL mà bạn cung cấp.
Xem sự kiện trả hàng và theo dõi giao hàngSử dụng tài liệu tương tác để xác thực payload, xác thực và phản hồi trước khi đưa vào môi trường sản xuất.
Tokens phải được giữ ở backend. Không để lộ thông tin đăng nhập trên trang công khai, ứng dụng front-end hoặc kho mã.
Trong /send-text và /send-media, Idempotency-Key cho phép bạn lặp lại cùng một yêu cầu với phản hồi thành công trong tối đa 48 giờ. Tái sử dụng khóa với nội dung khác sẽ trả về 409. Không có khóa, gọi lại có thể làm gửi trùng lặp. Tuân thủ các header RateLimit và Retry-After; giới hạn yêu cầu khác với hạn ngạch gói.
Một chứng thức cho mỗi tích hợp, với các quyền cần thiết.
Trong bảng điều khiển, đặt tên cho token, chọn phạm vi (scopes) và thiết lập thời hạn tùy chọn. Token đầy đủ chỉ hiển thị một lần khi tạo. Danh sách cho phép kiểm tra lần sử dụng cuối, thời hạn và thu hồi quyền truy cập khi cần.
Khi thay đổi thông tin xác thực, cập nhật bí mật trên máy chủ của bạn và thu hồi thông tin trước đó. Không bao giờ sử dụng token của nhà cung cấp WhatsApp thay cho thông tin xác thực API.
Cho phép gửi văn bản và phương tiện. Chỉ cấp cho các tích hợp cần khởi xướng việc gửi.
Chúng cho phép tra cứu, tương ứng, lịch sử tin nhắn và các lần giao webhook. Thông tin xác thực gửi không tự động có các quyền này.
Cho phép gửi thông tin khách hàng, giỏ hàng và đơn hàng qua Events API tới các tự động hóa đã cấu hình trong tài khoản.
Kiểm tra cài đặt đã lưu, tự động hóa, số liệu và nhật ký gần đây để chẩn đoán. Có thể bao gồm dữ liệu cá nhân và nội dung tin nhắn: chỉ cấp cho các tích hợp và hỗ trợ được ủy quyền. Truy vấn này không kiểm tra kết nối với nhà cung cấp theo thời gian thực.
MCP và API chính thức của WhatsApp.
Kết nối công cụ AI với hoạt động WhatsApp của bạn bằng MCP của WPP Marketing. Tích hợp WhatsApp vào các luồng làm việc của trợ lý và đại lý, sử dụng Official API làm kết nối nhắn tin.
MCP kết nối các luồng của đại lý của bạn với tích hợp; API nhắn tin thực hiện các lượt gửi và kết nối chính thức tuân theo quy định của WhatsApp. Điều này không biến MCP thành chatbot bản địa cũng không thay thế việc cấu hình tài khoản. Nhóm hướng dẫn các hành động và yêu cầu tích hợp cho trường hợp sử dụng của bạn.
Sử dụng MCP như đường dẫn tích hợp giữa các công cụ AI và WhatsApp, bổ sung cho luồng công việc của hệ thống và đội ngũ của bạn.
Trao đổi với đội ngũ của chúng tôi về công cụ AI bạn đang sử dụng và các hành động bạn muốn kết nối với WhatsApp. Kiểm tra các yêu cầu và phạm vi phù hợp cho hoạt động của bạn.
Nói về tích hợp MCPSẵn sàng tích hợp hệ thống của bạn với WPP Marketing?
Mở Swagger để xem các endpoints của Messaging API, ví dụ payload, xác thực bearer token và các phản hồi dự kiến. Đối với sự kiện cửa hàng và phản hồi giao hàng, cũng xem Events API và Webhooks de status.