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.2.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.2-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: gomailer-1.0.2.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.2.tar.gz
Algorithm Hash digest
SHA256 6b872ebafe6f5b0ee3716705d32cc2ea4c08d4a418b82aa229d874c5910d7be3
MD5 429aa06c8c2a9d6fe4d6e6585d58cf70
BLAKE2b-256 5d55e9442f89007aa7f7505a56d4075939427038b4ea725121de94b143e03fb3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: gomailer-1.0.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 dd8d021a77df951c9aae0e8d0bb888d61009e6363a58a2f3c7493cb701a0248e
MD5 483b0aaa7c3f2336bed5abb836aa33d3
BLAKE2b-256 aff7f757aa8d6610a352a743cf418981eca261e501aa970ced3d19382b8114f0

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