シェア:
){kind=small}
Benjamin AronovはVonageの開発者支援者です。彼はRuby on Railsのバックグラウンドを持つ実績のあるコミュニティ・ビルダーです。Benjaminは故郷であるテルアビブのビーチを楽しんでいる。テルアビブを拠点に、世界最高のスタートアップの創設者たちと出会い、学ぶことができる。技術以外では、完璧なパン・オ・ショコラを求めて世界中を旅するのが好き。
AI Studioアドバンス：Airtableからリアルタイムアラートをトリガーする
所要時間：1 分
AI Studioの会話型AIエージェントは、ユーザーのセルフサービス対話を作成することで、カスタマーエクスペリエンスの向上を支援します。ドラッグ＆ドロップのプラットフォームで、ユーザーのリクエストに応えるエージェントを超高速で構築できます。ちょっとした工夫で、さらに多くのことができます！
この この前回の記事では、AI Studioとデータベースを接続し、あらゆるデータを保存できる完全なアプリケーションを作成する方法を紹介しました。しかし、その記事では、アプリケーションはユーザーに応答するだけだったので、顧客が会話のきっかけを作る必要がありました。会話を開始したい場合はどうすればいいでしょうか？例えば、緊急アラートやタイムリーなプロモーション通知を送りたい場合などです。AI Studioではこのようなことも可能です。 アウトバウンドイベント。
この投稿ではでは、もう一つのローコードツールであるPostmanを使用して、AirtableデータベースからAI Studioにリアルタイムアラートをトリガーする方法を紹介します。
ヤラ、行こう！
Vonage アカウントt - AI Studioを使用するには、Vonage Developer Accountが必要です。詳細は下記をご覧ください。
Airtableアカウント- サインアップ こちら.バックエンドデータベースとしてAirtableを使用します。
ポストマン アカウント- サインアップ こちら.このチュートリアルの上級編では、Postmanを使ってリクエストを送信します。
この投稿では、送信 SMS セッションのトリガー方法を説明します。ロジックはWhatsAppと同じです。 WhatsAppビジネスアカウントが必要です。
以下の指示に従ってエージェントをセットアップしてください。エージェントは以下のような構成になっているはずです：
タイプ:SMS
テンプレート:ゼロから始める
イベント:アウトバウンド
まずはSend Message Nodeを1つ作る。このノードには、"Hey! $currentName?AI Studioです。そして $currentNameを追加する必要があります。 カスタムパラメータ.
または、このスターターエージェントをダウンロードしてインポートすることもできます。方法は こちら.
このコピーを作成する エアテーブル・ベース.
列にテスト用の電話番号を追加する必要がある。 PHONE_NUMBERカラムに追加する必要がある。Postmanがデータベースを正しく反復していることを確認するために、Big BirdとKermitの両方に自分の番号を渡すことをお勧めする。国番号と市外局番を必ず入れてください。ただし、国番号の前に+は入れないでください。
Postmanを使ってSMSを送信する。
まず ワークスペースをを作る必要がある。ワークスペースでは コレクションを作成することができます。これらの 変数を使うことで、最初の GET リクエストから 2 番目の POST リクエストにデータを渡すことができます。
連絡先を取得するには、Airtable DBにGETリクエストを送信し、認証のためにヘッダーにAccess Tokenを渡す必要があります。
Airtable で GET リクエストを生成する方法については、以下を参照してください。 こちら.リクエストは以下のようになります。 baseIdbaseId}プレースホルダの代わりに
[https://api.airtable.com/v0/{baseId}/Customers](https://api.airtable.com/v0/%7BbaseId%7D/Customers)
また、認証のためにPersonal Access Tokenを提供する必要があります。パーソナル・アクセストークンの生成方法と使用方法については こちら.必ずスコープを指定してください： data.records:readそして data.records:write.このトークンは一度しか見ることができないので、後でコピー＆ペーストできるように安全な場所に保存しておくこと。
あなたのポストマンは次のようになるはずだ：
postman-retrieve-contacts-example.png
送信をクリックすると、テーブル内のすべての顧客に関するレスポンスが返ってくるはずです。これで、Postmanのロジックを少し追加して、顧客を変数に格納することができます。
Testsタブで、Javascriptを少し追加する：
var jsonData = JSON.parse(responseBody);
var bodyData = jsonData.records;
pm.variables.set("retrievedRecords", bodyData);これでGETレスポンスのデータにアクセスできるようになります。 “retrievedRecords”.以下の行を追加して console.log(pm.variables);を追加して コンソール.そこには retrievedRecordsキー：
postman-console-inspector
これで pm.variablesに格納されている情報を使用して繰り返し処理を行い、各連絡先に対してAI StudioにPOSTリクエストを送信します。
まず、コレクションに新しいリクエストを追加します。ここでは "Trigger Promotional Message "と呼び、POSTリクエストに変更します。しかし、リクエストをどこに送ればいいのでしょうか？
クールな点は、すべてのアウトバウンドエージェントが同じエンドポイントによってトリガーされることです。あなたは X-Vgai-Keyと適切なパラメータを渡すだけです。これについては こちら.
キャンバスの右上にあるX-Vgai-Keyをクリックしてください。ユーザー」アイコンをクリックし、「APIキーを生成」をクリックします。
ヘッダーに X-Vgai-Keyヘッダーに追加した後、AI Studioに適切なパラメータを提供する必要があります。ボディには、次のような生のJSを渡します。テキストではなく、JSONとして渡すようにしてください。
{
"to": {{currentNumber}},
"agent_id": "641c0ef9056e5bc7635cddf4",
"channel": "sms",
"session_parameters": [
{
"name": "currentName",
"value": {{currentName}}
}
]
}しかし、POSTリクエストで渡すcurrentNameとcurrentNumberはどうやって取得するのだろうか？Postmanの プレリクエストスクリプトを使用して、retrievedRecordsを繰り返し処理し、各連絡先の情報にアクセスしてPOSTリクエストを行う必要があります。こんな感じです：
const records = pm.variables.get('retrievedRecords');
pm.variables.set('currentRecord', records.shift());
const currentRecord = pm.variables.get('currentRecord');
pm.variables.set('currentName', JSON.stringify(currentRecord.fields.NAME));
pm.variables.set('currentNumber', JSON.stringify(currentRecord.fields.PHONE_NUMBER));
const currentName = pm.variables.get("currentName");
const currentNumber = pm.variables.get("currentNumber");
if (records.length > 0){
postman.setNextRequest('Trigger Promotional Message');
} else {
postman.setNextRequest(null);
}
そして今 コレクションを実行するを実行すると、Airtableデータベースに追加した各テスト番号にテキストメッセージが届くはずです。成功です！
AI Studio、Airtable、Postmanを使って、マウスをクリックするだけでSMSでデータを保存・送信できる完全なアプリケーションを作成しました。このアプリケーションは様々な方法で拡張することができます。まず、AI Studioで完全なユーザーフローを構築します。次に、Airtable に保存したいすべての情報を追加します。AI Studioでインバウンドエージェントを使用し、顧客が最初にコンタクトしてきたときに、顧客からすべての情報を収集することができます。最後に、PostmanのCollection Runnerを使用して、あらかじめ決められた時間にメッセージを送信するスケジュール実行を設定することができます。
しかもロー・コードですべて可能だ！なんてクールなんだ
このチュートリアルが好きな方、嫌いな方、ぜひ教えてください！私を ツイッターまたは VonageコミュニティSlack(AI Studioのチャンネルもあります）。あなたがLow Codeを使って何を作っているのか、とても興味があります！