Difference between revisions of "API Method MessageCompose"

From Updox API
Jump to: navigation, search
(Compose Message)
 
(6 intermediate revisions by one user not shown)
Line 1: Line 1:
== Credentials ==Provide appropriate credentials for the user who will be sending the message:
+
== Credentials ==
 +
Provide appropriate credentials for the user who will be sending the message:
 
[[File:MessageCompose1.png]]
 
[[File:MessageCompose1.png]]
 +
  
  
Line 8: Line 10:
  
  
== Request / Response JSON
+
 
 +
== Request and Response JSON ==
 
Sending this transaction consists of the following request JSON and response JSON and returns a token:
 
Sending this transaction consists of the following request JSON and response JSON and returns a token:
 
[[File:MessageCompose3.png]]
 
[[File:MessageCompose3.png]]
 +
  
  
 
== Build URL ==
 
== Build URL ==
 
Use this token to construct a url in the following manner:
 
Use this token to construct a url in the following manner:
https://{environment}/sso/messageCompose/{vendorId}/{token}
+
    https://{environment}/sso/messageCompose/{vendorId}/{token}
  
 
which for this example would look like this:
 
which for this example would look like this:
https://'''updoxqa.com'''/sso/messageCompose/'''updox'''/'''611e840357c9dd58625436996cc2631910188c61'''
+
    https://updoxqa.com/sso/messageCompose/updox/611e840357c9dd58625436996cc2631910188c61
  
 +
Note that as this token has already been used, browsing to this exact link will result in a 404 error.
  
== Message Compose ==
+
== Compose Message ==
Browsing to this url will show the following '''''one-use-only''''' Direct message compose screen:
+
Browsing to this url will show the following '''''one-use-only''''' Direct message compose screen.  Note that the From address is the specified user's directAddress and is pre-populated and unchangeable.  The other pre-populated items are changeable at compose-time.
 
[[File:MessageCompose4.png]]
 
[[File:MessageCompose4.png]]
 +
 +
When the user hits Send, this window will execute an API call behind the scenes.

Latest revision as of 16:51, 8 April 2014

Contents

Credentials

Provide appropriate credentials for the user who will be sending the message: MessageCompose1.png


Attachments, Prepopulation, Metadata

Provide any relevant additional parameters. If an attachment is to be sent, it must be specified here: MessageCompose2.png


Request and Response JSON

Sending this transaction consists of the following request JSON and response JSON and returns a token: MessageCompose3.png


Build URL

Use this token to construct a url in the following manner:

   https://{environment}/sso/messageCompose/{vendorId}/{token}

which for this example would look like this:

   https://updoxqa.com/sso/messageCompose/updox/611e840357c9dd58625436996cc2631910188c61

Note that as this token has already been used, browsing to this exact link will result in a 404 error.

Compose Message

Browsing to this url will show the following one-use-only Direct message compose screen. Note that the From address is the specified user's directAddress and is pre-populated and unchangeable. The other pre-populated items are changeable at compose-time. MessageCompose4.png

When the user hits Send, this window will execute an API call behind the scenes.