Como enviar múltiplos SMS a partir do Python

A maneira mais simples de enviar SMS a partir do Python é usar a API HTTP/Rest de SMS integrada do Ozeki SMS Gateway. Quando você usa esta API, enviará mensagens SMS realizando uma requisição HTTP Post para o gateway de SMS. A requisição HTTP Post conterá uma mensagem formatada em formato json. O gateway de SMS enviará este SMS para o telefone do destinatário e retornará uma resposta HTTP 200 OK para a sua requisição.

como enviar múltiplos sms a partir do python
Figura 1 - Como enviar múltiplos SMS a partir do Python

Código Python para enviar SMS para celular

O exemplo de código Python para SMS abaixo demonstra como você pode enviar SMS usando a API HTTP Rest de SMS do Ozeki SMS Gateway com a biblioteca Python ozekilibsrest. Esta biblioteca é fornecida gratuitamente, e você pode usá-la e modificá-la em qualquer um dos seus projetos.

SendMultipleSms.py

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
from ozekilibsrest import Configuration, Message, MessageApi
         
configuration = Configuration(
    username="http_user",
    password="qwe123",
    api_url="http://127.0.0.1:9509/api"
)
         
msg1 = Message(
    to_address="+3620111111",
    text="Olá mundo 1!"
)
         
msg2 = Message(
    to_address="+36202222222",
    text="Olá mundo 2!"
)
         
msg3 = Message(
    to_address="+36203333333",
    text="Olá mundo 3!"
)
         
api = MessageApi(configuration)
         
result = api.send([msg1, msg2, msg3])
         
print(result)
     

Como usar o exemplo de SMS em Python:

Este exemplo de SMS em Python pode ser usado em qualquer aplicação Python. Para usá-lo, você deve instalar o pacote ozekilibsrest com o comando pip install ozekilibsrest. Após a instalação do pacote, você deve incluir a diretiva from ozekilibsrest import Configuration, Message, MessageApi na seção de cabeçalho do seu código-fonte Python. Isso permitirá que você use as classes fornecidas pela biblioteca ozekilibsrest. Você pode usar a classe Message para criar o SMS. Você pode usar a classe MessageApi para enviar o SMS para o gateway de SMS. O gateway de SMS encaminhará sua mensagem para a rede móvel através de uma conexão sem fio ou pela Internet.

Baixar SendMultipleSms.py

O código-fonte explicado neste artigo pode ser baixado, usado e modificado gratuitamente.
Download: SendMultipleSms.py.zip (423B)

O que há na pasta SendMultipleSms.py?

A pasta SendMultipleSms.py contém o script do exemplo de SMS em Python que mostrará como enviar múltiplas mensagens SMS usando Python.

diretório de envio de múltiplos sms em python
Figura 2 - O que há dentro de SendMultipleSms.py.zip

Como instalar a biblioteca ozekilibsrest

Para instalar a biblioteca ozekilibsrest, você deve abrir o prompt de comando e usar o seguinte comando. Isso instalará a biblioteca ozekilibsrest e as dependências necessárias.

1
2
pip install ozekilibsrest
     

Código 2 - Comando para instalar a biblioteca ozekilibsrest

Como enviar múltiplos SMS a partir do Python (Passos rápidos)

Para enviar múltiplos SMS a partir do Python:

  1. Baixe e instale o Python
  2. Instale a biblioteca ozekilibsrest usando pip ou conda
  3. Baixe o arquivo SendMultipleSms.py.zip
  4. Extraia o arquivo .zip da pasta de Downloads
  5. Abra o arquivo SendMultipleSms.py em qualquer editor de texto
  6. Inicie o Ozeki SMS Gateway
  7. Crie um usuário de API HTTP no Ozeki
  8. Execute o código SendMultipleSms.py usando o prompt de comando para enviar as mensagens SMS de teste
  9. Verifique a caixa de Enviados no Ozeki SMS Gateway

Instale o Ozeki SMS Gateway e crie um usuário de API HTTP

