操作可能なユーザ権限：投稿権限、編集権限、一般権限、管理権限
ユーザ権限の詳細については「 契約内の5つのユーザ権限について 」をご参照ください。
Webhookは外部のシステムからTocaroのグループへメッセージを投稿するためのAPIです。
JSONペイロード形式でHTTPリクエストを送信することで、メッセージを投稿します。
Webhookを活用すると、以下のようなことを実現することができるようになります
- 監視システムのアラートをTocaroへ通知する
- スケジューラーに登録した予定をTocaroへ通知する
- 気になるニュース記事のURLをTocaroへ集める
Json Format
POSTメソッドのPayloadパラメタにJSONを含めて送信します。payloadのJSONにtextパラメタを追加しリクエストを叩くとすぐにグループへ投稿することが可能です。
payload={
"text": "This is sample message. link format is http://example.com",
"color": "info", // info, warning, danger, success
"attachments": [
{
"title": "This is sample title",
"value": "This is sample value"
},
{
"image_url": "https://dev.tocaro.im/assets/www/img_integration_inbound_webhook.png"
}
]
}
Curl Example
グループに投稿するためのCurlリクエストサンプルです。
curl -X POST -H 'Content-type: application/json' --data '{"text": "This is test message. ex link http://example.com.", "attachments": [ { "title": "This is sample title", "value": "This is sample value" } ] }' https://hooks.tocaro.im/integrations/inbound_webhook/xxxxxxxxxxxxxxxxxxxxxx
Webhookの詳細な仕様については「Webhookドキュメント」をご確認ください。