# Envio de Pix por SMS

## Introdução
A funcionalidade de **Enviar Pix por SMS** foi desenvolvida para simplificar o compartilhamento de dados de cobranças via **Pix** diretamente pelo sistema. Essa solução otimiza a comunicação ao permitir o envio de informações de cobrança para contatos cadastrados, promovendo maior transparência no relacionamento com os clientes. Além disso, elimina a necessidade de procedimentos manuais, assegurando que as informações sejam transmitidas com precisão, segurança e agilidade.

> [!NOTA] **Acesso à Configuração:**  
> **Caminho:** Configurações > Parâmetros > Parâmetros financeiro > SMS para envio de boletos

Com essa funcionalidade, é possível notificar os clientes de forma eficiente sobre pagamentos via Pix. Este documento apresenta o passo a passo para configurar e utilizar essa ferramenta no sistema.

### Requisitos de Uso
Para utilizar a funcionalidade de envio de , é necessário atender às seguintes condições:
- Possuir uma integração de [[gateway sms|Gateway SMS]] ativa e funcional no sistema, que suporte envios de textos com mais de 300 caracteres;
-  Utilizar integrações bancárias que efetuem a geração do código pix; 

>[!EXAMPLE] Carteiras de cobrança compatíveis para o envio de pix:
>**Carteiras de pix instantâneo:**
>- Efí Bank;
>- modobank; 
>
>**Carteiras de boleto híbrido (boleto com QRCode Pix):**
>- API Banco do Brasil;
>- API Santander;
>- API Sicoob;
>- API Sicredi;
>- Wide Pay;
>- Iugu;
>- Efí Bank (Gerencianet);
>- Cel_cash (Galaxpay).
>  
>**Carteiras de cobrança com configuração alternativa de pagamento com:**
>- Efí Bank (não gera QR Code no boleto);
>- modobank; 

## Entrega de Valor
Esta funcionalidade oferece valor em diversas áreas:
- Possibilita a personalização e envio de cobranças alinhadas às necessidades específicas de cada cliente, promovendo um atendimento mais próximo e individualizado;
- Otimiza o tempo para envio dos dados de cobrança, agilizando o processo de compartilhamento das informações;
- Simplifica o pagamento ao fornecer opções práticas, como Pix Copia e Cola ou QR Code, tornando o processo mais acessível;
- Oferece maior transparência ao disponibilizar aos clientes um acesso fácil e direto às informações de suas cobranças;
- Garante a confiabilidade das informações enviadas, baseando-se em filtros configurados no sistema.

## Estrutura da Funcionalidade
A funcionalidade **'Enviar Pix por SMS'** está integrada ao processo de geração de boletos do tipo Pix, permitindo o envio eficiente de cobranças diretamente por SMS. Com essa ferramenta, é possível compartilhar um resumo detalhado dos dados de cobrança com o cliente, incluindo opções práticas de pagamento, como Pix Copia e Cola e QR Code. Essa solução agiliza a comunicação, melhora a experiência do cliente e facilita o recebimento dos pagamentos de forma simples e segura.

Esta funcionalidade é acessada por meio do envio de boletos:
- [[envio de boletos por sms pelo financeiro do cliente|Envio de Boletos por SMS pelo Financeiro do Cliente]]
- [[envio de boletos por sms pelo relatorio de emissao de boletos|Envio de Boletos por SMS pelo Relatório de Emissão de Boletos]]

Ao utilizá-la, o usuário aplica filtros personalizados no sistema, determinando os dados específicos a serem incluídos no envio. O sistema compila as informações e as encaminha automaticamente ao SMS do destinatário.

O envio de SMS inclui informações detalhadas sobre a cobrança conforme a configuração das variáveis no SMTP, tais como:
- Pix copia e cola;
- Valor a ser pago;
- Linha digitável (quando houver a emissão de boleto tradicional + Pix);
- Data de vencimento;

Essa ferramenta é especialmente útil para empresas que desejam enviar dados financeiros de boletos gerados para seus clientes, garantindo uma comunicação eficiente e transparente sobre os custos e o uso do serviço.

## Configuração e Envio do SMS para Envio de Pix

