← Tất cả bài viết
Cẩm nang

Không nhận được webhook bình luận TikTok? Kiểm tra polling và định tuyến

Đăng ký post.comment.created trong UnifyPort không tự bật polling bình luận TikTok. Polling mặc định tắt: hãy đặt provider_data.enable_comment thành giá trị Boolean true, rồi áp dụng bằng thao tác khởi động hoặc kết nối lại. Thay đổi khi tài khoản đang online yêu cầu kết nối lại. Endpoint nhận dữ liệu cũng cần được kiểm tra riêng. Khởi động thành công không chứng minh cấu hình polling đã được áp dụng; không có webhook cũng không chứng minh không ai bình luận.

Điểm chính

  • Tách việc phát hiện bình luận, áp dụng cấu hình kết nối, định tuyến và xử lý trong ứng dụng.
  • Xác nhận môi trường hỗ trợ và chuẩn bị bộ nhận trước khi bật polling.
  • Cấu hình webhook riêng của tài khoản có thể thay thế cấu hình workspace; khi bị tắt hoặc không khớp đăng ký, hệ thống không tự chuyển về workspace.
  • Thông báo là tín hiệu best-effort, không phải lịch sử đầy đủ hay quyền tự động trả lời.

Trước tiên, xác định bạn đang cấu hình webhook nào

Danh mục webhook chính thức của TikTok mô tả tên sự kiện và cấu trúc yêu cầu riêng. Tài liệu post.comment.created của UnifyPort là một hợp đồng khác: thông báo bình luận TikTok được chuẩn hóa sau bước nhận diện và kiểm tra bài đăng thuộc tài khoản đang kết nối.

Điền tên sự kiện UnifyPort vào TikTok Developer Portal không cấu hình UnifyPort thay bạn. Hãy tách bộ nhận webhook chính thức của TikTok khỏi giao diện không chính thức kết nối tài khoản hiện có. Bài này nói về đường kết nối thứ hai, không phải tin nhắn chăm sóc khách hàng TikTok Shop hay DM.

Nếu chưa kết nối tài khoản nhắn tin, hãy hoàn tất quy trình xác thực TikTok bằng QR trước. Xác thực thành công và kết nối đang chạy chỉ là điều kiện ban đầu, không phải bằng chứng đã bật polling bình luận.

Kiểm tra lần lượt bốn ranh giới

Ranh giớiBằng chứng cần kiểm traĐiều chưa thể kết luận
Phát hiệnMôi trường hỗ trợ và đã chủ động bật pollingMọi bình luận trong lịch sử đều được tìm thấy
Kết nốiSau đổi cấu hình đã khởi động hoặc kết nối lại theo yêu cầuKhởi động thành công đồng nghĩa cấu hình polling đã áp dụng
Định tuyếnĐúng phạm vi endpoint, trạng thái active, đăng ký khớpNguồn phía trên đã tạo sự kiện
Xử lýSự kiện đã xác minh, lưu bền vững và xử lýMọi bình luận đều được chuyển đến hoặc câu trả lời đã hiển thị công khai

Thứ tự này tránh việc thay khóa ký để xử lý polling đang tắt, hoặc kết nối lại liên tục chỉ vì sự kiện bị bộ lọc loại bỏ.

1. Kiểm tra cấu hình thực tế, không chỉ ô chọn trên giao diện

Tài liệu cập nhật tài khoản quy định provider_data.enable_comment chỉ nhận Boolean. true và false hợp lệ; chuỗi, số và null trả về 400 invalid_request. Lưu giá trị dự định và kết quả API thực tế trong quy trình quản lý cấu hình được bảo vệ.

Cẩn thận với provider_data: bỏ qua trường này giữ nguyên cấu hình, còn {} sẽ xóa cấu hình. Đừng mặc định rằng gửi một phần đối tượng lồng nhau sẽ hợp nhất với toàn bộ giá trị hiện có. Chuẩn bị cấu hình mong muốn từ nguồn được kiểm soát, giữ các giá trị cần thiết và không ghi bí mật vào log. Phản hồi đọc đã lược bỏ cấu hình nhạy cảm không phải bản sao lưu đầy đủ.

Với tài khoản online, lên kế hoạch thực hiện một lần kết nối lại runtime sau cập nhật. Với tài khoản đã xác thực nhưng đang dừng, dùng quy trình khởi động được tài liệu hóa khi phù hợp. Phối hợp với worker khôi phục tự động để tránh lệnh cạnh tranh. Hợp đồng công khai không định nghĩa khởi động thành công là “polling bình luận đã được xác minh”.

2. Tìm endpoint thực sự chi phối tài khoản này

Dùng danh sách webhook endpoints để kiểm tra riêng cấp workspace và cấp tài khoản. Không truyền account_id sẽ trả về endpoint của workspace; truyền tham số này chỉ trả về cấu hình độc lập của tài khoản, không bao gồm cấu hình kế thừa từ workspace.

Tài liệu cấu hình webhook nêu rằng cấu hình tài khoản có ưu tiên cao hơn workspace. Endpoint độc lập bị tắt hoặc đăng ký không khớp sẽ không tự chuyển về endpoint workspace. Vì vậy, bộ nhận workspace hoạt động tốt chưa đủ để xác nhận tuyến của tài khoản này.

