Ligar um ERP, CRM ou sistema próprio aos avisos por SMS: o que o programador precisa

WhatsApp e APIs·· 33 visualizações· 3 min de leitura

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 My MozOut, 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

1 Idempotency-Key em cada envio, com um valor ligado ao acontecimento (factura, encomenda, marcação). Uma repetição nunca envia duas vezes.
2 Lote para listas. Para os avisos do dia, um pedido com /v1/sms/messages/batch em vez de centenas de pedidos.
3 Limites. A conta tem um limite de pedidos por minuto, somando as chaves, e um limite diário de envios. Leia os cabeçalhos X-RateLimit-Remaining e, num 429, espere o tempo de Retry-After.
4 Estados por webhook, em vez de perguntar de minuto a minuto: o webhook do SMS.
5 Números que não recebem. Um número na lista da conta é recusado com number_opted_out; o sistema deve marcar esse cliente e deixar de lhe enviar.

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

VEJA TAMBÉM

Enviar SMS pela API: chave, permissões, Sandbox e o primeiro pedido

Erros e estados das mensagens na API de SMS: o que significa cada um e o que fazer

Enviar muitos avisos por SMS num só pedido à API: o envio em lote e os resultados

O webhook do SMS: como o seu sistema fica a saber que cada aviso saiu ou falhou

Uma chave de API ou um token ficou exposto: o que fazer, pela ordem certa

O que é uma API, em palavras simples: pedidos, respostas e um exemplo REST

PRODUTO RECOMENDADO

Hospedagem de sites com cPanel

Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 396,00 MT/mês (plano de 3 anos, com cupão)

Ver planos
Esta resposta foi útil? A sua resposta ajuda-nos a melhorar este artigo.