Miralot
Connect Miralot to Fiona to synchronise films as soon as they are submitted to Miralot.
Before continuing, make sure you have access to the Miralot dashboard and the integration settings in your Fiona.
Setting up the integration
To successfully set up an integration with Miralot, you will need to:
- Add a Webhook URL from Fiona to Miralot
- Add a Webhook signing secret from Miralot to Fiona
- Define the default values
- Adjust the mapping if needed
Integration Settings
Webhook URL
In Fiona, go to Settings > Integration > Miralot to open the Miralot integration settings. Here you can copy the Webhook URL. Next, log in to your festival's Miralot Dashboard. Go to 'settings' and paste the webhook from Fiona in the Webhook URL field in Miralot.
Webhook signing secret
Now you need to set up the Webhook Signing Secret. Create a password and add this to both the Webhook signing secret field in Fiona and in the Miralot settings.


Submissions to
Finally, pick which activity you want the submissions to end up in.
Define the default values
Before synchronising submissions, you need to define a few default values in Fiona.

Texts, pictures, and links attached to a Miralot submission will appear in the 'attachments section' of Fiona. You can define the default content type of the following attachments:
- Content type (info) - Custom questions, synopsis, and other text attachments.
- Content type (links) - All URLs.
- Content type (stills) - Pictures like posters and stills.
- Content type (preview) - Screener links.

Credits are also synchronised with this integration. Fiona will try to map the roles of the credits with the ones in Fiona. In case Fiona cannot find a match, the following default value will be applied.

Mappings
If values for Countries and Credit roles are different between Fiona and Miralot, you can use the mapping table to adjust the integration. On the left of the mapping table, you see the Fiona value; on the right, you can add the value of Miralot.
You can check the attachment "Import Errors" to see if there were any values that could not be mapped.

Next, you can update the mapping in Fiona. Future submissions will now be mapped correctly.

Competitions
Filmmakers can submit their films to different submissions in Fiona. These competitions end up as competitive programmes in Fiona in the 'Is eligible for' field. To get matched, you first need to set up the same competitions in Fiona. You can do this through an overview of programmes and checking the 'Is competition' checkbox.

Using the integration
Now that the integration is set up, any submission to Miralot will automatically appear in Fiona within seconds.
Retriggering Submissions
In case some submissions were submitted before you set up the integration, you can re-trigger these by hand.
Go to your festival's settings in Miralot and go to 'Retrigger Webhook'. Select the title of the film you want to synchronise and press 'Retrigger'.

Note that titles that are already in Fiona will not be synchronised again. You need to delete these titles from Fiona first before retriggering the submission.
Overviews
To keep track of your Miralot submissions, Fiona always adds 'Miralot' as the source of each entry. You can find this field in the entry section. You can also use this field to filter out Miralot submissions from an overview of films.
