Appearance
Run
The Run tab is your hub for generating and delivering personalised videos. From here, you can create videos via API or by importing a CSV file, and set up webhooks to automatically deliver them to your system once generated.
You can also track your output directly in this view by monitoring both the total number of videos generated and trends over a selected timeframe.
Create via API
In order to create videos programmatically via API, you'll need to send data to your project's API endpoint. You will get your project's API details by clicking on the Create via API button.
More information can be found in the API documentation.
Import CSV
In order to create videos manually using a CSV file, you can either drag and drop a CSV file to the Import CSV field, or click on the button to open a file explorer.
You will be prompted to map the fields from your CSV to the properties used in your Project.
Property and column names do not need to match in order to be mapped, but they will be mapped automatically in case they match.
After you have mapped your properties, you can proceed to import your file and generate your videos by clicking Import and generate videos.
More information about the import can be found in Data Import Best Practices.
Send videos to your system
Seen can automatically deliver generated videos to your own infrastructure via webhook. Click + Add webhook to open the configuration modal, which is split into two tabs: General and Security.
You can find more information about what is required by your system by referring to your system's API documentation.
General
- URL (required) – The endpoint URL where Seen will send the webhook payload upon video generation.
- Method (required) – The HTTP method to use for the request. Defaults to
POST. - Headers – Custom HTTP headers to include with each request. A
Content-Type: application/jsonheader is preconfigured by default. Additional headers can be added via + Add a header. - Request content – The JSON body of the webhook request. Use this to define the payload structure sent to your endpoint on each trigger.
You'll be able to include any personalisations you've added to the project in the URL, Header and the Request content. You also get access to the output of the video generation: Seen video player link, email thumbnail, and the regular thumbnail link.
Security
Seen supports four authentication methods for securing your webhook endpoint:
- No Authentication – The request is sent without any auth credentials.
- Basic Auth – Authenticates using a username and password.
- OAuth – Authenticates via an OAuth token exchange.
- JWT to Token – Authenticates using a signed JWT, exchanged for an access token before the request is made.
View Videos
You can access more options by clicking on View Videos.
When clicking View Videos you will get additional options such as viewing data in your project, status of the data that has already been received by the Seen platform, view already generated videos and more.
Left sidebar
On the left sidebar, you can choose if you want to view all videos or filter based on which origin the data is from: API or import. You will also be able to view the data of each individual imported file.
You can also view your exports, as well as the quota left on your Workspace.
Export data
You are also able to export data from this view by clicking on Export data.
Within the export modal, you have the following options on what to export:
- Filter data – Here you can choose to filter based on the origin, which import the data was a part of, and any project field values.
- Columns – Here you can choose which project fields you'd like to include in the export. You can also rename them to match what your system expects right away.
- Video outputs & metrics – Here you can choose which outputs and/or metrics you would like to include in the export, e.g. Seen video player link, email thumbnail link, etc.
Next steps
When you have started the distribution of your videos, move to the Insights tab to see the statistics of your personalised video campaign.