SDK Python

pip install messageglobe

from messageglobe import ContactRequest, EmailMessage, MessageGlobe, SmsMessage mg = MessageGlobe.create(    # Copia il tuo token dalla dashboard sviluppatori.    # Un solo token abilita tutte le funzioni REST.    api_token="XX|xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",    smtp={        "host": "smtp.messageglobe.com",        "port": 587,        "from_address": "[email protected]",        "from_name": "YourApp",        "username": "smtp-user",        "password": "smtp-password",        "encryption": "tls",    },) # Invia un SMSresponse = mg.sms.send(    SmsMessage(to="393612345678", sender_id="YourName", message="This is a test message"))print(response.message_id) # Crea un contattocontact = mg.contacts.create("list_uid_example", ContactRequest(phone="393310000000"))print(contact.uid) # Invia una emailmg.email.send(    EmailMessage(        to="[email protected]",        subject="Welcome",        html="<h1>Hi Jane</h1>",        text="Hi Jane",    ))

from messageglobe import ApiConfig, SmsClient client = SmsClient(ApiConfig("XX|your-api-token")) # Lingua delle risposte API: "en" oppure "it".client = SmsClient(ApiConfig("XX|your-api-token", accept_language=ApiConfig.LANGUAGE_IT))

from messageglobe import SmsMessage response = client.send(    SmsMessage(        to="393612345678",          # un numero, "n1,n2" oppure una lista        sender_id="YourName",       # max 11 caratteri se alfanumerico        message="Hello world",        dlr_callback_url="https://yourapp.com/webhooks/dlr",  # opzionale, solo HQ    )) result = response.first()print(result.message_id)   # "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"print(result.status)       # "Sent"print(result.cost)         # 0.06

SmsMessage(to="393612345678", sender_id="YourName", message="Привет 😀", auto_type=True)# sms_type diventa "unicode" automaticamente # I mutatori sono concatenabili anche dopo la costruzione:message = SmsMessage().to("393612345678").set_message("Hello world").low_quality()

response = client.send(    SmsMessage(        to=["393612345678", "880172145789"],  # oppure "393612345678,880172145789"        sender_id="YourName",        message="Hello everyone",    )) for result in response:    print(result.recipient, "=>", result.message_id)

result = client.status("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx") print(result.status)       # es. "Delivered"print(result.updated_at)

{    "message_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",    "recipient": "393612345678",    "sender_id": "YourName",    "status_code": 1,    "status": "Delivered",    "updated_at": "2024-06-28T11:41:51.000000Z"}

from messageglobe import ApiConfig, ContactRequest, ContactsClient client = ContactsClient(ApiConfig("XX|your-api-token")) # Almeno uno tra phone ed email è obbligatorio.contact = client.create(    "list_uid_example",    ContactRequest(phone="393310000000", first_name="Jane", last_name="Doe"),) print(contact.uid)          # "contact_uid_example"print(contact.status)       # "subscribe" # Elimina indicando la lista e l'uid del contatto.client.delete("list_uid_example", "contact_uid_example")

from messageglobe import ApiConfig, GroupsClient client = GroupsClient(ApiConfig("XX|your-api-token")) group = client.create("Newsletter subscribers")uid = group.uid group = client.show(uid)group = client.update(uid, "VIP subscribers") client.delete(uid) # Elenca tutte le liste (dati grezzi, paginati)page = client.all()

from messageglobe import ApiConfig, SenderIdRequest, SendersClient client = SendersClient(ApiConfig("XX|your-api-token")) # Elenca tutti i sender IDfor sender in client.all():    print(sender.sender_id, "=>", sender.status)  # "active" / "pending" # Cerca un sender ID per nomesender = client.show("YourName") # Creane uno nuovo: tutti i campi sono obbligatori, 3-11 caratteri.sender = client.create(    SenderIdRequest(        sender_id="YourName",        company="Your Company",        tax_code="ABCDEF12G34H567I",        vat_code="01234567890",        address="Via Roma 1",        city="Rome",        province="RM",        country="IT",        email_address="[email protected]",        phone="391234567890",        pec_address="[email protected]",    )) # Elimina per nomeclient.delete("YourName")

from messageglobe import Attachment, EmailClient, EmailMessage, SmtpConfig client = EmailClient(    SmtpConfig(        host="smtp.messageglobe.com",        port=587,        from_address="[email protected]",        from_name="YourApp",        username="smtp-user",        password="smtp-password",        encryption=SmtpConfig.ENCRYPTION_TLS,    )) message = (    EmailMessage(subject="Your report")    .to("[email protected]", "Jane Doe")    .cc("[email protected]")    .reply_to("[email protected]")    .html("<h1>Report ready</h1><p>See attachment.</p>")    .text("Report ready. See attachment.")    .attach(Attachment.from_path("/path/to/report.pdf"))    .attach(Attachment.from_content(csv_string, "data.csv", "text/csv"))) client.send(message)

config = SmtpConfig.for_messageglobe(    "[email protected]",      # username di accesso a MessageGlobe    "XX|your-api-token",      # API token, usato come password SMTP    "[email protected]",    "YourApp",) client = EmailClient(config)

from messageglobe import ApiError, MessageGlobeError, ValidationError try:    client.send(sms)except ValidationError:    # Validazione lato client fallita    ...except ApiError as exc:    # L'API ha restituito un errore    print(exc.message)            # "Invalid params"    print(exc.api_error_code)     # 200    print(exc.http_status_code)   # 422    print(exc.errors)except MessageGlobeError:    # Qualsiasi altro errore dell'SDK    ...

import requests from messageglobe import HttpResponse  class RequestsHttpClient:    def request(self, method, url, headers=None, body=None):        response = requests.request(method, url, headers=dict(headers or {}), data=body)         return HttpResponse(            status_code=response.status_code,            body=response.text,            headers=dict(response.headers),        )  client = SmsClient(config, RequestsHttpClient())