# Fila de SMS

## Introdução

>[!TIP] Definição - Fila de SMS
>Uma **fila de SMS** é um sistema ou processo que organiza e gerencia o envio de mensagens de forma sequencial e controlada. Ela é usada para otimizar o fluxo de envio, evitando sobrecarga do sistema e garantindo que as mensagens sejam enviadas de maneira ordenada e eficiente.

O formulário **Fila de SMS** é uma ferramenta essencial para o gerenciamento e monitoramento de mensagens SMS em fila de envio. Esta funcionalidade permite aos usuários visualizar e atualizar informações sobre mensagens, gateways e status de envio, proporcionando um controle eficaz das comunicações via SMS.

> [!NOTA] **Acesso ao Formulário**
> **Caminho:** Sistema > Mensagens > Mensagem SMS > Aba Fila SMS

### Requisitos de uso
Para utilizar a fila de SMS, é necessário atender as seguintes condições:
- Possuir uma integração de [[gateway sms|Gateway SMS]] cadastrada no sistema. Ela deve estar ativa e funcional;
- Parametrização da funcionalidade de Fila de SMS associada à tarefa EnviarSMSFila para ativação do recurso.

## Entrega de valor
Aa fila de SMS otimiza o processo de envio de mensagens em massa, garantindo uma distribuição eficiente e controlada. Promovendo:
- Organização do fluxo de envio de SMS;
- Priorização de mensagens;
- Controle da taxa de envio;
- Redução de sobrecarga nos servidores;
- Melhoria na entregabilidade das mensagens.

## Estrutura do formulário
O formulário **Fila de SMS** é composto por uma única seção principal: **Fila de SMS.** Este formulário está relacionado ao formulário de [[mensagens sms|Mensagens SMS]], o qual permite o cadastro de Mensagens de SMS no sistema para envios variados.

Esta seção permite a visualização e gerenciamento das mensagens SMS que estão na fila de envio, através de uma grid, organizada em linhas e colunas, apresentando as principais informações relacionadas às mensagens que estão armazenadas na fila de envio, como por exemplo: Status de envio, Prioridade, e Telefone.

#### Campos principais

| Campo           | Descrição                                                           |
| --------------- | ------------------------------------------------------------------- |
| ID              | Identificador único da mensagem na fila, gerado automaticamente     |
| Gateway         | Identificador do Gateway SMS utilizado para o envio da mensagem SMS |
| Prioridade      | Define a prioridade de envio da mensagem, variando de 1 a 10        |
| Status de Envio | Indica o status atual do envio da mensagem (Enviado ou Não enviado) |
| Mensagem        | ID da mensagem relacionada, proveniente do módulo de marketing      |

## Princípios de Funcionamento
A fila de SMS é baseada na configuração de um [[gateway sms|Gateway SMS]], no cadastro de mensagem de SMS e a sua parametrização.Para ativar o uso da fila, são necessários os seguintes critérios:
- Configuração das mensagens de SMS;
 - Parametrização e ativação da funcionalidade de fila de SMS;
 - Configuração do intervalo de envio no cadastro da mensagem;
 - Configuração da tarefa EnviarSMSFila para envio periódico das mensagens.

A configuração da fila de SMS define o intervalo de tempo e a prioridade para as mensagens. Essas mensagens são enviadas à fila assim que o disparo for efetuado. Para garantir o envio efetivo dentro do período estipulado, é necessário cadastrar a Tarefa - EnviarSMSFila. Esta tarefa lê as mensagens da fila e seus destinatários, realizando então o envio por completo.

>[!TIP] Manual:
>Para conferir como realiza-se a configuração da Fila de SMS, confira o manual: [[configuracao de fila de sms|Configuração de Fila de SMS]]

## Funcionalidades principais

### Atualização das mensagens na fila
- O formulário permite atualizar a lista de mensagens na fila assim que um novo envio é realizado, garantindo que os usuários tenham acesso às informações mais recentes.
### Gerenciamento da fila de SMS
- O formulário apresenta de forma geral, todas as informações competentes ao envio da mensagem e seu registro na fila, como o status de envio, prioridade e o telefone de envio, promovendo uma gestão eficiente sobre o uso da fila de SMS.

## Fluxo de utilização

```mermaid
sequenceDiagram

	participant Sistema
	participant FilaSMS
	participant GatewaySMS
	participant Cliente
	Sistema->>Sistema: Dispara mensagem
	Sistema->>FilaSMS: Adiciona mensagem à fila
		loop Processamento da Fila
		FilaSMS->>FilaSMS: Verifica prioridades e tempo de envio
		FilaSMS->>GatewaySMS: Envia mensagem
		GatewaySMS->>Cliente: Entrega SMS
	end
```

## Considerações Finais
O formulário Fila de SMS é uma ferramenta crucial para empresas que dependem de comunicações via SMS. Ele oferece uma visão clara e gerenciável das mensagens em fila, permitindo um controle eficiente do processo de envio e garantindo que as mensagens sejam entregues de acordo com as prioridades estabelecidas.


## Etiquetas
#Integracoes #IntegracaoGatewaySMS #FilaDeSMS #SMS 

## Leia Também
- [[integracoes|Integrações]]
- [[gateway sms|Gateway SMS]]
- [[cadastro de mensagem de sms|Cadastro de Mensagem de SMS]]
- [[mensagens sms|Mensagens SMS]]
- [[tarefa - enviarsmsfila|Tarefa - EnviarSMSFila]]