opencpaas 0.0.1

An SDK that allows flexibility between CPaaS providers.

OpenCpaas Python SDK

OpenCpaas allows customers to switch between CpaaS providers without having to rewrite code.

Currently supports:

• Bandwidth
• Twilio

See our full documentation.

Requirements

• Python 3.5+

Installation

pip install opencpaas

Getting Started

Client Initialization

Begin by initializing a new CpaaS client. This example uses the BandwidthClient for initialization. Specifics for each client can be found in each client's repository.

import opencpaas

auth = 	{
	'api_token': '789',
	'api_secret':'1011',
	'account_id': 'myaccount' ,
	'application_id': 'myapplication',
	'user': 'username',
	'pass': 'password',
	'site_id': '12345' 
	}

client = BandwidthClient(auth)

Each type of CpaaS client will require different authentications. Refer to our documentation for a complete list.

Send an SMS

message = client.send_sms(to="[phone]"
                          from_="[phone]"
                          text="Hello there!")

print(message['id'])

Send an MMS

message = client.send_mms(to="[phone]"
                          from_="[phone]"
                          text="Take a look at this!"
                          media_url="www.media.com/cute-cat")

print(message['id'])

Order a phone number

result = client.order_number(phone_number="[phone]")

print(result['order_status'])

Order multiple phone numbers

result = client.order_numbers(area_code="410"
                              quantity=10)

print(result['order_status'])

Make an outgoing phone call

parameters = {
          'url':"http://mycallbackurl.com/123",
          'status_callback':"http://mystatuscallbackurl.com/123",
          'answer_url':"http://myanswerurl.com/123"
          }

call_id = client.create_call(to="[phone]",
                             from_="[phone]",
                             **parameters
                             )

print(call_id)

CpaaS clients require different callback urls. Please check our documentation for specific information on these urls.