demo_send.py

"""demo.py

flowroute-messaging-python is a Python SDK that provides methods
to send an outbound SMS from a Flowroute phone number and also
to retrieve a Message Detail Record (MDR). These methods use v2
(version 2) of the Flowroute API.

Copyright:
    Flowroute, Inc.  2016

Prerequisites:
    * Messaging enabled on both numbers.
"""

import os
import pprint
from time import sleep
import sys

from FlowrouteMessagingLib.Controllers.APIController import *
from FlowrouteMessagingLib.Models.Message import *

# Set up your API credentials
# Please replace the variables in Configuration.php with your information.
username = os.getenv('ACCESS_KEY')
password = os.getenv('SECRET_KEY')
from_number = os.getenv('FROM_E164')
to_number = os.getenv('TO_E164')

# Print the demo script header.
print("Flowroute, Inc - Demo SMS Python script.\n")
if username is None or password is None or from_number is None or to_number is None:
    print("To operate this script, please set the environment variables as follows:")
    print("'ACCESS_KEY'=Your account tech_prefix")
    print("'SECRET_KEY':Your API Secret Key")
    print("'FROM_E164':Flowroute DID with leading +1")
    print("'TO_E164':Destination DID with leading +1")
    sys.exit(0)

# Create the Controller.
controller = APIController(username=username, password=password)
pprint.pprint(controller)

# Build your message.
message = Message(to=to_number, from_=from_number, content='Your cool new SMS message here!')

# Send your message.
try:
    response = controller.create_message(message)
    pprint.pprint(response)
except APIException as e:
    print("Send Error - " + str(e.response_code) + '\n')
    pprint.pprint(e.response_body['errors'])
    exit(1)        # can't continue from here

# Get the MDR id from the response.
mdr_id = response['data']['id']
print("MDR ID: {}".format(mdr_id))

# Wait for message to register.
# Three seconds should be enough.
sleep(3)

# Retrieve the MDR record.
try:
    # Example MDR: 'mdr1-b334f89df8de4f8fa7ce377e06090a2e'
    mdr_record = controller.get_message_lookup(mdr_id)
    pprint.pprint(mdr_record)
except APIException as e:
    print("MDR Retrieval Error - {} - {}".format(str(e.response_code), e.response_body))
    pprint.pprint(e.response_body['errors'])
    exit(2)