EMMI (Enterprise Media Management Interface)

EMMI is an enterprise digital asset management (DAM) system. Videobot integrates with EMMI's REST API to import videos and images from your EMMI instance, including folder hierarchies, custom metadata, and keywords.

EMMI sources support both scheduled polling and real-time webhook notifications, so your Videobot library stays up to date as assets are added, changed, or removed.

Adding an EMMI Source

1. Navigate to Account Settings > Media Import.
2. Click Add Source and select EMMI.
3. Fill in the source configuration:

Field	Required	Description
Name	Yes	A display name for this source (e.g., "Corporate DAM")
Instance URL	Yes	The base URL of your EMMI instance (e.g., https://emmi.example.com)
Username	Yes	EMMI login username
Password	Yes	EMMI login password
Webhook Token	Yes	A token (16-128 characters) used to authenticate incoming webhook events
Polling Interval	Yes	How often Videobot checks for updates (15 min to 24 hours)

INFO

Credentials are stored securely in AWS Secrets Manager and are never exposed in the dashboard.

4. Click Validate to test the connection. Videobot will attempt to authenticate with your EMMI instance.
5. Click Save to create the source.

Folder Selection

After creating the source, you can configure which EMMI folders to sync:

• Sync all folders — Import assets from every folder in the EMMI instance.
• Select specific folders — Choose individual folders to import from.
• Include subfolders — When selecting specific folders, optionally include all nested subfolders.

EMMI folders are mapped to Videobot categories, preserving the folder hierarchy. If a folder doesn't map to an existing category, Videobot can auto-create it.

Webhooks (Real-Time Sync)

EMMI supports webhook notifications that trigger immediate syncs when assets change, without waiting for the next polling interval.

Setting Up Webhooks

1. Open your EMMI source in the dashboard and find the Webhook URL section.
2. Copy the generated webhook URL (it includes your authentication token).
3. In your EMMI admin panel, configure a webhook pointing to this URL.
4. Select the events to subscribe to:

Event	What It Does
Created	Imports the new asset into Videobot
MetadataChange	Updates title, description, tags, and custom fields
VersionChange	Marks the media as draft (indicates a new file version)
FolderLinkChange	Updates category assignments based on new folder links
AssetDeleted	Archives the corresponding media in Videobot

TIP

Webhooks complement scheduled polling. Even with webhooks enabled, polling acts as a safety net to catch any events that may have been missed.

Webhook Security

Each EMMI source has a unique webhook token included as a query parameter in the URL. Only requests with a valid token are accepted. Additionally, webhook endpoints are rate-limited to prevent abuse (defaults shown):

• 300 requests per minute per IP address
• 60 requests per minute per webhook token

These limits are configurable via environment variables (emmi_webhook_ip_rate_limit, emmi_webhook_token_rate_limit, and their corresponding _window_seconds settings). When a rate limit is exceeded, the endpoint returns HTTP 429 with a Retry-After header.

How EMMI Assets Map to Videobot

EMMI Concept	Videobot Concept
Folder hierarchy	Category hierarchy
Asset name / title	Media name
Asset description	Media description
Keywords / tags	Tags
Property values	Custom fields
File (master/original)	Media file (uploaded to Videobot)
Thumbnail / preview image	Thumbnail
Duration	Duration

Media Type Detection

Videobot determines whether an EMMI asset is a video or image based on:

1. Asset type or file type fields
2. MIME type
3. File extension (.mp4, .mov, .avi, .webm, .mkv, .m4v, .wmv, .flv are treated as video)

Localized Metadata

EMMI supports localized asset metadata. When parsing titles and descriptions, Videobot tries these locale keys in order: x-default, en, fi. The first available value is used.

Category Mapping

EMMI folders map to Videobot categories:

• Automatic — Folder names are matched to existing categories by name. If Auto-create categories is enabled, missing categories are created automatically, preserving the folder hierarchy.
• Manual — In the Advanced Field Mapping section, you can explicitly map specific folder IDs to Videobot category IDs.

Custom Field Mapping

EMMI property values can be mapped to Videobot custom fields. In the Advanced Field Mapping section, map external property keys to Videobot field keys. Supported type conversions:

Source Type	Videobot Type
Text	Text
Number	Number
Boolean	Boolean
Date	Date
List/enum	Select