# Cancelamento de Mensagens na Fila de 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.

---

>[!quote] **Definições**
> >[!tip] **SMS**:  
> O **SMS** (Short Message Service) é um serviço de mensagens curtas de texto que permite a comunicação entre dispositivos móveis. Ele possui como principais características o limite de 160 caracteres por mensagem e a capacidade de funcionar em praticamente qualquer celular, sem a necessidade de internet. É amplamente utilizado para comunicações empresariais, notificações de serviços, confirmações de pagamento, alertas e marketing direto.
> 
> >[!tip] **Fila de SMS**:  
> Uma **fila de SMS** é um sistema ou processo que organiza e gerencia o envio de mensagens de SMS de forma sequencial e controlada. Ela é utilizada para otimizar o fluxo de envio, evitando a sobrecarga do sistema e garantindo que as mensagens sejam enviadas de maneira ordenada e eficiente.

A **fila de SMS** é um recurso projetado para o gerenciamento do envio de mensagens de SMS em massa, sendo especialmente útil para campanhas de marketing e comunicações automatizadas com clientes. Em determinados casos, pode ser necessário cancelar mensagens pendentes. Para isso, utilizamos a funcionalidade de **Cancelamento de Mensagens de SMS**, garantindo maior controle sobre o processo antes da mensagem ser entregue ao destinatário.

> [!NOTA] **Acesso à Fila de SMS**
> **Caminho:** CRM > Marketing > SMS Marketing > Fila de SMS

### Requisitos de Uso
Para utilizar esta ferramenta, é necessário atender as seguintes condições:
- Possuir uma integração de [[gateway sms|Gateway SMS]] ativa e funcional no sistema;
- O parâmetro **Adicionar mensagens à fila** deve estar habilitado no sistema;
- A fila de SMS deve conter mensagens com o status **Não enviado** para que o cancelamento seja permitido.

## Entrega de Valor
O cancelamento de mensagens pendentes na fila de SMS oferece os seguintes benefícios:
- Controle sobre campanhas de marketing em andamento;
- Correção de erros em mensagens programadas;
- Economia de recursos ao evitar o envio de mensagens desnecessárias;
- Flexibilidade na gestão de comunicações com clientes.

## Estrutura da Funcionalidade
Quando o sistema identificar mensagens pendentes na **fila de SMS** com o status **Não enviado**, ele deve permitir o cancelamento dessas mensagens. Para que o cancelamento seja realizado, é necessário que existam mensagens **aguardando** envio na fila. Este processo ocorre por meio de uma ação manual de um usuário no sistema, garantindo o controle sobre o cancelamento. O cancelamento das mensagens fica registrado nos [[log sms|Log SMS]] através de um registro com status "Falha".

## Passo a Passo - Cancelar Mensagens Pendentes na Fila de SMS
Para realizar o cancelamento de mensagens pendentes na fila de SMS, siga as etapas a seguir:

1. Acesse o formulário de [[mensagens sms|Mensagens SMS]] através do caminho: Sistema > CRM > Mensagem SMS;
2. Selecione o cadastro da mensagem que foi enviada ao cliente;
3. Clique em **Editar** e acesse a aba **Fila SMS**;
4. Na fila de SMS, clique no botão **Cancelar pendentes**;
5. O sistema irá cancelar a entrega das mensagens de SMS para os clientes, identificando somente as mensagens de status **Não enviado.**

>[!Caution] Atenção:
>Mensagens que já constam com o status de **Enviado** ainda na fila de SMS, não podem ser canceladas, pois já foram distribuídas e eliminadas da fila de SMS.

>[!SUCCESS] Finalização:
>Após realizar o cancelamento das mensagens, o disparo delas será interrompido e não serão entregues aos destinatários. Para as mensagens que tiverem os envios cancelados, serão removidas da fila e gerados logs de "Falha" nos [[log sms|Log SMS]].

## Fluxo de Processo

```mermaid
flowchart TD
    A[Usuário acessa o sistema] --> B[Acessar Sistema > CRM > Mensagem SMS]
    B --> C[Selecionar a mensagem enviada ao cliente]
    C --> D[Clicar em Editar e acessar a aba Fila SMS]
    D --> E[Clicar no botão Cancelar pendentes]
    E --> F{O status da mensagem é Não enviado?}
    
    F -- Sim --> G[O sistema cancela as mensagens pendentes]
    F -- Não --> H[Cancelamento não permitido]
    G -->I[Gera log de falha nos Logs SMS]

```

## Considerações Finais
O cancelamento de mensagens pendentes na fila de SMS é uma funcionalidade importante para o gerenciamento de comunicações com clientes. Certifique-se de revisar cuidadosamente as mensagens selecionadas antes de cancelá-las, pois esta ação não pode ser desfeita. Utilize este recurso para manter o controle sobre suas comunicações e garantir que apenas as mensagens relevantes e atualizadas sejam enviadas aos seus clientes.

## Etiquetas
#Integracoes #IntegracoesDeGatewaySMS #MensagemDeSMS #SMS #FilaDeSMS
## Leia Também
- [[integracoes|Integrações]]
- [[gateway sms|Gateway SMS]]
- [[cadastro de mensagem de sms|Cadastro de Mensagem de SMS]]
- [[mensagens sms|Mensagens SMS]]
- [[aba (fila sms) na mensagem sms - master abril 2025|Aba (Fila SMS) na Mensagem SMS - MASTER ABRIL 2025]]
- [[configuracao de fila de sms|Configuração de Fila de SMS]]