Hướng dẫn API Send Message Zalo: gửi text, rich text và ảnh

Giới thiệu

Trong tài liệu API hiện tại của 3FTool, nhóm endpoint được dùng nhiều nhất để gửi tin là send_message, send_message_richtext, send_image và send_images. Nếu bạn đang muốn dùng API để gửi tin nhắn Zalo thật sự, đây là nhóm cần nắm đầu tiên.

Các endpoint gửi tin hiện có trong 3FTool

Bạn có thể gửi tới user theo uid, theo phone_number hoặc gửi tới nhóm theo gid. Với text cơ bản, dùng send_message. Nếu cần nội dung có định dạng, dùng send_message_richtext với phần text_properties. Nếu cần hình ảnh, dùng send_image cho một ảnh hoặc send_images cho nhiều ảnh.

Bắt đầu gửi text qua API theo các bước ngắn

B1. Tạo API key và xác định rõ account Zalo sẽ dùng để gửi tin.

B2. Chọn kiểu nhận phù hợp: uid, phone_number hoặc gid.

B3. Gọi endpoint POST https://app.3ftool.com/api.php với action send_message và nội dung message.

B4. Test thành công với một tin text ngắn trước khi thêm rich text hoặc ảnh.

B5. Chỉ sau khi text chạy ổn định mới nối API vào website, CRM hoặc hệ thống nội bộ.

{\n  "action": "send_message",\n  "account_id": 20,\n  "phone_number": "0912345678",\n  "message": "Xin chào"\n}

Khi nào dùng rich text

Nếu nội dung cần nhấn mạnh một số phần như tên chương trình, số tiền, thời hạn hoặc thông tin quan trọng, bạn có thể dùng send_message_richtext. Trong tài liệu nội bộ, action này đi cùng text_properties để mô tả phần định dạng. Đây là cách phù hợp khi muốn nội dung gọn hơn, dễ đọc hơn so với một khối text thuần.

Khi nào nên gửi ảnh hoặc nhiều ảnh

Dùng send_image khi chỉ cần một ảnh minh họa và có thể kèm caption. Dùng send_images khi cần gửi nhiều ảnh trong cùng một request. Với các đội bán hàng, đây là cách rất hữu ích để gửi banner, ảnh sản phẩm, ảnh ưu đãi hoặc bộ hình giới thiệu mà không cần thao tác tay từng lần.

{\n  "action": "send_image",\n  "account_id": 20,\n  "uid": "1234567890",\n  "image_url": "https://images.example.com/banner.jpg",\n  "caption": "Ảnh giới thiệu sản phẩm"\n}

Lưu ý để gửi API ổn định hơn

Đừng nhảy ngay vào flow phức tạp. Hãy test text trước, sau đó mới tới rich text, rồi mới tới ảnh. Đồng thời nên tách riêng từng use case bằng key riêng để dễ theo dõi lỗi gửi tin, lỗi dữ liệu hoặc lỗi do account. Đây là cách làm thực tế nhất nếu bạn muốn API đi vào vận hành thật chứ không chỉ test một lần cho biết.

Kết luận

Nếu mục tiêu của bạn là dùng API send message Zalo để gửi tin thực tế, hãy bắt đầu từ nhóm endpoint cơ bản này. Chúng đã đủ để triển khai text, rich text, một ảnh hoặc nhiều ảnh và phù hợp cho rất nhiều use case CRM, website hoặc phần mềm riêng.

Sau bước gửi tin, bạn có thể xem tiếp hướng dẫn lấy dữ liệu bạn bè, nhóm và tra cứu số điện thoại để hoàn thiện luồng tích hợp.