API de SMS
Introdução
MozeSMS é uma plataforma de alta qualidade, permitindo a integração em qualquer um dos aplicativos seus com o nosso sistema de envio de mensages SMS.
A principal vantagem do nosso sistema é a simplicidade de implementação.
A mensagem pode ter remetente(SenderID) nome da tua empresa ou qualquer numero de telefone teu ou da sua empresa.
Passos para Começar com o MozeSMS:
Criar uma Conta ou Fazer Login:Acesse o site do MozeSMS em https://my.mozesms.com/create_account e crie uma conta gratuita ou faça login se já tiver uma conta existente.
Registrar o SenderID:
Após criar a conta e fazer login, registre um nome ou número de remetente (SenderID).
Isso permitirá que você personalize o remetente das mensagens SMS enviadas para seus destinatários.
API base URL
Os endereços de URL que voce precisa usar para se conectar ao servidor MozeSMS :Url endpoint para envio de sms
Enviar mensagem
Voce precisa apenas de 3 parametros para começar, todos campos são obrigatorios:Parametro | Descrição: |
---|---|
from | Sender_ID/remente pode ser nome da sua empresa ou numero de telefone a ser apresentado ao destinatario |
to | O numero ou o destinatario, o endereço onde a mensagem será enviada |
message | O conteudo da mensagem |
<?php
$curl = curl_init();
$param = array(
'from' => "Sender_ID", // ID do remetente (Sender ID)
'to' => "+258845888195", // Número de telefone do destinatário
'message' => "Ola MozeSMS API" // Mensagem que deseja enviar
);
curl_setopt_array($curl, array(
CURLOPT_URL => "http://api.mozesms.com/message/v2",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => $param,
CURLOPT_HTTPHEADER => array(
"Authorization: Bearer YOUR_API_KEY"
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>
curl -X POST "https://api.mozesms.com/message/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d "from=Sender_ID" \
-d "to=+258845888195" \
-d "message=Hello from MozeSMS API"
import requests
url = 'https://api.mozesms.com/message/v2'
headers = {'Authorization': 'Bearer 12:MAfdl1-xs728E-vP9tNc-NH3GW0'}
data = {
'from': 'Sender_ID', # ID do remetente (Sender ID)
'to': '+258845888195', # Número de telefone do destinatário
'message': 'Hello, from mozesms api' # Mensagem que deseja enviar
}
response = requests.post(url, data=data, headers=headers)
print(response.json())
var request = require('request');
var options = {
method: 'POST',
url: 'https://api.mozesms.com/message/v2',
headers: {
'Authorization': 'Bearer YOUR TOKEN' // Substitua 'YOUR TOKEN' pelo seu token de autorização
},
form: {
'from': 'Sender_ID', // ID do remetente (Sender ID)
'to': '+258845888195', // Número de telefone do destinatário
'message': 'Hello from MozeSMS API' // Mensagem que deseja enviar
}
};
request(options, function (error, response) {
if (error) {
throw new Error(error);
}
console.log(response.body);
});
import kong.unirest.HttpResponse; import kong.unirest.Unirest; public class MozeSmsSender { public static void main(String[] args) { String apiUrl = "https://api.mozesms.com/message/v2"; String apiKey = "Bearer YOUR_API_KEY"; // Substitua "YOUR_API_KEY" pelo seu token de autorização String from = "Sender_ID"; // ID do remetente (Sender ID) String to = "+258845888195"; // Número de telefone do destinatário String message = "Hello from MozeSMS API"; // Mensagem que deseja enviar HttpResponse
response = Unirest.post(apiUrl) .header("Authorization", apiKey) .field("from", from) .field("to", to) .field("message", message) .asString(); System.out.println("Resposta da API:"); System.out.println(response.getBody()); } }
.asString();
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
namespace MozeSmsSender
{
class Program
{
static async Task Main(string[] args)
{
string apiUrl = "https://api.mozesms.com/message/v2";
string bearerToken = "Bearer YOUR TOKEN"; // Substitua "YOUR TOKEN" pelo seu token de autorização
string from = "Sender_ID"; // ID do remetente (Sender ID)
string to = "+258845888195"; // Número de telefone do destinatário
string message = "Hello from MozeSMS API"; // Mensagem que deseja enviar
var httpClient = new HttpClient();
httpClient.DefaultRequestHeaders.Add("Authorization", bearerToken);
var content = new FormUrlEncodedContent(new[]
{
new KeyValuePair("from", from),
new KeyValuePair("to", to),
new KeyValuePair("message", message)
});
try
{
var response = await httpClient.PostAsync(apiUrl, content);
response.EnsureSuccessStatusCode();
string responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine("Resposta da API:");
Console.WriteLine(responseBody);
}
catch (HttpRequestException ex)
{
Console.WriteLine($"Ocorreu um erro na solicitação: {ex.Message}");
}
}
}
}
Bulk SMS
Bulk SMS com MozeSMS é a solução ideal para enviar mensagens em massa de forma eficiente e confiável. Com o serviço da MozeSMS, você pode alcançar uma ampla base de clientes, colaboradores ou membros de maneira rápida e eficaz.
Ao utilizar o Bulk SMS da MozeSMS, você pode preparar mensagens personalizadas, adicionar os números de telefone dos destinatários e, em questão de segundos, enviar todas as mensagens. Isso permite uma comunicação direta e imediata com seu público, seja para campanhas de marketing, comunicações internas ou alertas importantes.
Com a tecnologia robusta da MozeSMS, você garante a entrega das mensagens em tempo real, proporcionando uma experiência de comunicação ágil e segura. Experimente agora mesmo o poder do Bulk SMS com a MozeSMS e leve suas comunicações para o próximo nível.
<?php
// Defina os números de telefone e as mensagens que deseja enviar
$tell1 = "NUMERO1"; // Substitua "NUMERO1" pelo número de telefone 1
$tell12 = "NUMERO2"; // Substitua "NUMERO2" pelo número de telefone 2
$tell13 = "NUMERO3"; // Substitua "NUMERO3" pelo número de telefone 3
$messages = array(
'sender' => "ESHOP",
'messages' => array(
array(
'number' => $tell1,
'text' => 'Esta é a sua mensagem'
),
array(
'number' => $tell12,
'text' => 'Esta é outra mensagem'
),
array(
'number' => $tell13,
'text' => 'Esta é outra mensagem'
),
)
);
// Codifica o array em formato JSON
$messages_json = json_encode($messages);
$curl = curl_init();
$param = array('post_data' => $messages_json);
curl_setopt_array($curl, array(
CURLOPT_URL => "http://api.mozesms.com/bulk_json/v2/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => $param,
CURLOPT_HTTPHEADER => array(
"Authorization: Bearer Seu token"
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>
curl -X POST "http://api.mozesms.com/bulk_json/v2/" \
-H "Authorization: Bearer Seu token" \
-H "Content-Type: application/json" \
-d '[
{
"number": "NUMERO1",
"text": "Esta é a sua mensagem"
},
{
"number": "NUMERO2",
"text": "Esta é outra mensagem"
},
{
"number": "NUMERO3",
"text": "Esta é outra mensagem"
}
]'
import requests
# Defina os números de telefone e as mensagens que deseja enviar
tell1 = 'NUMERO1' # Substitua "NUMERO1" pelo número de telefone 1
tell2 = 'NUMERO2' # Substitua "NUMERO2" pelo número de telefone 2
tell3 = 'NUMERO3' # Substitua "NUMERO3" pelo número de telefone 3
messages = [
{
'number': tell1,
'text': 'Esta é a sua mensagem'
},
{
'number': tell2,
'text': 'Esta é outra mensagem'
},
{
'number': tell3,
'text': 'Esta é outra mensagem'
}
]
api_url = 'http://api.mozesms.com/bulk_json/v2/'
bearer_token = 'Bearer Seu token' # Substitua pelo seu token de autorização
# Envia a solicitação HTTP POST usando o módulo requests
response = requests.post(api_url, json={'messages': messages}, headers={'Authorization': bearer_token})
# Verifica se a solicitação foi bem-sucedida
if response.status_code == 200:
print('Resposta da API:', response.json())
else:
print('Ocorreu um erro ao enviar as mensagens:', response.text)
const axios = require('axios');
// Defina os números de telefone e as mensagens que deseja enviar
const tell1 = 'NUMERO1'; // Substitua "NUMERO1" pelo número de telefone 1
const tell2 = 'NUMERO2'; // Substitua "NUMERO2" pelo número de telefone 2
const tell3 = 'NUMERO3'; // Substitua "NUMERO3" pelo número de telefone 3
const messages = [
{
number: tell1,
text: 'Esta é a sua mensagem'
},
{
number: tell2,
text: 'Esta é outra mensagem'
},
{
number: tell3,
text: 'Esta é outra mensagem'
}
];
const apiUrl = 'http://api.mozesms.com/bulk_json/v2/';
const bearerToken = 'Bearer Seu token'; // Substitua pelo seu token de autorização
// Envia a solicitação HTTP POST usando axios
axios.post(apiUrl, { messages }, { headers: { Authorization: bearerToken } })
.then(response => {
console.log('Resposta da API:', response.data);
})
.catch(error => {
console.error('Ocorreu um erro ao enviar as mensagens:', error.message);
});
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
public class BulkSmsSender {
public static void main(String[] args) {
// Defina os números de telefone e as mensagens que deseja enviar
String tell1 = "NUMERO1"; // Substitua "NUMERO1" pelo número de telefone 1
String tell2 = "NUMERO2"; // Substitua "NUMERO2" pelo número de telefone 2
String tell3 = "NUMERO3"; // Substitua "NUMERO3" pelo número de telefone 3
String messages = "[\n" +
" {\n" +
" \"number\": \"" + tell1 + "\",\n" +
" \"text\": \"This is your message\"\n" +
" },\n" +
" {\n" +
" \"number\": \"" + tell2 + "\",\n" +
" \"text\": \"This is another message\"\n" +
" },\n" +
" {\n" +
" \"number\": \"" + tell3 + "\",\n" +
" \"text\": \"This is another message\"\n" +
" }\n" +
"]";
String apiUrl = "http://api.mozesms.com/bulk_json/v2/";
String bearerToken = "Bearer Seu token"; // Substitua pelo seu token de autorização
try {
URL url = new URL(apiUrl);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setRequestProperty("Authorization", bearerToken);
conn.setRequestProperty("Content-Type", "application/json");
conn.setDoOutput(true);
// Envia os dados JSON no corpo da solicitação
OutputStream os = conn.getOutputStream();
os.write(messages.getBytes());
os.flush();
os.close();
// Lê a resposta da API
int statusCode = conn.getResponseCode();
if (statusCode == 200) {
BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
String line;
StringBuffer response = new StringBuffer();
while ((line = reader.readLine()) != null) {
response.append(line);
}
reader.close();
// Exibe a resposta da API
System.out.println("Resposta da API:");
System.out.println(response.toString());
} else {
System.out.println("Ocorreu um erro ao enviar as mensagens. Código de resposta: " + statusCode);
}
conn.disconnect();
} catch (IOException e) {
e.printStackTrace();
}
}
}
using System;
using System.IO;
using System.Net;
using System.Text;
namespace BulkSmsSender
{
class Program
{
static void Main(string[] args)
{
// Defina os números de telefone e as mensagens que deseja enviar
string tell1 = "NUMERO1"; // Substitua "NUMERO1" pelo número de telefone 1
string tell2 = "NUMERO2"; // Substitua "NUMERO2" pelo número de telefone 2
string tell3 = "NUMERO3"; // Substitua "NUMERO3" pelo número de telefone 3
string messages = "[\n" +
" {\n" +
" \"number\": \"" + tell1 + "\",\n" +
" \"text\": \"This is your message\"\n" +
" },\n" +
" {\n" +
" \"number\": \"" + tell2 + "\",\n" +
" \"text\": \"This is another message\"\n" +
" },\n" +
" {\n" +
" \"number\": \"" + tell3 + "\",\n" +
" \"text\": \"This is another message\"\n" +
" }\n" +
"]";
string apiUrl = "http://api.mozesms.com/bulk_json/v2/";
string bearerToken = "Bearer Seu token"; // Substitua pelo seu token de autorização
try
{
var request = (HttpWebRequest)WebRequest.Create(apiUrl);
request.Method = "POST";
request.ContentType = "application/json";
request.Headers.Add("Authorization", bearerToken);
// Envia os dados JSON no corpo da solicitação
byte[] data = Encoding.UTF8.GetBytes(messages);
using (var stream = request.GetRequestStream())
{
stream.Write(data, 0, data.Length);
}
using (var response = (HttpWebResponse)request.GetResponse())
{
int statusCode = (int)response.StatusCode;
if (statusCode == 200)
{
using (var reader = new StreamReader(response.GetResponseStream()))
{
string result = reader.ReadToEnd();
// Exibe a resposta da API
Console.WriteLine("Resposta da API:");
Console.WriteLine(result);
}
}
else
{
Console.WriteLine($"Ocorreu um erro ao enviar as mensagens. Código de resposta: {statusCode}");
}
}
}
catch (WebException ex)
{
Console.WriteLine($"Ocorreu um erro na solicitação HTTP: {ex.Message}");
}
}
}
}
Verificar ou OTP(One-Time-Password)
Confirme a identidade para proteger contas, autenticar transações e evitar fraudes com autenticação de dois fatores (2FA) e senhas únicas (OTP).
Crie um novo objeto Verify através da API para iniciar o processo de verificação de um destinatário. MozeSMS cuidará para que a mensagem seja entregue ao número fornecido.
Enviar Mensagens de Autenticação
Solicite uma verificação. Cria um novo objeto Verificar e envia um token de verificação para um destinatário.
Voce precisa apenas de 3 parametros para começar, todos campos são obrigatorios:
Parametro | Descrição: |
---|---|
AppID | Id do aplicativo que cadastrou no portal MozeSMS, e o appname servira para identificar sua app/sms. ex: Seu codico MozeSMS é: 918727. Obrigado |
to | O numero ou o destinatario, o endereço onde a mensagem será enviada |
code | O codigo que gerou em seu sistema para validar o numero, random() |
Codico para OTP
<?php
$curl = curl_init();
$param = array( 'AppID' =>"AppID" , 'to'=>"+258845888195", 'code'=>"Your generated code" );
curl_setopt_array($curl, array(
CURLOPT_URL => "http://api.mozesms.com/otp/v2",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => $param,
CURLOPT_HTTPHEADER => array(
"Authorization: Bearer YOUR_API_KEY"
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
import requests
response = requests.post(
'https://api.mozesms.com/otp/v2',
data={'AppID': 'AppID','to':'+258845888195', 'code':' xxxx'},
headers={'Authorization': 'Bearer YOUR_API_KEY'},
)
print(response.json())
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.mozesms.com/otp/v2',
'headers': {
'Authorization': ' Bearer YOUR TOKEN'
},
form: {
'AppID': 'AppID',
'to': '+258845888195',
'code': 'xxxx'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
HttpResponse response = Unirest.post("https://api.mozesms.com/message/v2")
.header("Authorization", "Bearer YOUR_API_KEY")
.field("AppID", "AppID")
.field("to", "+258845888195")
.field("code", "xxxxx")
.asString();
Codigos de resposta
status | code | description |
SUCCESS | 200 | A mensagem foi enviada com sucesso |
ERROR | 206 | Invalid SenderID |
ERROR | 305 | Saldo insufiente para enviar um determinado sms |
ERROR | 400 | Invalid balance amount |
ERROR | 401 | Invalid user_account |
ERROR | 402 | Missing important filds, parametros em falta : {from,to e message/code} |
ERROR | 403 | Unauthorized, Your request was made with invalid credentials. |
ERROR | 404 | Not found, ocorre quando o caminho não foi definido na url /message/v2 ou /otp/v2 |
ERROR | 501 | Server unable to send message |
----------- | -------- | ----------- |