ヤマト運輸の送り状番号から現在の配送状況を確認し、状況が変わったときに指定チャンネルへ知らせる機能です。追跡、通知の登録・変更・解除・一覧表示を1つのコマンドで行えます。
使い方
| 形式 |
内容 |
/yamato action:現在の配送状況を追跡 tracking_number:<送り状番号> |
現在の配送状況を確認 |
/yamato action:通知を登録・変更 tracking_number:<送り状番号> channel:<通知先> |
状況変化の通知を登録または通知先を変更 |
/yamato action:通知を解除 tracking_number:<送り状番号> |
通知を解除 |
/yamato action:通知一覧 |
サーバー内の登録を一覧表示 |
引数
| 引数 |
必須 |
説明 |
action |
はい |
追跡、通知を登録・変更、通知を解除、通知一覧から選択 |
tracking_number |
操作による |
ハイフンを除いて11桁または12桁の送り状番号 |
channel |
いいえ |
通知先。省略時はコマンドを実行したチャンネル |
応答・返り値
- 現在の配送状況と更新日
- 通知登録・変更・解除の結果
- サーバー内の通知登録一覧
- 状況変化時の通知と前回からの変化
- 配送完了の最終通知
必要条件・権限
- 現在の配送状況を追跡するだけなら、特別な権限は必要ありません。
- 通知の登録・変更・解除・一覧表示には「サーバーの管理」権限が必要です。
- botには通知先で「チャンネルを見る」「メッセージを送信」「埋め込みリンク」の権限が必要です。
制限・仕様
- 配送状況が変わったときだけ通知します。
- 配送完了を通知した後は、通知登録を自動で解除します。
- 追跡結果と設定結果は実行者本人だけに表示します。
- チャンネル通知では、送り状番号の中央4桁を伏せます。
- 1サーバーにつき50件まで登録できます。
使用例
/yamato action:現在の配送状況を追跡 tracking_number:1234-5678-9012
/yamato action:通知を登録・変更 tracking_number:1234-5678-9012 channel:#配送通知
/yamato action:通知を解除 tracking_number:1234-5678-9012
/yamato action:通知一覧
エラー・注意点
- 発送直後など、追跡情報がまだ反映されていない場合があります。
- 送り状番号を確認しても情報が出ない場合は、時間をおいて再度お試しください。
- 荷物の所有者や関係者の許可を得た送り状番号だけを登録してください。
コメント