Cum să programezi un SMS în Python

Cea mai simplă metodă de a trimite SMS-uri programate din Python este utilizarea API-ului HTTP/Rest SMS încorporat al Ozeki SMS Gateway. Când folosești acest API, vei trimite mesaje SMS prin emiterea unei cereri HTTP Post către gateway-ul SMS. Cererea HTTP Post va conține un mesaj formatat în format json. Gateway-ul SMS va trimite acest SMS către telefonul destinatar și va returna un răspuns HTTP 200 OK la cererea ta.

cum să programezi un sms în python
Figura 1 - Cum să programezi un SMS în Python

Cod Python pentru a trimite SMS programat pe mobil

Exemplul de cod Python pentru SMS de mai jos demonstrează cum poți trimite SMS programat folosind API-ul http rest sms al Ozeki SMS Gateway cu ajutorul bibliotecii Python ozekilibsrest. Această bibliotecă este oferită gratuit și poți să o folosești și să o modifici în oricare dintre proiectele tale.

SendScheduledSms.py 

		from ozekilibsrest import Configuration, Message, MessageApi
		from datetime import datetime
		
		configuration = Configuration(
		    username="http_user",
		    password="qwe123",
		    api_url="http://127.0.0.1:9509/api"
		)
		
		msg = Message(
		    to_address="+3620111111",
		    text="Hello world!",
		    time_to_send=datetime.strptime("2021-09-10 14:25:00", "%Y-%m-%d %H:%M:%S")
		)
		
		api = MessageApi(configuration)
		
		result = api.send(msg)
		
		print(result)

Cum să folosești exemplul Python pentru SMS:

Acest exemplu Python pentru SMS poate fi folosit în orice aplicație Python. Pentru a-l utiliza, trebuie să instalezi pachetul ozekilibsrest cu comanda pip install ozekilibsrest. După instalarea pachetului, trebuie să adaugi directiva from ozekilibsrest import Configuration, Message, MessageApi în secțiunea de antet a codului sursă Python. Aceasta îți va permite să folosești clasele oferite de biblioteca ozekilibsrest. Poți folosi clasa Message pentru a crea SMS-ul. Poți folosi clasa MessageApi pentru a trimite SMS-ul către gateway-ul SMS. Gateway-ul SMS va transmite mesajul tău către rețeaua mobilă fie printr-o conexiune wireless, fie prin Internet.

Descarcă SendScheduledSms.py

Codul sursă explicat în acest articol poate fi descărcat, folosit și modificat gratuit.
Descarcă: SendScheduledSms.py.zip (458B)

Ce conține folderul SendScheduledSms.py?

Folderul SendScheduledSms.py conține scriptul exemplului Python pentru SMS care îți va arăta cum să trimiți SMS-uri programate folosind Python.

director send scheduled sms py
Figura 2 - Ce se află în SendScheduledSms.py.zip

Cum să instalezi biblioteca ozekilibsrest

Pentru a instala biblioteca ozekilibsrest, trebuie să deschizi promptul de comandă și să folosești următoarea comandă. Aceasta va instala biblioteca ozekilibsrest și dependențele necesare. 

		pip install ozekilibsrest

Codul 2 - Comanda pentru a instala biblioteca ozekilibsrest

Cum să trimiți SMS programat din Python (Pași rapizi)

Pentru a trimite SMS programat din Python:

  1. Descarcă și instalează Python
  2. Instalează biblioteca ozekilibsrest folosind pip sau codna
  3. Descarcă fișierul SendScheduledSms.py.zip
  4. Extrage fișierul .zip din folderul Downloads
  5. Deschide fișierul SendScheduledSms.py în orice editor de text
  6. Lansează Ozeki SMS Gateway
  7. Creează un utilizator HTTP API în Ozeki
  8. Rulează codul SendScheduledSms.py folosind promptul de comandă pentru a trimite mesajele SMS de test
  9. Verifică căsuța Sent în Ozeki SMS Gateway

Instalează Ozeki SMS Gateway și creează un utilizator HTTP API

Pentru a putea trimite SMS din Python, mai întâi trebuie să instalezi Ozeki SMS Gateway. Gateway-ul SMS poate fi instalat pe același computer pe care îți dezvolți codul Python. După instalare, următorul pas este să conectezi Ozeki SMS Gateway la rețeaua mobilă. Poți trimite un SMS de test din interfața grafică Ozeki pentru a verifica dacă conexiunea ta la rețeaua mobilă funcționează. Ultimul pas pentru a-ți pregăti mediul este să creezi un utilizator HTTP sms api. Creează un utilizator cu numele de utilizator "http_user" și parola "qwe123" pentru ca exemplul să funcționeze fără modificări.

După ce mediul este configurat, poți rula codul tău Python.

URL API HTTP pentru a trimite SMS din Python

Pentru a trimite SMS din Python, aplicația ta Python va trebui să emită o cerere HTTP către gateway-ul SMS. URL-ul API este afișat mai jos. Reține că adresa IP (127.0.0.1) ar trebui să fie înlocuită cu adresa IP a gateway-ului tău SMS. Dacă Ozeki SMS Gateway este instalat pe același computer pe care rulează aplicația Python pentru SMS, aceasta poate fi 127.0.0.1. Dacă este instalat pe un computer diferit, ar trebui să fie adresa IP a acelui computer. 

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

