# Enviar Notificação Push em Massa - Relatório de Contratos

## Introdução

>[!TIP] Definição:
>Uma **Notificação push** é uma mensagem curta e instantânea enviada por um aplicativo para o dispositivo do usuário, aparecendo na tela do dispositivo com o intuito de fornecer informações em tempo real ou de alertas importantes.

O envio em massa de Notificações Push é uma ferramenta projetada para a comunicação à um grande público. Esta função promove o envio de uma mensagem direcionada à uma cartela seleta de clientes, baseado nos filtros aplicados através do [[menu relatorios/relatorios provedor/relatorios contratos/relatorios contratos/formulario relatorio de contratos|public/Menu Relatórios/Relatórios provedor/Relatórios contratos/Relatórios contratos/Formulário Relatório de Contratos]]. Ao aplicar os filtros no relatório, o processo de envio de notificações push se estende à diversos clientes, proporcionando maior agilidade ao realizar o envio de um comunicado, alerta ou campanha promocional. Além disso, aproveita as informações já disponíveis no sistema para otimizar a comunicação. 

>[!INOTE] Acesso à funcionalidade
>A funcionalidade permite utilização a partir de dois caminhos alternativos:
>- **Caminho:** Sistema > Hotsite > Notificações Push > Modelo de mensagens push
>
>- **Caminho:** Relatórios > Relatórios provedor > Relatórios contratos > Relatórios contratos
>

### Requisitos de uso
- Para realizar envios de notificação push, **é necessário o uso do aplicativo [[central do assinante|Central do Assinante]]**, sendo este o aplicativo do cliente disponibilizado pela sua organização, visando o acesso e gerenciamento das informações sobre o contrato por parte do cliente.

## Entrega de valor
- A informação chega ao dispositivo do usuário em tempo real;
- Permite atingir um grande número de usuários simultaneamente;
- Estimula a interação do cliente com o aplicativo/serviço;
- Promove maior facilidade operacional ao enviar um comunicado em massa, 

## Estrutura da funcionalidade
A funcionalidade de envio de notificações push em massa consiste em:
- Cadastro de um [[modelo de notificacao push|Modelo de Notificação Push]];
- Envio através do [[menu relatorios/relatorios provedor/relatorios contratos/relatorios contratos/formulario relatorio de contratos|public/Menu Relatórios/Relatórios provedor/Relatórios contratos/Relatórios contratos/Formulário Relatório de Contratos]];


## Como enviar notificação push em massa

### Passo 1: Cadastro do [[modelo de notificacao push|Modelo de Notificação Push]]
Para realizar o disparo, é necessário realizar o cadastro do modelo de mensagem a ser enviada aos clientes. Siga os passos a seguir para realizar a configuração da mensagem:

1. Acesse o formulário **Modelo de Notificação Push** através do caminho: Sistema > Hotsite > Notificações push > Modelo de mensagens push;
2. Clique no botão **Novo**;
3. Preencha os campos apresentados:
	- **Tipo de notificação:** selecione o tipo de notificação de acordo com o conteúdo da mensagem que você deseja cadastrar. As opções disponíveis são: Financeiro, Atendimento, Contrato, Franquia e Geral. Escolha a categoria que melhor se alinha ao propósito e ao conteúdo da sua notificação;
	- **Título:** defina o título da mensagem para identificação;
	- **Mensagem:** insira o corpo da mensagem, de acordo com o conteúdo que será enviado.
	
> [!TIP] **Dica:**
	> Utilize variáveis para enviar mensagens personalizadas para cada cliente, com informações individuais:
	>- `#areceber_data_emissao#`: preenche a data da emissão que foi gerado o financeiro do cliente;
	>-  `#areceber_data_vencimento#`: preenche a data do vencimento da fatura;
	>-  `#areceber_numero#`: preenche a informação do ID de contas a receber;
	>-  `#areceber_valor#`:	preenche o valor em aberto da fatura.

4. Clique em Salvar para validar a criação da mensagem de notificação push. Após realizar o cadastro do modelo, ficará disponível para o envio utilizando o [[menu relatorios/relatorios provedor/relatorios contratos/relatorios contratos/formulario relatorio de contratos|public/Menu Relatórios/Relatórios provedor/Relatórios contratos/Relatórios contratos/Formulário Relatório de Contratos]].

