Vii Events is an All-In-One 3D 360° virtual events platform. Integration only takes a few minutes with no development required. You can embed the activation using iFrame into the Vii Events virtual environment.
Webhook Setup
A common use case for calling a webhook after an activation is played is to send a player’s score to a 3rd party leaderboard, such as Vii event. In this scenario, the activation can be iFramed into a web page or virtual event platform. One or more query string parameters can be dynamically added to the end of the game URL and then forwarded on to the inbound webhook endpoint URL. You can find more details on our Activation Webhook here.
Example
You can forward a Universally unique identifier (UUID) by appending a new parameter to the game launch URL as &webhook_var=[UUID}. The webhook_var parameters will be forwarded with the payload under webhook_info.
When you iFrame a game you can dynamically append the UUID To setup a webhook, go to the Action tab of the Activation builder page. Here, you would need to provide your Endpoint URL. Your webhook endpoint URL from Vii Events will look something similar to this: https://vii.events/api/webhooks/captello/?apiKey=e67a3734d9aa616d4372621e7
Here are a few things to note when setting up your webhook in the Activation Builder:
...
Use the +/- to add/remove one or more webhooks. Multiple webhooks can trigger simultaneously.
Choose to send our standard payload to your Endpoint URL or select one of our integrations to send a payload formatted for the integration partner.
Enter the Endpoint URL where you want us to send the payload. Make sure you have a script to parse the payload. This would be your inbound webhook URL.
Decide whether or not to include Prospect information (email, name, etc.) to adhere to your company’s privacy policy.
Example
When iFraming a game you could dynamically append a Universally unique identifier (UUID) to the "webhook_var[UUID]" query string parameter. This webhook_var parameter will be forwarded back to your inbound webhook endpoint URL.
Here's an example of embedding a game with an attendee that has a UUID of 56:
| Info |
|---|
If you need to forward more parameters to the webhook, then it is better to name the parameter as something like webhook_var_parameter. So, you can have different parameters like: webhook_var_param1=x&webhook_var_param2=y&webhook_var_param3=z |
...