Returning.AI
  1. Widgets
Returning.AI
  • Returning.AI
    • APIs
      • Authentication
      • System API
        • Auth
          • Secure Auth
          • register
          • verify email
          • login
        • Server
          • create new server
          • get my servers
          • update server
          • role list of server
          • channel list of server
        • Channel
          • get channels list
          • create new channel
          • update channel
          • delete channel
        • Role
          • create new role
          • update role
          • delete role
          • add role to a user on a server
          • remove role from a user on a server
          • get role list of user on a server
        • Badge
          • get badges list
          • create new badge
          • update badge
          • delete badge
          • award badge to user
          • remove badge from user
      • Application API
        • Community Users
          • Get community users
          • Get user
        • User Fields
          • Get All User Fields
          • Get Specific User Field
          • Create Custom User Field
          • Update Custom User Field
          • Delete Custom User Field
        • User Field Histories
          • Get all user field histories in a community
          • Get user field histories for a specific field
          • Get user field histories for a specific user
          • Get user field histories of specific user field and user
          • Create user field history for specific user
      • Integration API
        • Users
          • Get Users with Filters
          • Create New User
          • Get User Data
          • Manage User Account
          • Get User Gamification History
          • Get User Gamification Stats
          • Bulk Import
          • Bulk Update
        • Messages
          • Get Messages
          • Send Message
          • Reply Message
          • React Message
        • Channels
          • Get Channels List
      • User API
        • API key
          • api key info
          • Delete Endpoint
          • Update User Api Key
          • Post User Api Key
          • Get User Api Key
        • Messages
          • Send Message
          • Reply Message
          • React Message
    • Channels
      • Iframe
    • Events
      • Outgoing webhooks
        • Encryption
        • User Joins Server
        • User Visits server
        • New Message Posted Anywhere
        • New Message Posted To channel
        • Purchased Store Item
      • Incoming webhooks
        • API Keys & Encryption
        • Send message into channels
        • Update Custom User Fields
        • Update In-game currency
    • Widgets
      • Authenticated widgets
      • Channels
      • Leaderboard
      • Milestone
      • Socials
      • Store
      • Currency Overview
  1. Widgets

Authenticated widgets

Embed interactable widgets that mirrors the community's features onto your platform, each authenticated user will be able to use it as if they have visited the community!

Authentication#

Get the token required from this end point
A successfull call (200) will return the token, save it as RETURNINGAI_WIDGET_TOKEN.
Examples:
Node.js
PHP
Python

Script#

Add this JavaScript to your frontend to handle authentication and token passing to the widget iframe. It calls your backend endpoint. It uses {postMessage} for secure communication.

Iframe#

Finally, insert the iframe code into the HTML file to display the widget.

Supported feature#

Channels
Example:
Store
Milestone
Currency Overview
Modified at 2025-10-10 08:47:41
Previous
Widgets
Next
Channels