Why using a webhook?
From your Fastory account, you can send the data collected by your contests towards the URL of your choice. You need to create this URL in the first place.
Then, you'll be able to send the data towards your servers or web service.
In which cases can I use a webhook?
You need to treat data on your end in order to record scores on your server, synchronize data, login users...
You need to trigger a script after specific bot questions (for example sending emails) or Zapier
Follow these steps:
From your workspace, go to the add-ons page
Click on the search bar and type webhook
Informations: if you don't have access to this add-on, click on "Contact us" and fill in the form. You'll be contacted by our team (the webhook add-on can be taken in option to your plan).
Once the add-on is activated:
Go to Settings in your workspace
Go to Integrations
Click on the settings of the webhook
A window appears with the setting options:
Specify the Token and add your custom URL. The token allows to safely authorize the requests sent to the URL.
Then click on Test the connection
If the answer says Success, the connection succeeded. You can now send Fastory data to your custom URL.
If the answer says Error, the connection failed and an error message has been sent to the API.
At the same time, this connection test will send a standard answer to your API and you'll need to check if there is an error on your side.
Endpoints from bot questions
Once the connection succeeded, you can specify the endpoints in a bot question.
This endpoint will be added at the end of the URL your just specified in the add-on settings. You can collect the specific data to this question and send them to you custom URL.
The steps to follow:
In your workspace, go to Experiences
Choose the microsite in which you want to collect data
Click on Edit
In the studio:
Click on the bot tab
Select the bot of your choice
Select the bot from which you want to retrieve the data
When you are on the bot settings:
Select Custom URL in Send to
In Custom URL entered in the add-on will appear the URL that you have previously added in the add-on
Choose the mode
Send my data after a specific question
This mode allows you to collect a large amount of data from the bot and send it to your URL in a single request. The sending of this request can be triggered at the end of a question for example.
To do this, you need to :
go to the parameters of the question that will trigger the sending of the data
check the box choose this question but be careful you can check only one question.
Send my data after each question
This allows you to send the data to your URL for each question answered by the participant. The data is instantly sent to your URL.
If you have chosen this mode, you need to add an endpoint. To do so:
select the question you want
add the specific path
This endpoint will be added at the end of the URL you just specified in the add-ons settings. You will be able to retrieve the data specific to this question and send it to your Custom URL.
Informations : Currently, the add-on can only be used with the answers given to the bot, the contests and the games.