feishu-voice-sender

Feishu Voice Sender

Feishu 音声メッセージ送信ツール — MP3 音声をボイスメッセージ形式で Feishu のチャットに送信します。

使用する場面

• MP3 音声を（ファイル添付ではなく）ボイスメッセージ形式で Feishu に送信する必要があるとき
• グループチャットまたは個人チャットに音声通知を送信する必要があるとき
• WeChat のボイスメッセージのように（タップで直接再生）ユーザー体験を提供したいとき
• 自動化フローと連携して音声メッセージを送信する必要があるとき

このスキルを使用しない場合

• 動画メッセージを送信する必要がある → feishu-video-sender を使用
• 通常のテキストまたはリッチテキストメッセージを送信する必要がある → feishu-group-welcome または標準の message ツールを使用
• 音声ファイルを送信する必要がある（ユーザーにダウンロードして再生してもらう）→ file メッセージタイプを直接使用

典型的なトリガーフレーズ

• 「グループにボイスメッセージを送信して」
• 「Send this MP3 as a voice message in Feishu」
• 「この音声を Feishu のボイスメッセージに変換して」
• 「音声通知を一斉送信して」

ワークフロー

1. 入力を確認: 音声ファイルのパス（MP3）、対象 ID（グループ ID oc_xxx またはユーザー ID ou_xxx）、送信タイプ（chat/user）を確認します
2. 環境を確認: システムに ffmpeg がインストールされていること、Python に requests がインストールされていることを確認します
3. フォーマットを変換: MP3 → AMR（Feishu の音声フォーマット）
4. 音声をアップロード: Feishu にアップロードして file_key を取得します
5. ボイスメッセージを送信: msg_type: "voice" を使用して送信します

   # 发送到群聊
   python3 skills/feishu-voice-sender/feishu_voice_sender.py /tmp/voice.mp3 oc_xxx --chat
   
   # 发送到私聊
   python3 skills/feishu-voice-sender/feishu_voice_sender.py /tmp/voice.mp3 ou_xxx --user
   

6. 配信を確認: メッセージ送信結果を返します

ガードレール

• フォーマット変換のために ffmpeg をインストールする必要があります
• ボイスメッセージと音声ファイルの違いは msg_type にあります。voice は直接再生され、file はダウンロードが必要です
• Feishu アプリにメッセージ送信の権限があることを確認してください

Python API

from skills.feishu_voice_sender import send_voice_message

# 发送到群聊
result = send_voice_message(
    audio_path="/tmp/voice.mp3",
    target_id="oc_xxx",
    target_type="chat"
)

# 发送到私聊
result = send_voice_message(
    audio_path="/tmp/voice.mp3",
    target_id="ou_xxx",
    target_type="user"
)

ボイスメッセージとファイルの比較

方式	メッセージタイプ	ユーザー体験
ボイスメッセージ	msg_type: "voice"	✅ タップで再生、WeChat のボイスメッセージに類似
音声ファイル	msg_type: "file"	❌ ダウンロード後に再生

関連スキル

• feishu-video-sender - Feishu 動画メッセージを送信（プレーヤー付き）
• feishu-group-welcome - グループチャットのウェルカムメッセージ管理

概要

UniqueClub による Feishu 自動化ツールキットの一部です。 🌐 https://uniqueclub.ai