Hướng dẫn lấy dữ liệu bạn bè, nhóm và tra cứu số điện thoại qua API Zalo

Giới thiệu

Sau khi làm được phần gửi tin, phần tiếp theo nhiều đội kỹ thuật cần là lấy dữ liệu từ Zalo về hệ thống của mình. Trong tài liệu API hiện có của 3FTool, nhóm endpoint này gồm get_friends_list, get_friend_alias, get_groups_list, get_group_member, get_friend_request, get_sent_friend_request và get_users_info_by_phone_number.

Nhóm dữ liệu nào đang lấy được qua API

Nếu cần danh sách bạn bè, dùng get_friends_list. Nếu cần xem tên hiển thị hoặc alias, dùng get_friend_alias. Nếu cần dữ liệu nhóm, dùng get_groups_list và get_group_member. Nếu cần tra cứu thông tin người dùng theo số điện thoại, dùng get_users_info_by_phone_number. Đây là các tác vụ đủ thực tế cho CRM, hệ thống cộng đồng hoặc phần mềm bán hàng muốn gom dữ liệu về một nơi.

Bắt đầu lấy dữ liệu theo các bước ngắn

B1. Đăng nhập vào app.3ftool.com, thêm account Zalo cần lấy dữ liệu và tạo API key phù hợp.

B2. Chọn đúng nhóm dữ liệu đang cần lấy: bạn bè, nhóm, thành viên nhóm hay tra cứu theo số điện thoại.

B3. Test từng action riêng lẻ trong phần API trước khi gọi từ CRM hoặc phần mềm nội bộ.

B4. Chuẩn hóa cách lưu dữ liệu bên hệ thống của bạn, ví dụ lưu group_id, uid, số điện thoại và tên hiển thị.

B5. Chỉ sau khi dữ liệu trả về ổn định mới đưa vào quy trình lớn hơn như tìm khách hàng mới, phân nhóm khách hoặc chăm sóc lại.

Khi nào nên dùng từng endpoint

get_friends_list phù hợp khi cần đồng bộ tệp bạn bè để làm chăm lại hoặc kiểm tra dữ liệu. get_groups_list và get_group_member phù hợp khi nguồn khách đến từ nhóm hoặc cộng đồng. get_users_info_by_phone_number phù hợp khi phần mềm đang có sẵn số điện thoại và cần đối chiếu người dùng trước khi đi tiếp sang gửi tin hoặc đưa vào quy trình bán hàng.

{\n  "action": "get_users_info_by_phone_number",\n  "account_id": 20,\n  "phone_number": "0912345678"\n}

Lưu ý khi đưa dữ liệu API vào quy trình bán hàng

Đừng lấy dữ liệu chỉ để đó. Giá trị thật nằm ở chỗ dữ liệu này được đưa vào luồng tiếp theo, ví dụ đưa nhóm khách sang chiến dịch, xác định lead theo cộng đồng, hoặc đối chiếu số điện thoại rồi gửi tin nhắn follow-up. Nếu không gắn với một quy trình rõ ràng, dự án API rất dễ dừng ở mức chỉ “lấy được dữ liệu”.

Kết luận

Nhóm endpoint dữ liệu là phần rất quan trọng của cụm API Zalo trên 3FTool. Nó giúp bạn không chỉ gửi được tin nhắn, mà còn có dữ liệu bạn bè, nhóm và người dùng để nối Zalo vào CRM hoặc hệ thống nội bộ một cách bài bản hơn.

Nếu bạn đang bắt đầu từ nhu cầu gửi tin, hãy xem lại API Send Message Zalo và hướng dẫn gửi text, rich text và ảnh để hoàn chỉnh cụm triển khai.