Hotline: 0852 87 45 87
Dịch vụ khác

Hướng dẫn lấy App ID, App Secret và OA Secret Key từ Zalo

91 lượt xem

Hướng dẫn tìm, sao chép App ID, App Secret và OA Secret Key của đúng ứng dụng Zalo; phân biệt OA ID, bảo quản khóa và xử lý khi lấy nhầm thông số.

Hướng dẫn lấy App ID, App Secret và OA Secret Key từ Zalo

Bạn đang cần App ID, App Secret và OA Secret Key để kết nối Zalo với phần mềm? Hãy lấy cả ba thông tin trong ứng dụng trên Zalo for Developers. Chúng không nằm ở trang thông tin doanh nghiệp trong OA Manager.

Nếu chưa có tài khoản OA, hãy làm trước theo hướng dẫn đăng ký và xác thực Zalo OA. Sau khi có OA, hãy mở đúng ứng dụng mà doanh nghiệp của bạn có quyền quản lý. Nếu chưa có, xem cách tạo ứng dụng trên Zalo Developers.

1. Phân biệt App ID, App Secret, OA Secret Key và OA ID

  • App ID / ID ứng dụng: mã xác định ứng dụng đang kết nối. Sao chép ở mục Cài đặt của ứng dụng, không lấy mã OA điền thay.
  • App Secret / Khóa bí mật của ứng dụng: khóa dùng trong quá trình xác thực của ứng dụng, chẳng hạn khi hệ thống lấy hoặc làm mới thông tin truy cập. Khóa phải thuộc đúng App ID.
  • OA Secret Key: khóa tại mục Webhook của ứng dụng, dùng để kiểm tra thông báo sự kiện Zalo gửi về hệ thống có hợp lệ hay không. Dù có chữ “OA”, vị trí lấy khóa này là trang Webhook trong Zalo for Developers.
  • OA ID: mã của Official Account, xem ở OA Manager. Ví dụ OA Công ty Dybicom có mã 4133621167770884605; đây không phải App ID.

Access Token và Refresh Token là các mã truy cập được cấp khi thực hiện kết nối. Bạn không dùng những mã này thay cho App Secret hay OA Secret Key. Nếu dịch vụ tự quản lý token sau khi được cấp quyền, hãy kết nối theo hướng dẫn của dịch vụ, không tự tạo token rồi gửi qua tin nhắn.

2. Mở đúng ứng dụng trước khi lấy thông số

Đăng nhập Zalo Developers, mở danh sách ứng dụng rồi đối chiếu tên, App ID và hệ thống doanh nghiệp đang sử dụng. Nếu chưa có ứng dụng hoặc chưa biết tài khoản nào quản lý, làm theo hướng dẫn tạo và quản lý ứng dụng Zalo trước khi tiếp tục.

Khi đã mở đúng ứng dụng, giữ nguyên ứng dụng đó để lần lượt lấy App ID, App Secret và OA Secret Key. Đổi ứng dụng giữa chừng dễ làm bạn ghép ID của ứng dụng này với khóa của ứng dụng khác.

3. Lấy App ID và App Secret trong Cài đặt ứng dụng

  1. Chọn đúng ứng dụng trong danh sách, sau đó mở Cài đặt.
  2. Tìm ô ID ứng dụng. Sao chép đầy đủ dãy số và lưu dưới dạng văn bản nếu dùng bảng tính, để mã không bị chuyển thành số khoa học hoặc mất chữ số.
  3. Ở ô Khóa bí mật của ứng dụng, dùng biểu tượng sao chép. Nếu cần xem giá trị, dùng nút hiển thị theo giao diện và thực hiện yêu cầu bảo mật của Zalo.
  4. Chuyển khóa trực tiếp vào ô cấu hình bảo mật của hệ thống cần kết nối hoặc nơi lưu trữ an toàn do doanh nghiệp quy định.
  5. Kiểm tra App ID và App Secret được lấy trong cùng ứng dụng; không để khoảng trắng, dấu ngoặc hoặc xuống dòng thừa.

