Skip to main content

A Python API for the SOAP Web Services offered by responsys.

Project description

========
Interact
========

Responsys Interact
==================
**Disclaimer:** *This code is neither officially supported nor endorsed by Responsys.*

Module for simplified usage of the Responsys Interact API.

This Python package was created to fill the need for a simplified Python
interface to the Responsys Interact web services for our latest version
of the software.

SOAP Web Services can be a bit tricky to deal with, especially for
Responsys Interact if the developer does not have experience with terms
that are specific to Responsys and/or marketing. This package is geared
to help an experienced developer get the ball rolling with minimal
knowledge of the Responsys Interact API and UI.

The Interact API is limited in comparison to the features offered through
the web UI, but offers everything you would need to create a website that
integrates with services offered by Responsys. There is no way to
dynamically create an email campaign through code, but you will be able to
launch them dynamically using this API.

Example use case::

#!/usr/bin/env python
from interact import Interact6
api = Interact6()
api.connect(username='user', password='pass', pod=5)
api.merge_into_list('folder/listname', [{
'EMAIL_ADDRESS_': ...,
'CUSTOMER_ID_': ...,
}, { ... }, ...])
api.trigger_campaign('folder/campaign_name', 'folder/list_name', [{
'EMAIL_ADDRESS_': ...,
'OPTIONAL_DATA1': ...,
'OPTIONAL_DATA2': ...,
}, ... ])
api.disconnect()

It's also possible to create a file at ~/.interact/creds.py with saved credentials.

The format of the credentials file::
credentials = {
'5': {
'username': 'apiuser',
'password': 'pass123',
},
}

Use '5' if your endpoint is ws5.*, 2 for ws2.*

Then you connect simply with::

#!/usr/bin/env python
from interact import Interact6
api = Interact6()
api.connect(pod=5)

If a file in ~/.interact/rc.py exists, it will execfile that when
creating an instance of Interact6 unless kward exec_rc is set to False.
This allows you to create simple campaign or program configs so that you
do not need to hardcode paths to Interact objects.

Project details


Release history Release notifications

This version
History Node

0.7.8

History Node

0.7.7

History Node

0.7.6

History Node

0.7.5

History Node

0.7.4

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
pyinteract-0.7.8.tar.gz (9.5 kB) Copy SHA256 hash SHA256 Source None Jun 10, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page