Typetalk notifications

Typetalk is a fun and easy to use messaging tool focused on team-based communication.

By setting Typetalk as a notification channel, you can have alert information from hosts being monitored by Mackerel broadcasted to any chat room(s) you designate. You can also receive detailed information regarding important alerts in real-time.

Connecting to Typetalk

To configure connection to Typetalk, add Typetalk as a new channel in the Channels page.

For sending notifications to Typetalk, use Typetalk’s Bot API function.

To successfully register Typetalk as a notification channel, it will be necessary to obtain Typetalk API’s URL token. The following will explain how to get the token.

Obtaining the token

Log into Typetalk and click the Edit button in the topic in which you would like to receive notifications.

f:id:mackerelio:20141210105856p:plain

The Edit button is located in the upper right corner of this screen.

f:id:mackerelio:20141204180748p:plain

The Edit button looks like this.

Next, in the Edit Topic screen, click on the “Bots” tab, click “Add bot” and register the Mackerel notification bot.

f:id:mackerelio:20141210110125p:plain

Next a screen will be displayed where you can enter the new bot’s information. Enter any ID and Full Name, make sure “topic.post” under API Scope is checked, and then click “Create”.

f:id:mackerelio:20141210110323p:plain

The token should now be displayed at the bottom portion of the screen. Copy the “Get or post messages URL” and paste it back in Mackerel to complete registration.

f:id:mackerelio:20141210110442p:plain

Optional features: about Prefix

When using Typetalk to receive notifications, it is possible to set custom prefixes which respond to the status of alerts. (If this has not been configured, no prefix will appear with alerts.)

Configure prefixes for each type of status such as happy and sad emojis, or anything that you choose.

f:id:mackerelio:20141210110603p:plain

For example if you have configured your Prefix settings as shown here…

f:id:mackerelio:20141210110619p:plain

Your notifications will look like this!

-

If you have any questions please contact our support team at support@mackerel.io