Skip to main content

​
Twilio

ShanoneのTwilio連携は、SMS/WhatsAppメッセージングに加え、電話番号のプロビジョニング、カンファレンスコール、そして他の連携ではあまり扱われない使用量・レポート系ツールまで含む45個のツールをエージェントに提供します。

​
はじめに

1

Twilioの認証情報を取得する

Twilio ConsoleのダッシュボードからAccount SIDとAuth Tokenを取得します。
2

APIキーで接続する

Shanoneダッシュボードの連携 → TwilioでAccount SIDとAuth Tokenの両方を入力します — Twilioはどちらか片方だけでは認証できないため、両方の設定が必須です。
3

リクエストを再実行する

接続が完了すると、twilio_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはTwilio向けに45個のツールを、以下のカテゴリに整理して提供しています。
twilio_search_available_phone_numbers, twilio_purchase_phone_number, twilio_get_phone_number, twilio_update_phone_number, twilio_release_phone_number
twilio_list_messaging_services, twilio_get_messaging_service, twilio_create_messaging_service, twilio_delete_messaging_service
twilio_send_whatsapp_message, twilio_send_whatsapp_media, twilio_send_whatsapp_template, twilio_list_whatsapp_messages
twilio_list_content_templates, twilio_get_content_template, twilio_send_message_with_template
twilio_list_message_media, twilio_get_message_media, twilio_delete_message_media
twilio_list_conferences, twilio_get_conference, twilio_create_conference_participant, twilio_list_conference_participants, twilio_get_conference_participant, twilio_update_conference_participant, twilio_remove_conference_participant
twilio_get_recording, twilio_list_call_recordings, twilio_list_conference_recordings, twilio_list_transcriptions, twilio_get_transcription, twilio_list_recording_transcriptions, twilio_delete_transcription
twilio_get_call_feedback, twilio_create_call_feedback
twilio_list_addresses, twilio_create_address, twilio_delete_address
twilio_list_api_keys, twilio_create_api_key, twilio_get_api_key, twilio_delete_api_key
twilio_list_usage_records, twilio_list_usage_records_daily, twilio_list_usage_records_monthly

​
よくあるユースケース

予約リマインダー

他のツールから取得した予約情報に基づき、SMSやWhatsAppでリマインダーを送信する

WhatsAppでのカスタマーサポート

承認済みのメッセージテンプレートを使ってWhatsApp上で顧客に返信する

電話番号のオンデマンド調達

サポート窓口やキャンペーン用に新しい番号を検索・購入・設定する

使用量・コストの監視

日次/月次の使用量レコードを取得し、サービス横断で支出を追跡する

​
トラブルシューティング

TwilioはAccount SIDとAuth Tokenの両方の設定が必須です — Shanoneの接続チェックは片方のみの設定を「未接続」として扱うため、連携画面で両方のフィールドを確認してください。
WhatsAppテンプレートメッセージは、Twilioのコンテンツテンプレートカタログで承認済みのテンプレートを参照する必要があります。まずtwilio_list_content_templatesで有効な承認済みテンプレートSIDを確認してください。
先にtwilio_search_available_phone_numbersを国番号・エリアコード/パターンを指定して実行してください — 番号の在庫は地域や番号種別(ローカル/フリーダイヤル/モバイル)によって大きく異なります。
録音・文字起こしは特定の通話またはカンファレンスSIDに紐づいています。グローバルな一覧を期待するのではなく、正しい通話/カンファレンスSIDを指定してtwilio_list_call_recordingsやtwilio_list_conference_recordingsを使用してください。