LogoLogo
  • Go to Docs Center
  • Plum DEV Documentation
  • Overview
  • Developer Reference
    • Tutorial
    • How to...
      • Use Plum's Transcription API
    • Audio Formats and Prompts
    • Grammars and Speech Recognition
    • Available ASR Engines
    • TTS Engine Characteristics
      • Amazon Polly TTS Engine
        • Polly Voice Tag Attribute Details
      • AT&T Natural Voices
      • Cepstral Engine
      • RealSpeak Engine
      • Vocalizer 7
        • Vocalizer 7: <voice> tag and SSML Support
    • Data Exchange
    • Logging
    • Caching
    • Root Documents
  • VoiceXML
    • Tags
      • <assign>
      • <audio>
      • <block>
      • <break>
      • <catch>
      • <choice>
      • <clear>
      • <data>
      • <desc>
      • <disconnect>
      • <else>
      • <elseif>
      • <emphasis>
      • <enumerate>
      • <error>
      • <example>
      • <exit>
      • <field>
      • <filled>
      • <foreach>
      • <form>
      • <goto>
      • <grammar>
      • <help>
      • <if>
      • <initial>
      • <item>
      • <lexicon>
      • <link>
      • <log>
      • <mark>
      • <menu>
      • <meta>
      • <metadata>
      • <noinput>
      • <nomatch>
      • <one-of>
      • <option>
      • <paragraph>
      • <param>
      • <phoneme>
      • <prompt>
      • <property>
      • <prosody>
      • <record>
      • <reprompt>
      • <return>
      • <rule>
      • <ruleref>
      • <say-as>
      • <script>
      • <sentence>
      • <speak>
      • <sub>
      • <subdialog>
      • <submit>
      • <tag>
      • <throw>
      • <token>
      • <transfer>
      • <value>
      • <var>
      • <voice>
      • <vxml>
    • Properties
      • audiofetchhint
      • audiomaxage
      • audiomaxstale
      • bargein
      • bargeintype
      • certverifypeer
      • completetimeout
      • confidencelevel
      • datafetchhint
      • datamaxage
      • datamaxstale
      • documentfetchhint
      • documentmaxage
      • documentmaxstale
      • fetchaudio
      • fetchaudiodelay
      • fetchaudiominimum
      • fetchtimeout
      • grammarfetchhint
      • grammarmaxage
      • grammarmaxstale
      • incompletetimeout
      • inputmodes
      • interdigittimeout
      • logging
      • maxnbest
      • maxspeechtimeout
      • normalizeaudio
      • recordcall
      • recordcallappend
      • recordutterance
      • recordutterancetype
      • scriptfetchhint
      • scriptmaxage
      • scriptmaxstale
      • sensitivity
      • speedvsaccuracy
      • termchar
      • termmaxdigits
      • termtimeout
      • timeout
      • universals
      • voicegender
      • voicename
    • Application and Session Variables
      • application.lastresult$[i].confidence
      • application.lastresult$[i].inputmode
      • application.lastresult$[i].interpretation
      • application.lastresult$[i].recording
      • application.lastresult$[i].recordingduration
      • application.lastresult$[i].recordingsize
      • application.lastresult$[i].utterance
      • session.callrecording
      • session.id
      • session.telephone.ani
      • session.telephone.dnis
    • VoiceXML Resources
  • Plum DEV Guide
    • Using the Plum DEV site
    • Using the File Repository
    • Outbound Calling Guide
      • Using the Outbound Tools in the DEV web UI
      • DEV Outbound Programming Notes
      • Outbound FAQs and Tips
    • Call Reporting
    • Analytics
    • VoiceTrends
    • Debugging
    • Scratchpads
    • Saved URLs
    • Voice Biometrics
    • Call Routing
    • Data Security
      • 'Private' Tags
      • Managing Secure Phone Numbers
      • Sensitive Data Types
    • SMS Guide
      • Standard Short Codes
      • SMS Debugging/Error Logs
      • Additional SMS Info
    • Single Sign On
  • Plum DEV APIs
    • DEV Outbound APIs
      • Contacts CSV Formatting
      • Outbound API Parameter Notes
      • Legacy and Miscellaneous Notes
    • SMS API
    • Call Logs API
    • Call Scheduling and Pacing API
    • Transcription API
    • Application API
    • Blocklist API
Powered by GitBook
On this page
  • Outbound API Methods
  • Queue A Single Call
  • Queue Multiple Calls
  • Required Settings
  1. Plum DEV APIs

DEV Outbound APIs

PreviousSingle Sign OnNextContacts CSV Formatting

Last updated 2 years ago

- NEW! - Interactive API docs, now live!

Visit to read Plum API documentation, build and test requests in our interactive API sandbox, review the responses, and share it all with your team.

Outbound API Methods

Method

Service

Description

Queue a Single Call with the queuecall web service

This default campaign and the calls within it are visible in and controlled from your campaign management interface after you login with your login name and PIN.‌ If you do not already have a PIN for outbound calling, contact Plum's team.

If you plan to queue more than one call at a time, use the API Method. Looping the Single Call API for individual calls can cause DDoS, which will result in all calls failing.

Queue A Single Call

POST http://outbound.plumvoice.com/webservice/queuecall.php‌

The queuecall API method allows users to initiate a call to a specific phone number. Initiating an outbound call in this manner places the call into the default calling campaign for your account.

Request Body

Name
Type
Description

login

string

Sender login name (max length 128)

pin

string

Sender PIN code (max length 16)

phone_number

string

Phone number to be dialed (include a 1 before the area code) (max length 128)

start_url

string

