# Integração TV - Apptec

## Introdução

> [!TIP] O que é a Apptec?
> A [Apptec](https://www.apptecbr.com/pt-br/) é uma plataforma de IPTV e OTT. A plataforma oferece uma solução completa para PayTV (ou televisão por assinatura), um modelo de serviço de televisão onde os espectadores pagam uma taxa para acessar uma seleção de canais e conteúdo premium).

A integração entre a Apptec e o Sistema foi desenvolvida para aprimorar a gestão de serviços de telecomunicações e conteúdo digital, oferecendo uma plataforma unificada para provedores de internet. Com esta solução, sua empresa consegue:
- Simplificar a administração dos serviços de TV e streaming;
- Unificar todos os dados do provedor em um único ambiente;
- Otimizar o gerenciamento de clientes e fluxo de receitas;
- Automatizar o monitoramento e controle de inadimplência.

  > [!NOTA] Acesso ao Formulário
> Caminho: Configurações > Integrações > Integrações TV

## Entrega de Valor
- Alinhar as necessidades dos clientes que utilizam streaming e TV por assinatura com a plataforma Apptec;
 - Centralizar as informações do provedor em um único local e facilitar o gerenciamento de inadimplentes, gestão de clientes e faturamento mensal.
- Simplificação do processo de ativação e manutenção de clientes;
- Otimização do controle de inadimplência.

## Configuração da Integração

>[!Caution] Credenciais:
>Assim que o seu provedor (ISP) realizar o credenciamento junto a plataforma citada, serão fornecidos os dados necessários para realizar a integração com o ERP IXC Soft. A partir destes dados, é possível realizar o cadastramento da integração no IXC, conforme o material a seguir.

### Passo 1: Acesso ao Formulário de Integrações
Neste passo, é efetuado o cadastro da integração. Este processo permite a comunicação e troca de dados entre o sistema e a plataforma Apptec.

1. Acesse  o formulário de [[integracoes de tv|Integrações de TV]] através do caminho: Configurações > Integrações > Integrações TV;
2. Pressione o botão **Novo**;
3. Selecione **Apptec** no campo **Plataforma**;
4. Preencha os campos:
	- **Ambiente:** marque se produção (já está em uso e sendo ofertado aos clientes) ou se em homologação (testes);
	- **IP Integração:** este campo se refere à URL fornecida pela plataforma credenciada. Ela é responsável por "liberar o acesso" do sistema IXC Soft à plataforma Apptec para estabelecer a comunicação entre as plataformas envolvidas.
	- **Login TV:** refere-se à informação do usuário API na Apptec, informação fornecida pela plataforma;
	- **Senha TV:** refere-se à informação de senha do usuário API na Apptec, informação fornecida pela plataforma;
	- **ID filial:** ID da filial da integração, baseia-se nas informações da filial do contrato do cliente;
	- **Pacote para usuários inadimplentes:** ID do pacote da Apptec que o usuário TV assume, ao ter o contrato bloqueado no sistema. Esse pacote substituirá o pacote atual diretamente no backoffice da Apptec;
	- **Operator:** informe o operador da plataforma;
	- **ID Lineup:** informe o ID da Lineup que será utilizada na integração.
	
6. Clique em **Salvar** para estabelecer a comunicação entre o IXC e a plataforma e para concluir o cadastro da integração.

>[!CAUTION] **Importante:** 
>As informações de **Login TV** e **Senha TV** são fornecidas pela própria Apptec e não se referem às mesmas utilizadas para acesso a plataforma da Apptec, são exclusivas para a integração API.

### Passo 2: Configuração do Produto de TV
O cadastro do produto de TV é essencial para a gestão do produto no contrato, faturamento e também para permitir a ativação do usuário TV, pois o produto se relaciona com a integração pelos pacotes disponibilizados pela plataforma.

>[!INFO] Informação:
>O cadastro do produto no sistema é respectivo ao pacote disponível para a plataforma.

1. Acesse o formulário de [[cadastro de produtos|Cadastro de Produtos]] através do caminho: Sistema > Cadastros > Produtos;
2. Pressione o botão **Novo**;
3. Preencha os campos obrigatórios na aba **Produtos** e na aba **Planejamento**;
4. Acesse a aba **TV**;
5. No campo **Plataforma**, selecione a opção **Apptec**;
6. Preencha os campos:
	- **ID integração:** preencha o campo de ID integração clicando sobre a lupa e clicando na integração cadastrada;
	- **ID pacote:** clique sobre o botão de seleção e selecione um dos produtos disponibilizados pela plataforma, do qual consta disponível em seu contrato com a plataforma.
	
7. Clique em **Salvar** para validar e finalizar o cadastro do produto.

### Passo 3: Produto no Contrato
Para realizar a gestão do contrato efetivamente, é necessário vincular o produto de TV ao contrato. Esta ação permite realizar a geração do faturamento, emitir notas fiscais e também efetuar ativação do usuário TV associado à integração. Esta ativação pode ocorrer diretamente pelo contrato ou por [[formulario planos de venda|Formulário Planos de Venda]].

1. Acesse o formulário de [[formulario contrato do cliente|Formulário Contrato do Cliente]] através do caminho: Sistema > Cadastros > Contratos;
2. Selecione o contrato do cliente do qual deseja incluir o produto no contrato;
3. Pressione o botão **Editar** para acessar o contrato;
4. Navegue até a aba **Produtos** e clique no botão **Novo**. Defina o tipo do produto como **TV/Streaming** e no campo **Produto/Serviço**, clique na lupa e selecione o produto de TV cadastrado. Clique em **Salvar** para validar as configurações.

### Passo 4: Ativação do Usuário TV
A ativação do usuário TV consiste em criar as credenciais de acesso para o usuário final obter acesso à plataforma.

1. Ainda no contrato do cliente, navegue até a **aba TV**;
2. Clique no botão **Novo** e preencha os campos apresentados:
	- **Plataforma:** no botão de seleção, selecione a opção Apptec;
	- **Tipo de tecnologia TV:** defina o tipo de tecnologia do produto;
	- **Dispositivos:** permite definir quantos equipamentos simultâneos terão acesso àquela conta. Este campo pode ser atualizado conforme a necessidade de ajuste da quantidade de dispositivos simultâneos utilizados pelo usuário TV.
		
3. Após preencher os campos, clique em **Salvar** para validar as modificações e efetivar a criação do usuário TV;
4. Os campos **Account ID** e **ID login plataforma** são preenchidos automaticamente após o login TV ser cadastrado no sistema e na plataforma Apptec, indicando a comunicação no processo de ativação do login.

> [!INFO] **Exemplo:** 
> Um cliente com limite de 3 dispositivos poderá assistir ao mesmo tempo em:
>- Uma TV
>- Um celular
>- Um tablet
>
>**Observação:** Para acessar em um quarto dispositivo, será necessário desconectar um dos dispositivos em uso.

Após realizar a ação de todos os passos, o usuário TV estará pronto para uso. O controle de acesso é feito diretamente pelas ações do contrato (bloqueio e liberação).

## Casos de Uso

### Ações do contrato
A integração com a plataforma da Apptec valida ações sobre o contrato, impactando no acesso do usuário TV, permitindo o controle de acesso pelo sistema e espelhando na plataforma credenciada.

> [!Caution] Pacote para usuários inadimplentes:
> Em casos de bloqueios por inadimplência, faz-se necessário realizar a configuração de um pacote para usuários inadimplentes diretamente na integração da Apptec, conforme indicado no **cadastro da integração**.

#### Controle de acesso do usuário TV a partir do status do contrato:

- **Aviso de atraso/Financeiro em atraso:** a integração com a plataforma Apptec valida o status do contrato em atraso por inadimplência, portanto, o acesso do login TV é assumido pelo **Pacote para usuários inadimplentes**, apresentando o status **Bloqueio Parcial** diretamente na plataforma da Apptec.
  
- **Bloqueio manual ou automático:** em casos de bloqueio automático ou manual devido inadimplência, o login TV terá seu acesso interrompido, assumindo o **Pacote para usuários inadimplentes**, apresentando o status **Bloqueio Parcial** diretamente na plataforma da Apptec.
  
- **Liberação automática:** a liberação de acesso ocorre sob pagamento. A partir da identificação do pagamento, o contrato é ativado, liberando o acesso do login para o produto vinculado no contrato.
  
- **Liberação manual:** a liberação manual libera totalmente o acesso do login TV, retornando ao plano padrão do contrato.
  
- **Cancelamento**: o login TV é inativado, ficando com o Status **Bloqueio Total** diretamente na plataforma da Apptec.
  
- **Aguardando assinatura:** irá constar como online, acesso liberado.

>[!DANGER] **Atenção:**
>Evite deletar um usuário TV diretamente pelo painel de controle da Apptec. A comunicação entre as plataformas ocorre apenas de IXC Provedor para a Apptec, portanto, alterações feitas na plataforma não serão consideradas no IXC Provedor.
>
>Em caso de deleção do usuário TV, o sistema perderá a comunicação com a plataforma e não permitirá mais alterações no usuário TV através do IXC.

#### Controle de acesso do usuário TV 
Além do controle de acesso do usuário TV ser gerenciado pelas ações do contrato, é possível realizar alterações manuais de status através dos botões **Ativar** e **Desativar** diretamente no usuário TV. O status do usuário TV pode ser controlado de duas formas:

- **Ativar:** permite realizar a ativação do usuário TV, para retomar o consumo do usuário;

- **Desativar:** permite que o cliente tenha somente o usuário de TV inativado, sem cancelar o contrato. Este corte é efetuado fazendo com que o usuário TV não tenha mais acesso à plataforma.

## Considerações Finais
A integração Apptec com o sistema oferece uma solução robusta para provedores de internet, simplificando a gestão de serviços de TV e streaming. Esta tecnologia melhora a eficiência operacional, reduz erros de informação e proporciona uma experiência superior aos clientes.

## Etiquetas
#Integracoes #IntegracaoTV #IPTV #Apptec

## Leia Também:
- [[integracoes|Integrações]]
- [[integracoes de tv|Integrações de TV]]
- [[integracoes de tv|Integrações de TV]]
- [[public/menu sistema/cadastros/pasta tv sva/login tv/usuarios tv|Usuários TV]]
- [[aba - tv - contrato do cliente|Aba TV - Contrato do cliente]]