# Instale a integração Videoteca Player

A integração **Videoteca Player** oferece uma solução rápida e eficiente para hospedar o player [Videoteca](https://videofront.com.br/videoteca) do Videofront utilizando o método de embedding iframe. Com esta integração, você pode carregar vídeos simplesmente passando o argumento `video-id` como uma `query string` para especificar o conteúdo a ser exibido.

---

## Requisitos

Para configurar esta integração, você deve fornecer um **Username** e um **API Token** da **Videoteca**. Para obter essas credenciais, você precisa ter uma conta no [site da Videoteca](https://videofront.com.br/videoteca).

---

## Obtenha a integração

Para instalar esta integração fornecida pelo Marketplace da Azion:

1. Acesse o [Azion Console](/pt-br/documentacao/produtos/guias/como-acessar-o-azion-console/) > **Marketplace**.
2. Na homepage do Marketplace, selecione o card da integração.
3. Quando a página da integração abrir, clique no botão **Install**, localizado no canto inferior direito.

Aparecerá uma mensagem indicando que sua integração foi instalada com sucesso.

:::tip
Você pode procurar qualquer integração navegando pelos cards, usando os filtros ou digitando uma palavra-chave na barra de busca.
:::

---

## Configure a integração

### Instancie a function

Para criar uma instância da função da integração:

1. No **Products menu**, navegue até **Build** > **Applications**.
2. Selecione na lista a aplicação à qual você deseja adicionar a integração ou [crie uma nova application](/pt-br/documentacao/produtos/build/applications/primeiros-passos/).
3. Selecione a aba **Function Instances**.
4. Clique no botão **+ Function Instance**.
5. Dê um nome à sua instância.
6. No menu suspenso, selecione a função *Videoteca Player*.
  - Esta ação carregará a aba **Arguments**, onde você pode adicionar os parâmetros para executar sua aplicação.
7. Na aba **Arguments**, passe esses parâmetros:


```json
{
"videoteca_user": "<seu_nome_de_usuario>", // Substitua pelo seu nome de usuário da Videoteca
"videoteca_token": "<seu_token>", // Substitua pelo seu token da API da Videoteca
"custom_html": "<seu_html_personalizado>" // Substitua pelo seu HTML personalizado
}
```

Onde:

| Variável | Obrigatório | Descrição |
| ---- | ----- | ----- |
| `videoteca_user` | Sim | O nome da conta da qual a função irá recuperar os vídeos |
| `videoteca_token` | Sim | O token para acessar a API da Videoteca |
| `custom_html` | Não | HTML personalizado para a página entregue pela função. Deve incluir a tag `<!-- videoteca_iframe -->` no HTML para que a função a substitua pelo iframe real do vídeo |

:::tip
Você pode obter seu token em: `https://<SEU-USUÁRIO>.videotecaead.com.br/Apidoc`, substituindo `<SEU-USUÁRIO>` pelo seu nome de usuário da Videoteca.
:::

8. Clique no botão **Save** para salvar sua configuração.

Pronto. Agora sua instância do Videoteca Player está salva.


### Configure o Rules Engine

Para finalizar, você deve configurar o **Rules Engine** para definir o *comportamento* e os *critérios* para executar a função.

Ainda na página do **Applications**:

1. Selecione a aba **Rules Engine**.
2. Clique no botão **+ Rule Engine**.
3. Dê um nome à regra.
4. Em **Criteria**, defina as condições para executar a função.
5. Selecione o *behavior* (comportamento) **Run Function**. 
    - Selecione a função adequada de acordo com o nome que você deu na etapa de instanciação.
6. Clique no botão **Save**.

Pronto. Agora a integração será executada de acordo com os critérios que você definiu.

---