Plum DEV Documentation
plumdevguide:outbounddevguide

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
plumdevguide:outbounddevguide [2020/01/07 14:22]
127.0.0.1 external edit
plumdevguide:outbounddevguide [2020/05/27 13:49] (current)
admin
Line 50: Line 50:
 NOTE: Before your outbound calls go out, the outbound platform sends a GET request to confirm that the start_url and result_url URLs return an HTTP 200 OK response. If these URLs don't return this response, the queuecall operation fails. NOTE: Before your outbound calls go out, the outbound platform sends a GET request to confirm that the start_url and result_url URLs return an HTTP 200 OK response. If these URLs don't return this response, the queuecall operation fails.
  
 +===Contacts CSV Formatting===
 +There are several different acceptable formats for CSV contacts. The only format restriction is that the first column header must be '​destination'​. Other than that, users may supply optional columns of information. Dev sets these data as variables within your outbound call.
 +
 +The following list provides samples of different phone number formats for 5 different contacts. Observe that none of these numbers have call variables set:
 +<​code>​
 +"​destination"​
 +"​1234567890"​
 +"​1112223456"​
 +"​tel:​12223456547"​
 +"​tel:​+16177123000;​ani=5553336666"​
 +"​19998886666"​
 +</​code>​
 +
 +Note the various supported phone number formats. Users can add optional parameters for phone number strings, e.g. '​tel',​ '​ani',​ etc. 
 +
 +**As of 2019, ANI should be set on all outbound phone calls** as federal regulation requirements means that most inbound carriers will block outbound calls that do not originate somewhere. ANI should be a number that you own.
 +
 +For more information about this, please see [[https://​docs.plumvoice.com/​fuse/​_media/​robocalling.pdf|here]].
 +
 +The following file includes the same list of phone numbers, but with the additional variables '​first_name'​ and '​last_name'​ for use within the application:​
 +<​code>​
 +"​destination","​first_name","​last_name"​
 +"​1234567890","​Steve","​Smith"​
 +"​1112223456","​Klein","​Reynolds"​
 +"​tel:​12223456547","​Sloane","​Bergeron"​
 +"​tel:​+16177123000;​ani=5553336666","​Plum","​Voice"​
 +"​19998886666","​Keith","​Johnston"​
 +</​code>​
  
 ====Data Flow and Control Flow==== ====Data Flow and Control Flow====