1. Resources
  2. World Settings

πŸ›Ž  Notifications & Webhooks

Want to know who is entering your world? Get informed on who is coming in and what is being reported in your world.

Notifications
πŸ“Œ  Enable Push Notifications
πŸ””  Subscribe to Push Notifications

Webhooks
πŸͺ  World Webhook
πŸͺ€  Interactive Asset Webhooks
πŸ‘‹  Using a Webhook for People Joining the World
πŸͺŸ  Using a Webhook to Manage the Waitlist
πŸ†˜  Using a Webhook for Moderation

 


πŸ›ŽοΈ  Subscribe to Push Notifications

Receive a notification when an admin opens the world. You can subscribe to this world notification by following these simple steps:

  • Enter the Topia world

  • ​Click the My Account icon at the top of the toolbar

  • On the bottom of the My Account drawer, click the toggle labeled Notify me when this world opens. When turned on, the toggle will show a check mark highlighted in blue

  • Collapse the page by clicking the β˜β† icon in the top right corner or close the page and drawer by clicking on the βœ• in the drawer

Enable Push Notifications in the Browser

In order to receive push notifications, notifications must be enabled within your browser for Topia.io. To do this, access the browser settings menu:

  • Check that the notifications settings for Topia.io are set to "Ask (Default)"

  • Disable any browser extensions that may block notifications (you can use an incognito or private browser window to do so)


πŸ›Ž  Allow Users to Subscribe to Your Doorbell

As a world owner, you can also allow other users & members of your community to receive notifications for your world. The doorbell will send a push notification through your browser anytime someone enters your world. To do this follow these simple steps:

  • Enter your Topia world.

  • Click the World Settings icon

  • Under World Configurations click Integrations

  • Choose an option under World Push Notifications.

  • Collapse the page by clicking the β˜β† icon in the top right corner or close the page and drawer by clicking on the βœ• in the drawer

*By enabling this setting, depending on the option you chose, any user or admin who visits your world can choose to receive push notifications for your world.


πŸͺ Webhooks

By using a webhook service like Zapier, you can get alerted via email, text message or even a notification on Slack when someone comes into your world. or performs a trigger action.

πŸͺ  Add a World Webhook

  • Enter your Topia world

  • Click the World Settings icon

  • Under World Settings click Integrations

  • In the Webhooks section, click Add Webhook

  • Choose the Webhook Type that matches the action being captured:

    • User Joins World

    • User Waitlisted

    • User Reported

  • Enter a title and description so you can find it later

  • Enter the webhook URL and use the toggle if you want to limit the webhook to trigger only once per user per day

  • Collapse the page by clicking the β˜β† icon in the top right corner or close the page and drawer by clicking on the βœ• in the drawer

  • Topia will send data to this webhook when somebody triggers the action

πŸͺ€  Add a Webhook to an Interactive Asset (two ways) 

  • Enter your Topia world
  • Make sure Edit Mode is on and the Edit toggle on the toolbar is blue

  • Hover over the asset you want to trigger a webhook and click the pencil icon

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Option 1: Click Integrations

    • In the Integrations page, click Add Webhook

    • Choose the Webhook Type that matches the action attributed to the asset:

      • Private Zone Entered

      • Broadcast Zone Entered

      • Media Played

      • Media Play Finished 
      • Asset Clicked

      • Webhook Zone Entered
      • Webhook Zone Exited
  • Option 2: Click Zones
    • Check a Zone type
    • Click Add Webhook
    • Choose a Webhook Type from the drop-down (this list will change based on the zone selected)
  • Enter a title and description so you can find it later

  • Enter the webhook URL and use the toggle if you want to limit the webhook to trigger only once per user per day

  • Collapse the page by clicking the β˜β† icon in the top right corner or close the page and drawer by clicking on the βœ• in the drawer

  • Topia will send data to this webhook when somebody interacts with that asset

 


πŸ‘‹  Using a Webhook for People Joining the World

Want to get a notification the instant a person enters your world? We have you covered! By using a webhook, you can be get an alert as soon as a user enters or monitor when brand new users arrive.

  • Enter your Topia world

  • Click the World Settings icon

  • Under World Settings click Notifications & Webhooks

  • In the Notifications & Webhooks, click Add Webhook

  • Under Webhook Type, choose User Joins World

  • Enter a title and description so you can find it later

  • Enter the webhook URL and use the toggle if you want to limit the webhook to trigger only once per user per day

  • Collapse the page by clicking the β˜β† icon in the top right corner or close the page and drawer by clicking on the βœ• in the drawer


πŸšͺ  Using a Webhook to Manage the Waitlist

Hosting a popular event in a world with a capacity limit? You can use a webhook to get alerted when a person is waiting to join because the world is currently at capacity. The webhook will deliver the display name of the user waitlisted and the URL of the world who's capacity has been reached.

  • Enter your Topia world

  • Click the World Settings icon

  • Under World Settings click Notifications & Webhooks

  • In the Notification & Webhooks page, click Add Webhook

  • Under the Webhook Type, choose User Waitlisted

  • Enter a title and description so you can identify the webhook it later

  • Enter the webhook URL and use the toggle if you want to limit the webhook to trigger only once per user per day

  • Collapse the page by clicking the ❘ ← icon in the top right corner or close the page and drawer by clicking on the βœ• in the drawer

  • Topia will send data to this webhook when somebody joins the world

 


πŸ†˜  Using a Report Webhook for Moderation

A report webhook can be used to get an alert when a person in the world is being reported by another user. The webhook will deliver the display name of the user and reported person, the reason for the report, and a URL to the exact coordinates where the report happened. This can be very useful when moderating a public world, allowing the world owner or admins the ability to respond to situations quickly.

A report webhook can be added by doing the following:

  • Click the World Settings icon

  • Under World Settings click Notifications & Webhooks

  • In the Notification & Webhooks page, click Add Webhook

  • Under the Webhook Type, choose User Reported

  • Enter a title and description so you can identify the webhook it later

  • Enter the webhook URL and use the toggle if you want to limit the webhook to trigger only once per user per day

  • Collapse the page by clicking the ❘ ← icon in the top right corner or close the page and drawer by clicking on the βœ• in the drawer

  • Topia will send data to this webhook when somebody joins the world