Yammer は、社員が部門、場所、ビジネスアプリケーションを横断しコラボレーションするのを促進するプライベートソーシャルネットワークです。Mackerel のチャンネル機能と連携することにより、Yammer のグループへアラートメッセージを通知し、グループメンバーでアラート内容を容易に共有出来ます。
Yammerへのアラート通知を追加する
通知の設定は、チャンネルページのYammerフォームから、新しいチャンネルを追加してください。
Access Token と Group ID の取得方法について
チャンネルの登録には、Access Token と Group ID の設定が必要です。以下の方法にてこれらの値を取得出来ます。
以下、アプリケーション登録時のリダイレクトURL(Expected redirect) redirect_uri
が https://localhost
であり、また 2) にて取得した Client ID
と Client secret
が mackerel_client
と mackerel_secret
、そして 3) にて取得した code
が mackerel_code
の場合を想定した Access Token 取得例を紹介します。ご利用の環境に合わせ、例示したアクセス先URLなどを適時変更してください。
1) Mackerel と連携するためのアプリケーションの登録を アプリケーション登録ページより行ってください。 アプリケーション登録方法は、公式ページを参考にしてください。
2) 登録したアプリケーションの Client ID
と Client secret
を取得してください。
アプリケーション登録ページより、登録したアプリケーションを選択してください。画面上の Client ID
と Client secret
項目に記載されています。
3) 登録したアプリケーションの code
を取得してください。
下記URLに client_id
、また redirect_uri
のクエリを設定してアクセスすることにより Code が取得出来ます。
https://www.yammer.com/oauth2/authorize?client_id=mackerel_client&response_type=code&redirect_uri=https%3A%2F%2Flocalhost
ブラウザーで適切なURLにアクセスした場合、アプリケーション認証画面へ移行します。承認(Allow)ボタンをクリックしてください。
承認後、ブラウザURL表示部分を参照して code
クエリ値から code
を取得できます。
4) 登録したアプリケーションの Access Token を取得してください
下記URLに client_id
、 client_secret
、 code
のクエリを設定してアクセスすることにより Access Token が取得出来ます。
https://www.yammer.com/oauth2/access_token.json?client_id=mackerel_client&client_secret=mackerel_secret&code=mackerel_code
返却されるJSONに含まれる "token" キーの値が Access Token
です。
Group ID の取得方法について
下記方法にて Group ID の取得が出来ます。
1) 連携時に投稿予定のグループページにアクセスします。
2) ブラウザー上のURL項目に表示された feedId
クエリ値を取得します
feedId
の値が Group ID
となります。
連携時のグループへのメッセージ投稿回数について
Yammer は現時点(ヘルプページ最終更新時)では、30秒間で可能なメッセージAPIコール回数が10回と制限されています。そのため30秒間で制限回数を超えるアラートが起こった場合、その超過期間中に超過分のアラートメッセージはグループへ投稿されません。この点をご留意ください。