Direct Posting Via Web Services

<< Click to Display Table of Contents >>

Navigation:  Message Retrieval Accounts > Reading/Receiving Messages >

Direct Posting Via Web Services

You can post messages to ThinkAutomation directly by calling the ThinkAutomation AddMessage web service. Messages added this way will be processed immediately by ThinkAutomation.

 

Click the Direct API option on the Ribbon bar.

 

Click the Accept Messages From Remote ThinkAutomation Clients & ThinkAutomation Web Services option to enable this option.

 

The AddMessage web service takes the following parameters:

 

webservices_addmessageg

 

Parameters:

 

UserName

Your ThinkAutomation user name. This is the same user name that you use to login to the ThinkAutomation Administrator.

Password

Your ThinkAutomation password. This can be passed as plain text or a base64 encoded MD5 Hash of the password.

AccountID

The Account ID of the ThinkAutomation Account that you want to use to process the message. The AccountID is shown on the Direct API pane of the Account Settings.

TriggerID

The Trigger ID of the ThinkAutomation Trigger within the Account that you want to execute. This can be passed as a blank string, in which case the first Trigger that matches the Trigger conditions for the message will be executed.

MimeText

The message contents. This is the content of the message. It can be just text or full mimetext with headers and attachments.

 

If a header 'Message-ID' is available in the mimetext then this will be used for the message-id, otherwise ThinkAutomation will assign the message a unique ID.

 

The AddMessage call will return 'OK' if the message was added successfully to the Edge Queue. Otherwise an error will be returned in the format 'Error:{message}'.

 

Errors returned will be:

Error:No Message Text

The MimeText parameter was blank.

Error:No AccountID Specified

You must provide the Account ID.

Error:Access Denied

The username/password specified was invalid.

Error:Account does not exist

No ThinkAutomation Account exists with the specified ID.

Error:Account not assigned to user

The Account ID exists but is not available to the user specified.

Error:Direct API not enabled for this account

The Direct API option has not been enabled for the specified account.

Error:Not configured from AddMessage

The web services could not read the ThinkAutomation settings from the registry. Usually an access issue.

Error:{other}

Runtime error occurred.

 

The web service option requires the ThinkAutomation Web Services to be available via an external URL. See: ThinkAutomation Web Services

ThinkAutomation © Parker Software 2016