# Erro "Não autorizado" ao Cadastrar Usuário TV Watch
## Introdução
O erro "Não autorizado", retornado ao utilizar a integração de TV Watch TV pode ocorrer durante o processo de cadastro de [[public/menu sistema/cadastros/pasta tv sva/login tv/usuarios tv|Usuários TV]]  na plataforma [Watch TV](https://descubra.watch.tv.br/) integrada ao sistema. Este erro está relacionado à instabilidades de dados, normalmente diretamente ligado ao arquivo JSON, arquivo este fundamental para a comunicação entre as plataformas.

O arquivo JSON é um formato de troca de dados que permite a configuração da integração da plataforma Watch com o IXC, viabilizando o intercâmbio de informações entre os sistemas. Quando implementado no sistema IXC, é gerado um token de autenticação com prazo de expiração, que é atualizado em todas as requisições relacionadas à integração. O erro é exibido quando o sistema perde a comunicação com a Watch devido à expiração do token.


> [!NOTA] Acesso ao Formulário  
> **Caminhos:**
> 
> Sistema > Cadastros > TV/SVA > Usuários TV
> 
> Sistema > Contratos > aba TV 


## Causa do Erro
O erro “Não autorizado” ocorre devido a problemas de autenticação entre o sistema e a plataforma Watch TV. As causas mais comuns incluem:

1. Token de acesso expirado ou inválido;
2. Credenciais de integração incorretas ou desatualizadas;
3. Problemas de conectividade com a API da Watch;
4. Configurações de integração inadequadas no Sistema.

## Solução do Erro
Para resolver o erro "Não autorizado" durante o cadastro de Usuário TV Watch, é necessário solicitar um novo arquivo JSON à plataforma. O processo envolve o contato direto com o suporte da Watch TV para requerer a geração de um documento atualizado de configuração. Após receber o novo arquivo, o usuário deve acessar as configurações de integração do sistema, localizar a seção específica da Watch TV e substituir o arquivo JSON existente pelo novo documento recebido.

## Passo a Passo: Correção do Erro “Não autorizado” ao Cadastrar Usuário TV Watch
A atualização do arquivo JSON renova as credenciais de autenticação, restabelecendo a comunicação entre os sistemas. É fundamental salvar as novas configurações e verificar se o token de autenticação foi gerado corretamente. Recomenda-se, após a inserção, realizar um teste de cadastro de usuário TV para confirmar que a integração foi restabelecida com sucesso.

### URL de Retorno
A comunicação entre o sistema IXC e a plataforma Watch TV ocorre através do uso de um arquivo JSON, gerado com base na URL de retorno. A URL de retorno, configurada com a estrutura `sistema.com.br/retorno/watch/`, é fornecida à plataforma Watch TV como ponto de conexão.

>[!INFO] **URL de retorno:** 
>Uma **URL de retorno** (ou **callback URL**, em inglês) é um endereço na web que é usado como ponto de retorno para um aplicativo ou serviço após a conclusão de uma ação ou processo. Esse conceito é frequentemente utilizado em cenários de integração entre sistemas, como em APIs, autenticação

Para que a plataforma Watch TV possa gerar o arquivo JSON necessário para a integração, envie à equipe Watch a URL de retorno configurada com o domínio de acesso ao sistema IXC.

>[!INFO] **Exemplo de URL de retorno**: 
>`https://seuprovedor.com.br/retorno/watch/`

1. Copie o link de acesso ao seu sistema IXC;
2. Remova o sufixo `/adm.php` ou `/login.php`, mantendo apenas a estrutura base do domínio (ex.: `https://seudominio.com.br`);
3. Acrescente ao final do link a seguinte estrutura: `/retorno/watch/`;
4. A URL de retorno final terá a seguinte forma: `https://seudominio.com.br/retorno/watch/`.

Após coletar a URL de retorno, encaminhe-a para a equipe Watch, que será responsável pela geração do arquivo JSON necessário para estabelecer a integração. A equipe técnica da Watch processará a solicitação e enviará o arquivo para reestabelecer a comunicação entre os sistemas. Ao receber o documento, faça o download em seu computador para realizar o upload no sistema IXC e prossiga com as demais etapas:

1. Acesse o menu Configurações > Integrações > Integrações TV > selecione a integração com a plataforma Watch TV e clique em **Editar**;
2. Em seguida, clique no botão **Arquivo** localizado do lado direito do campo **Arquivo JSON**. O sistema exibirá os arquivos salvos em sua máquina, selecione o arquivo JSON fornecido e clique em **Salvar**. O sistema deve gerar um novo token e será exibido no campo **Token acesso**, indicando sucesso na comunicação entre as plataformas.

>[!SUCCESS] Finalização: 
>Após realizar a ação de todos os passos, o usuário TV pode ser cadastrado e então estará pronto para uso. O controle de acesso é feito diretamente pelas ações do contrato (bloqueio e liberação).


## Fluxo de Trabalho

```mermaid
graph TD
    A[Início: Erro Não Autorizado] --> B[Gerar URL de Retorno]
    B --> C[Formatar URL]
    C --> D{URL Válida?}
    D -->|Sim| E[Contatar Suporte Watch]
    D -->|Não| B
    E --> F[Solicitar Novo Arquivo JSON]
    F --> G[Receber Arquivo JSON]
    G --> H[Acessar Configurações IXC]
    H --> I[Localizar Integração Watch TV]
    I --> J[Fazer Upload do Arquivo JSON]
    J --> K[Gerar Novo Token]
    K --> L{Token Gerado?}
    L -->|Sim| M[Testar Cadastro Usuário TV]
    L -->|Não| E
    M --> N{Cadastro Realizado?}
    N -->|Sim| O[Fim: Integração Restabelecida]
    N -->|Não| E
```

## Considerações Finais
O processo de resolução do erro "Não autorizado" na Watch TV demonstra mais do que simplesmente corrigir um problema pontual, essa situação ressalta a necessidade de monitoramento contínuo, atualização de credenciais e adaptação dos mecanismos de integração. A precisão técnica, combinada com uma estratégia clara de solução, permite superar desafios de comunicação entre diferentes plataformas, garantindo a continuidade operacional e a eficiência dos sistemas.

## Etiquetas
#Integracoes #IntegracoesTV #IntegracaoWatchTV #WatchTV #UsuarioTV #ErrosComuns #ErrosComunsWatch

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