Đây là cách chuẩn để onboard khách hàng. Người dùng của bạn kết nối tài khoản
mạng xã hội của họ thông qua trang kết nối JWT URL được white-label được mô tả bên dưới —
họ không bao giờ đăng nhập vào Ayrshare và không bao giờ chạm vào dashboard của bạn.
Dashboard được dành cho
đội nội bộ của bạn (tạo và quản lý profile, kiểm thử và đăng bài thay mặt cho
khách hàng).
Quy trình Tích hợp
Để tích hợp Ayrshare vào ứng dụng của bạn, bạn sẽ cần thực hiện hai lệnh gọi API:- Gọi điểm cuối Tạo Profile để tạo một profile Ayrshare mới cho người dùng của bạn.
- Gọi điểm cuối Tạo JWT để lấy một URL JWT.

Vì lý do bảo mật, các nền tảng mạng xã hội yêu cầu người dùng xác thực thông qua trình duyệt của họ,
điều không thể thực hiện thông qua các lệnh gọi máy chủ backend. Điều này đảm bảo người dùng của bạn có thể an toàn kết nối
các tài khoản mạng xã hội của họ bằng cách đăng nhập trực tiếp với trang đăng nhập chính thức của mỗi nền tảng.
Các mạng xã hội hạn chế xác thực chỉ diễn ra thông qua các miền đối tác được ủy quyền của họ,
chẳng hạn như Ayrshare. Họ cũng chặn iFrame, điều này có nghĩa là bạn không thể nhúng hoặc hiển thị trang liên kết
Ayrshare trong iFrame trên trang web của bạn.
Tạo một Profile Người dùng Ayrshare
Tạo Profile bằng API
Khi một người dùng mới đăng ký với hệ thống của bạn hoặc khi khách hàng của bạn nhấp vào liên kết mạng xã hội trong ứng dụng của bạn, hãy tạo một tài khoản profile Ayrshare mới bằng cách gọi điểm cuối RESTful /profiles/create-profile, hoặc sử dụng gói NPM hoặc PyPi.Profile
Tạo Profile bằng Dashboard (Đội nội bộ)
Đội nội bộ của bạn cũng có thể tạo Profile Người dùng trực tiếp từ Developer Dashboard — hữu ích để kiểm thử, onboard một profile thủ công, hoặc quản trị một lần. Đây là công cụ dành cho đội, không phải quy trình hướng tới khách hàng: khách hàng của bạn không bao giờ được cấp quyền truy cập dashboard và luôn được onboard thông qua trang kết nối JWT URL. Đối với onboard trong môi trường sản xuất, hãy tạo profile theo cách lập trình với API để mỗi người dùng mới được cấp phát tự động.Quản lý Profile Người dùng trong Dashboard
Gói Tích hợp
Trong quá trình onboarding với tư cách là khách hàng Gói Business hoặc Gói Launch, bạn đã nhận được một gói tích hợp được cá nhân hóa với thông tin thiết lập và tên miền quan trọng, các lệnh gọi điểm cuối mẫu, và nhiều hơn nữa. Vui lòng kiểm tra với chủ tài khoản chính của bạn để có thông tin này. Bạn cũng có thể truy xuất hoặc đặt lại gói tích hợp trong dashboard ở trang API. Hãy đảm bảo chuyển sang Profile Chính (Primary Profile) trước.
Đăng nhập một lần với Xác thực JWT
Ayrshare sử dụng JWT (JSON Web Token) để xác thực người dùng của bạn và thực hiện Đăng nhập một lần (Single Sign-On) đến trang liên kết mạng xã hội. JWT là một cơ chế an toàn để truyền tải thông tin đã được ký kỹ thuật số và cho phép Ayrshare xác thực bạn và người dùng của bạn.Tạo JWT
Ứng dụng của bạn sẽ tạo một JWT bao gồm API Key, Profile Key của người dùng và một vài tham số khác. JWT sẽ được ký bằng khóa riêng 1024-bit của bạn.JWT token có hiệu lực trong 5 phút. Vui lòng xem Max Pack để có thời gian
hết hạn dài hơn.
URL JWT là đường dẫn onboarding được khuyến nghị cho mọi khách hàng. Người dùng của bạn xác thực
trực tiếp với từng mạng xã hội theo cách riêng của họ — bạn không bao giờ thu thập hoặc lưu trữ thông tin
đăng nhập mạng xã hội của họ. Nếu đội của bạn cần liên kết một tài khoản thủ công trong quá trình kiểm thử,
bạn có thể làm như vậy từ dashboard, nhưng đây là tiện ích nội bộ và không phải là cách khách hàng được onboard.
White-Label trang Kết nối Tài khoản
Vì trang kết nối được mở bởi URL JWT là giao diện Ayrshare duy nhất mà người dùng của bạn từng thấy, bạn nên xây dựng thương hiệu như của riêng bạn. Thêm logo và tiêu đề tùy chỉnh của bạn, chọn mạng xã hội nào xuất hiện, đặt ngôn ngữ trang và sử dụng các liên kết trợ giúp của riêng bạn — và với Max Pack, áp dụng tệp CSS tùy chỉnh đầy đủ, favicon, tiêu đề trang và chân trang. Các tùy chọn này được cấu hình một lần bởi đội của bạn từ Profile Chính và áp dụng cho mọi URL JWT bạn tạo.White-Label trang Kết nối Tài khoản
Xem mọi tùy chọn xây dựng thương hiệu và tùy chỉnh cho trang kết nối.
Đăng xuất Tự động Phiên Profile
Mở & Đóng URL Liên kết Mạng xã hội
Trang Tài khoản Mạng xã hội có nút “Close” đóng cửa sổ và đưa người dùng của bạn trở lại trang của bạn.Mở URL Liên kết Mạng xã hội
Khi bạn mở URL liên kết mạng xã hội, chúng tôi khuyến nghị sử dụng hàmwindow.open() của JavaScript thay vì href anchor.
Nút “Close” sử dụng JavaScript để đóng cửa sổ, và hầu hết các trình duyệt chỉ cho phép các cửa sổ được mở qua script được đóng.
Bạn có thể sử dụng mã mẫu sau trên trang web của mình để khởi chạy cửa sổ liên kết mạng xã hội.
Window Open
Window Open Function
origin=true vào tham số truy vấn của URL chuyển hướng.
Vui lòng xem điểm cuối Tạo JWT để biết thêm chi tiết.
Chuyển hướng khi Đóng
Ngoài ra, nếu bạn muốn có nútClose chuyển hướng trở lại trang của bạn (thường hữu ích trên thiết bị di động), hãy truyền tham số GET redirect dưới dạng chuỗi URL encoded bắt đầu bằng https.
Vui lòng xem tham số điểm cuối Tạo JWT để biết thêm chi tiết.
JWT URL
redirect không được truyền.
Để đặt lại nút Close về mặc định đóng, hãy truyền tham số redirect=null.
Thông tin thêm
Thông báo Liên kết hoặc Hủy Liên kết Người dùng
Khi người dùng liên kết hoặc hủy liên kết một mạng xã hội, bạn có thể nhận thông báo qua webhook. Vui lòng xem trang Webhook Hành động Mạng xã hội để biết thêm thông tin. Bạn cũng có thể sử dụng điểm cuối user để lấy các mạng xã hội đã kết nối cho một profile người dùng.Nhiều Bộ Tài khoản Mạng xã hội
Tổng quan
Mỗi Profile Người dùng có một bộ tài khoản mạng xã hội và có thể tạo một kết nối đến mỗi mạng xã hội. Nếu người dùng hoặc khách hàng của bạn có nhiều bộ tài khoản mạng xã hội, chẳng hạn như hai Trang Facebook, hai tài khoản Instagram và hai kênh YouTube, bạn có thể quản lý nhiều bộ tài khoản mạng xã hội này bằng cách làm theo các bước sau:- Tạo nhiều Profile Người dùng - Tạo các Profile Người dùng riêng biệt trong hệ thống Ayrshare cho mỗi bộ tài khoản mạng xã hội mà người dùng hoặc khách hàng của bạn cần quản lý.
- Lưu trữ các Profile Key duy nhất - Mỗi Profile Người dùng sẽ có Profile Key duy nhất của riêng nó, được trả về từ điểm cuối tạo Profile Người dùng.
- Gán nhãn cho profile của bạn - Đặt tiêu đề hoặc gắn thẻ cho mỗi Profile Người dùng để nhận dạng rõ ràng chúng liên kết với tài khoản mạng xã hội nào (ví dụ, “Trang Facebook A” và “Trang Facebook B”).
- Ánh xạ trong cơ sở dữ liệu của bạn - Trong hệ thống của riêng bạn, liên kết tất cả các Profile Key có liên quan với người dùng hoặc khách hàng tương ứng.
- Sử dụng Profile Key phù hợp - Khi đăng nội dung hoặc truy xuất phân tích cho một tài khoản mạng xã hội cụ thể, hãy sử dụng Profile Key liên kết với tài khoản đó. Ví dụ, để đăng lên Trang Facebook A, hãy sử dụng Profile Key của Profile Người dùng được kết nối với Trang Facebook A.
Ví dụ
Hãy xem xét một tình huống thực tế cho nhiều tài khoản khách hàng:- Khách hàng: Chuỗi Nhà hàng của Joe với hai địa điểm
- Trang Facebook: “Joe’s Downtown Bistro”
- Instagram: @joesdowntownbistro
- LinkedIn: Trang doanh nghiệp Joe’s Downtown Bistro
- Trang Facebook: “Joe’s Seaside Grill”
- Instagram: @joesseasidegrill
- LinkedIn: Trang doanh nghiệp Joe’s Seaside Grill
- Tạo hai Profile Người dùng riêng biệt trong Ayrshare:
- Profile Người dùng 1: Tiêu đề “Tài khoản Joe’s Downtown Bistro”
- Profile Người dùng 2: Tiêu đề “Tài khoản Joe’s Seaside Grill”
- Kết nối các tài khoản mạng xã hội phù hợp với từng profile:
- Profile 1: Liên kết Facebook, Instagram và LinkedIn của Downtown Bistro
- Profile 2: Liên kết Facebook, Instagram và LinkedIn của Seaside Grill
-
Lưu trữ cả hai Profile Key trong cơ sở dữ liệu của bạn, liên kết chúng với tài khoản của Joe:
- Khi đăng một cập nhật thực đơn đặc biệt cho địa điểm Downtown, hãy sử dụng Profile Key 1 trong các lệnh gọi API. Khi đăng về khuyến mãi hải sản tại địa điểm Seaside, hãy sử dụng Profile Key 2.