Vị trí ID ứng dụng và Khóa bí mật tại Cài đặt. Ảnh hướng dẫn của Zalo Platforms đã che thông tin; đây không phải thông số ứng dụng của DYBICOM.

Vị trí ID ứng dụng và Khóa bí mật tại Cài đặt. Ảnh hướng dẫn của Zalo Platforms đã che thông tin; đây không phải thông số ứng dụng của DYBICOM. Xem hướng dẫn Zalo. Mở ảnh kích thước đầy đủ.

Khi nhập cấu hình, bạn cần giá trị khóa thật, không phải chuỗi dấu sao đang che khóa. Nếu chỉ muốn sao chép lại, bạn không cần đổi khóa. Bạn có thể đối chiếu vị trí và nút sao chép trong hướng dẫn lấy App Secret Key của Zalo.

4. Lấy OA Secret Key tại mục Webhook

Qua Webhook, Zalo gửi thông báo sự kiện tới địa chỉ nhận của hệ thống, chẳng hạn khi có người nhắn tin hoặc có sự kiện cần xử lý. Hệ thống dùng OA Secret Key để kiểm tra thông báo đó có hợp lệ hay không. Bạn cần phân biệt khóa này với địa chỉ Webhook URL.

  1. Giữ nguyên ứng dụng vừa lấy App ID và App Secret.
  2. Chọn Webhook trong menu của ứng dụng.
  3. Tìm ô có nhãn OA Secret Key, không sao chép nhầm ô Webhook URL phía trên.
  4. Nếu khóa đang được che, dùng chức năng hiển thị theo giao diện, sao chép nguyên giá trị rồi lưu vào nơi cấu hình bảo mật được yêu cầu.
  5. Che lại khóa khi xong và kiểm tra không đưa khóa vào ảnh chụp, nội dung website hoặc kho mã công khai.

OA Secret Key nằm tại mục Webhook của ứng dụng và là ô khác với Webhook URL. Ảnh từ hướng dẫn Webhook của Zalo; các khóa đang được che.

OA Secret Key nằm tại mục Webhook của ứng dụng và là ô khác với Webhook URL. Ảnh từ hướng dẫn Webhook của Zalo; các khóa đang được che. Xem hướng dẫn Zalo. Mở ảnh kích thước đầy đủ.

Nếu chưa thấy ô khóa, đừng dùng App Secret điền thay và đừng bấm Reset để thử. Hãy đối chiếu hướng dẫn Webhook của Zalo với yêu cầu của hệ thống tích hợp. Một số trường hợp cần hoàn thiện thiết lập Webhook trước. Khi đó, URL phải do hệ thống thực sự nhận sự kiện cung cấp; đừng điền địa chỉ trang chủ chỉ để đủ thông tin.

Nếu chỉ cần lấy khóa, hãy giữ nguyên URL, trạng thái bật/tắt sự kiện và bộ lọc cú pháp của kết nối đang hoạt động. Những tùy chọn này ảnh hưởng đến dữ liệu hệ thống nhận được. Người triển khai cần kiểm tra chúng theo chức năng đang sử dụng.

5. Ví dụ lấy nhầm thông số giữa hai ứng dụng

Giả sử doanh nghiệp có ứng dụng A cho website và B cho một hệ thống khác. Bạn lấy App ID của A nhưng mở B để sao chép App Secret hoặc OA Secret Key. Dù từng ô đều có giá trị, bộ thông tin vẫn không khớp vì ID và khóa thuộc hai ứng dụng khác nhau.

Cách làm đúng là mở A, đối chiếu tên và App ID, lấy App Secret tại Cài đặt rồi chuyển sang Webhook của chính A để lấy OA Secret Key. Khi lưu trong nơi bảo mật, hãy ghi kèm tên ứng dụng, App ID, hệ thống sử dụng và người phụ trách để dễ đối chiếu. Đừng đưa khóa thật vào bảng theo dõi công khai chỉ để nhận biết ứng dụng.

