The socials Widget enables you to embed a interactable social quest page from your Returning.AI community into external websites. It is an authenticated widget where users can log into their social accounts and start earning in-game currencies by engaging on your social profiles!Installation#
1.
Enable widgets in your store settings on admin portalCommunity settings → Social Quests
2.
Configure whitelisted domains for securityNo domains added: The widget can be embedded and used on any domain.
Domains added: The widget can only be embedded and used on the listed domain(s).
4.
Configure widget's appearanceCustomise the theme of the widget to match your site.
5.
Follow the instruction below for installation
{widget_id} and {API_key} placeholders.
API keyFound in the bottom of the authenticated widget codes in admin panel.
Store the API key in environment variables on your server (e.g., process.env.WIDGET_API_KEY in Node.js).
Never expose your API key in client-side code! The API key should only be used on your backend server.
Found in the URL of the authenticated widget codes in admin panel.
Step 1: Backend Authentication (Server-Side Only)#
Implement an endpoint on your server that authenticates the user and fetches the token from our service.Examples:
Node.js/Express exampleStep 2: Frontend Implementation (Client-Side)#
Add this JavaScript to your frontend to handle authentication and token passing to the widget iframe. It calls your backend endpoint and uses postMessage for secure communication.Embed the iframe in your HTML where you want the widget to appear. Ensure the frontend script from Step 2 is loaded on the same page.Example widget:
Support#
For additional support, please contact our dedicated support team. We're here to help you maximize the potential of our APIs.This widget is provided by Returning.AI. Usage is subject to the Returning.AI Terms of Service and Widget License Agreement. 