# Aba (Fila SMS) na Mensagem SMS (Beta)

## Introdução

>[!tip] Atenção!
>Este conteúdo está presente na **versão [[clientes beta ixc soft|Beta]]** do sistema.
>A disponibilidade desta integração na **versão Estável** será a partir de Abril de 2025.

---

>[!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, monitoramento e controle de mensagens SMS na fila de envio. Esta funcionalidade permite aos usuários visualizar, atualizar e gerenciar informações sobre as mensagens, gateways de envio, status de processamento e cancelamento de mensagens pendentes. Esta funcionalidade garante um controle eficaz e uma análise precisa das comunicações via SMS. A **Fila de SMS** facilita a visualização de logs detalhados e a realização de ajustes rápidos para otimizar o fluxo de mensagens.

> [!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;
- Utilização da [[rotina de cobranca (crm de cobranca)|Rotina de Cobrança (CRM de Cobrança)]].

## 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.
- Possibilita o cancelamento de mensagens quando necessário.

## 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. Além disso, permite o cancelamento de mensagens pendentes para validação do conteúdo ou correção de envios manuais e equivocados.

#### 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 depende da configuração de um [[gateway sms|Gateway SMS]], do cadastro da mensagem de SMS e de sua parametrização. Ela opera na distribuição das mensagens conforme são armazenadas nas filas, enviando-as para o cliente no momento adequado. Para habilitar o uso da fila, é essencial cumprir os seguintes critérios:
- Configuração das mensagens de SMS;
- Parametrização e ativação da funcionalidade de fila de SMS;
- Definição do intervalo de envio no cadastro da mensagem;
- Configuração da tarefa **EnviarSMSFila** para o envio periódico das mensagens.

A configuração da fila de SMS determina o intervalo de tempo e a prioridade das mensagens. Assim que o disparo é efetuado, as mensagens são enviadas à fila e recebem diferentes status conforme seu processamento:
- Enquanto estiverem na fila, terão o status **"Não enviado"**;
- Quando forem distribuídas e saírem da fila, assumirão o status **"Enviado"**;
- No [[log sms|Log SMS]], será registrado se a mensagem chegou ao destinatário ou se houve falha no envio.

Para garantir o envio dentro do período estipulado, é essencial cadastrar a **[[tarefa - enviarsmsfila|Tarefa - EnviarSMSFila]]**, que lê as mensagens da fila, identifica os destinatários e realiza o envio 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.
### Cancelamento de Mensagens
- O formulário permite o cancelamento de envio de mensagens que estão aguardando o disparo na fila.

## Fluxo de utilização

```mermaid
flowchart TD
    A[Sistema adiciona mensagem à fila] --> B{A mensagem pode ser enviada?}
    
    B -- Sim --> C[Mensagem enviada para o GatewaySMS]
    C --> D{Entrega bem-sucedida?}
    
    D -- Sim --> E[Cliente recebe SMS]
    E --> F[Registra log de sucesso]
    
    D -- Não --> G[Mensagem falhou]
    G --> H[Registra log de falha]
    
    B -- Não --> I[Mensagem cancelada e removida da fila]

```

## Considerações Finais
O processo de uso da **Fila de SMS** foi estruturado para garantir eficiência e confiabilidade no envio das mensagens. Ao ser adicionada à fila, a mensagem é processada e encaminhada para o Gateway SMS conforme sua ordem e prioridade. Em caso de entrega bem-sucedida, um log de sucesso é gerado, assegurando rastreabilidade. Caso ocorra falha na entrega, um log de falha é registrado para que possa ser acompanhado. Se a mensagem for cancelada antes de ser enviada, ela é removida da fila sem gerar logs de falha, simplificando o processo. Esse fluxo proporciona transparência e controle, garantindo confiança em todas as etapas do processo.

## Etiquetas
#Integracoes #IntegracoesGatewaySMS #FilaDeSMS #SMS #MensagemDeSMS 

## 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]]
- [[log sms|Log SMS]]