通知
docStatic はワークフロー通知の送信に GitHub Actions を使用しています。レビューと翻訳の通知例は .github/workflows/ フォルダに含まれています。これらを有効にするには、GitHub での設定が必要です。また、独自のカスタム通知を開発するための出発点としても使用できます。
メール
email-review.yml と email-translate.yml アクションは、メインブランチの Markdown ファイルにレビューまたは翻訳タグが設定されたときにトリガーされます。使用するには、以下のシークレットをリポジトリに追加してください:
SMTP_SERVERSMTP_PORTSMTP_USERNAMESMTP_PASSWORDNOTIFY_EMAIL_TONOTIFY_EMAIL_FROM
この情報はメールプロバイダーから取得できます。たとえば:
- iCloud(アプリ専用パスワードが必要です)。
- Outlook
Slack
slack-review.yml と slack-translate.yml アクションはメールバージョンと同じトリガーを使用します。使用するには、Slack の Webhook URL を SLACK_WEBHOOK_URL という名前のシークレットとして追加してください。詳細については、Slack ドキュメントの Sending messages using incoming webhooks を参照してください。
Teams
teams-review.yml と teams-translate.yml アクションは Slack バージョンと同様に動作します。Microsoft は 2025年12月から Teams の Incoming Webhooks アプリを廃止しますが、現在のところ Adaptive Cards をワークフローに送信するための公開された GitHub メソッドは存在しません。回避策として curl を使用します:
- name: Send Teams test notification
run: |
curl --ssl-no-revoke -X POST \
--location ${{ secrets.MS_TEAMS_HTTP_POST_URL }} \
--header 'Content-Type: application/json' \
--data '{ \
"type": "message", \
"attachments": [{ \
"contentType": "application/vnd.microsoft.card.adaptive", \
"content": { \
"$schema": "http://adaptivecards.io/schemas/adaptive-card.json", \
"type": "AdaptiveCard", \
"version": "1.3", \
"body": [ { \
"type": "TextBlock", \
"text": "This is a test notification from GitHub Actions (Teams).", \
"wrap": true }]}}]}'
- Teams で、メッセージを送信したいチャンネルに移動し、省略記号(…)をクリックして Workflows を選択します。
- Manage をクリックします。
- New Flow をクリックします。
- Webhook のテンプレートを検索して Send webhook alerts to a channel をクリックします。
- (オプション)Flow name を編集します。
- サインインして Next をクリックします。
- リストから Team と Channel を選択して Create Flow をクリックします。
MS_TEAMS_HTTP_POST_URLをコピーして GitHub のシークレットとして保存し、Done をクリックします。
テスト通知の GitHub Action を使用して接続をテストできます。