Tools
WhatsAppメッセージを送信
WhatsAppは、個人と企業間の安全で信頼性の高いコミュニケーションを可能にする、世界的に人気のあるメッセージングプラットフォームです。
WhatsApp Business APIは組織に以下の強力な機能を提供します:
- 顧客とのエンゲージメント: パーソナライズされたメッセージ、通知、更新を顧客が好むメッセージングアプリに直接送信
- 会話の自動化: 一般的な問い合わせに対するインタラクティブなチャットボットと自動応答システムの作成
- サポートの強化: リッチメディアをサポートする使い慣れたインターフェースを通じてリアルタイムの顧客サービスを提供
- コンバージョンの促進: 安全でコンプライアンスに準拠した環境で顧客との取引やフォローアップを促進
Mandalaでは、WhatsApp統合によりエージェントがワークフローの一部としてこれらのメッセージング機能を活用できるようになります。これにより、予約リマインダー、認証コード、アラート、インタラクティブな会話など、高度な顧客エンゲージメントシナリオが可能になります。この統合はAIワークフローと顧客コミュニケーションチャネルの間のギャップを埋め、エージェントがタイムリーで関連性の高い情報をユーザーのモバイルデバイスに直接配信できるようにします。MandalaとWhatsAppを接続することで、顧客が好むメッセージングプラットフォームを通じて顧客とエンゲージする知的なエージェントを構築し、ユーザー体験を向上させながら定型的なメッセージングタスクを自動化できます。
使用方法
WhatsAppをワークフローに統合します。メッセージを送信できます。
ツール
whatsapp_send_message
WhatsAppメッセージを送信する
入力
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
phoneNumber | string | はい | 国コード付きの受信者電話番号 |
phoneNumberId | string | はい | WhatsAppビジネス電話番号ID |
accessToken | string | はい | WhatsApp Business API アクセストークン({{WHATSAPP_ACCESS_TOKEN}} のような環境変数参照に対応) |
mode | string | いいえ | モード:text, interactive, image, video, audio, document, sticker, location, contacts, reaction, raw(互換:media + media.type) |
message | string | いいえ | メッセージ本文(mode=text の場合のみ必須) |
media | object | いいえ | image/video/audio/document/sticker 用(link 必須、caption/filename は任意) |
interactive | object | いいえ | インタラクティブペイロード(リスト/ボタン) |
location | object | いいえ | 位置情報(latitude, longitude, 任意で name, address) |
contacts | object | いいえ | 連絡先(Cloud API の contacts 配列) |
reaction | object | いいえ | リアクション(message_id, emoji) |
rawPayload | object | いいえ | WhatsApp Cloud API の生ペイロード送信(上級者向け) |
出力
| パラメータ | 型 | 説明 |
|---|---|---|
success | boolean | 送信の成功ステータス |
messageId | string | 一意のWhatsAppメッセージID(取得できる場合) |
httpStatus | number | WhatsApp/Graph API からの HTTP ステータスコード |
error | string | エラーメッセージ(該当する場合) |
rawResponse | json | API の完全なレスポンス(デバッグ向け) |
メディアに関する注意
- メディアモード(
image/video/audio/document/sticker)では、media.linkは直接ダウンロードできる公開ファイルURLである必要があります(例:https://.../file.mp4がバイト列を返す)。 - YouTubeリンクは直接ファイルではないため、テキストとして送信してください。
- ステッカーは WebP(
image/webp)である必要があります。 - アップロードで “File too large” が出る場合、ファイルサイズ/ビットレートを下げるか、リンクをテキストで送ってください。
注意事項
- カテゴリー:
tools - タイプ:
whatsapp