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
  • https://api.mozesms.com/message/v2
  • Url endpoint para envio de sms de Autenticação
  • https://api.mozesms.com/otp/v2
  • 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;
    ?>
     
    


    file: sendsms.php
    
    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())
     
    	


    file: sendsms.py
    
    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);
    });
    


    file: sendsms.js
    
    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();


    file: sendsms.java
    
    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;
    ?>
    
    


    file: sendsms.php
    
    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)
    
    


    file: sendsms.py
    
    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);
      });
    
    


    file: sendsms.js
    
    	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();
            }
        }
    }
    
    
    


    file: sendsms.java
    
    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;


    file: sendsms.php
    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())


    file: sendsms.py
    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);
    });


    file: sendsms.js
    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();


    file: sendsms.java

    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
    ----------- -------- -----------