Validação de SMS - devbasetecnologia/devmobility GitHub Wiki

Configuração de SMS

Dentro do sistema é possível realizar a validação de SMS, sendo necessário que o usuário informe um código para poder finalizar o cadastro, para isso é necessário realizar de conta junto a MARKTEL provedora do serviço de envio de SMS.

No menu 'Configurações > APIs/Integrações > SMS API' é possível realizar a configuração da conta criada na MARKTEL.

Após acessar o menu, basta clicar no ícone de "editar" (veja imagem abaixo), para inserir as informações fornecidas pela provedora contratada (Marktel por exemplo).

Na tela seguinte, após clicar para editar, será apresentada a tela abaixo com os seguintes campos:

1- Nome: Nome da provedora.

2- Web Services User: Login fornecido pela provedora.

3- Web Services Senha: Senha fornecida pela provedora.

4- Web Services Token: Token de autenticação fornecido pela provedora.

5- Custo por SMS: Valor do custo por envio de SMS. Esse campo trata-se do valor que é cobrado pela provedora, para que o adm da plataforma faço o controle do saldo. A cada consulta realizada pelos APPs, o valor desse campo será descontado do campo "saldo", até atingir o valor "zero". (Sugerimos manter o valor "0,00" caso não queira atualizar o campo saldo sempre que necessário)

6- Saldo: Saldo disponível na provedora. É necessário informar um valor maior que 0,00. Sempre que uma validação (consulta) é realizado na provedora (seja por cadastro de cliente ou prestador via APP), o valor definido no campo "Custo" é descontado desse campo. Se o valor desse campo chegar a zero, as próximas consultas não serão realizadas, até que o valor seja novamente inserido, ou consultado pelo botão (desde que a empresa contratada forneça essa funcionalidade). (Por esse motivo, conforme explicado no campo acima, sugerimos deixar o valor do campo de custo como zero, para não diminuir o saldo)

  • ATENÇÃO: Caso possua ativo no menu 'Configurações > Sistemas' a "VALIDAÇÃO DE SMS" e dentro da configuração da API do SMS estiver com o SALDO = ZERO (R$0,00) será apresentado uma informação no menu 'Dashboard > Indicadores' semelhante a da imagem abaixo.

7- Service ID: Manter o campo sempre em branco, a menos que realmente seja informado pela provedora.

8- Testar Configurações de Envio de SMS: Função para testar o envio de SMS utilizando um número próprio.

  • Atenção: Somente é possível realizar um teste de envio após informar todos os campos anteriores e GRAVAR as informações digitadas. Se algum campo estiver errado ou não informado, será apresentada uma mensagem de erro. Caso esteja tudo correto, será apresentado a mensagem de "sucesso no envio".

Consultar Saldo e Editar as informações

Após configurar os campos fornecidos pela provedora, será possível utilizar os botões (veja imagem acima) conforme necessário.

1- Consultar: Trata-se do botão para realizar a consulta do saldo disponível diretamente na provedora contratada (desde que o tipo de conta e a provedora forneçam essa informação). Caso a empresa não disponibilize essa informação de forma automática ao consultar, é possível digitar manualmente apenas editando o campo através do botão "Editar".

2- Editar: Botão responsável para editar as informações referente a conta contratada.

Ativar a Validação

Para que a validação ocorra, além das configurações realizadas dentro do menu 'Configurações > APIs/Integrações > SMS API' é necessário também ativar duas opções dentro do menu "Configurações > Sistemas" sendo elas:

1º - No campo de "Configuração Validação SMS > Empresa para Validação por SMS" é obrigatório estar definido a empresa que foi feita a configuração.

2º - No campo de "Checks" é necessário que a flag de "Utiliza Validação por SMS" esteja marcada.

  • ATENÇÃO: Caso qualquer uma dessas opções não estejam configuradas corretamente a validação de SMS não irá funcionar, não exigindo o código de validação para o passageiro/motorista durante o processo de cadastro.

Funcionamento nos Aplicativos

Ao realizar o cadastro tento no aplicativo de PASSAGEIRO quanto no aplicativo de MOTORISTA será apresentado uma tela para que o usuário possa incluir o código de verificação enviado para a caixa de mensagens do numero informado.