Skip to main content

The Go-Mailer Utility library

Project description

The Go-Mailer Python utility Package


The Python API utility library for the Go-Mailer marketing platform.

This package enables API transactions to the Go-Mailer servers for faster and seamless inter-application communications. It enables you to:

  • Synchronize your contact data with Go-Mailer.
  • Notify Go-Mailer of any events that occur on your application.
  • Send out transactional emails through Go-Mailer.

Installation


The API client can be installed using PIP.

pip install gomailer

Basic Usage


Synchronize contacts

You are able seamlessly synchronize your user's data with Go-Mailer. This helper would create a new Go-Mailer contact if none exists with the specified email address OR it will update the Go-Mailer contact with the necessary data if a Go-Mailer contact exists with the specified email.

NOTE:

  • Go-Mailer contacts are uniquely identified by their email address in order to avoid duplicate communications.
  • You can store any custom attribute.
  import gomailer

  data = {
    'firstname': 'John',
    'lastname': 'Doe,
    'last_login': '12-12-2024T12:12:12:0000Z',
    // other attributes
  }

  client = Client('YOUR_API_KEY')
  response = client.contacts().synchronize(<email_address>, data)

  if (response['status_code'] === 200) {
    // handle success
  }

You can find more information here

Send a transactional email

Quickly and reliably send transactional emails to your users using Go-Mailer. This helper would send a transactional email to the specified recipient.

NOTE:

  • If no Go-Mailer contact exists for the specified email address, a new one will be created.
import gomailer

client = Client('YOUR_API_KEY')
response = client.mailing().send_transactional_email(<template_code>, <recipient_email>, <context data>, <html markup>, <attachments>, <bcc email>)

if (response['status_code'] === 200) {
  // handle success
}

You can find more information here

Notify Go-Mailer of an event

Notify Go-Mailer of an event that has occured on your application. This is useful to react to such events such as sending a transactional email, SMS messages etc. You need to pass the event code, the affected user's email and all other relevent context data around the event occurence.

NOTE:

  • A new event will be created on your Go-Mailer account the event code does not exist.
import gomailer

client = Client('YOUR_API_KEY')
response = client.automation().trigger_event(<event_code>, <user_email>, <context data>)

if (response['status_code'] === 200) {
  // handle success
}

You can find more information here

License


MIT license. See the LICENSE file for more details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gomailer-1.0.3.tar.gz (3.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gomailer-1.0.3-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

Details for the file gomailer-1.0.3.tar.gz.

File metadata

  • Download URL: gomailer-1.0.3.tar.gz
  • Upload date:
  • Size: 3.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.7.12

File hashes

Hashes for gomailer-1.0.3.tar.gz
Algorithm Hash digest
SHA256 0a1a08dcadff69c93fab29a97632ff8dba40104e27996f7998e6887485083200
MD5 108bbcfca0ce5416dd32fe7f972cd669
BLAKE2b-256 e32b979d9fef1fc0662447496d80ea21550068374a29fe96e4f211dce5026e49

See more details on using hashes here.

File details

Details for the file gomailer-1.0.3-py3-none-any.whl.

File metadata

  • Download URL: gomailer-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 6.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.7.12

File hashes

Hashes for gomailer-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 8a131bf70c021c9861614cd2de8770bd3c0cee4baf0088b4773f0afb48552f13
MD5 877defce1f96fb84c901a7e04642c296
BLAKE2b-256 7cd48e17ea2e057954ddb80391e3e89f9a3233a9c7c7a1cbdc79abc356a1cd5d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page