### Passo 2: Envio da mensagem
A mensagem de notificação push pode ser enviada em massa a partir de duas alternativas: através do formulário de [[modelo de notificacao push|Modelo de Notificação Push]] ou então através do [[menu relatorios/relatorios provedor/relatorios contratos/relatorios contratos/formulario relatorio de contratos|public/Menu Relatórios/Relatórios provedor/Relatórios contratos/Relatórios contratos/Formulário Relatório de Contratos]].

#### 2.1 Envio através do formulário de [[modelo de notificacao push|Modelo de Notificação Push]]
Esta alternativa permite realizar o envio da mensagem sem acessar diretamente o relatório de contratos, podendo cadastrar a mensagem e realizar o envio a partir do direcionamento do botão **Enviar em massa**. Para realizar o envio da mensagem através do formulário [[modelo de notificacao push|Modelo de Notificação Push]], siga os passos a seguir:

1. Acesse o formulário [[modelo de notificacao push|Modelo de Notificação Push]] através do caminho: Sistema > Hotsite > Notificações push > Modelo de mensagens push;
2. Selecione a mensagem cadastrada clicando em seu registro e em seguida, clique no botão **Enviar em massa**;
3. O botão **Enviar em massa** irá direcionar a guia ao Relatório de Contratos. Preencha os filtros de envio nas abas **Filtros** e **Outros filtros**, indicando qual cartela de cliente receberá as notificações. A aba **Envios CRM** já contemplará a mensagem de notificação push no campo **Notificações push em massa**;
   
>[!TIP] Aplicação de filtros:
>Exemplo de filtro aplicado: ao selecionar o status do contrato como **Ativo** e o status de acesso como **Corte Manual**, somente os clientes que se enquadram nestas condições receberão a mensagem.

4. Após aplicar os filtros, clique sobre o botão **Envios CRM**, localizado na parte superior do formulário,
5. Selecione a opção **Enviar notificações push em massa**;
6. Após realizar o envio, o sistema retornará uma listagem das mensagens de notificação push que foram enviadas, detalhando também as mensagens de retornaram falha.

>[!CAUTION] Principais motivos de falha nas notificações push:
>- Cliente não realizou o primeiro acesso à [[central do assinante|Central do Assinante]] e/ou não possui o login;
>- Cliente não possui o aplicativo [[central do assinante|Central do Assinante]] instalado;
>- Cliente não está logado no aplicativo da [[central do assinante|Central do Assinante]];
>- Cliente está logado, mas com as notificações desabilitadas para o aplicativo [[central do assinante|Central do Assinante]].

#### 2.2 Envio através do [[menu relatorios/relatorios provedor/relatorios contratos/relatorios contratos/formulario relatorio de contratos|public/Menu Relatórios/Relatórios provedor/Relatórios contratos/Relatórios contratos/Formulário Relatório de Contratos]]
Para realizar o envio em massa da mensagem de notificação push cadastrada, siga os passos abaixo:

1. Acesse o formulário de **[[menu relatorios/relatorios provedor/relatorios contratos/relatorios contratos/formulario relatorio de contratos|public/Menu Relatórios/Relatórios provedor/Relatórios contratos/Relatórios contratos/Formulário Relatório de Contratos]]** através do caminho: Relatórios > Relatórios provedor > Relatórios contratos > Relatório contratos;
2. Na aba **Filtros**, combine os filtros necessários para aplicar a seleção de clientes que receberá as mensagens;
3. Na aba **Outros filtros**, acrescente demais filtros conforme necessário, de acordo com os campos disponíveis;
4. Na aba **Envios CRM**, no campo **Notificações push em massa**, clique na lupa e selecione a mensagem de notificação push cadastrada que será enviada à cartela de clientes filtrados;
5. Após aplicar os filtros, clique sobre o botão **Envios CRM**, localizado na parte superior do formulário;
6. Selecione a opção **Enviar notificações push em massa**;
7. Após realizar o envio, o sistema retornará uma listagem das mensagens de notificação push que foram enviadas, detalhando também as mensagens de retornaram falha.

>[!TIP] Aplicação de filtros:
>Exemplo de filtro aplicado: ao selecionar o status do contrato como **Ativo** e o status de acesso como **Corte Manual**, somente os clientes que se enquadram nestas condições receberão a mensagem.

>[!CAUTION] Principais motivos de falha nas notificações push:
>- Cliente não realizou o primeiro acesso à [[central do assinante|Central do Assinante]] e/ou não possui o login;
>- Cliente não possui o aplicativo [[central do assinante|Central do Assinante]] instalado;
>- Cliente não está logado no aplicativo da [[central do assinante|Central do Assinante]];
>- Cliente está logado, mas com as notificações desabilitadas para o aplicativo [[central do assinante|Central do Assinante]].


