---
name: azion-install-the-videoteca-player-integration
description: >-
  Install Videoteca Player from Azion Marketplace and run it on an application to host a Videofront Videoteca player with an iframe.
---

# Install the Videoteca Player integration

Videoteca Player hosts the player of [Videofront's Videoteca](https://videofront.com.br/videoteca) and embeds it with an iframe. To choose the video the page displays, pass its ID in the `video-id` query string argument. It is one of the [Marketplace integrations](/en/documentation/platform/marketplace/integrations/) that run on an application.

Four objects must exist before a request loads the player: the installed function, an application with the **Functions** module turned on, a function instance that holds your Videoteca credentials, and a Rules Engine rule with the **Run Function** behavior. Each section below creates one of them.

---

## Prerequisites

- An Azion account. To sign in, refer to [How to access Azion Console](/en/documentation/guides/platform/account-and-billing/how-to-access-azion-console/).
- An [application](/en/documentation/platform/applications/) served by a [workload](/en/documentation/platform/workloads/). To create one, refer to [Applications quickstart](/en/documentation/platform/applications/quickstart/).
- An account on the [Videoteca website](https://videofront.com.br/videoteca), with its **Username** and **API Token**. The function instance requires both.
- Turning on a product or a module can generate usage costs. For more information, refer to [Pricing](/en/documentation/fundamentals/pricing/).

---

## Install the integration

The install adds the Videoteca Player function to your account. To install it from Azion Console:

1. **Open Marketplace**

   Access [Azion Console](https://console.azion.com/) > **Marketplace**.

2. **Find the integration**

   Enter `Videoteca Player` in the **Search on Marketplace** field, then select the integration's card.

3. **Select Install**

The card shows `Successfully installed!` and `Latest version installed!`. The function is then listed in the **Function** list of the **Create Instance** drawer.

---

## Turn on the Functions module

An application runs an installed function only when its **Functions** module is on. To turn on the module:

1. **Open your application**

   Access [Azion Console](https://console.azion.com/) > **Applications** > **your application**.

2. **Open the Modules section**

   In the **Main Settings** tab, go to the **Modules** section.

3. **Turn on the Functions switch**

4. **Select Save**

Azion Console confirms that the application was updated.

---

## Create the function instance

A function instance holds the arguments the Videoteca Player function reads for one application. To create the instance in your application:

1. **Open the Functions Instances tab**

   In **Applications**, select your application, then select the **Functions Instances** tab.

2. **Select + Function**

   An application with no instance yet offers the same action as **Function Instance**. The **Create Instance** drawer opens.

3. **Name the instance**

   In **Name**, enter a unique name that identifies the instance. For example: `videoteca-player`.

4. **Select the function**

   In **Function**, select *Videoteca Player*. The **Arguments** editor fills with the default arguments of the integration.

5. **Edit the arguments**

   In **Arguments**, enter your Videoteca username and API token. Each key is described in the table below.

6. **Select Save**

The instance appears in the **Functions Instances** tab with the name you entered.

### Arguments

The arguments are one JSON object. Replace each placeholder with your own value:

```json
{
"videoteca_user": "<your_username>", // Replace with your Videoteca username
"videoteca_token": "<your_token>", // Replace with your Videoteca API token
"custom_html": "<your_html>" // Replace with your custom html
}
```

| Key               | Required | Description                                                                                                                                                   |
| ----------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `videoteca_user`  | Yes      | The name of the account the function retrieves the videos from                                                                                                |
| `videoteca_token` | Yes      | The token that accesses the Videoteca API                                                                                                                     |
| `custom_html`     | No       | Custom HTML for the page the function delivers. It must include the `<!-- videoteca_iframe -->` tag, which the function replaces with the iframe of the video |

To get your API token, open `https://<YOUR-USER>.videotecaead.com.br/Apidoc`, with `<YOUR-USER>` replaced by your Videoteca username.

---

## Create the rule

The instance runs only when a Rules Engine rule calls it. The rule below matches every request. To create the rule:

1. **Open the Rules Engine tab**

   In **Applications**, select your application, then select the **Rules Engine** tab.

2. **Select + Rule**

3. **Name the rule**

   In **Name**, enter a name for the rule. For example: `Run Videoteca Player on every request`.

4. **Select the phase**

   In the **Phase** section, select *Request Phase*.

5. **Set the criterion**

   In the **Criteria** section, keep the `${uri}` variable and the *starts with* operator, then enter `/` as the argument.

6. **Add the Run Function behavior**

   In the **Behaviors** section, select *Run Function*, then select the instance you created by its name.

7. **Select Save**

The rule appears in the **Rules Engine** tab, under the request phase, and runs the Videoteca Player instance on every request. To narrow the requests that load the player, change the criterion.

For every criterion and behavior a rule accepts, refer to [Rules Engine](/en/documentation/platform/applications/rules-engine/).

---

## Next steps

- [Marketplace integrations](/en/documentation/platform/marketplace/integrations.md): The integrations Marketplace offers, and the application or firewall each one runs on.
- [Rules Engine](/en/documentation/platform/applications/rules-engine.md): The criteria and behaviors a rule accepts, to narrow the requests that load the player.
- [Deploy the Static Cache + Videoteca Player template](/en/documentation/guides/media-and-streaming/streaming/static-cache-videoteca-template.md): A template that deploys an application with cache settings and a route that runs the Videoteca Player function.
- [Update an integration](/en/documentation/guides/application-development/integrations/update-an-integration.md): How to get the latest version of an installed integration, and what an update creates.