Hi, there.

 

Recently, I have prepared “Add-on XML (Service Task definition file)” for cooperation with several enterprise social networking tools in response to some requests.

In this post, it is with Typetalk.

 

TOC
1. Overview of linkage between Typetalk and Questetra
2. Settings on Typetalk
3. Settings on Questetra
4. Closing

 

1. Overview of linkage between Typetalk and Questetra

The flow of processing is like the following figure.
In the example flow, a result of an approval request on Questetra is posted to Typetalk as its content and the link to the details.

 

2. Settings on Typetalk

Regarding the authentication method, “Typetalk token” and OAuth2 is available. We are going to setup OAuth2 (Authorization Code) in this post.

* Incidentally, when you use “Typetalk token” the posts are from bot, and in OAuth2 method, the posts are from the authenticated user.
* Reference Typetalk API document: Authentication & Authorization

Define a bot along the following procedures, and obtain a URL including “Typetalk token”.

 

3. Settings on Questetra

Use the following Add-on.

* Although it is also available using “Throwing Message intermediate Event (HTTP)” in accordance with API definition, using Add-on is easier.

* See the following for the details of “Throwing Message Intermediate Event (HTTP)”
 M225: Auto Sending of HTTP Request with Business data Inserted

Download the Add-on file below and import it to Questetra App in reference to this page (M415).

 Typetalk Post Message (use API token)

Config items are as the following.

Config name Required Type
A: URL Yes Enter URL including “Typetalk token”
B: Select TEXT DATA for Post Messag Yes Select a String type Data Item (multiple lines) that is storing the text you want to post
X: Select TEXT DATA for Log Optional Specify a String type Data Item to store log output if needed

* If you set up the following in the text field of Data Item as the initial value, the wording to be posted will be prepared automatically.
(Substitute the part “XXX.questetra.net” with the value of your own environment.)

Your request has been approved. [Details] https://XXX.questetra.net/OR/ProcessInstance/listView?processInstanceId=#{processInstanceId}
 Otherwise, there is another method using “Service Task (Data assignment)” before the Add-on.
  Related document: M227: Auto Executing Data Binding, Arithmetic Operations

* See this document for the details of message formatting.

 

4. Closing

When you run it, it will be posted like the following.

Thus, you can insert a processing of posting to Typetalk into a business flow only with easy settings.

If you have any question, please feel free to Contact us.