Contents

Incoming Webhooks

Incoming Webhooks は、外部にあるボット、アプリ、サービスが Typetalk の特定トピックにメッセージを投稿する機能です。

メッセージ制限

メッセージの文字数は最大 4,000 文字です。長いメッセージは分割することを検討してください。投稿時に replyTo パラメーターに親メッセージ ID を指定することで、メッセージをスレッドにまとめることもできます。

Incoming Webhook 連携をする

  1. Incoming Webhook を使ってメッセージを投稿したいトピックの右上にある [•••] を選択し、「トピック設定」を開きます。
  2. 「ボット」タブを開き、「新規作成」ボタンを選択します。
  3. 「ボット ID」「ボット名」を入力し、「作成」ボタンを選択します。

投稿する:

  • HTTP ヘッダー X-TYPETALK-TOKEN にボットの「Typetalk Token」を貼り付けます。
  • 「メッセージの取得と投稿の URL」に HTTP POST リクエストを送信します。

Node.js 例:

import * as https from 'https'

const payload = JSON.stringify({
  message: 'Message you want to post',
})
const options = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-TYPETALK-TOKEN': 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
  },
}
const webhookurl: 'https://typetalk.com/api/v1/topics/nnnnn'
const request = https.request(webhookUrl, options)
request.write(payload)
request.end()

詳細は メッセージを投稿する API を参照ください。

Incoming Webhook を削除する

  1. Incoming Webhook を削除したいトピックの右上にある [•••] を選択し、「トピック設定」を開きます。
  2. 「ボット」タブを開き、「新規作成」ボタンを選択します。
  3. 「このボットを完全に削除する」を選択します。