Blog
Bài viết, hướng dẫn và thông báo từ nhóm UnifyPort.
- Hướng dẫn
Rời nhóm WhatsApp qua API: quy trình thực hiện an toàn
Dùng UnifyPort để rời nhóm WhatsApp với đúng tài khoản và ID nhóm. Tách việc rời nhóm khỏi xóa lịch sử, hàng đợi trả lời và xử lý kết quả chưa xác nhận.
Đọc thêm → - Hướng dẫn
Lỗi định dạng Telegram: gửi văn bản động an toàn bằng HTML
Kiểm tra parse_mode, escape tên khách hàng và câu trả lời đúng cách, đồng thời phân biệt Telegram Bot API với provider_data của UnifyPort.
Đọc thêm → - Hướng dẫn
Hiệu ứng đang tải trên LINE không hiện? Kiểm tra cuộc trò chuyện và thời điểm
Hiển thị hiệu ứng đang tải bằng chatId và loadingSeconds, chẩn đoán tình trạng không hiện hoặc biến mất sớm, đồng thời tách biệt với reply token.
Đọc thêm → - Hướng dẫn
Telegram Bot API 429: xử lý retry_after trong hàng đợi gửi
Lưu thời hạn retry_after, chia sẻ thời gian chờ giữa các worker và tách lỗi giới hạn tần suất khỏi lần gửi chưa rõ kết quả. Phân biệt hợp đồng Bot API và UnifyPort.
Đọc thêm → - Hướng dẫn
Đổi quản trị viên nhóm WhatsApp qua API: promote và demote
Bổ nhiệm hoặc gỡ quyền quản trị viên WhatsApp bằng UnifyPort với LID thành viên, kiểm tra vai trò và xác nhận kết quả, không nhầm với xóa khỏi nhóm.
Đọc thêm → - Hướng dẫn
Thêm và gỡ cảm xúc tin nhắn bằng UnifyPort
Gửi hoặc gỡ cảm xúc WhatsApp và Telegram với đúng tin nhắn đích và sender_id. Phân biệt thao tác gửi với webhook phản ánh cảm xúc.
Đọc thêm → - Hướng dẫn
Lấy liên kết mời nhóm WhatsApp qua API: đọc khác với đặt lại
Dùng UnifyPort để lấy liên kết mời nhóm WhatsApp, kiểm soát việc chia sẻ và cập nhật bản sao sau khi đặt lại trong ứng dụng, đúng giới hạn API.
Đọc thêm → - Hướng dẫn
Chuyển chat WhatsApp giữa các nhãn: quy trình API an toàn
Chuyển chat WhatsApp sang nhãn công việc mới bằng UnifyPort: thêm nhãn đích, kiểm tra rồi gỡ nhãn nguồn, giữ nguyên nhãn khác và xử lý kết quả chưa rõ.
Đọc thêm → - Hướng dẫn
Ghi chú liên hệ WhatsApp: đặt hoặc xóa tên hiển thị riêng
Đặt và xóa ghi chú liên hệ WhatsApp bằng UnifyPort. Phân biệt tên ở cấp tài khoản với bí danh CRM, đồng bộ danh bạ và gửi thẻ liên hệ.
Đọc thêm → - Hướng dẫn
Nhắc tên trong nhóm qua UnifyPort: sửa thẻ dạng văn bản trên WhatsApp và LINE
Ghép mentions ở cấp cao nhất với dấu đánh dấu trong nội dung; kiểm tra trường cũ và khác biệt hỗ trợ giữa WhatsApp, LINE cùng các kênh khác.
Đọc thêm → - Hướng dẫn
Gửi media bằng UnifyPort: kiểm tra URL và trạng thái giao tin
Tạo yêu cầu gửi ảnh, video và tệp đúng cấu trúc, kiểm tra khả năng của kênh và URL nguồn, phân biệt yêu cầu được chấp nhận với tin đã giao để tránh gửi trùng.
Đọc thêm → - Hướng dẫn
Đồng bộ tên liên hệ WhatsApp bằng webhook contact.updated
Hợp nhất thay đổi tên trong danh bạ WhatsApp: phân biệt trường bị lược bỏ với chuỗi rỗng, giữ biệt danh nội bộ và tách ID liên hệ khỏi ID hội thoại.
Đọc thêm → - Hướng dẫn
Theo dõi lỗi UnifyPort API bằng request_id và X-Request-Id
Lưu ID yêu cầu phía máy khách và máy chủ, xử lý phản hồi 204 và timeout, đồng thời tách truy vết API khỏi khử trùng lặp webhook và gửi lại.
Đọc thêm → - Hướng dẫn
Tải tin nhắn WhatsApp cũ hơn bằng yêu cầu lịch sử theo nhu cầu
Xây dựng chức năng tải tin nhắn cũ với UnifyPort: đăng ký sự kiện lịch sử, hợp nhất các lô bất đồng bộ, chọn mốc hợp lệ và không nhầm tiếp nhận với hoàn tất.
Đọc thêm → - Hướng dẫn
Album media qua webhook: gom ảnh mà không làm mất tin nhắn
Lưu từng mục bằng ID tin nhắn, gom album theo phạm vi tài khoản và cuộc trò chuyện, xử lý bản trùng, thiếu tổng số và ảnh đến muộn mà không suy đoán tính đầy đủ.
Đọc thêm → - Hướng dẫn
Thay signing secret của webhook UnifyPort một cách an toàn
Triển khai xác minh tạm thời bằng hai khóa, cập nhật signing_secret rồi loại bỏ khóa cũ theo tiêu chí rõ ràng—không tắt HMAC hoặc giả định có thời gian gia hạn ở máy chủ.
Đọc thêm → - Hướng dẫn
Trả lời trích dẫn trên WhatsApp: reply_token khác ID tin nhắn cha thế nào?
Gửi trả lời trích dẫn qua UnifyPort bằng reply_token của tin nhắn đã chọn, không phải ID tin nhắn cha. Xử lý token bị thiếu, invalid_reply_token và giới hạn kênh.
Đọc thêm → - Hướng dẫn
Xử lý LINE Unsend mà không làm tin nhắn đã xóa xuất hiện lại
Dùng message.deleted để dọn nội dung LINE đã thu hồi khỏi hộp thư, tìm kiếm và ngữ cảnh AI, đồng thời chặn sự kiện nhận hoặc sửa đến muộn khôi phục nội dung.
Đọc thêm → - Hướng dẫn
WhatsApp Passkey QR Authentication: thiết lập Webhook an toàn
Hướng dẫn WhatsApp QR + Passkey với UnifyPort: tạo messaging account, tiếp tục nhánh WebAuthn Passkey và xác minh signed inbound events.
Đọc thêm → - Hướng dẫn
Telegram getUpdates và setWebhook bị xung đột: runbook chuyển đổi an toàn
Khi bot Telegram không nhận được updates sau khi chuyển giữa getUpdates và setWebhook, hãy dùng runbook này để kiểm tra chế độ nhận hiện tại, gỡ receiver cũ, xử lý pending updates và quyết định có nên dùng unified inbound webhook hay không.
Đọc thêm → - Hướng dẫn
File media Telegram trong Unified Webhook: ảnh, voice, tài liệu, liên hệ và vị trí
Xử lý media message của Telegram qua event message.received đã được UnifyPort chuẩn hóa: map text, attachment, contact và location, xác minh HMAC-SHA256 rồi lưu payload an toàn.
Đọc thêm → - Hướng dẫn
Zalo QR Authorization: xử lý qrcode_expired và nhận Webhook đã ký
Kết nối Zalo messaging account bằng QR authorization, xử lý qrcode_expired an toàn và xác thực message.received Webhook trước khi đưa tin nhắn vào hệ thống hỗ trợ.
Đọc thêm → - Hướng dẫn
Kết nối tài khoản TikTok vào signed webhook bằng QR authorization
Hướng dẫn nhận tin nhắn TikTok qua UnifyPort: tạo signed webhook trước, tạo tài khoản TikTok, poll trạng thái QR authorization và nhận sự kiện chuẩn hóa message.received.
Đọc thêm → - Hướng dẫn
Xây hàng đợi duyệt yêu cầu vào nhóm WhatsApp bằng UnifyPort
Biến yêu cầu vào nhóm WhatsApp thành một hàng đợi có thể xác minh chữ ký và kiểm tra lại: dùng group.join_request, API danh sách pending và API approve/reject theo lô.
Đọc thêm → - Hướng dẫn
Sau khi tạo UnifyPort API key: checklist kiểm tra Webhook đầu tiên
Checklist thực tế cho workspace UnifyPort mới: xác thực API key, tạo webhook endpoint có chữ ký, lưu sự kiện message.received và tránh các lỗi tích hợp thường gặp trong ngày đầu.
Đọc thêm → - Hướng dẫn
Dùng GitHub Copilot tạo TikTok DM Webhook Receiver
Đưa tài liệu webhook của UnifyPort cho GitHub Copilot để scaffold receiver TikTok inbound có kiểm tra HMAC-SHA256, lưu message.received và chuyển vào hàng đợi hỗ trợ.
Đọc thêm → - Hướng dẫn
Tích hợp inbound với UnifyPort: hãy bắt đầu từ Webhook
Checklist cho đội nhỏ: tạo signed webhook, xác minh message.received bằng HMAC-SHA256, lưu event trước khi nối WhatsApp, Zalo, LINE, Telegram, TikTok hoặc X vào CRM hay AI workflow.
Đọc thêm → - Hướng dẫn
Yêu cầu tham gia nhóm Telegram: Xây hàng đợi phê duyệt đáng tin cậy
Xây hàng đợi duyệt yêu cầu vào nhóm Telegram với danh sách chờ làm nguồn dữ liệu chính, webhook làm tín hiệu làm mới và thao tác phê duyệt hoặc từ chối theo lô.
Đọc thêm → - Hướng dẫn
Xử lý tin nhắn LINE đã chỉnh sửa bằng Webhook message.updated
LINE đã thêm sự kiện Webhook messageEdited cho các nhóm chat đủ điều kiện. Bài viết hướng dẫn hợp nhất thay đổi bằng message.updated của UnifyPort mà không tạo tin nhắn trùng trong hộp thư chung.
Đọc thêm → - Hướng dẫn
Cách đồng bộ trạng thái đã đọc và chưa đọc WhatsApp trong hộp thư dùng chung
Xây dựng đồng bộ trạng thái hộp thư WhatsApp đáng tin cậy bằng thao tác đọc/chưa đọc, biên nhận đọc và sự kiện conversation.updated của UnifyPort.
Đọc thêm → - Hướng dẫn
Cách xử lý reaction của tin nhắn bằng webhook hợp nhất
Hướng dẫn xử lý an toàn sự kiện message.reaction của UnifyPort: xác định tin nhắn gốc, phân biệt thêm và gỡ emoji, xác minh HMAC-SHA256 và cập nhật trạng thái theo cách idempotent.
Đọc thêm → - Hướng dẫn
Bộ lọc sự kiện UnifyPort Webhook: dùng subscribed_events hay Wildcard?
Cách chọn danh sách subscribed_events cụ thể hoặc ["*"] khi tạo UnifyPort Webhook, kèm cấu hình cho hộp thư đến, trạng thái tài khoản và bộ thu thập toàn bộ sự kiện.
Đọc thêm → - Hướng dẫn
Cách luân chuyển UnifyPort API Key không gây gián đoạn
Thay UnifyPort API Key an toàn: tạo key thứ hai, triển khai và kiểm tra trước, rồi mới vô hiệu hóa key cũ. Bài viết cũng giải thích khi nào không nên gọi rotate endpoint ngay lập tức.
Đọc thêm → - Hướng dẫn
WhatsApp Contact API: thêm liên hệ hay gửi vCard?
Phân biệt việc thêm một người vào danh bạ của tài khoản WhatsApp đã kết nối với việc gửi vCard trong cuộc trò chuyện, kèm route, field và error chính xác của UnifyPort.
Đọc thêm → - Hướng dẫn
Kết nối tài khoản người dùng Telegram với webhook: mã đăng nhập và QR
Hướng dẫn cấu hình Telegram API ID/API hash, webhook có chữ ký và xác thực bằng mã hoặc QR để nhận sự kiện message.received.
Đọc thêm → - Hướng dẫn
Khôi phục runtime cho tài khoản nhắn tin: Refresh, Reconnect, Start hay xác thực lại?
Dùng runtime_status và trạng thái xác thực để chọn đúng thao tác khôi phục UnifyPort, tránh khởi động lại kết nối đang tốt hoặc nhầm lỗi kết nối với lỗi xác thực.
Đọc thêm → - Hướng dẫn
Webhook TikTok Shop Customer Service API: Checklist lên production
Thiết lập webhook New Message cho TikTok Shop Customer Service API với xác minh chữ ký, phản hồi nhanh, xử lý idempotent, đối soát lịch sử và kiểm thử nghiệm thu.
Đọc thêm → - Hướng dẫn
Cách sửa lỗi Telegram API_ID_PUBLISHED_FLOOD: checklist khôi phục
Khắc phục Telegram API_ID_PUBLISHED_FLOOD bằng cách thay API ID mẫu đã công khai bằng thông tin ứng dụng của bạn, phân biệt lỗi xác thực và kiểm thử lại an toàn.
Đọc thêm → - Hướng dẫn
Tái xét duyệt LINE MINI App: từ Approved đến Reflected
Biết thay đổi nào của LINE MINI App đã xác minh cần tái xét duyệt, cách Approved thành Reflected và giới hạn tự phát hành sau 30 ngày.
Đọc thêm → - Hướng dẫn
Xử lý lỗi LINE MINI App Service Message API: 400, 401, 403, 429 và 500
Tách bước cấp token và gửi tin để chẩn đoán lỗi LINE MINI App Service Message API, lưu token mới đúng cách và chọn chiến lược retry an toàn theo status.
Đọc thêm → - Hướng dẫn
Cần xác minh gì sau khi WhatsApp Embedded Signup hoàn tất
Kiểm tra WABA, quyền system user, trạng thái số, đăng ký webhook và lần phân phối đầu tiên sau Embedded Signup trước khi kích hoạt tenant.
Đọc thêm → - Hướng dẫn
Triển khai send guard WhatsApp 24 giờ cho phản hồi trong queue
Dùng state machine ở server để chặn phản hồi WhatsApp đã hết hạn, xử lý việc đặt lại cửa sổ và chọn đường gửi hợp lệ ngay trước khi gửi.
Đọc thêm → - Hướng dẫn
Telegram Bot API 10.2 Communities: Xử lý sự kiện thêm và gỡ chat
Hướng dẫn xử lý community_chat_added và community_chat_removed trong Telegram Bot API 10.2, đối soát bằng getChat và tách cấu trúc Community khỏi luồng tin nhắn đa kênh.
Đọc thêm → - Hướng dẫn
Cách chuyển khỏi LINE Mark as Read API cũ trước cuối tháng 10/2026
Chuyển từ LINE Mark as read API (old) cần đăng ký sang POST /v2/bot/chat/markAsRead, xử lý markAsReadToken từ webhook và giữ Official Account Chat hoạt động.
Đọc thêm → - Hướng dẫn
Khôi phục Webhook thanh toán LINE MINI App bị bỏ sót: Runbook đối soát 7 ngày
Khôi phục Webhook thanh toán LINE MINI App bị bỏ sót bằng lịch sử sự kiện chính thức trong 7 ngày, phân trang cursor, idempotency theo orderId và quy trình đối soát an toàn.
Đọc thêm → - Hướng dẫn
Cách gửi tin nhắn dịch vụ LINE MINI App bằng token thông báo
Hướng dẫn phát hành, lưu trữ, gia hạn và sử dụng token thông báo dịch vụ LINE MINI App qua các endpoint chính thức, kèm giới hạn và cách xử lý lỗi.
Đọc thêm → - Hướng dẫn
Cách gửi tin nhắn tạm thời của bot Telegram trong nhóm
Tìm hiểu quy tắc Bot API 10.2 cho phản hồi riêng tư trong nhóm: trigger hợp lệ, cửa sổ 15 giây, quyền quản trị viên, giới hạn phân phối và cách sửa hoặc xóa.
Đọc thêm → - Hướng dẫn
Chống phát lại webhook HMAC: timestamp, retry và idempotency
Ngăn webhook request bị phát lại bằng cách xác minh timestamp RFC 3339 và chữ ký HMAC-SHA256 của raw body, rồi loại trùng retry hợp lệ theo event ID.
Đọc thêm → - Hướng dẫn
Di chuyển WhatsApp Embedded Signup v4: Checklist Coexistence trước ngày 15/10/2026
Meta sẽ ngừng Embedded Signup v2 vào ngày 15/10/2026. Hãy chuyển quy trình onboarding WhatsApp Coexistence sang v4 theo checklist về cấu hình, webhook, callback và rollout này.
Đọc thêm → - Hướng dẫn
Cách theo dõi phí WhatsApp service message trước ngày 1 tháng 10 năm 2026
Xây dựng kế hoạch đo lường trước khi WhatsApp bắt đầu tính phí service message vào ngày 1 tháng 10 năm 2026 bằng Pricing Analytics và status webhook, không nhầm lẫn conversation, message category hay phí AI agent.
Đọc thêm → - Hướng dẫn
Xây dựng n8n WhatsApp AI Agent từ inbound webhook có chữ ký
n8n rất phù hợp cho AI workflow, nhưng tự động hóa chăm sóc khách hàng WhatsApp cần một inbound event stream ổn định trước. Bài viết này hướng dẫn nối webhook message.received có chữ ký của UnifyPort vào n8n production workflow.
Đọc thêm → - Hướng dẫn
TikTok Data Portability không phải luồng tin nhắn trực tiếp: xây hàng đợi inbound cho đội hỗ trợ
TikTok Data Portability API đã mô tả rõ hơn dữ liệu xuất từ tin nhắn trực tiếp, nhưng dữ liệu xuất không phải luồng chăm sóc khách hàng theo thời gian thực. Đây là cách xây hàng đợi inbound TikTok có chữ ký bằng UnifyPort webhook.
Đọc thêm → - Hướng dẫn
Đưa tài liệu Webhook cho Devin Desktop, 20 phút có ngay handler nhận tin LINE
Nhật ký build: đưa tài liệu API UnifyPort cho Devin Desktop (tên cũ Windsurf), dựng handler nhận tin LINE bằng Python — xác thực HMAC-SHA256, log có cấu trúc, mở rộng đa nền tảng — không cần LINE Official Account.
Đọc thêm → - Hướng dẫn
Tôi cho Cursor đọc tài liệu Webhook — 30 phút sau có luôn relay Telegram sang Slack
Nhật ký build: đưa tài liệu Webhook UnifyPort cho Cursor và để nó dựng một relay chuyển tin nhắn Telegram sang Slack bằng Node.js — xác minh chữ ký, định dạng Slack Block Kit, chuyển tiếp đa kênh — không cần đăng ký bot Telegram.
Đọc thêm → - Hướng dẫn
Tôi nhờ Claude Code xây một trình giám sát DM và mention trên X — hoàn toàn không đụng vào API của X
Nhật ký xây dựng: đưa tài liệu webhook UnifyPort cho Claude Code, để nó dựng trình giám sát DM và mention trên X bằng Node.js — xác minh chữ ký, log có cấu trúc, cảnh báo Discord — không tốn phí API tính-theo-lượt của X.
Đọc thêm → - Hướng dẫn
Tôi đưa tài liệu API cho Claude Code và nó xây luôn một Zalo Webhook Receiver
Nhật ký xây dựng: đưa tài liệu API của UnifyPort cho Claude Code, để nó dựng một webhook receiver cho Zalo bằng Python — xác minh chữ ký, ghi log tin nhắn, chuyển tiếp sang Slack — chưa đến một giờ.
Đọc thêm → - Hướng dẫn
Tôi chỉ cho một AI coding agent đọc tài liệu webhook, và nó dựng ra một bot tự trả lời chạy được
Một build log: đưa tài liệu webhook của UnifyPort cho một AI coding agent như Cursor hay Claude Code, rồi xem nó dựng một bot tự trả lời thật sự — kiểm tra chữ ký, định tuyến tin đến và gọi gửi trả lời — chỉ trong một buổi chiều.
Đọc thêm → - Hướng dẫn
Nhận tin nhắn đến trên WhatsApp mà không cần API chính thức
Những thay đổi của Meta năm 2026 — tính phí theo từng tin nhắn, bắt buộc xác minh doanh nghiệp và cấm bot AI đa năng — đã nâng rào cản của WhatsApp API chính thức. Nếu thứ bạn cần chỉ là nhận tin nhắn đến một cách ổn định, vẫn còn một con đường khác.
Đọc thêm → - Hướng dẫn
Quy tắc 12 giờ của TikTok Shop: Tại sao hệ thống CSKH cần kiến trúc hướng sự kiện
TikTok Shop đã đưa thời gian phản hồi DM vào điểm đánh giá sức khỏe cửa hàng. Xử lý thủ công tất yếu sụp đổ trong livestream. Tìm hiểu cách hệ thống hướng sự kiện xử lý traffic đột biến và thiết kế mở rộng đa kênh.
Đọc thêm → - Hướng dẫn
Telegram Bot-to-Bot API: Ý nghĩa với kiến trúc AI Agent
Telegram âm thầm trở thành nền tảng tỷ người dùng đầu tiên hỗ trợ giao tiếp native giữa các bot. Phân tích thay đổi kỹ thuật, tác động đến hệ thống đa tác nhân và những điều cần cân nhắc trước khi xây dựng.
Đọc thêm →