About the Whispir platform API
API gateway changes
Getting started
Conventions
Workspaces
Messages
Message status
Message responses
Templates
Callbacks
Response rules
Resources
Contacts
Imports
Users
Distribution lists
Scenarios
Custom lists
Events
Activities
Apps
Contact devices
Contact us

About the Whispir platform API

Built by developers, for developers, Whispir is the place where you can easily build communications into your app – SMS, email, push, voice, chat, web, social networks and web pages.

Whispir APIs let developers:

  • Create, send and retrieve multi-channel messages over 8 different channels.
  • Invoke scenario-based communications for quick, effective and targeted communications.
  • Publish messages to internal or external web pages, RSS feeds and social networks.
  • Asynchronously receive all responses to a given message and perform analysis on the data.

Templates API

The Whispir Templates API lets developers:

  • Create rich, cross-channel message templates that can be managed by designers within the Whispir Rich Message Studio.
  • Ensure a DRY (‘don’t repeat yourself’) pattern within developer code by separating the communication content from code.
  • Reduce code change by managing content elsewhere.

Events Management API

The Events Management API provides developers with the tools needed to manage the communications around events:

  • Save different event details, such as Severity, Priority, Description and Tasks, to ensure a path to a seamless resolution.
  • Automatically inform teams through Whispir’s integrated cross-channel messaging, ensuring that you know who has received a message and, more importantly, who hasn’t.

Contacts Management API

The Contacts Management API provides developers with the ability to manage the recipients of their messages:

  • Store contact information in a cloud-based, highly available and accessible environment.
  • Use standards based methods to create, update, and delete contact information.
  • Build forms to allow contacts to self-register and manage their account, with auto-generated email notifications.
  • Create, update and delete distribution lists that can be accessed for messaging at a later date.
  • JSON
  • XML

API endpoint

https://api.<region>.whispir.com

Whispir regions:

AU - https://api.au.whispir.com
AP - https://api.ap.whispir.com
AP1 - https://api.ap1.whispir.com
NZ - https://api.nz.whispir.com
US - https://api.us.whispir.com
IT - https://api.it.whispir.com
EDU - https://api.education.whispir.com

API authorization

Users must use an API Key and Authorization Header to access the Whispir API. These are available by signing up for a free 14-day trial

Resource endpoints

The following resource endpoints are accessible when using the Whispir API:

/messages
/messages/:id/messagestatus
/messages/:id/messageresponses
/templates
/responserules
/contacts
/contacts/:id/devices
/distributionlists
/scenarios
/events
/imports
/resources
/activities
/users
/customlists
/callbacks
/callbacks/:id/calls
/workspaces
/apps


Note: The /events endpoint is only available for users who have the Events module enabled.

Example request:

{{codeStart}}

# Authorization and apikey are provided in the registration processes

curl -H "Authorization: Basic <YOUR AUTHORIZATION HEADER>" -H "x-api-key: <YOUR API KEY>"

https://api.<region>.whispir.com/messages

{{codeEnd}}

Example response:

HTTP/1.1 200 OK

{{codeStart}}

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<ns2:return xmlns:ns2="http://schemas.api.whispir.com/dap" xmlns:ns3="http://schemas.api.whispir.com">

<status>No records found</status>

</ns2:return>

{{codeEnd}}