Kiểm tra trạng thái và đăng ký của endpoint đang có hiệu lực. Thêm rõ post.comment.created, hoặc dùng lựa chọn rộng được hỗ trợ như ["*"]. Giữ lại đăng ký tin nhắn và xác thực vẫn cần dùng. Hướng dẫn bộ lọc sự kiện giải thích việc chọn sự kiện để chuyển đến, không phải bật polling ở nguồn.

Đừng xóa endpoint độc lập chỉ để thử chẩn đoán. Xóa cấu hình độc lập cuối cùng sẽ khôi phục kế thừa workspace cho các lần chuyển giao ban đầu tiếp theo, làm thay đổi nơi nhận sự kiện trong tương lai. Hãy xem đây là thay đổi định tuyến cần được duyệt rõ ràng.

3. Xác minh tiếp nhận mà không đoán trường bình luận

Tuân theo hợp đồng chuyển giao của UnifyPort: khi bật chữ ký, xác minh X-Device-Signature bằng HMAC-SHA256 trên X-Device-Timestamp, một dấu chấm và phần thân yêu cầu nguyên bản; đồng thời kiểm tra độ mới của dấu thời gian. Lưu bền vững sự kiện đã xác minh trước khi trả 2xx, và loại trùng loại sự kiện này bằng id trong phạm vi workspace.

Tài liệu xác định phần bao chung gồm id, type, provider, account_id, occurred_at và data, nhưng cho biết tài liệu trường chi tiết và mẫu thu thập thực tế vẫn đang được chuẩn bị. Đừng xây parser production dựa trên đường dẫn đoán như data.comment, cũng đừng tự tạo mẫu rồi coi đó là payload chính thức. Giữ phần bao đã xác minh để kiểm tra trong môi trường được kiểm soát, và xác nhận hợp đồng payload thực tế trước khi bật tự động hóa phụ thuộc các trường bên trong.

Dùng phép thử có kiểm soát, không tạo vòng lặp kết nối lại

Đây là quy trình chẩn đoán đề xuất, không phải kết quả kiểm thử đã thực hiện:

  1. Xác nhận tính năng có sẵn trong môi trường đích và chọn bài đăng thuộc tài khoản đang kết nối.
  2. Giữ trả lời tự động ở trạng thái tắt. Chuẩn bị bộ nhận có chữ ký và đăng ký đúng.
  3. Áp dụng giá trị Boolean cùng thao tác kết nối cần thiết một lần.
  4. Nhờ người tham gia kiểm thử được phép thêm một bình luận dễ nhận biết, rồi lưu tham chiếu gốc an toàn.
  5. Theo dõi riêng yêu cầu đến, xác minh chữ ký, lưu trữ, loại trùng và xử lý worker.

Nếu thiếu tín hiệu, giữ mã tài khoản và endpoint đã che dữ liệu nhạy cảm, kết quả cấu hình và thao tác, thời gian cùng request ID nếu có để điều tra. Không cam kết thời hạn nhận cố định: sự kiện có thể chậm, trùng, sai thứ tự hoặc bị thiếu. Một lần quan sát thành công chỉ chứng minh đường đi hoạt động trong lần thử đó, không chứng minh độ bao phủ đầy đủ.

Tắt polling không thu hồi sự kiện đã vào hàng đợi

Nếu cần dừng ngay các hành động nghiệp vụ, hãy tạm dừng worker thực hiện hành động với bình luận trong ứng dụng trước. Sau đó áp dụng enable_comment: false và kết nối lại theo yêu cầu nếu tài khoản online. Tiếp tục nhận an toàn các lượt chuyển giao đã vào hàng đợi theo chính sách lưu giữ của bạn; tài liệu nói rõ việc tắt không thu hồi chúng.

Tạm dừng worker là biện pháp của ứng dụng, không phải trường API mới. Giữ xử lý DM độc lập nếu cần tiếp tục. Sự kiện đến sau khi tắt không tự động chứng minh cấu hình thất bại.

Nếu sau này bật trả lời, dùng riêng quy trình trả lời bình luận cấp cao nhất. Thiếu parent_comment_id không chứng minh đó là bình luận cấp cao nhất có thể trả lời, và thông báo cũng không phải biên nhận được bảo đảm cho câu trả lời trước đó.

Câu hỏi thường gặp

Đăng ký post.comment.created có bật polling không?

Không. Bộ lọc webhook và provider_data.enable_comment là hai phần điều khiển khác nhau. Kết nối cũng phải áp dụng cấu hình.

running có nghĩa là giám sát bình luận hoạt động không?

Không. Nó mô tả trạng thái kết nối. Cấu hình, tuyến chuyển giao và quan sát có kiểm soát cần được xác nhận riêng.

Không có sự kiện nghĩa là không có bình luận mới?

Không. Thông báo có thể bị thiếu. Đừng trình bày sự im lặng như số đếm hoặc kho lịch sử đầy đủ.

Có thể dùng sự kiện này để kích hoạt trả lời DM tự động không?

Không. Đây là thông báo bình luận, không phải message.received. Xác minh bài đăng và bình luận đích trước khi thực hiện một hành động trả lời công khai riêng.

Bước tiếp theo và nguồn

Bắt đầu với tài liệu post.comment.created và ghi rõ ranh giới nào chưa được xác minh trước khi đổi cấu hình production.

Nguồn chính thức được kiểm tra ngày 2026-11-14:

UnifyPort API

Biến tích hợp nhắn tin thành một pipeline sản phẩm ổn định.

Bắt đầu bằng cách gửi qua một API, rồi đưa mọi tin nhắn inbound trở lại hệ thống kinh doanh bằng sự kiện chuẩn.