# Enviar Mensagem de SMS em Massa - Relatório de Contratos

## Introdução

>[!TIP] Definição:
>Uma **Mensagem de SMS** é um serviço de comunicação que permite o envio de mensagens curtas de texto entre dispositivos móveis (telefones celulares). Possui alta taxa de entrega e leitura, permitindo uma comunicação assíncrona.

O envio em massa de Mensagens de SMS é 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 Mensagens de SMS 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
>**Caminho:** Relatórios > Relatórios provedor > Relatórios contratos > Relatórios contratos
>

### Requisitos de uso
- O envio de [[mensagens sms|Mensagens SMS]] requer a integração de um [[gateway sms|Gateway SMS]] ao sistema. Este componente é essencial para viabilizar o disparo efetivo das mensagens através do canal de SMS.

>[!TIP] Gateway SMS:
>O Gateway SMS é uma plataforma/serviço que opera como um intermediário para o envio de mensagens de SMS no sistema, facilitando a comunicação entre os indivíduos envolvidos. Os envios podem ser notificações importantes, alertas de cobrança, informações sobre os serviços, entre outras.

## 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 Mensagens de SMS em massa consiste em:
- [[cadastro de mensagem de sms|Cadastro de Mensagem de SMS]];
- 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 Mensagem de SMS em massa

### Passo 1: [[cadastro de mensagem de sms|Cadastro de Mensagem de SMS]]
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 de [[mensagens sms|Mensagens SMS]] através do caminho: Sistema > CRM > Mensagens > Mensagem SMS;
2. Clique no botão **Novo**;
3. Preencha os campos:
	- **Gateway SMS:** clique na lupa e selecione o Gateway SMS responsável por realizar o envio da mensagem;
	- **Remetente:** insira de forma breve o remetente que constará para o cliente;
	- **Descrição:** insira uma descrição para facilitar a identificação de mensagens no sistema. Este campo não é visível ao cliente;
	- **Mensagem:** insira o assunto da mensagem correspondente ao título do SMS que será enviado na mensagem;
	- **Prioridade:** ao utilizar o recurso de [[aba (fila sms) na mensagem sms|Aba (Fila SMS) na Mensagem SMS]], poderá definir a prioridade de envio da mensagem entre as mensagens da fila;
	- **Intervalo de tempo:** indique em minutos o período que a mensagem será enviada quando for acrescentada na fila de SMS;
	- **Marketing:** indique se a mensagem é uma mensagem de marketing. Este campo é somente informativo, não afetando em termos de usabilidade.
	  
4. Clique em **Salvar** para validar o cadastro da mensagem de SMS.

Após cadastrar a mensagem, ela permanecerá disponível no formulário de **[[mensagens sms|Mensagens SMS]]** para possíveis ajustes e edição, caso necessário. Com a mensagem cadastrada, poderá utilizá-la para realizar os envios conforme a necessidade.

### Passo 2: Envio da mensagem
A mensagem de Mensagem de SMS pode ser enviada em massa a partir de filtros aplicados no [[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 Mensagem de SMS 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 **Mensagem SMS**, clique na lupa e selecione a mensagem de SMS 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 SMS**;
7. Após realizar o envio, o sistema retornará uma listagem das mensagens de Mensagem de SMS 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 Mensagens de SMS:
>- Bloqueio do serviço contratado;
>- Alteração das credenciais API para estabelecimento da comunicação entre os sistemas;
>- Dados de integração incorretos.

## 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 Mensagem de SMS 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 [[mensagens sms|Mensagens SMS]] 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:
	- **Mensagem SMS:** clique na lupa e selecione a mensagem cadastrada;
	  
6. Após selecionar a mensagem, clique em **Envios CRM** > **Enviar SMS** 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 Mensagem de SMS à uma cartela seleta de clientes;
- Permite personalizar o envio de mensagens;
- Permite registrar o envio de Mensagens de SMS e seus respectivos status de envio através dos formulários de [[log sms|Log SMS]] e [[aba sms enviados - cliente|Aba SMS enviados - Cliente]].

## Fluxo de trabalho
```mermaid
flowchart TD
    A[Início] --> B[Acessar formulário de modelo de Mensagens de SMS]
    B --> C[Realizar criação de uma Mensagem de SMS]
    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]
   
    G1--> J[Relatório de envio apresentado na tela]
	J --> K[Monitorar envios pelos Logs SMS]

```

## 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 
#GatewaySMS #RelatoriosDeContratos #RelatorioDeContrato #MensagemDeSMS #EnvioDeMensagens 

## Leia mais
- [[integracoes|Integrações]]
- [[gateway sms|Gateway SMS]]
- [[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]]
- [[cadastro de mensagem de sms|Cadastro de Mensagem de SMS]]
- [[log sms|Log SMS]]
- [[aba sms enviados - cliente|Aba SMS enviados - Cliente]]