# Histórico de Notificações Push

## Introdução
O formulário de **Histórico de Notificações Push** é uma ferramenta essencial para gerenciar e monitorar as notificações enviadas através do aplicativo [[central do assinante|Central do Assinante]] no sistema IXC Soft. Este recurso permite aos usuários acompanhar o status das notificações, identificar sucessos e falhas, e compreender os motivos por trás de eventuais problemas no envio.

> [!NOTA] Acesso ao formulário
> Caminho: Sistema > Hotsite > Notificações push > Histórico de notificações push

## Conceitos fundamentais

>[!tip] Definições:
>- **Notificação push:** Mensagem curta enviada diretamente para dispositivos móveis dos usuários, visando uma comunicação eficiente e direta;
>- **[[central do assinante|Central do Assinante]]:** Interface onde os clientes podem acessar informações e serviços relacionados à sua conta;
>- **Status de Notificação**: Indica o estado atual de uma notificação enviada, podendo ser "Enviada", "Falha", ou "Aguardando".

## Entrega de Valor
- Rastreamento eficiente das notificações enviadas;
- Identificação rápida de falhas no envio;
- Melhoria na comunicação com os clientes;
- Análise do desempenho das campanhas de notificação.

## Estrutura do Formulário
O formulário de **Histórico de Notificações Push** está estruturado em uma grid, composta por dados organizados em linhas e colunas, contendo as principais informações sobre o envio da notificação. A grid está disposta conforme a descrição a seguir:

|**Campo**|**Descrição**|
|---|---|
|**ID**|Identificação numérica única do histórico da notificação push.|
|**Cliente**|Nome do cliente que recebeu a notificação.|
|**Status de envio**|Indicador do status do envio, que pode ser: Aguardando, Falhou, etc.|
|**Título**|Título da notificação enviada.|
|**Mensagem**|Conteúdo da mensagem da notificação enviada.|
|**Tipo de notificação**|Categoria da notificação enviada, como Financeiro, Contrato, etc.|
|**Data de criação**|Data e hora em que a notificação foi criada.|
|**Data de envio**|Data e hora em que a notificação foi efetivamente enviada.|
Ao selecionar um registro individual para visualização, são apresentados os detalhes conforme os campos a seguir:

| **Campo**                                | **Descrição**                                                                                      |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------- |
| **ID**                                   | Identificação numérica única do histórico da notificação push.                                     |
| **Cliente**                              | Identificação numérica e nome do cliente que recebeu a notificação.                                |
| **Tipo de notificação**                  | Categoria da notificação enviada, como Financeiro, Atendimento, Contrato, Franquia ou Geral.       |
| **Título**                               | Título da notificação enviada.                                                                     |
| **Mensagem**                             | Conteúdo da mensagem da notificação enviada.                                                       |
| **Token do Firebase**                    | Token utilizado no Firebase para o envio da notificação push.                                      |
| **Data criação**                         | Data e hora em que a notificação foi criada.                                                       |
| **Data de envio**                        | Data e hora em que a notificação foi efetivamente enviada.                                         |
| **Status de envio**                      | Indicador do status do envio, que pode ser: Aguardando, Enviado, Falhou, etc.                      |
| **Retorno do envio da notificação push** | Mensagem de retorno referente ao envio da notificação push, indicando sucessos ou falhas no envio. |

### Leitura dos Status de Envio de Notificação Push

- **Aguardando:** a notificação está na fila de envios em processamento para ser enviada ao cliente;
- **Enviada:** a notificação foi entregue com sucesso ao celular do cliente;
- **Falha:** não foi possível entregar a mensagem ao cliente.

>[!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]].


## Funcionalidades Principais

### Visualização do Histórico
O formulário apresenta uma lista detalhada de todas as notificações push enviadas, incluindo:
- Data e hora do envio;
- Conteúdo da mensagem;
- Destinatário;
- Status atual.

### Filtragem de Notificações
Os usuários podem refinar a visualização do histórico utilizando diversos filtros:

| Filtro              | Descrição                                                   |
| ------------------- | ----------------------------------------------------------- |
| Status de envio     | Filtra por notificações enviadas, falhas, etc.              |
| Cliente             | Exibe notificações enviadas para um cliente específico      |
| Data                | Permite selecionar um intervalo de datas                    |
| ID                  | Permite filtrar por um ID específico                        |
| Mensagem            | Conteúdo de mensagem enviada                                |
| Tipo de notificação | Tipo de notificação push definida na configuração do modelo |
## Fluxo de Trabalho

```mermaid
graph TD
    A[Acesso ao Formulário] --> B[Visualização do Histórico]
    B --> C{Necessidade de Filtro?}
    C -->|Sim| D[Aplicar Filtros]
    C -->|Não| E[Análise Geral]
    D --> E
    E --> F{Identificação de Problemas?}
    F -->|Sim| G[Investigação Detalhada]
    F -->|Não| H[Relatório de Sucesso]
    G --> I[Ações Corretivas]
    H --> J[Fim do Processo]
    I --> J
```

## Considerações Finais
O Histórico de Notificações Push é uma ferramenta essencial para garantir a eficácia da comunicação com os clientes através de notificações móveis. Ao fornecer uma visão abrangente e detalhada do processo de envio, permite que as empresas otimizem suas estratégias de comunicação e resolvam rapidamente quaisquer problemas técnicos.

## Etiquetas
#NotificaçõesPush #CentralDoAssinante 

## Leia Também
- [[central do assinante|Central do Assinante]]
- [[modelo de notificacao push|Modelo de Notificação Push]]
- [[cadastro de notificacao push|Cadastro de Notificação Push]]
- [[enviar notificacao push em massa - relatorio de contratos|Enviar Notificação Push em Massa - Relatório de Contratos]]
- [[envio de notificacao push avulsa pelo cadastro do cliente|Envio de Notificação Push Avulsa pelo Cadastro do cliente]]
- [[notificacoes push de cobranca|Notificações Push de Cobrança]]
- [[rotina de cobranca (crm de cobranca)|Rotina de Cobrança (CRM de Cobrança)]]]