Với OA Công ty Dybicom, mã OA 4133621167770884605 chỉ giúp xác định đúng tài khoản doanh nghiệp khi cấp quyền. Có đúng mã OA không có nghĩa là bạn có thể dùng khóa của một ứng dụng khác.

6. Không thấy ứng dụng, không thấy khóa hoặc kết nối báo lỗi

  • Danh sách ứng dụng trống: kiểm tra tài khoản đăng nhập, hỏi người đang quản lý ứng dụng; đừng vội tạo nhiều ứng dụng trùng mục đích.
  • Có quyền OA nhưng không quản lý được ứng dụng: quyền Admin OA và quyền quản lý ứng dụng là hai phạm vi riêng. Nhờ người quản lý đúng tài nguyên kiểm tra quyền của bạn.
  • Ứng dụng chưa hoạt động hoặc thiếu quyền API: xem phần trạng thái và quyền API trong hướng dẫn quản lý ứng dụng Zalo. Việc đã lấy được khóa không đồng nghĩa ứng dụng đã được cấp những quyền còn thiếu.
  • App Secret không hợp lệ: kiểm tra đúng cặp App ID/khóa, ký tự thừa và việc khóa đã bị thay sau lần sao chép hay chưa.
  • Hệ thống không xác thực được sự kiện: kiểm tra OA Secret Key thuộc ứng dụng nào và cấu hình đang dùng ở hệ thống nhận; không kết luận chỉ từ việc “đã lưu khóa”.

Khi nhờ hỗ trợ, gửi App ID, OA ID, bước thao tác và thông báo lỗi đã che dữ liệu bí mật. Không gửi App Secret, OA Secret Key, token hoặc mật khẩu qua bình luận công khai.

7. Nếu khóa đã lộ hoặc cần thay đổi

Trước khi đổi khóa, hãy xác định những dịch vụ đang dùng ứng dụng và người chịu trách nhiệm cập nhật. Sau khi thay khóa bằng chức năng Zalo cung cấp, bạn cần cập nhật các nơi dùng khóa cũ rồi kiểm tra lại kết nối và sự kiện. Với OA Secret Key, thay đổi sẽ ảnh hưởng đến việc kiểm tra Webhook; bạn không nên coi đây là thao tác giống hệt đổi App Secret.

Người chỉ phụ trách trả lời khách hoặc đăng bài thường không cần nắm các khóa này. Bạn có thể dùng hướng dẫn quản lý Zalo OA để giao đúng công việc mà không chia sẻ tài khoản đăng nhập.

Khi đã có đúng bộ thông tin và được doanh nghiệp cho phép tích hợp, chuyển sang hướng dẫn cấu hình kết nối Zalo OA trong CMS. Bài đó chỉ rõ URL callback, Webhook và quy trình cấp quyền, lưu cấu hình, kiểm tra thông báo trên Dybi.


ĐỌC TIẾP
GÓC TRAO ĐỔI

Bình luận & đánh giá

Chia sẻ trải nghiệm hoặc đặt câu hỏi về nội dung bài viết.

0 bình luậnChưa có đánh giáViết bình luận ↓

Bạn có câu hỏi hoặc kinh nghiệm muốn chia sẻ? Hãy là người đầu tiên để lại bình luận.

Viết bình luận của bạn

Bình luận sẽ hiển thị sau khi được duyệt. Số điện thoại chỉ dùng để liên hệ, không hiển thị công khai.

Mức độ hữu ích (không bắt buộc)
Từ 10 đến 3.000 ký tự. Không gửi mật khẩu hoặc thông tin nhạy cảm.
Mã xác nhận gồm 5 ký tự
KHÁM PHÁ THÊM

Bài viết khác cùng danh mục

Xem tất cả: Dịch vụ khác →

Hướng dẫn quản lý Zalo OA

Hướng dẫn quản lý Zalo OA: phân quyền Admin, chat, khách hàng, nội dung, chatbot, gói dịch vụ và kiểm soát các ứng dụng đã liên kết.

Trao đổi nhu cầu của bạn với Dybi

Bạn cần website theo yêu cầu, phần mềm POS hay một quy trình kết hợp cả hai?

Đăng ký tư vấn