Skip to content
Messente public API libraries merged into one Python library
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.openapi-generator 1.0.1 (#1) May 22, 2019
docs 1.0.3 (#3) Jun 6, 2019
messente_api 1.0.3 (#3) Jun 6, 2019
test 1.0.3 (#3) Jun 6, 2019
.gitignore Travis update: Mar 2019 (Build 29) Mar 1, 2019
.openapi-generator-ignore
.travis.yml 1.0.1 (#1) May 22, 2019
README.md 1.0.3 (#3) Jun 6, 2019
git_push.sh Travis update: Mar 2019 (Build 29) Mar 1, 2019
requirements.txt Travis update: Mar 2019 (Build 29) Mar 1, 2019
setup.py 1.0.3 (#3) Jun 6, 2019
test-requirements.txt Travis update: Mar 2019 (Build 29) Mar 1, 2019
tox.ini Travis update: Mar 2019 (Build 29) Mar 1, 2019

README.md

Messente API Library

  • Messente API version: 1.0.2
  • Python package version: 1.0.3

Messente is a global provider of messaging and user verification services. Use Messente API library to send and receive SMS, Viber and WhatsApp messages, blacklist phone numbers to make sure you're not sending any unwanted messages, manage contacts and groups. Messente builds tools to help organizations connect their services to people anywhere in the world.

Installation

Install Messente API library with pip install messente-api.

Features

Messente API has the following features:

Messente API Library provides the operations described below to access the features.

BlacklistApi

  1. Adds a phone number to the blacklist add_to_blacklist
  2. Deletes a phone number from the blacklist delete_from_blacklist
  3. Returns all blacklisted phone numbers fetch_blacklist
  4. Checks if a phone number is blacklisted is_blacklisted

ContactsApi

  1. Adds a contact to a group add_contact_to_group
  2. Creates a new contact create_contact
  3. Deletes a contact delete_contact
  4. Lists a contact fetch_contact
  5. Lists groups of a contact fetch_contact_groups
  6. Returns all contacts fetch_contacts
  7. Removes a contact from a group remove_contact_from_group
  8. Updates a contact update_contact

DeliveryReportApi

  1. Retrieves the delivery report for the Omnimessage retrieve_delivery_report

GroupsApi

  1. Creates a new group with the provided name create_group
  2. Deletes a group delete_group
  3. Lists a group fetch_group
  4. Returns all groups fetch_groups
  5. Updates a group with the provided name update_group

OmnimessageApi

  1. Cancels a scheduled Omnimessage cancel_scheduled_message
  2. Sends an Omnimessage send_omnimessage

Auth

Type: HTTP basic authentication

Read the external getting-started article which explains API keys and Sender ID logic.

Getting started: sending an omnimessage

from pprint import pprint
from messente_api import (
    OmnimessageApi,
    Viber,
    SMS,
    Omnimessage,
    Configuration,
    ApiClient,
    WhatsApp,
    WhatsAppText
)
from messente_api.rest import ApiException

# API information from https://dashboard.messente.com/api-settings
configuration = Configuration()
configuration.username = '<MESSENTE_API_USERNAME>'
configuration.password = '<MESSENTE_API_PASSWORD>'

# create an instance of the API class
api_instance = OmnimessageApi(ApiClient(configuration))

whatsapp = WhatsApp(
    sender='<sender name (optional)>',
    text=WhatsAppText(
        body='hello whatsapp'
    )
)

viber = Viber(
    sender='<sender name (optional)>',
    text='hello python',
)

sms = SMS(
    sender='<sender name (optional)>',
    text='hello python',
)

# The order of items in 'messages' specifies the sending order:
# WhatsApp will be attempted first,
# then Viber,
# and SMS as the final fallback
omnimessage = Omnimessage(
    messages=(whatsapp, viber, sms),
    to='<recipient_phone_number>',
)  # Omnimessage | Omnimessage object that is to be sent

try:
    # Sends an Omnimessage
    response = api_instance.send_omnimessage(omnimessage)
    print(
        'Successfully sent Omnimessage with id: %s that consists of the following messages:' % response.omnimessage_id
    )
    for message in response.messages:
        pprint(message)
except ApiException as exception:
    print('Exception when sending an omnimessage: %s\n' % exception)

License

Apache 2.0

Terms

https://messente.com/terms-and-conditions

You can’t perform that action at this time.