MozeSMS API v2.0

Obter API Key

Introdução

API REST para envio de SMS com autenticação Bearer Token, suporte a Bulk SMS e sistema OTP integrado.

https://api.mozesms.com

Bearer Token

Autenticação segura

Bulk SMS

Até 1000 mensagens

Sistema OTP

Geração automática

SenderID

Nome personalizado

Como Começar

1. Crie uma conta em my.mozesms.com

2. Registre um SenderID no painel

3. Gere sua API Key em Configurações

Autenticação

Todas as requisições requerem Bearer Token no header:

Header Valor
Authorization Bearer {seu_token}
Content-Type application/json

Enviar SMS

POST /v2/sms/send

Parâmetros

Campo Tipo Descrição
phone string Número com código (258...)
message string Texto da mensagem
sender_id string Nome ou número remetente

Exemplo

  • PHP
  • cURL
  • Python
  • Node.js
  • C#
  • Ruby
  • Java
$ch = curl_init('https://api.mozesms.com/v2/sms/send');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer SEU_TOKEN',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'phone' => '258845888195',
        'message' => 'Olá, teste de SMS',
        'sender_id' => 'MozeSMS'
    ]),
    CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($ch);
curl_close($ch);
curl -X POST https://api.mozesms.com/v2/sms/send \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "258845888195",
    "message": "Olá, teste de SMS",
    "sender_id": "MozeSMS"
  }'
import requests

response = requests.post(
    'https://api.mozesms.com/v2/sms/send',
    headers={
        'Authorization': 'Bearer SEU_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'phone': '258845888195',
        'message': 'Olá, teste de SMS',
        'sender_id': 'MozeSMS'
    }
)
print(response.json())
const response = await fetch('https://api.mozesms.com/v2/sms/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer SEU_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phone: '258845888195',
    message: 'Olá, teste de SMS',
    sender_id: 'MozeSMS'
  })
});
const data = await response.json();
using System.Net.Http;
using System.Text;
using System.Text.Json;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer SEU_TOKEN");

var data = new {
    phone = "258845888195",
    message = "Olá, teste de SMS",
    sender_id = "MozeSMS"
};

var json = JsonSerializer.Serialize(data);
var content = new StringContent(json, Encoding.UTF8, "application/json");

var response = await client.PostAsync(
    "https://api.mozesms.com/v2/sms/send", 
    content
);
var result = await response.Content.ReadAsStringAsync();
require 'net/http'
require 'json'

uri = URI('https://api.mozesms.com/v2/sms/send')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer SEU_TOKEN'
request['Content-Type'] = 'application/json'

request.body = {
  phone: '258845888195',
  message: 'Olá, teste de SMS',
  sender_id: 'MozeSMS'
}.to_json

response = http.request(request)
puts response.body
import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

String json = """{
    "phone": "258845888195",
    "message": "Olá, teste de SMS",
    "sender_id": "MozeSMS"
}""";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.mozesms.com/v2/sms/send"))
    .header("Authorization", "Bearer SEU_TOKEN")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(json))
    .build();

HttpResponse response = client.send(
    request, 
    HttpResponse.BodyHandlers.ofString()
);
System.out.println(response.body());

Resposta

{
  "status": 200,
  "message": "SMS enviado com sucesso",
  "sms_id": "12345678"
}

Bulk SMS

POST /v2/sms/bulk

Envie até 1000 mensagens em uma única requisição.

Campo Tipo Descrição
messages array Lista de objetos com phone e message
sender_id string Remetente para todas mensagens

Exemplo

{
  "messages": [
    {"phone": "258845888195", "message": "Olá João"},
    {"phone": "258845888196", "message": "Olá Maria"}
  ],
  "sender_id": "MozeSMS"
}

Sistema OTP

Enviar OTP

POST /v2/otp/send
Campo Tipo Descrição
phone string Número com código
length integer Tamanho do código (4-8)

Verificar OTP

POST /v2/otp/verify
Campo Tipo Descrição
phone string Número que recebeu OTP
code string Código recebido
Códigos OTP expiram em 5 minutos

Códigos de Resposta

Código Status Descrição
200 Sucesso Operação realizada com sucesso
400 Erro Dados inválidos
401 Não autorizado Token inválido ou ausente
402 Sem saldo Créditos insuficientes
429 Limite Muitas requisições
500 Erro servidor Erro interno do sistema

Suporte

Email

suporte@mozesms.com

Telefone

+258 84 588 8195

Portal

my.mozesms.com

WhatsApp

+258 84 588 8195