## Caso de uso
- **Cenário:** Envio de comunicado para clientes ativos que tiveram o acesso à internet cortado devido à inadimplência.
  
### Descrição
Para realizar o envio da notificação push para os clientes inadimplentes com acesso cortado, siga o fluxo abaixo. Este processo envolve o cadastro inicial da mensagem de notificação e a seleção dos clientes específicos aplicando filtros no sistema.

1. Inicie o processo acessando o formulário de notificações push para cadastrar o comunicado. Insira o conteúdo da mensagem direcionada a clientes com status de corte por inadimplência.
2. Após cadastrar a mensagem, acesse o formulário de [[menu relatorios/relatorios provedor/relatorios contratos/relatorios contratos/formulario relatorio de contratos|public/Menu Relatórios/Relatórios provedor/Relatórios contratos/Relatórios contratos/Formulário Relatório de Contratos]] para segmentar os clientes que receberão a mensagem;
3. Aplique os filtros de segmentação. Na aba **Filtros**, aplique os seguintes filtros:
	   -  **Status do contrato**: selecione a opção **Ativo** para incluir apenas contratos ativos.
	   - **Status de Acesso**: Marque **Corte Manual/Automático** para segmentar clientes com o acesso suspenso devido à inadimplência.
4. Na aba **Outros filtros**, aplique os seguintes filtros:
	- **Cadastro Ativo**: Na aba **Outros Filtros**, selecione **Sim** para garantir que apenas clientes com cadastro ativo sejam incluídos
5. Na aba **Envios CRM**, insira amensagem:
	- **Notificações push em massa**: clique na lupa e selecione a mensagem cadastrada;
	  
6. Após selecionar a mensagem, clique em **Envios CRM** > **Enviar Notificações Push em Massa** para iniciar o envio aos clientes filtrados;
7. Ao final do processo, o sistema exibirá um relatório com os clientes que receberam a notificação. Este relatório inclui o status de cada envio, indicando se foi bem-sucedido ou se houve falhas.

Este processo garante que a comunicação seja direcionada com precisão aos clientes que atendem às condições definidas, aumentando a efetividade do comunicado e evitando o envio para clientes fora do perfil indicado.

## Funcionalidades principais
- Permite realizar um envio massivo de mensagens de notificação push à uma cartela seleta de clientes;
- Permite personalizar o envio de mensagens;
- Permite registrar o envio de notificações push e seus respectivos status de envio através do [[historico de notificacoes push|Histórico de Notificações Push]].

## Fluxo de trabalho
```mermaid
flowchart TD
    A[Início] --> B[Acessar formulário de modelo de notificações push]
    B --> C[Realizar criação de uma notificação push]
    C --> D[Escolher tipo de envio em massa]

    D --> E1[Envio pelo relatório de contratos]
    E1 --> F1[Acessar o relatório de contratos]
    F1 --> F2[Selecionar a mensagem que será enviada]
    F2 --> F3[Aplicar os filtros]
    F3 --> G1[Enviar]

    D --> E2[Envio pelo formulário de modelo de notificações push]
    E2 --> H1[Selecionar a mensagem]
    H1 --> G2[Clicar no botão Enviar em massa]
    G2 --> H2[Aplicar os filtros]
    H2 --> I2[Enviar]
    
    G1 & I2 --> J[Relatório de envio apresentado na tela]
	J --> K[Monitorar envios pelo Histórico de Notificações Push]

```

## Considerações finais
Esta abordagem permite uma comunicação mais eficiente e direcionada, melhorando a eficácia das mensagens enviadas e potencializando o engajamento dos clientes. Esta funcionalidade permite comunicar-se eficientemente com um grande número de clientes de forma rápida e direcionada. 

## Etiquetas
#NotificacoesPush #RelatoriosDeContratos #RelatorioDeContrato #CentralDoAssinante #EnvioDeMensagens 

## Leia mais
- [[central do assinante|Central do Assinante]]
- [[menu relatorios/relatorios provedor/relatorios contratos/relatorios contratos/formulario relatorio de contratos|public/Menu Relatórios/Relatórios provedor/Relatórios contratos/Relatórios contratos/Formulário Relatório de Contratos]]
- [[historico de notificacoes push|Histórico de Notificações Push]]
- [[modelo de notificacao push|Modelo de Notificação Push]]
- [[cadastro de notificacao push|Cadastro de Notificação Push]]