URL for the VoiceXML script used for the call (max length 255)

result_url

string

URL for post-call processing (max length 255)

message_reference

string

The message_reference string is POSTed to the URL specified by start_url (max length 255)

call_parameters

string

The call_parameters string is POSTed to the URL specified by start_url (max length 255)

max_retry

integer

An integer between 0 and 10 for the number of failed call attempts before giving up

retry_interval

integer

An integer from 60 to 172800 indicating the number of seconds between retries

scheduled_timestamp

integer

(Optional) 0 to start immediately or a UNIX-time integer indicating when to start attempting the call

expiration_timestamp

integer

(Optional) 0 to never expire or a UNIX-time integer indicating when the outbound system should give up attempting to complete an uncompleted call

scheduled_time

string

Alternative option to scheduled_timestamp. See call control settings below. (max length 80)

expiration_time

string

Alternative option to expiration_timestamp. See call control settings below. (max length 80)

is_pci

integer

0 or 1. For customers who have been granted access to our HIPAA-/PCI-compliant secure environment, setting this flag to 1 causes connected outbound calls to execute within that secure environment.

<?xml version="1.0"?>
<queuecall status="queued" call_id="112850593">
    <login>user</login>
    <pin>98765432</pin>
    <phone_number>+1234567890;ani=8001234567</phone_number>
    <start_url>http://charles.plumgroup.com/~schan/src/charles/vxml/start.php</start_url>
</queuecall>
<?xml version="1.0"?>
<queuecall status="queued" call_id="112852724">
    <login>user</login>
    <pin>98765432</pin>
    <phone_number>+1234567890;ani=8001234567</phone_number>
    <start_url>http://charles.plumgroup.com/~schan/src/charles/vxml/start.php</start_url>
    <max_retries>1</max_retries>
    <retry_interval>70</retry_interval>
    <scheduled_timestamp>1596832808</scheduled_timestamp>
    <scheduled_time>Fri, 07 Aug 2020 16:40:08 -0400</scheduled_time>
</queuecall>

Queue Multiple Calls with the queuecalls web service

Queue Multiple Calls

POST http://outbound.plumvoice.com/webservice/queuecalls.php‌

The queuecalls API method allows users to initiate calls to any number of callers listed in an uploaded text file. Initiating a group of outbound calls in this manner creates a calling campaign.

Headers

Name
Type
Description

content-type

string

multipart/form-data

Request Body

Name
Type
Description

login

string

Sender login name (max length 128)

pin

string

Sender PIN code (max length 16)

campaign_name

string

Unique name for the new calling campaign

phone_list

object

CSV file containing the list of phone numbers to be dialed, and optionally the message_reference and call_parameter. Each line will include the following items, delimited by a comma: 1) Phone number destination, include "1" before the area code (required) 2) message_reference - string posted to start_url and result_url (max length 128, optional) 3) call_parameter - string posted to start_url (max length 255, optional)

start_url

string

URL for the VoiceXML script used for the call (max length 255)

result_url

string

URL for post-call processing (max length 255)

message_reference

string

The message_reference string is POSTed to the URL specified by start_url (max length 255)

call_parameters

string

The call_parameters string is POSTed to the URL specified by start_url (max length 255)

max_retry

integer

An integer between 0 and 10 for the number of failed call attempts before giving up

retry_interval

integer

An integer from 60 to 172800 indicating the number of seconds between retries

scheduled_timestamp

integer

(Optional) 0 to start immediately or a UNIX-time integer indicating when to start attempting the call

expiration_timestamp

integer

(Optional) 0 to never expire or a UNIX-time integer indicating when the outbound system should give up attempting to complete an uncompleted call

scheduled_time

string

Alternative option to scheduled_timestamp. See call control settings below. (max length 80)

expiration_time

string

Alternative option to expiration_timestamp. See call control settings below. (max length 80)

is_pci

integer

0 or 1. For customers who have been granted access to our HIPAA-/PCI-compliant secure environment, setting this flag to 1 causes connected outbound calls to execute within that secure environment.

<?xml version="1.0"?>
<queuecalls status="success">
    <login>user</login>
    <pin>98765432</pin>
    <campaign_name>SunnyCamp</campaign_name>
    <start_url>http://charles.plumgroup.com/~schan/src/charles/vxml/start.php</start_url>
    <phone_list>
        <call call_id="112897970">
            <phone_number>tel:+19492222222;ani=8009957586</phone_number>
        </call>
        <call call_id="112897971">
            <phone_number>tel:+19492222223;ani=8009957586</phone_number>
        </call>
    </phone_list>
</queuecalls>

You must POST with multipart/form-data encoding in order for the queuecalls webservice to properly receive and process the uploaded file .‌

All settings are applied to all calls in the campaign. However, message_reference and call_parameters (see below) are set on a per-call basis and are specified in the uploaded text file with each phone number.‌

Required Settings

Calls are listed in the phone number list file on comma-delimited lines where the first field is the phone number and the second and third fields contain a message_reference string and call_parameters string, respectively, for the call as described here. The second and third fields are optional.‌

See the for additional information on these single call API parameters.

The campaign manager interface allows users to assign campaigns a unique name and to manage various aspects of the campaign. Use your login name and PIN to access the campaign manager.‌ If you do not already have a PIN for outbound calling, contact Plum's team.

See the for additional information on these multi-call API parameters.

Account Management
api-docs.plumvoice.com
Account Management
Queue Multiple Calls
POST
webservice/queuecall.php
Queues a single outbound phone call
POST
webservice/queuecalls.php
Queues multiple outbound phone call
Outbound API parameter notes
Outbound API parameter notes