User ID của LINE Login và Messaging API khác nhau? Kiểm tra provider
Nếu cùng một người có User ID khác nhau trong LINE Login và Messaging API, hãy kiểm tra LINE provider sở hữu từng channel trước. LINE cấp User ID theo provider: cùng một người có cùng ID trên các loại channel thuộc một provider, nhưng có ID khác nhau ở các provider khác nhau. Đừng gộp khách hàng theo tên hiển thị hoặc cho rằng thay token sẽ làm các ID khớp nhau.
Những điểm chính
- Kiểm tra provider trước khi thay đổi xác thực hoặc cấu hình webhook.
- API User ID, LINE ID dùng để tìm bạn và tên hiển thị là những khái niệm khác nhau.
- Không thể chuyển channel đã tạo sang provider khác.
- Chuẩn hóa cấu trúc tin nhắn không tạo ra danh tính khách hàng dùng chung cho mọi hệ thống.
Vì sao User ID của LINE Login và Messaging API khác nhau?
Tài liệu lấy User ID của LINE xác định rõ phạm vi: provider quyết định không gian định danh, không phải loại channel.
| Trường hợp so sánh | Quy tắc hoặc giới hạn kết luận | Cách xử lý trong ứng dụng |
|---|---|---|
| Cùng người dùng, Login và Messaging API trong cùng provider | Cùng User ID | So sánh ID đã xác minh trong provider đó |
| Cùng người dùng, khác provider | Khác User ID | Giữ riêng cho đến khi có quy trình liên kết tài khoản rõ ràng |
| Cùng tên hiển thị | Không chứng minh là cùng người | Không tự động gộp |
| LINE ID để tìm kiếm và API User ID | Hai định danh khác nhau | Lấy đúng giá trị API, không dùng ID tìm kiếm trong hồ sơ |
Ví dụ, channel đăng nhập website và channel Messaging API của bộ phận hỗ trợ có thể do hai nhóm tạo dưới hai provider khác nhau. Đây là ví dụ cấu hình, không phải sự cố khách hàng được ghi nhận. Việc CRM không tìm thấy bản ghi trong tình huống này không chứng minh LINE bất ngờ thay đổi danh tính người dùng.
Cũng cần phân biệt từ provider: LINE provider là nhóm sở hữu channel trong LINE Developers Console. Trường provider: line của UnifyPort chỉ nền tảng nhắn tin. Hai khái niệm này không phải cùng một không gian định danh.
Kiểm tra nguồn trước khi thay đổi cấu hình
- Xác định nguồn của cả hai ID. Ghi lại channel và giá trị đến từ luồng Login đáng tin cậy hay webhook Messaging API. Không so sánh tên nhập thủ công với định danh API.
- Kiểm tra provider sở hữu. Mở từng channel trong Console, ghi lại provider và phân biệt môi trường thử nghiệm với môi trường thật. Tên channel giống nhau không chứng minh cùng chủ sở hữu.
- Dùng tài khoản thử nghiệm có kiểm soát. Đăng nhập và gửi tin bằng đúng tài khoản. So sánh bằng chứng đã xác minh ở máy chủ, không dùng ảnh chụp không liên quan hay dữ liệu hồ sơ chưa xác minh từ phía máy khách.
- Kiểm tra dữ liệu ứng dụng. Nếu cùng provider nhưng bản ghi khác nhau, hãy kiểm tra phiên cũ, người thực sự đăng nhập, nhầm môi trường và lỗi ánh xạ trường trước.
- Dừng các thao tác gộp chưa chắc chắn. Giữ cả hai bản ghi nguồn khi điều tra. Không ghi đè ID chỉ để truy vấn tìm được kết quả.
Nếu vấn đề thực sự là nhiều công cụ tranh quyền sử dụng thông tin xác thực hoặc webhook của một Official Account, hãy xem checklist dùng nhiều công cụ với một LINE Official Account. Đó là vấn đề khác với phạm vi User ID.
Nếu channel đã nằm dưới các provider khác nhau
Hướng dẫn bắt đầu với LINE Login nêu rõ không thể chuyển channel đã tạo sang provider khác. LINE khuyến nghị tạo Login và Messaging API channel cần liên kết trong cùng provider ngay từ đầu.
Với hệ thống đang chạy, đừng coi xóa rồi tạo lại channel là sửa đổi vô hại. Trước khi lập kế hoạch thay thế, hãy kiểm kê các luồng đăng nhập, thông tin xác thực, callback và tham chiếu danh tính đã lưu. Channel mới không bảo đảm các ánh xạ CRM cũ sẽ được giữ nguyên.
Đề xuất thiết kế dữ liệu nội bộ: tách danh tính bên ngoài khỏi hồ sơ khách hàng nội bộ. Lưu hệ thống nguồn, LINE provider, channel xuất xứ và User ID, rồi quản lý riêng mối liên hệ đã xác minh với khách hàng. Đây là dữ liệu quản lý của ứng dụng, không phải trường mới trong webhook LINE.
Khi cần liên kết xuyên provider, hãy dùng quy trình rõ ràng để xác minh quyền kiểm soát các tài khoản liên quan và lấy sự đồng ý của người dùng. Lưu căn cứ liên kết và hỗ trợ hủy liên kết. Tên hoặc ảnh đại diện giống nhau là chưa đủ. Ngay cả khi ID bằng nhau trong một provider, quyền và sự đồng ý cũng không tự chuyển sang quy trình khác.
Tách danh tính UnifyPort khỏi đích trả lời
Giao diện không chính thức của UnifyPort cung cấp một luồng tin nhắn riêng cho tài khoản đã kết nối. Hợp đồng sự kiện chuẩn gồm provider, account_id, data.sender.id và data.conversation.id. Sender chỉ người gửi; conversation chỉ cuộc trò chuyện. Đặc biệt không được nhầm hai giá trị này trong nhóm.
| Bản ghi nội bộ | Phạm vi đề xuất |
|---|---|
| Danh tính LINE chính thức | Tenant ứng dụng, LINE provider, User ID đã xác minh |
| Người gửi UnifyPort | Workspace, provider, account_id, data.sender.id |
| Cuộc trò chuyện UnifyPort | Workspace, provider, account_id, data.conversation.id |
| Liên hệ với khách hàng nội bộ | Liên kết rõ ràng, đã xác minh tới danh tính nguồn tương ứng |
Đây là thiết kế lưu trữ thận trọng, không phải tuyên bố UnifyPort chuyển đổi User ID LINE chính thức. Hợp đồng công khai không mô tả khả năng đó. Không xóa tiền tố, đổi chữ hoa chữ thường hoặc suy ra tính tương đương từ các chuỗi trông giống nhau.
Tài liệu danh sách liên hệ trả riêng id, conversation_id và provider_user_id; để tìm cuộc trò chuyện hoặc gửi tin, tài liệu hướng dẫn dùng conversation_id. Hãy giữ ánh xạ nhận được thay vì thay trực tiếp bằng ID liên hệ. Ranh giới này cũng quan trọng trong đồng bộ tên liên hệ WhatsApp, nhưng không được áp dụng hành vi contact.updated trong bài đó cho LINE. Tương tự, một inbox có cả WhatsApp và Zalo vẫn cần giữ ngữ cảnh nguồn, không mặc định mọi kênh có cùng khả năng.
Trước khi thay đổi liên kết danh tính, xác minh và lưu bền vững sự kiện theo hợp đồng giao webhook. Chữ ký hợp lệ xác thực dữ liệu được giao; nó không chứng minh hai tài khoản bên ngoài thuộc cùng một người.
Kiểm thử nghiệm thu và giới hạn
Trước khi bật liên kết CRM, hãy thử cùng người dùng trong một provider, cùng người dùng ở hai provider, hai người trùng tên và các tài khoản nhắn tin UnifyPort khác nhau. Kết quả không khớp hoặc không rõ ràng phải để danh tính riêng biệt, không âm thầm gộp lịch sử trò chuyện.
Cũng cần thử tin nhắn nhóm: việc chọn người gửi không được vô tình thay thế cuộc trò chuyện cần trả lời bằng một đích khác. Định tuyến nên độc lập với thao tác gộp hồ sơ khách hàng về sau.
Nếu yêu cầu là liên kết danh tính LINE Login với Official Account, hãy dùng channel chính thức. UnifyPort không chuyển channel, cấp quyền chính thức hay tự xác lập tính tương đương danh tính giữa các provider.
Câu hỏi thường gặp
LINE Login và Messaging API có phải trả cùng User ID không?
Có, nếu là cùng người dùng LINE trong cùng provider. Khác provider sẽ được cấp ID khác nhau.
Có thể sửa bằng cách chuyển channel không?
Không. LINE nêu rõ channel hiện có không thể chuyển sang provider khác. Hãy lập kế hoạch sở hữu trước khi tạo các channel cần liên kết.
Tên hiển thị hoặc UnifyPort sender ID có tự giải quyết việc không khớp không?
Không. Tên không phải khóa định danh và không có tài liệu về phép chuyển từ User ID LINE chính thức sang UnifyPort sender ID.
Bước tiếp theo và nguồn
Trước tiên, ghi lại provider của hai channel chính thức. Nếu xây dựng inbox riêng cho tài khoản đã kết nối, hãy đọc cấu trúc sự kiện UnifyPort và thiết kế phạm vi định danh trước khi nhập liên hệ.
Tài liệu chính thức được kiểm tra ngày 2026-10-05:
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.