Para poder enviar SMS a partir do Python, primeiro você precisa instalar o Ozeki SMS Gateway. O gateway de SMS pode ser instalado no mesmo computador onde você desenvolve seu código Python. Após a instalação, o próximo passo é conectar o Ozeki SMS Gateway à rede móvel. Você pode enviar um SMS de teste a partir da interface gráfica do Ozeki para verificar se sua conexão com a rede móvel está funcionando. O passo final para preparar seu ambiente é criar um usuário de API HTTP para SMS. Crie um usuário com o nome de usuário "http_user" e senha "qwe123" para fazer o exemplo funcionar sem modificações.

Após a configuração do ambiente, você pode executar seu código Python.

URL da API HTTP para enviar SMS a partir do Python

Para enviar SMS a partir do Python, seu código Python terá que fazer uma requisição HTTP para o gateway de SMS. A URL da API é mostrada abaixo. Observe que o endereço IP (127.0.0.1) deve ser substituído pelo endereço IP do seu gateway de SMS. Se o Ozeki SMS Gateway estiver instalado no mesmo computador onde a aplicação Python está sendo executada, pode ser 127.0.0.1. Se estiver instalado em um computador diferente, deve ser o endereço IP desse computador.

1
2
http://127.0.0.1:9509/api?action=rest
     

Autenticação HTTP para enviar SMS a partir de Python

Para autenticar o cliente de SMS em Python, você precisa enviar o nome de usuário e senha em uma string codificada em base64 para o servidor em uma requisição HTTP. O formato utilizado é: base64(nome de usuário+":"+senha). Em Python, você pode usar o seguinte código para fazer essa codificação:

1
2
3
4
def create_authorization_header(username, password):
    username_password = f'{ username }:{ password }'
    return f'Basic { b64encode(username_password.encode()).decode() }'
     

Por exemplo, se você codificar o nome de usuário 'http_user' e a senha 'qwe123', você obterá a seguinte string codificada em base64: aHR0cF91c2VyOnF3ZTEyMw==.

Cabeçalho da requisição HTTP para enviar SMS a partir de Python

Para enviar as mensagens SMS, você precisa incluir as seguintes linhas como cabeçalhos na requisição HTTP. Observe que incluímos um tipo de conteúdo e um cabeçalho de Autorização.

1
2
3
Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
     

Requisição HTTP para enviar SMS a partir de Python

