シェア:
){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を使ってリクエストを送信します。
To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.
この投稿では、送信 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を使って何を作っているのか、とても興味があります！