Configurar o SMS
Este tutorial liga o envio de SMS do Atlaz: escolher o provedor, preencher as credenciais, testar e ajustar as mensagens. Os campos e as regras estão em SMS.
Acesso à página
Caminho: Configurações → Notificações → SMS
Pré-requisitos
- Conta no provedor de SMS (Genérico, PlaySMS, smsgateway.me, Zenvia ou Locaplataforma) e as credenciais dele.
- Permissão Visualizar dados de SMS para abrir e Editar dados de SMS para salvar e testar.
- Um número de celular de teste com DDD.
Credenciais
Tokens, senhas e URLs dão acesso ao serviço de SMS. Digite-os só na tela do Atlaz e não os registre em capturas.
Passo 1 — Escolha o provedor
Na aba Configurações do Servidor, escolha o Serviço. Com Desativado, nenhum SMS é enviado. Os campos de cada serviço:
| Serviço | Campos |
|---|---|
| Genérico | URL, Token e a URL de callback de entrega, que você informa ao provedor |
| Sites que utilizam PlaySMS | Servidor playsms, Login/username e Senha |
| smsgateway.me | DEVICE ID, Email e Token |
| Zenvia | Conta API e Senha API |
| Locaplataforma | Token e Tipo de serviço |
Serviço próprio pela opção Genérico
Se sua empresa está integrando um serviço próprio pela opção Genérico, consulte a documentação da API Atlaz para conferir os detalhes da requisição, autenticação, resposta e callback. A opção Genérico integra um serviço próprio à API definida pela Atlaz; o endereço, o token e o callback seguem essa documentação. Nunca publique credenciais na Wiki.
Passo 2 — Defina o intervalo
Em Intervalo entre envios, escolha Sem atraso ou de 10 a 60 segundos entre as mensagens.
Passo 3 — Salve
Clique em Salvar configurações.
Passo 4 — Envie um teste
Clique em Enviar SMS de Teste, informe o número e envie. O teste envia um SMS real.
Passo 5 — Ajuste as mensagens
Em Templates Automáticos, ative e edite as mensagens que o Atlaz envia sozinho (aviso de vencimento, confirmação de pagamento, bloqueio e outras). Em Templates Manuais, crie as mensagens que a equipe escolhe ao enviar à mão. Os textos aceitam variáveis como %nomecliente%. Quando e para quem as automáticas saem é definido em Notificações — Geral.
Resultado esperado
O SMS de teste chega ao celular, e o envio aparece em Relatórios → SMS com o status de entrega.
Problemas comuns
| Situação | O que conferir |
|---|---|
| O teste não chega | As credenciais do serviço, o número com DDD e o status no relatório. |
| Nada sai de forma automática | O Serviço não está em Desativado, a mensagem está ativa e as regras de Notificações — Geral. |
| A entrega não é confirmada | No serviço Genérico, informe ao provedor a URL de callback de entrega. |
| O texto é cortado | Alguns provedores limitam o tamanho. Encurte a mensagem. |
Checklist
- Serviço escolhido e credenciais preenchidas
- Intervalo definido e configuração salva
- SMS de teste recebido
- Mensagens automáticas e manuais revisadas