Para enviar as mensagens SMS, sua aplicação Python enviará uma requisição HTTP semelhante à abaixo. Observe que esta requisição contém uma parte de cabeçalho HTTP e uma parte de corpo HTTP. O corpo HTTP é uma string de dados codificada em JSON. Ela contém os números dos destinatários e os textos das mensagens.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
POST /api?action=sendmsg HTTP/1.1
Host: 127.0.0.1:9509
User-Agent: python-requests/2.26.0
Accept-Encoding: gzip, deflate
Accept: */*
Connection: keep-alive
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Content-Type: application/json
Content-Length: 1027
         
{
    "messages": [
        {
            "message_id": "cf609600-7269-46e3-ab6e-87ef5a99f848",
            "to_address": "+3620111111",
            "text": "Hello world 1!",
            "create_date": "2021-09-10T15:19:20",
            "valid_until": "2021-09-17T15:19:20",
            "time_to_send": "2021-09-10T15:19:20",
            "submit_report_requested": true,
            "delivery_report_requested": true,
            "view_report_requested": true,
            "tags": []
        },
        {
            "message_id": "8d93e43a-b4dc-493f-a243-10db358a58ec",
            "to_address": "+36202222222",
            "text": "Hello world 2!",
            "create_date": "2021-09-10T15:19:20",
            "valid_until": "2021-09-17T15:19:20",
            "time_to_send": "2021-09-10T15:19:20",
            "submit_report_requested": true,
            "delivery_report_requested": true,
            "view_report_requested": true,
            "tags": []
        },
        {
            "message_id": "35e56437-15e4-4ee7-9ad4-dfc00a8f7c3a",
            "to_address": "+36203333333",
            "text": "Hello world 3!",
            "create_date": "2021-09-10T15:19:20",
            "valid_until": "2021-09-17T15:19:20",
            "time_to_send": "2021-09-10T15:19:20",
            "submit_report_requested": true,
            "delivery_report_requested": true,
            "view_report_requested": true,
            "tags": []
        }
    ]
}
     

Resposta HTTP recebida pelo exemplo de SMS em Python

Assim que o gateway de SMS receber esta requisição, ele gerará uma resposta HTTP. A resposta HTTP conterá um código de status, para indicar se a requisição de envio de SMS foi bem-sucedida ou não. Também retornará uma estrutura codificada em JSON para fornecer detalhes úteis sobre o envio da mensagem.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: application/json; charset=utf8
Last-Modified: Fri, 10 Sep 2021 10:22:37 GMT
Server: 10/10.3.124 Microsoft-HTTPAPI/2.0
User-Agent: OZEKI 10.3.124 (www.myozeki.com)
Access-Control-Allow-Origin: *
Date: Fri, 10 Sep 2021 13:19:19 GMT
         
{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "Messages queued for delivery.",
  "data": {
    "total_count": 3,
    "success_count": 3,
    "failed_count": 0,
    "messages": [
      {
        "message_id": "cf609600-7269-46e3-ab6e-87ef5a99f848",
        "from_station": "%",
        "to_address": "+3620111111",
        "to_station": "%",
        "text": "Hello world 1!",
        "create_date": "2021-09-10 15:19:20",
        "valid_until": "2021-09-17 15:19:20",
        "time_to_send": "2021-09-10 15:19:20",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      },
      {
        "message_id": "8d93e43a-b4dc-493f-a243-10db358a58ec",
        "from_station": "%",
        "to_address": "+36202222222",
        "to_station": "%",
        "text": "Hello world 2!",
        "create_date": "2021-09-10 15:19:20",
        "valid_until": "2021-09-17 15:19:20",
        "time_to_send": "2021-09-10 15:19:20",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      },
      {
        "message_id": "35e56437-15e4-4ee7-9ad4-dfc00a8f7c3a",
        "from_station": "%",
        "to_address": "+36203333333",
        "to_station": "%",
        "text": "Hello world 3!",
        "create_date": "2021-09-10 15:19:20",
        "valid_until": "2021-09-17 15:19:20",
        "time_to_send": "2021-09-10 15:19:20",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      }
    ]
  }
}
     

Exemplo de SMS em Python: SendMultipleSms.py

Como baixar o projeto SendMultipleSMS.py (Tutorial em vídeo)

No vídeo a seguir, você aprenderá como usar o projeto Python SendMultipleSms.py. O vídeo começará com a página de download e o guiará até o painel do editor de código aberto. Você aprenderá como baixar e abrir o arquivo de código. O vídeo tem apenas 54 segundos, mas contém todas as informações necessárias para usar o arquivo de código de exemplo com sucesso.

Vídeo 1 - Como baixar e abrir a solução acima (Tutorial em vídeo)

O código de exemplo abaixo faz parte da pasta SendMultipleSms.py.zip.

como enviar múltiplos sms usando python
Figura 3 - SendMultipleSms.py

Como usar o projeto (Tutorial em vídeo)

No próximo clipe, você verá como pode executar o código Python SendMultipleSms.py. O vídeo começará com o código aberto e o guiará até a aba de eventos com o registro da mensagem enviada. Você verá como executar o código e o que acontece se o código for executado. O vídeo tem menos de 1 minuto, mas contém todas as informações necessárias para executar o projeto.

Vídeo 2 - Como usar o script SendMultipleSms.py (Tutorial em vídeo)

Conclusão

Este artigo mostrou os passos para enviar múltiplos SMS em uma única requisição usando Python.

Com esse conhecimento e as ferramentas fornecidas, você deve ser capaz de alcançar vários clientes com um único código. O Ozeki SMS Gateway tem uma parte importante nesse processo, pois esse programa organiza a entrega das mensagens. O Ozeki SMS Gateway funciona com alta qualidade e desempenho, permitindo que você envie até 1000 SMS por segundo.

Continue seu aprendizado nas páginas de tutorial da Ozeki, onde você pode ler sobre tópicos como exclusão em Python.

Agora, a única coisa que você precisa fazer é baixar o Ozeki SMS Gateway e começar a trabalhar!

More information