Table of Contents [expand]
Easy Movie allows companies to leverage their employees to create authentic videos at scale. This add-on is designed to help developers integrate the EasyMovie platform with their apps on Heroku.
To create a video in a few minutes you need to :
Choose a template
Film by following the instructions and our real-time tips while you film
Add the text that will appear in the video
Your video is created automatically with your logo, colors, and editable text
Use this add-on to manage, list and retrieve the videos.
Provisioning the add-on
Easy Movie can be attached to a Heroku application via the CLI:
A list of all plans available can be found here.
$ heroku addons:create easymovie
-----> Adding easymovie to sharp-mountain-4005... done, v18 (free)
After you provision Easy Movie, the EASYMOVIE_URL
config var is available in your app’s configuration. It contains the URL to access the API. You can confirm this via the heroku config:get
command:
$ heroku config:get EASYMOVIE_URL
http://user:pass@instance.ip/resourceid
Dashboard
The Easy Movie dashboard allows you to see the status of each video you send to the platform.
You can access the dashboard via the CLI:
$ heroku addons:open easymovie
Opening easymovie for sharp-mountain-4005
or by visiting the Heroku Dashboard and selecting the application in question. Select Easy Movie from the Add-ons menu.
Managing videos
Create a new video request
To create a new video request, you need to make POST request to the EASYMOVIE_URL
config var. The payload associated with the POST request is :
{
"title": "Discover our new CRM",
"frames" : [
{
"url" : "https://linktothevideo.com",
"order" : 1,
"text": "We migrate our CRM to Salesforce",
}
],
"template": "1",
"comment": "This video is for internal purpose",
"external_id": "video1"
}
Retrieving the list of video requests
To retrieve the list of your video requests (and your final video URL), you need to make a GET request to the EASYMOVIE_URL
config var. It will contains an array of all the video requests you made.
[
{
"frames": [
{
"createdAt": "2019-09-24T14:25:50.592Z",
"updatedAt": "2019-09-24T14:25:50.592Z",
"id": "5d8a276e6b2bd60017ddecf2",
"url": "https://linktothevideo.com",
"order": 1,
"text": "We migrate our CRM to Salesforce",
"video": "5d8a276e6b2bd60017ddecf1"
}
],
"createdAt": "2019-09-24T14:25:50.552Z",
"updatedAt": "2019-09-24T14:25:50.552Z",
"id": "5d8a276e6b2bd60017ddecf1",
"title": "Discover our new CRM",
"comment": "This video is for internal purpose",
"external_id": "video1",
"final": "",
"template": "1",
"status": "pending",
"heroku": "5d6709a22bcd8a00177b4bad"
}
]
Migrating between plans
Application owners should carefully manage the migration timing to ensure proper application function during the migration process.
Use the heroku addons:upgrade
command to migrate to a new plan.
$ heroku addons:upgrade easymovie:newplan
-----> Upgrading easymovie:newplan to sharp-mountain-4005... done, v18 (free)
Your plan has been updated to: easymovie:newplan
Removing the add-on
You can remove Easy Movie via the CLI:
This will destroy all associated data and cannot be undone!
$ heroku addons:destroy easymovie
-----> Removing easymovie from sharp-mountain-4005... done, v20 (free)
Support
All Easy Movie support and runtime issues should be submitted via one of the Heroku Support channels. Any non-support related issues or product feedback is welcome on our contact form.