>[!INFO] Importante:
>Para efetuar o envio de mensagens por SMS, considere já utilizar uma integração de [[gateway sms|Gateway SMS]] no sistema. 
### Passo 1: Cadastro da Mensagem de SMS
Nesta etapa, será cadastrada uma mensagem de SMS para o envio das mensagens relacionadas às cobranças pix. Para realizar este procedimento, siga os passos a seguir:

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 para ser utilizado no Inmap Sales.
	  
4. Clique em **Salvar** para validar o cadastro da mensagem de SMS.

>[!TIP] Dica:
>Verifique as variáveis de SMS suportadas para este tipo de envio acessando o material:
>- [[variaveis de sms para envio manual de cobrancas pix|Variáveis de SMS para Envio Manual de Cobranças Pix]]

>[!CAUTION] Lembre-se:
>Para garantir o envio de informações financeiras detalhadas por SMS, é necessário que o gateway de SMS suporte mensagens com mais de 300 caracteres. Caso o texto ultrapasse esse limite, a mensagem poderá ser enviada de forma incompleta ou não ser enviada.


### Passo 2: Parametrização da Mensagem 
Nesta etapa, considerando a mensagem de SMS já cadastrada, é necessário definí-la como padrão para envios manuais. Para efetuar este procedimento, siga os passos a seguir:

1. Acesse o formulário de [[parametros financeiro|Parâmetros Financeiro]] através do caminho: Configurações > Parâmetros > Parâmetros financeiro;
2. Na aba **Geral**, no campo **SMS para envio de boletos**, clique na lupa e selecione uma a mensagem de SMS previamente configurada;
3. Clique em **Salvar** para validar a alteração.

>[!DANGER] Cuidado:
>Esta mensagem será destinada a envios manuais realizados pelo sistema, abrangendo tanto os envios pelo relatório de [[emissao de boletos|Emissão de Boletos]] quanto pelo **Financeiro do Cliente**. Por isso, é essencial elaborar o conteúdo com cuidado, garantindo que seja adequado para o envio de diferentes tipos de boletos, especialmente em casos de carteiras da utilização de outras carteiras de cobrança que não incluem a geração do código Pix/QR Code.

### Passo 3: Envio do Pix por SMS
Com a mensagem SMS padrão configurada para o envio das mensagens, o envio dos dados da cobrança pix é viabilizado, podendo ser efetuado tanto pelo cadastro do [[formulario cliente|Formulário Cliente]] como pelo Relatório de [[emissao de boletos|Emissão de Boletos]]. A configuração prévia do servidor permite que o sistema envie estes dados sem a necessidade de realizar ajustes manuais a cada envio, proporcionando um processo contínuo e eficiente, portanto, para realizar o envio, siga os passos a seguir:

>[!TIP] Importante:
>Certifique-se de que o boleto gerado é do tipo **Pix.**

#### Envio através do cadastro do cliente
1. Acesse o [[formulario cliente|Formulário Cliente]] através do caminho: Sistema > Cadastros > Clientes;
2. Acesse a aba **Financeiro**;	
3. Selecione um dos boletos gerados e clique em **Imprimir boleto**;
4. Clique em **Enviar por SMS** para efetuar o disparo da mensagem de SMS com os dados da cobrança. O sistema processará a solicitação e exibirá um relatório confirmando o status do envio. Caso o envio seja bem-sucedido, a seguinte mensagem será exibida: _"SMS enviado com sucesso para (SMS do destinatário)!"_
	O destinatário receberá a mensagem em sua caixa de entrada, que incluirá os seguintes dados configurados no **Gateway SMS**:
	- **Assunto**;
	- **Responsável pelo envio**;
	- **Conteúdo da mensagem**.

#### Envio através do relatório de [[emissao de boletos|Emissão de Boletos]]
1. Acesse o formulário de [[emissao de boletos|Emissão de Boletos]] através do caminho: Relatórios > Relatórios financeiros > Relatórios de Saída > Emissão de boletos;
2. Filtre por **Carteira de cobrança**, **Data de vencimento inicial e final** e **Status dos títulos (abertos)**. Após aplicar os filtros, clique em **Enviar por SMS** para efetuar o disparo da mensagem de SMS com os dados da cobrança. O sistema processará a solicitação e exibirá um relatório confirmando o status do envio. Caso o envio seja bem-sucedido, um relatório será impresso na tela do sistema, contendo uma listagem com os clientes dos quais foram identificados nos filtros: _"SMS adicionado na fila com sucesso! Destinatário: (SMS do destinatário)!"_
	O destinatário receberá a mensagem em sua caixa de entrada, que incluirá os seguintes dados configurados no **Gateway SMS**:
	- **Assunto**;
	- **Responsável pelo envio**;
	- **Conteúdo da mensagem**.
	  
