Comece com uma chave de Sandbox, que valida os pedidos sem enviar nada nem gastar créditos. Quando estiver pronto, troque pela chave de Produção.
Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
sandbox_ no API Center do My MozOut, com a permissão sms:write.POST /v1/sms/messages com o número e o texto.prod_. O pedido não muda.curl https://api.mozout.com/v1/sms/messages \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-4521-ready" \
-d '{"number": "+258841234567",
"text": "Your order 4521 is ready for pickup."}'<?php
$ch = curl_init('https://api.mozout.com/v1/sms/messages');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
'Idempotency-Key: order-4521-ready',
],
CURLOPT_POSTFIELDS => json_encode([
'number' => '+258841234567',
'text' => 'Your order 4521 is ready for pickup.',
]),
]);
$sms = json_decode(curl_exec($ch), true);
echo $sms['data']['status']; // sent, queued or failedimport requests
r = requests.post(
"https://api.mozout.com/v1/sms/messages",
headers={"Authorization": "Bearer YOUR_API_KEY",
"Idempotency-Key": "order-4521-ready"},
json={"number": "+258841234567",
"text": "Your order 4521 is ready for pickup."},
timeout=30,
)
print(r.json()["data"]["status"]) # sent, queued or failedconst r = await fetch("https://api.mozout.com/v1/sms/messages", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
"Idempotency-Key": "order-4521-ready",
},
body: JSON.stringify({
number: "+258841234567",
text: "Your order 4521 is ready for pickup.",
}),
});
console.log((await r.json()).data.status); // sent, queued or failed
Um pedido HTTPS basta. A API valida, desconta os créditos e entrega a mensagem às operadoras; o seu sistema acompanha o estado.
Uma encomenda, uma fatura ou uma marcação dispara o pedido.
Valida a chave, o número e o saldo, e responde em JSON.
A mensagem segue com o seu Sender ID ou com o NETMSG.
Recebe o SMS em Moçambique e Angola, em qualquer telemóvel.
Os estados de uma mensagem:
scheduledqueuedsendingsentfailedcancelledsimulated
Todas começam em https://api.mozout.com, com a chave no cabeçalho Authorization: Bearer. A lista completa, com os campos e as respostas, está na documentação.
Quando alguma coisa acontece no seu sistema, o cliente recebe logo um SMS. Ninguém tem de se lembrar de avisar.
Avise quando uma fatura é emitida, quando vence ou quando a encomenda sai do armazém.
Confirme o pagamento e o pedido logo que o cliente paga, no balcão ou no seu site.
Diga ao cliente que o serviço terminou ou lembre a próxima revisão, sem telefonar.
As duas chaves usam o mesmo endereço e as mesmas operações. A diferença está no que acontece ao enviar.
sandbox_prod_simulated: true.sandboxproduction
Cada chave tem as suas permissões e pode ser revogada a qualquer momento. Os pedidos seguem sempre por HTTPS.
sms:read para consultar e sms:write para enviar e alterar.
Opcional: a chave só funciona a partir dos endereços que indicar.
30, 90 ou 365 dias, ou sem validade. Revogue quando quiser.
Com Idempotency-Key, o mesmo pedido repetido nunca envia duas vezes.
90 pedidos por minuto por chave e 300 por conta, nos cabeçalhos X-RateLimit.
As respostas mostram o número como 25884****567, para não ficar nos registos.
Os SMS enviados pela API usam o mesmo saldo de créditos do SMS Center. O preço do escalão vale para toda a quantidade que comprar.
Mínimo de 1.000 créditos. 1 SMS até 160 caracteres = 1 crédito. Sender ID: 3.000,00 MT por nome e por país.
Artigos para escolher, configurar e tirar o máximo deste serviço
A resposta curta: uma API é a forma combinada de um programa pedir coisas a outro. Em vez de uma pessoa abrir uma página e clicar, o seu site…
Ler o artigo
A resposta curta: se uma chave de API, um token ou o segredo de um webhook apareceu onde não devia (um repositório público, um ficheiro dentro do site, uma…
Ler o artigo
Para falar com uma API a partir do PHP usa-se o cURL: abre-se um pedido, envia-se, lê-se o código de estado (200, 401, 404…) e só depois se descodifica…
Ler o artigo
As perguntas mais frequentes sobre o envio de SMS pela API
Uma conta com o SMS activo, créditos de SMS e uma chave API com a permissão sms:write. A chave cria-se no API Center do My MozOut. Para testar, basta uma chave de Sandbox, sem créditos.
A resposta do envio já traz o estado: sent, queued ou failed. Depois, consulte GET /v1/sms/messages/{id} ou o histórico. Os estados possíveis são agendada, na fila, a enviar, enviada, simulada, falhada e cancelada.
Sim. Indique no campo sender um Sender ID aprovado. Pode pedi-lo pela API ou no My MozOut: custa 3.000,00 MT por nome e por país, e a análise leva até 48 horas úteis. Sem sender, sai o NETMSG, grátis.
Não. Os remetentes com nome, incluindo o NETMSG, não recebem respostas. Se precisar que o cliente fale consigo, escreva na mensagem um telefone, um e-mail ou o endereço do seu site.
Em qualquer linguagem que faça pedidos HTTPS: PHP, Python, JavaScript, Java, C# e outras. A documentação tem exemplos em cURL, PHP, Python e JavaScript, e um Playground para experimentar.
É um código à sua escolha que envia no cabeçalho do pedido. Se a ligação cair e o seu sistema repetir o mesmo pedido com o mesmo código, a API devolve a primeira resposta e o SMS não sai duas vezes.
Até 90 pedidos por minuto por chave e 300 por conta, somando todas as chaves. Os cabeçalhos X-RateLimit-Limit e X-RateLimit-Remaining dizem quantos restam. Se passar o limite, a API responde 429 com o tempo de espera.
São descontados do mesmo saldo de créditos do SMS Center. Cada parte de SMS gasta um crédito: até 160 caracteres é uma parte, ou até 70 com letras como ã ou ç. Num envio agendado, os créditos só saem quando a mensagem sair.
