Desenvolvedores
O SMS Fácil oferece integração com qualquer aplicativo que possa realizar chamadas HTTP, utilizando os métodos GET e POST.
Para maior segurança e confiabilidade, recomendamos o uso de HTTPS (protocolo seguro) em todas as chamadas.
► Enviando uma mensagem imediatamente
Para realizar o envio de mensagem imediatamente via HTTP, utilize esta URL:
https://www.smsfacil.com.br/api/EnviaSMS/?usuario=xxxx&senha=xxxx¶=xxxxxx&texto=texto+da+mensagem
► Enviando uma mensagem programada (envio agendado)
Para realizar o envio de mensagem programada via HTTP, utilize esta URL:
https://www.smsfacil.com.br/api/EnviaSMS/?usuario=xxxx&senha=xxxx¶=xxxxxx&texto=texto+da+mensagem&hora=hh:mm&data=dd/mm/aaaa
* O valor para o parâmetro data deve ser uma data válida no formato dd/mm/aaaa. Ex: 17/09/2015
* Para o parâmetro hora deve ser especificada uma hora válida no formato hh:mm. Ex: 12:30
* O relógio do servidor de envio está ajustado para o horário de Brasília.
* É importante atentar-se para o fuso horário de sua localidade e o horário de verão.
* Os envios que forem programados com data ou hora retrocedidas, serão enviados imediamente.
Ao realizar a chamada HTTP para o envio de mensagem, você receberá uma resposta à sua solicitação como segue:
| Resposta | Descrição |
| -2 | Formato de número móvel de destintário inválido. |
| -3 | Indica que o texto da mensagem está vazio/inválido. |
| -4 | Número móvel inválido ou não suportado pelo sistema. |
| -5 | Sistema indisponível tente novamente mais tarde. (muito raro) |
| -6 | Conta Bloqueada. (vide observação) |
| -7 | Crédito insuficiente para realizar o envio. |
| -8 | Usuário ou senha inválidos. |
| -9 | Data ou hora de agendamento inválidos.Os parâmetros data e hora (se informados), devem possuir valores válidos. |
| OK 1234567890923 | Indica que a mensagem foi enviada. Quando uma mensagem é enviada corretamente, a resposta fornece um número de solicitação que poderá ser consultado posteriormente. |
► Cancelando uma mensagem programada (envio agendado)
Para realizar o cancelamento de uma mensagem programada via HTTP, utilize esta URL:
https://www.smsfacil.com.br/api/cancelaenvio/?usuario=xxxxxx&senha=xxxxxx&nr_pedido=1234567890923
* O valor para o parâmetro nr_pedido deve ser exatamente o código de retorno fornecido pela resposta ao se enviar uma mensagem programada.
Ao realizar a chamada HTTP para o envio de mensagem, você receberá uma resposta à sua solicitação como segue:
| Resposta | Descrição |
| -1 | Formato de número de pedido inválido. Verifique se o número de pedido consultado contém apenas números. |
| -2 | Envio não encontrado. O envio já está em andamento, concluído ou não existe. Não é possível cancelar um envio em andamento. |
| -8 | Usuário ou senha inválidos. |
| OK | Indica que o envio da mensagem programada foi cancelado com sucesso. |
► Consultando o status de entrega de mensagem
Para consultar a situação de entrega da mensagem, utilize esta URL:
https://www.smsfacil.com.br/api/consultaenvio/?usuario=xxxx&senha=xxxx&nr_pedido=1234567890923
* O valor para o parâmetro nr_pedido deve ser exatamente o código de retorno fornecido pela resposta ao se enviar uma mensagem.
Ao realizar a chamada HTTP para consultar o status de entrega, você receberá uma resposta à sua solicitação como segue:
| Resposta | Descrição |
| Entregue | A mensagem foi entregue ao destinatário. |
| Não entregue | A mensagem não pôde ser entregue. |
| Enviada | A mensagem foi enviada, mas não foi possível saber se chegou ao destinatário. A confirmação de recebimento poderá chegar em até 3 dias a contar da data do envio. |
| Não enviada | A mensagem não pode ser enviada. |
| Número inválido | Destinatário é inválido, inexistente ou não há cobertura. Neste caso não há cobrança de créditos. |
| Texto inválido | A mensagem está em formato incorreto. |
| Pendente | A mensagem está na fila aguardando o envio. |
| Aguardando envio | A mensagem está pronta para ser enviada. |
| dd/mm/aaaa hh:mm | Se a mensagem foi enviada com data e hora programada e ainda não foi disparada, o retorno será a data e a hora em que o disparo será realizado. |
| -8 | Usuário ou senha inválidos. |
| -9 | Formato de número de pedido inválido. Verifique se o número de pedido consultado contém apenas números. |
| -10 | Mensagem inexistente ou com data de histórico expirada. |
► Consultando seu saldo
Para consultar seu saldo, utilize esta URL:
https://www.smsfacil.com.br/api/consultarsaldo/?usuario=xxxx&senha=xxxx
Ao realizar a chamada HTTP para consultar seu saldo, você receberá uma resposta à sua solicitação como segue:
| Resposta | Descrição |
| N | Onde N é será o número de créditos disponíveis em sua conta. |
| 8 | Usuário ou senha inválidos. |