Português
English
A resposta curta: qualquer sistema que faça um pedido HTTPS consegue enviar SMS pela nossa API: um ERP, um CRM, um programa de facturação ou um sistema feito à medida. O programador precisa de uma chave, do endereço e de conhecer meia dúzia de regras. Esta é a lista para lhe entregar.
O que entregar ao programador
| O quê | Pormenor |
| Endereço da API | https://{V:api_host}/v1, só HTTPS, pedidos e respostas em JSON. |
| Chave | Criada na página API do Meu Interweb, enviada no cabeçalho Authorization: Bearer .... A chave só aparece uma vez. |
| Permissões | sms:write para enviar e sms:read para consultar estados e saldo. Nada mais. |
| Sandbox e Produção | Uma chave sandbox_ para desenvolver (nada sai nem é cobrado) e uma prod_ para o dia de arranque. |
| Números | Telemóveis de Moçambique e Angola, escritos com ou sem o indicativo, porque o sistema reconhece o país pelo primeiro algarismo: 841234567 vai para Moçambique e 923456789 para Angola. Assim, +258 84 123 4567 e 258841234567 são o mesmo número que 841234567. |
| Remetente | Sem o campo sender, sai o NETMSG. Para o seu nome, um Sender ID já aprovado. |
As regras que evitam problemas
|
|
|
|
|
Segurança da chave
A chave fica no servidor, numa variável de ambiente ou num ficheiro fora da pasta pública, nunca numa aplicação de telemóvel nem no código do navegador. Na criação pode dar-lhe uma validade (30, 90 ou 365 dias, ou sem validade) e uma lista de IPs. Se ficar exposta: o que fazer, pela ordem certa.
| Quando pedir ajuda ao suporte, envie o X-Correlation-ID que vem em cada resposta, a hora e a operação. Nunca envie a chave: o suporte não precisa dela. |
| Comece por um só aviso, por exemplo o pagamento recebido, e ponha-o a funcionar de ponta a ponta na Sandbox. Os outros seguem o mesmo molde. O primeiro pedido está em enviar SMS pela API. |
|
Pronto para ligar o seu sistema? Veja a página da API e crie a primeira chave. Ver a página da API |
PRODUTO RECOMENDADO Hospedagem de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 321,75 MT/mês (plano de 3 anos, com cupão) Ver planos |
