Hi there.

Recently, I have prepared add-on XML Service Task definition files for cooperation with several enterprise social networking tools in response to some requests.

In this post I will introduce one for use with Typetalk.

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

1. Overview of linkage between Typetalk and Questetra

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

2. Settings on Typetalk

Regarding the authentication method, a “Typetalk token” or OAuth2 can be used. We are going to set up OAuth2 (Authorization Code) in this post.

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

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

3. Settings on Questetra

Use the following add-on.

* Although it is also possible using a Throwing Message intermediate Event (HTTP) in accordance with the API definition, using the add-on is easier.

* See the following for the details of the 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 follows.

Config nameRequiredType
A: URLYesEnter URL including the Typetalk token
B: Select TEXT DATA for Post MessageYesSelect a String-type Data Item (multiple lines) that is storing the text you want to post
X: Select TEXT DATA for LogOptionalSpecify a String-type Data Item to store the log output if needed

* If you set up the following in the text field of a 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/#{processInstanceId}/view

Otherwise, there is another method using an [Update Data] before the add-on.
Related document: M227: Auto Executing Data Binding, Arithmetic Operations

* See this document for the details of message formatting.

4. Summary

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

Thus, you can embed the process of posting to Typetalk into a business flow just using simple settings.

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

%d