Autentificare HTTP pentru a trimite SMS din Python

Pentru a autentifica clientul Python pentru SMS, trebuie să trimiteți numele de utilizator și parola într-un șir codat base64 către server într-o cerere HTTP. Formatul utilizat este: base64(nume_utilizator+":"+parolă). În Python, puteți utiliza următorul cod pentru a face această codare: 

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

De exemplu, dacă codificați numele de utilizator 'http_user' și parola 'qwe123', veți obține următorul șir codat base64: aHR0cF91c2VyOnF3ZTEyMw==.

Antetul cererii HTTP pentru a trimite SMS din Python

Pentru a trimite mesajele SMS, trebuie să includeți următoarele linii ca anteturi în cererea HTTP. Rețineți că includem un tip de conținut și un antet de autorizare. 

		Content-Type: application/json
		Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Cererea HTTP pentru a trimite SMS din Python

Pentru a trimite mesajele SMS, aplicația dvs. Python va trimite o cerere HTTP similară cu cea de mai jos. Rețineți că această cerere conține o parte de antet HTTP și o parte de corp HTTP. Corpul HTTP este un șir de date codat JSON. Acesta conține numerele destinatarilor și textele mesajelor. 

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

{
	"messages": [
		{
			"message_id": "cd0067bf-0797-489e-8796-325dacc68552",
			"to_address": "+3620111111",
			"text": "Hello world!",
			"create_date": "2021-09-17T08:20:15",
			"valid_until": "2021-09-24T08:20:15",
			"time_to_send": "2021-09-17T08:25:00",
			"submit_report_requested": true,
			"delivery_report_requested": true,
			"view_report_requested": true,
			"tags": []
		}
	]
}
Răspunsul HTTP primit de exemplul Python pentru SMS

Odată ce gateway-ul SMS primește această cerere, va genera un răspuns HTTP. Răspunsul HTTP va conține un cod de stare pentru a indica dacă cererea de trimitere a SMS-ului a fost reușită sau nu. De asemenea, va returna o structură codată JSON pentru a vă oferi detalii utile despre trimiterea mesajului. 

HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: application/json; charset=utf8
Last-Modified: Thu, 16 Sep 2021 09:14:44 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, 17 Sep 2021 06:20:15 GMT

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "Messages queued for delivery.",
  "data": {
    "total_count": 1,
    "success_count": 1,
    "failed_count": 0,
    "messages": [
      {
        "message_id": "cd0067bf-0797-489e-8796-325dacc68552",
        "from_station": "%",
        "to_address": "+3620111111",
        "to_station": "%",
        "text": "Hello world!",
        "create_date": "2021-09-17 08:20:15",
        "valid_until": "2021-09-24 08:20:15",
        "time_to_send": "2021-09-17 08:25:00",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      }
    ]
  }
}
Exemplu Python pentru SMS: SendScheduledSms.py Cum să descărcați proiectul SendScheduledSMS.py (Tutorial video)

În următorul videoclip, veți învăța cum puteți utiliza proiectul Python SendScheduledSms.py. Videoclipul va începe cu pagina de descărcare și vă va conduce până la panoul deschis al editorului de cod. Veți învăța cum să descărcați și să deschideți fișierul de cod. Videoclipul durează doar 54 de secunde, dar conține toate informațiile necesare pentru a utiliza cu succes fișierul de exemplu.

Video 1 - Cum să descărcați și să deschideți soluția de mai sus (Tutorial video)

Codul de exemplu de mai jos face parte din folderul SendScheduledSms.py.zip.

Figura 3 - SendScheduledSms.py

Cum să utilizați proiectul (Tutorial video)

În următorul clip, veți vedea cum puteți lansa codul Python SendScheduledSms.py. Videoclipul va începe cu codul deschis și vă va conduce până la fila de evenimente cu jurnalul mesajului trimis. Veți vedea cum să lansați codul și ce s-a întâmplat dacă codul a fost executat. Videoclipul este puțin mai scurt de 1 minut, dar conține toate informațiile necesare pentru a rula proiectul.

Video 2 - Cum să utilizați scriptul SendScheduledSms.py (Tutorial video)

Concluzie

Acest articol a prezentat pașii pentru trimiterea programată a SMS-urilor într-o singură solicitare din Python.

Cu aceste cunoștințe și instrumentele furnizate, ar trebui să puteți contacta mai mulți clienți cu un singur cod. Ozeki SMS Gateway joacă un rol important în acest proces, deoarece acest program organizează livrarea mesajelor. Ozeki SMS Gateway funcționează cu o calitate și performanță ridicate, permițându-vă să trimiteți până la 1000 de SMS-uri pe secundă.

Continuați învățarea pe paginile de tutoriale ale Ozeki, unde puteți citi despre subiecte precum Primirea SMS-urilor în Python.

Acum, singurul lucru care vă rămâne de făcut este să descărcați Ozeki SMS Gateway și să începeți să lucrați!

More information