>[!SUCCESS] Finalização:
>Após o sistema exibir a mensagem de confirmação, o processo será concluído e o cliente receberá a mensagem com sucesso. A mensagem ficará registrada em [[log sms|Log SMS]] (Configurações > Logs > Log SMS).

>[!CAUTION] Atenção:
>Caso, após solicitar o envio, a mensagem exibida seja diferente de _"Sucesso"_, verifique os dados da conta de **Gateway SMS** integrada. Certifique-se de que as credenciais estejam corretamente configuradas para garantir o envio bem-sucedido das mensagens.


## Fluxo de Trabalho

```mermaid
graph TD
  A[Início] --> B{Enviar SMS através do cadastro do cliente?}
  B -->|Sim| C[Acesse o Formulário Cliente<br>Sistema > Cadastros > Clientes]
  C --> D[Acesse a aba Financeiro]
  D --> E[Selecione um boleto e clique em Imprimir boleto]
  E --> F[Clique em Enviar por SMS]
  F --> G[O sistema processa a solicitação e exibe o status]
  G --> H{Envio bem-sucedido?}
  H -->|Sim| I[SMS enviado com sucesso]
  I --> J[Registrar no log de SMS]
  H -->|Não| K[Erro no envio<br>Verificar configuração do Gateway SMS]

  B -->|Não| L{Enviar SMS através do relatório de Emissão de Boletos?}
  L -->|Sim| M[Acesse Relatórios > Relatórios financeiros<br>Relatórios de Saída > Emissão de boletos]
  M --> N[Filtre por:<br>- Carteira de cobrança<br>- Data de vencimento<br>- Status dos títulos]
  N --> O[Clique em Enviar por SMS]
  O --> P[O sistema processa a solicitação e exibe o status]
  P --> Q{Envio bem-sucedido?}
  Q -->|Sim| R[SMS adicionado à fila]
  R --> S[Registrar no log de SMS]
  Q -->|Não| T[Erro no envio<br>Verificar configuração do Gateway SMS]

```

## Considerações Finais
A funcionalidade de envio de SMS para cobrança de boletos oferece uma solução eficiente e automatizada para empresas, simplificando a comunicação com os clientes e garantindo o envio de informações precisas sobre os pagamentos. A integração com o log de SMS proporciona maior controle e rastreabilidade das ações, permitindo que as equipes monitorem o sucesso ou falha de cada envio. Com a personalização dos dados, como o assunto, responsável e conteúdo da mensagem, a ferramenta assegura que o processo de cobrança seja transparente, ágil e alinhado às necessidades da empresa, resultando em um atendimento mais eficiente e em melhores práticas de gestão financeira.

## Etiquetas
#Integracoes #EmailSMTP #EmissaoDeBoletos #CadastroCliente 
## Leia Também
 - [[integracoes|Integrações]]
 - [[gateway sms|Gateway SMS]]
 - [[modobank - pix avulso|modobank - Pix Avulso]]
 - [[efi - pix avulso|Efí - Pix Avulso]]
 - [[emissao de boletos|Emissão de Boletos]]
 - [[formulario cliente|Formulário Cliente]]
 - [[parametros financeiro|Parâmetros Financeiro]]
 - [[contas a receber|Contas a Receber]]
- [[emissao de boletos|Emissão de Boletos]]
- [[integracoes bancarias - carteira de cobranca|Integrações Bancárias - Carteira de Cobrança]]
- [[integracoes bancarias - gateway|Integrações Bancárias - Gateway]]
- [[integracoes bancarias - api|Integrações Bancárias - API]]
- [[integracoes bancarias - pix avulso|Integrações Bancárias - Pix Avulso]]