一致するガイドが見つかりませんでした。ウィジェット、API、音声、請求、Webhook、WordPress、SendPulse、スケジュールなどの短いキーワードを試してください。
スクリーンショット注記: このマニュアルの各画像は、デモワークスペースを使って実際の sem.chat アプリから取得したものです。公開前に、機密性の高いアカウント情報、顧客データ、API キー、支払い情報、非公開の会話内容をマスクしています。
1まず、公開サイトまたはアプリからサインアップまたはサインインします。
2通知や請求メッセージに頼る前に、電子メール アドレスを確認してください。
3ダッシュボードを開く前に、オンボーディングを使用して最初のボットを作成します。
1クイック アクションを使用して、ボットの作成、ボットの表示、分析を開いたり、請求を管理したりできます。
2変更を加える前に、アクティブなボット、conversations、音声時間、満足度を確認してください。
3セットアップ テストのたびに、最近のアクティビティを確認してください。
最初の打ち上げ
サインアップしてトライアルを開始し、ダッシュボードを理解する
これの目的: このワークフローは、まったく新しいワークスペースの場合、または sem.chat を使用したことがないチームメイトをオンボーディングする場合に使用します。
始める前に- 確認メールと請求メールを受信できるビジネスメールを使用してください。
- チームの他のメンバーを招待する前に、ワークスペースを誰が所有するかを決定してください。
- ウィジェットをインストールできるように、安全なテスト Web サイトまたはステージング ページを用意しておきます。
1
アプリのサインアップページを開く
Web サイトの [サインイン/サインアップ] ボタンから app.sem.chat/auth に移動します。
期待される結果: 認証ページには、サインインとアカウント作成のオプションが表示されます。
2
アカウントを作成する
ビジネス用電子メールを入力し、パスワードを作成し、サインアップ フォームを送信します。
期待される結果: アカウントが受け入れられた後、アプリは検証を要求するか、オンボーディングに移行します。
3
メールを確認する
確認メールを開いて確認リンクをクリックします。
期待される結果: アカウントは、請求、招待、レポート、および警告メッセージを受信できます。
4
完全なオンボーディング
ビジネス名を入力し、アシスタントの目標を説明し、開始色を選択して、最初のボットを作成します。
期待される結果: ワークスペースが開き、ボットのドラフトとアクティブな試用版の状態が表示されます。
5
概要を開く
左側のサイドバーで「概要」をクリックします。
期待される結果: ダッシュボードには、usage カード、クイック アクション、および最近のアクティビティが表示されます。
6
次のアクションを選択してください
セットアップには [新しいボットの作成] を、管理には [すべてのボットの表示] を、パフォーマンスには [分析] を、プランの制限には [請求] を使用します。
期待される結果: ワークスペースの状態に基づいて、どこから続行するかがわかります。
テスト方法: プライベート テスト ボットを 1 つ作成し、チームメイトを招待する前にテスト メッセージを送信します。テスト後に概要アクティビティが変更されたことを確認します。
| 問題 | 修正 |
|---|
| 認証メールが届かない | スパムをチェックし、電子メールのスペルを確認してから、別の確認電子メールを要求します。 |
| 請求時にダッシュボードが開きます | ワークスペースにはアクティブなトライアルまたはプランが必要な場合があります。トライアルを開始するか、セットアップ前に正しいプランを選択してください。 |
| チームメイトがワークスペースにアクセスできない | 所有者のログインを共有する代わりに、[設定]、[チーム] から招待します。 |
次に何をすべきか: 最初のボットを作成し、非公開でテストしてから、ステージング ページにウィジェットをインストールします。
プライベート打ち上げテスト
公開前に最初のプライベート ボット テストを作成する
これの目的: これを使用して、顧客にアシスタントが表示される前に、アカウント、ボット、ウィジェット、履歴追跡を確認します。
始める前に- お客様からの質問のサンプルを 1 つ用意してください。
- ステージング ページまたはローカル HTML テスト ページを準備します。
- 最初のテストでは実際の顧客データを使用しないでください。
1
My Bots を開く
サイドバーの My Bots をクリックするか、「概要からすべてのボットを表示」を使用します。
期待される結果: オンボーディング中に作成されたボット、または [新しいボット] ボタンを使用した空の状態を確認できます。
2
ボットビルダーを開く
[新しいボット] をクリックするか、既存のボットで [編集] をクリックします。
期待される結果: Bot Builder は、基本、ウィジェット、ナレッジ、音声、および統合コントロールで開きます。
3
ボットを一度保存します
必要なボット名と最初のメッセージを入力し、[保存] をクリックします。
期待される結果: ボットは有効な ID を受け取り、埋め込みコードを生成できます。
4
プライベートでプレビューする
プレビュー パネルを使用して、サンプルの質問を質問します。
期待される結果: 答えはあなたの指示と一致するか、どのような知識が欠けているかを明らかにする必要があります。
5
ステージング上にインストールする
[埋め込み] を開き、HTML スニペットをコピーし、ステージング ページの終了 body タグの前に貼り付けます。
期待される結果: ウィジェットはデスクトップとモバイルの設定済みコーナーに表示されます。
6
追跡を確認する
テスト会話の後、受信箱または Chat History を開きます。
期待される結果: テスト会話が正しいボット、チャネル、メッセージ履歴とともに表示されます。
テスト方法: 音声が有効になっている場合は、テキスト メッセージを 1 つ送信し、音声テストを 1 つ送信します。両方が Chat History に表示されることを確認します。
| 問題 | 修正 |
|---|
| 埋め込みコードは使用できません | まずボットを保存します。音声同期がまだ保留中の場合は、同期を待つか、必須フィールドの入力後に再度保存してください。 |
| ウィジェットに間違ったボットが表示される | スニペットの data-bot-id が埋め込みモーダルのボット ID と一致することを確認します。 |
| 履歴に会話が表示されない | Chat History を更新し、ボットがアクティブであることを確認し、古いページではなく、インストールされたウィジェットでテストが行われたことを確認します。 |
次に何をすべきか: Bot Builder のセットアップと知識トレーニングに進みます。
1新しいボットをクリックして新しいアシスタントを開始します。
2各ボット カードで [編集]、[埋め込み]、[転送]、[アクティブ化]、または [削除] を使用します。
3テストする前に、アクティブ状態と最終更新時刻を確認してください。
1ボット名、アバター、最初のメッセージ、システム指示を入力します。
2公開前にプレビューを使用してテストします。
3埋め込みコードをコピーする前に、保存して同期してください。
ボットの作成
My Bots から新しいボットを作成します
これの目的: 新しいブランド、Web サイト、サポート キュー、またはキャンペーンに独自のアシスタントが必要な場合は、このワークフローを使用します。
始める前に- ボット名、目標、最初のメッセージ、および 2 つまたは 3 つのサンプル質問を準備します。
- コンテンツをインポートする予定がある場合は、公開 Web サイト URL を収集します。
- 必要なボットと音声/アバター機能の数がプランで許可されていることを確認してください。
1
My Bots を開く
サイドバーの「My Bots」をクリックします。
期待される結果: 既存のボットと [新しいボット] ボタンが表示されます。
2
「新規ボット」をクリックします
My Bots ページから新しいボットを開始します。
期待される結果: Bot Builder はドラフト アシスタントで開きます。
3
ボット ID を設定する
ボット名を入力し、アバターをアップロードまたは選択し、訪問者に表示される最初のメッセージを作成します。
期待される結果: プレビュー パネルには、アシスタントの名前、アバター、挨拶が反映されます。
4
システム命令を書く
ボットが何をすべきか、どのように話すべきか、何を避けるべきか、いつ人間の助けを求めるべきかを説明します。
期待される結果: 知識が追加される前に、アシスタントには明確な行動ルールがあります。
5
基礎知識を追加する
重要な会社、製品、サポート、価格、連絡先情報をナレッジエリアに貼り付けます。
期待される結果: ボットは、Web サイトのインポートをまだ必要とせずに、一般的な質問に答えることができます。
6
ボットを保存する
[保存] をクリックし、保存または同期の確認を待ちます。
期待される結果: ボットには安定した ID があり、プレビューをテストでき、埋め込みオプションが利用可能になります。
7
結果をプレビューする
プレビューで用意されたサンプルの質問をします。
期待される結果: 回答は指示に従い、入力した知識を使用する必要があります。
8
準備ができた場合にのみアクティブ化する
プライベート テストに合格した後、ボットをアクティブにします。
期待される結果: ボットはウィジェットまたはチャネルのトラフィックを受け入れる準備ができています。
テスト方法: 少なくとも 5 つの現実的な質問をしてください。答えが正しいかどうか、ブランドに定着しているかどうか、必要なときに人間の助けを求めているかどうかを確認します。
| 問題 | 修正 |
|---|
| 答えが一般的すぎる | より具体的な知識を追加し、適切な回答の例を含めて指示を書き直します。 |
| ボットは答えるべき質問を拒否します | 過度に厳格な指示を削除し、そのトピックに関する信頼できる知識を追加します。 |
| 保存しても埋め込みコードが生成されない | 必須フィールドを確認し、音声プロバイダーの同期が完了した後、再度保存します。 |
次に何をすべきか: ウィジェット設定を構成し、Web サイトの知識を追加してから、ボットをインストールします。
ボットの管理
ボットの編集、ワークフローの複製、転送、非アクティブ化、または削除
これの目的: ボットの更新、所有権の変更、一時停止、または永久的な削除が必要な場合は、このワークフローを使用します。
始める前に- ボットを削除する前に、保持する必要がある会話または連絡先データをエクスポートします。
- ボットを削除または転送する前に、ボットが稼働中の Web サイトに埋め込まれていないことを確認してください。
- 本番ボットを非アクティブ化する前に、チームメイトに伝えてください。
1
My Bots を開く
名前またはステータスでボット カードを検索します。
期待される結果: カードには、現在の状態と実行可能なアクションが表示されます。
2
「編集」をクリックします
ボット ビルダーを開き、必要な変更を加えます。
期待される結果: エディターは現在の構成をロードします。
3
保存して再テストする
マテリアルを変更するたびに [保存] をクリックし、プレビューの質問を実行します。
期待される結果: 保存された設定は、プレビューおよびインストールされたウィジェットによって使用されます。
4
一時的に無効化する
ボットが訪問者の処理を一時的に停止する必要がある場合は、アクティブなトグルを使用します。
期待される結果: ボットは、構成を維持しながらライブ トラフィックの提供を停止します。
5
所有権を譲渡する
[転送] を使用し、受信者の電子メールを入力して確認します。
期待される結果: 選択したアカウントは、アプリの転送フローに従って所有権を受け取ります。
6
チェック後にのみ削除
ボットが不要になった場合にのみ、[削除] を使用し、警告を読み、確認してください。
期待される結果: ボットと関連構成は警告に従って削除されます。
テスト方法: 編集後、インストールされたウィジェットを開いて、変更の動機となった正確な質問をしてください。ライブアンサーが変更されたことを確認します。
| 問題 | 修正 |
|---|
| 古い答えがまだ表示されます | Web サイトのページを更新し、正しいボットを保存したことを確認し、インポートされたナレッジに同期が必要かどうかを確認します。 |
| 転送が失敗する | 受信者の電子メールが有効であり、宛先アカウントがボットを受け入れることができることを確認してください。 |
| 誤って削除をクリックしてしまいました | 最終確認の前に停止してください。このアクションによりボット データが永久に削除される可能性があるため、削除警告が存在します。 |
次に何をすべきか: ライブ変更後の分析と履歴を確認して、訪問者のエクスペリエンスが向上していることを確認します。
1ストック音声または保存されたクローン音声を選択します。
2音声時間の制限とトランスクリプトの保存を設定します。
3ストックのアバターを選択するか、プランで許可されている場合はカスタム アバターをアップロードします。
音声設定
音声通話とトランスクリプトを設定する
これの目的: 訪問者が入力するだけでなくボットと会話する必要がある場合にこれを使用します。
始める前に- プランに音声時間と希望の音声/アバター オプションが含まれていることを確認します。
- テストには静かなブラウザ環境を使用してください。
- 音声でテストするための現実的なサポートまたはセールスの質問を 1 つ用意します。
1
音声設定を開く
ボット ビルダーを開き、[音声] または [音声とアバター] 領域を選択します。
期待される結果: 音声コントロールと現在の音声選択が表示されます。
2
ストックボイスを選択してください
利用可能な音声をプレビューし、最適な音声を選択し、選択内容を保存します。
期待される結果: ボットは選択された音声を通話に使用します。
3
音声モードを設定する
訪問者が音声を利用できるようにする必要がある場合は、ウィジェット設定を使用して音声またはハイブリッドを選択します。
期待される結果: 訪問者にはウィジェットに音声オプションが表示されます。
4
音声制限を設定する
可能な場合は、ユーザーごとまたはワークスペースごとの制限を定義します。
期待される結果: 長時間の通話や繰り返しの通話では、意図した以上の分数を消費することはできません。
5
トランスクリプトを有効にする
通話履歴を確認する必要がある場合は、トランスクリプトの保存をオンにします。
期待される結果: 音声通話では、セッション後に読み取り可能なトランスクリプトが作成されます。
6
通話をテストする
ウィジェットを開き、マイクへのアクセスを許可し、通話を開始して、準備された質問をします。
期待される結果: ボットは音声で応答し、通話は正常に終了します。
7
トランスクリプトを読む
Chat History を開いて音声会話を見つけます。
期待される結果: トランスクリプトには、訪問者とボットの発言が表示されます。
テスト方法: 1 回の短い通話を完了し、音声議事録、トランスクリプト、および会話モードが記録されていることを確認します。
| 問題 | 修正 |
|---|
| ブラウザがマイクをブロックする | ブラウザでマイクの許可を許可し、ページをリロードします。 |
| 音声オプションがロックされています | [請求] を開き、ワークスペース プランに音声機能が含まれていることを確認します。 |
| トランスクリプトが空です | トランスクリプトの保存が有効になっていて、通話が正常に終了したことを確認します。 |
次に何をすべきか: 知識を追加または改良して、音声による回答が正確になるようにします。
音声クローンとアバター
音声のクローンを作成し、カスタム アバターを割り当てる
これの目的: アシスタントがブランドの音声や話すアバターのエクスペリエンスを必要とする場合にこれを使用します。
始める前に- 使用許可のある音声と画像のみを使用してください。
- バックグラウンドノイズが低いクリーンな音声サンプルを録音します。
- クローン音声とカスタム アバターのプラン制限を確認します。
1
オープンボイスクローン作成
「音声」領域から「音声のクローン」をクリックします。
期待される結果: アップロード ダイアログには、受け入れられたサンプル要件が表示されます。
2
サンプルをアップロードする
1 ~ 5 つのクリアな録音をアップロードし、クローン リクエストを送信します。
期待される結果: 処理後に複製された音声が表示されるか、ダイアログに次の要件が表示されます。
3
クローンした音声を割り当てる
音声セレクターでクローンした音声を選択し、保存します。
期待される結果: 今後の通話ではクローン音声が使用されます。
4
ストックアバターを選択してください
カスタム アバターのアップロードが必要ない場合は、含まれているアバターを選択します。
期待される結果: 音声体験には視覚的なアイデンティティがあります。
5
カスタムアバターをアップロードする
プランがサポートしている場合は、鮮明な顔画像または短いビデオをアップロードしてください。
期待される結果: アバターが処理され、選択できるようになります。
6
完全なプレビューを実行する
音声通話を開始し、音声、アバター、文字起こしの動作を一緒に確認します。
期待される結果: 訪問者のエクスペリエンスは、設定されたブランドと一致します。
テスト方法: クローン化された音声を選択して短い質問をし、通話で予想される音声/アバターが使用されていることを確認します。
| 問題 | 修正 |
|---|
| クローンの品質が低い | 1 台のスピーカー、安定した音量、音楽なしで、よりクリーンなサンプルを録音します。 |
| カスタムアバターのアップロードは利用できません | プランゲート型アバター制限については、「請求」を確認してください。 |
| 昔の声が今も流れている | 新しい音声を選択した後、ボットを保存し、ウィジェット ページをリロードします。 |
次に何をすべきか: 音声エクスペリエンスに正確な答えが得られるように、「知識とデータ」に進みます。
1ポリシー、価格設定、ブランド ルールに関するマニュアルの知識を追加します。
2Web サイトのページをインポートし、クロール結果を適用します。
3商品フィードを追加し、在庫が変更されたときにそれらを同期します。
知識源
手動の知識、Web サイトのインポート、製品フィードを使用してボットをトレーニングします。
これの目的: アシスタントが不完全な回答をした場合、または最新の製品、ポリシー、Web サイト情報が必要な場合は、これを使用します。
始める前に- ソース URLs と製品フィード URLs を準備します。
- 管理ページやプライベートページなど、インポートしないページを決定します。
- 追加したトピックごとにテスト質問を作成します。
1
オープンナレッジ
Bot Builder を開き、[ナレッジ] タブまたは [データ] タブを選択します。
期待される結果: マニュアルの知識、Web サイトのインポート、および製品フィード ツールが表示されます。
2
マニュアル知識を追加する
簡潔な事実、ポリシー、価格設定、連絡先の詳細、および回答スタイルのメモを貼り付けます。
期待される結果: ボットには、優先度の高い回答を提供するための、即時の信頼できるソースがあります。
3
Web サイトのコンテンツをインポートする
公開 Web サイト URL を貼り付け、クロール/インポートを開始します。
期待される結果: クロール結果には、検出されたページまたはインポート ステータスが表示されます。
4
結果を確認して適用する
有用なページを保持し、無関係なページを削除してから、選択したコンテンツを適用します。
期待される結果: 承認された Web サイトのコンテンツのみがナレッジ ベースに追加されます。
5
商品フィード URLs を追加
Google Merchant Center またはサポートされているフィード URLs を貼り付けてインポートします。
期待される結果: 製品、価格、在庫状況、属性をボットが利用できるようになります。
6
フィードを更新または削除する
カタログ データが変更された場合は更新を使用し、使用されなくなったフィードを削除します。
期待される結果: ボットは、古い商品データや重複した商品データを回避します。
7
保存して同期する
ボットを保存し、同期が完了するまで待ちます。
期待される結果: 最新の知識は、プレビューおよびライブ ウィジェットの回答によって使用されます。
8
確認のための質問をする
追加したソースごとに 1 つのテスト質問をします。
期待される結果: 回答には、更新された内容が正確に引用または反映されています。
テスト方法: 価格、返品、在庫状況、会社情報、サポートされていないトピックについて質問してください。ボットが既知のトピックに回答し、未知の詳細をでっち上げていないことを確認します。
| 問題 | 修正 |
|---|
| クローラーが無関係なページをインポートする | 選択した結果からそれらのページを削除し、より明確な手動説明を追加します。 |
| 商品の価格が古い | フィードを更新し、フィード URL 自体に現在の値が含まれていることを確認します。 |
| ボットが答えを作成する | 知識が不足している場合、ボットが「不明」と答え、人間によるサポートを提供するというルールを追加します。 |
次に何をすべきか: プレビューに戻って再度テストし、ウィジェットをインストールまたは更新します。
1ボットまたはチャネルでフィルターします。
2会話を開き、必要に応じて人間として返信します。
3変換、解決、およびハンドオフの制御は慎重に使用してください。
1すぐにハンドオフを待っていると主張します。
2エージェントとして応答するか、会話を AI に戻します。
3訪問者が人間の助けを必要としなくなったときに解決します。
1訪問者、ボット、チャネル、または日付で検索します。
2テキストおよび音声セッションの完全なトランスクリプトを開きます。
3必要に応じて、CSV または JSON をエクスポートします。
1ボットまたはソースごとに連絡先をフィルターします。
2連絡先の詳細と会話のコンテキストを開きます。
3選択した連絡先を SendPulse にエクスポートまたは同期します。
受信箱への返信
会話を開き、人間による返信を送信します
これの目的: AI を単独で続行させるのではなく、オペレーターが sem.chat から顧客に応答する必要がある場合にこれを使用します。
始める前に- オペレーターがボットまたはワークスペースにアクセスできることを確認します。
- 返信する前に会話を読んでください。
- 訪問者が同じ言語を期待しているかどうかを確認します。
1
受信箱を開く
サイドバーの「受信トレイ」をクリックします。
期待される結果: 最近の conversations がボット、チャネル、訪問者、ステータス、時間とともに表示されます。
2
必要に応じてフィルターをかける
チャネル、ボット、未読、またはステータス フィルターを使用して会話を見つけます。
期待される結果: リストは必要な会話セットに絞り込まれます。
3
会話を開いてください
訪問者の行をクリックします。
期待される結果: スレッド全体、訪問者情報、返信コントロールが表示されます。
4
必要に応じて翻訳する
訪問者の言語がエージェントの言語と異なる場合は、翻訳コントロールを使用します。
期待される結果: エージェントは理解して適切に応答できます。
5
返信を送信する
人間の応答を書いて送信します。
期待される結果: メッセージはエージェント/人間の応答としてスレッドに追加されます。
6
解決するかオープンのままにするか
会話が完了した場合は解決するか、フォローアップのために開いたままにしておきます。
期待される結果: 受信箱のステータスは実際の顧客の状態と一致します。
テスト方法: テスト会話に安全なテスト返信を送信し、訪問者ウィジェットと Chat History に表示されることを確認します。
| 問題 | 修正 |
|---|
| 返信の送信に失敗する | ネットワークの状態、会話のステータス、ライブ サポートが申請されているかどうかを確認します。 |
| 訪問者の言語が間違っています | 返信する前に翻訳を使用するか、ボットの言語設定を更新してください。 |
| 会話が受信トレイにありません | Chat History を検索し、ウィジェット テストで正しいボットが使用されたことを確認します。 |
次に何をすべきか: アクティブなハンドオフ キューには Live Support を使用し、監査には Chat History を使用します。
ライブサポート
請求、返信、AI へのハンドバック、ハンドオフの解決
これの目的: AI が人間にリクエストする場合、または訪問者が明示的にエージェントを必要とする場合にこれを使用します。
始める前に- ライブ サポートを有効にする前に、エージェントを対応させてください。
- AI がいつハンドオフを要求するかをボットの指示で定義します。
- ハンドオフ アラートの通知設定を有効にしておきます。
1
Live Support を開く
サイドバーの「Live Support」をクリックします。
期待される結果: 待機中およびアクティブなハンドオフ conversations が表示されます。
2
リクエストを請求する
待機中の会話で「要求」をクリックします。
期待される結果: 他のエージェントは、会話がアクティブに処理されていることを確認できます。
3
コンテキストを読む
返信する前にメッセージと訪問者の詳細を開いてください。
期待される結果: エージェントはハンドオフが発生した理由を理解しています。
4
人間の返信を送信する
明確に返答し、スレッドを常に最新の状態に保ちます。
期待される結果: 訪問者は人間の応答を受け取ります。
5
必要に応じて AI に戻します
問題が解決され、AI が続行できる場合は、手を戻してください。
期待される結果: AI が会話の処理を再開します。
6
終わったら解決する
訪問者がサポートを必要としなくなったら、[解決] をクリックします。
期待される結果: ハンドオフは閉じられ、アクティブなキューから削除されます。
テスト方法: テストハンドオフを作成し、それを要求し、一度応答して、返送し、Live Support と Chat History でステータスの変化を確認します。
| 問題 | 修正 |
|---|
| エージェントがリクエストを見逃す | ブラウザ/メール/プッシュ通知を有効にし、キューの所有権のプロセスを追加します。 |
| AI がすぐに引き継いでしまう | 指示と引き継ぎルールを調整して、解決されるか差し戻されるまで人間の制御がアクティブなままになるようにします。 |
| 外部 CRM が同期していません | Webhook または開発者レシピ セクションからのポーリングを使用します。 |
次に何をすべきか: サポート チームが sem.chat の外で作業している場合は、CRM/webhook に接続します。
経歴と連絡先
会話/連絡先記録の検索、エクスポート、使用
これの目的: これは、監査、リードのレビュー、CSV のエクスポート、および SendPulse の同期に使用します。
始める前に- conversations、連絡先、または両方が必要かどうかを決定します。
- エクスポートする前に、正しい日付範囲を適用してください。
- 必要以上に個人データをエクスポートしないでください。
1
Chat History を開く
サイドバーの「Chat History」をクリックします。
期待される結果: 会話フィルター、統計、トランスクリプトリストが表示されます。
2
検索とフィルター
ボット、チャネル、モード、訪問者、または日付範囲でフィルターします。
期待される結果: 一致する conversations のみが表示されたままになります。
3
トランスクリプトを開く
会話をクリックしてメッセージ スレッド全体を読みます。
期待される結果: 完全なコンテキスト、連絡先の詳細、会話のメタデータが表示されます。
4
conversations をエクスポート
[エクスポート] をクリックし、利用可能な場合は必要な形式を選択します。
期待される結果: エクスポートには、フィルター処理された会話データが含まれます。
5
連絡先を開く
サイドバーの「連絡先」をクリックします。
期待される結果: リード/連絡先のレコードが、ソース、ボット、ステータスとともに表示されます。
6
連絡先をフィルタリングしてエクスポートする
連絡先を検索し、目的のレコードを選択して、SendPulse にエクスポートまたは同期します。
期待される結果: 選択した連絡先は、選択したアクションに応じて sem.chat の外部で使用できます。
テスト方法: フィルター処理された小さな CSV をエクスポートし、ローカルで開いて列と日付範囲が正しいことを確認します。
| 問題 | 修正 |
|---|
| 連絡先に連絡先がありません | リードキャプチャが有効になっていることと、訪問者がフォームを送信したことを確認します。 |
| エクスポートが大きすぎます | エクスポートする前に、日付範囲またはボット フィルターを絞り込みます。 |
| SendPulse 同期は利用できません | まず統合で SendPulse に接続してから、連絡先に戻ります。 |
次に何をすべきか: Analytics を確認して、操作の実行後のパフォーマンスの傾向を理解します。
1チャネルまたは CRM 統合カードを選択します。
2各プロバイダーの OAuth または認証情報の手順に従います。
3同じページから統合を切断または再テストします。
チャンネルを接続する
メッセージング チャネルまたは CRM 統合を接続します
これの目的: sem.chat が Web サイト ウィジェットの外で conversations を受信する場合、または連絡先を他のツールに送信する必要がある場合にこれを使用します。
始める前に- 外部プラットフォームへの管理者アクセス権を持っています。
- どのボットがチャネル メッセージを受信すべきかを把握します。
- 運用アカウントを接続する前にテスト チャネルを使用してください。
1
オープンな統合
サイドバーの「統合」をクリックします。
期待される結果: 利用可能なチャネル、CRM ツール、SendPulse、および Web サイト ウィジェット オプションが表示されます。
2
統合を選択してください
Slack、メタ チャネル、Telegram、SendPulse、CRM、または手動資格情報で [接続] をクリックします。
期待される結果: セットアップ ダイアログまたは OAuth フローが開きます。
3
プロバイダーのセットアップを完了する
OAuth チャネルの場合は、要求された権限を承認します。手動チャネルの場合は、必要なトークン、シークレット、アカウント ID、または Webhook URL を貼り付けます。
期待される結果: sem.chat は接続を保存し、統合が接続されているものとして表示します。
4
ボットを割り当てる
ダイアログで尋ねられたときに、そのチャネルからのメッセージを処理するボットを選択します。
期待される結果: 受信メッセージは正しいアシスタントにルーティングされます。
5
チャンネルをテストする
外部チャネルからテスト メッセージを送信します。
期待される結果: メッセージは受信箱または正しいチャネルの Chat History に表示されます。
6
必要に応じて接続を解除します
チャネルが停止する必要がある場合は、統合カードからの切断を使用します。
期待される結果: sem.chat は、その統合を介した受信または送信を停止します。
テスト方法: 接続されたチャネルを通じて 1 つのテスト メッセージを送信し、ボットの応答、受信トレイの行、および履歴レコードを確認します。
| 問題 | 修正 |
|---|
| Telegram トークンが失敗しました | BotFather でトークンを作成またはリセットし、再度貼り付けます。 |
| Slack メッセージが到着しない | アプリのスコープ、イベント サブスクリプション URL、ボット トークン、署名シークレット、およびチャネル メンバーシップを確認します。 |
| メタチャネル接続が失敗する | Facebook/Instagram/WhatsApp アカウントに管理者権限と必要なビジネス アクセスがあることを確認します。 |
| SendPulse 同期が失敗します | SendPulse を再接続し、連絡先フィールドがマッピングされていることを確認します。 |
次に何をすべきか: チームのチャネル所有権を文書化し、起動後に受信箱を監視します。
1イベント タイプ、予約、分析、1 回限りのリンク、カレンダー、メール、設定のタブを使用します。
2イベント タイプを編集、コピー、埋め込み、アクティブ化、または一時停止します。
3パブリック リンクをコピーし、プライベート予約テストを実行します。
1名前、説明、期間、場所、バッファーを入力します。
2空き状況、予約期間、質問、有料イベントのオプション、キャンセル ルールを設定します。
3リンクを共有する前にイベントを保存してください。
1訪問者は公開予約ページから日付を選択します。
2訪問者は利用可能な時間枠を選択します。
3訪問者は予約を確認し、確認メールを受け取ります。
イベントの種類
イベントタイプを作成して予約リンクを公開する
これの目的: 訪問者がデモ、コンサルティング、営業電話、オンボーディング、またはサポート セッションを予約する必要がある場合にこれを使用します。
始める前に- イベント名、期間、会議の種類、所有者を選択します。
- リンクを共有する前に、タイムゾーンと可用性を設定します。
- ダブルブッキングが問題になる場合は、カレンダーを接続します。
1
オープンスケジュール
サイドバーの「スケジュール」をクリックします。
期待される結果: スケジュール ワークスペースには、イベント タイプ、予約、分析、1 回限りのリンク、カレンダー、電子メール、設定のタブが表示されます。
2
イベントタイプを作成する
「作成」をクリックし、名前、説明、期間、場所、バッファー、および予約ルールを追加します。
期待される結果: このイベントには、来場者が理解できるように十分な公開情報が含まれています。
3
セットの可用性
週ごとの営業時間、日付の上書き、通知ウィンドウ、予約ウィンドウを構成します。
期待される結果: 訪問者には、あなたが提供したい時間だけが表示されます。
4
質問を追加する
電話、会社、Web サイト、会議の目標など、必要な質問を追加します。
期待される結果: 予約では、通話前にチームが必要とするコンテキストを収集します。
5
カレンダーを接続する
カレンダーを開き、可能な場合は Google、Outlook、または iCal に接続します。
期待される結果: 混雑した時間をブロックしたり、確定した予約をカレンダーに書き込んだりできます。
6
メールとリマインダーを設定する
電子メールを開き、確認、リマインダー、キャンセル、および再スケジュールのメッセージを設定します。
期待される結果: 訪問者は正しい予約通知を受け取ります。
7
パブリックリンクを共有してテストする
イベント リンクをコピーし、プライベート ウィンドウで開き、スロットを選択して、テスト予約を完了します。
期待される結果: 予約が [予約] タブに表示され、確認メッセージが送信されます。
テスト方法: テスト予約を 1 件、スケジュール変更を 1 件、キャンセルを 1 件完了します。各イベントがスケジュールと接続されているカレンダーに表示されることを確認します。
| 問題 | 修正 |
|---|
| 公開ページに時間が表示されない | タイムゾーン、毎週の空き状況、日付の上書き、通知ウィンドウ、接続されているカレンダーの競合を確認します。 |
| 予約メールがありません | メール設定と迷惑メールフォルダを確認して、再度テスト予約を送信してください。 |
| 有料イベントで支払いが失敗する | 公開する前に、請求/支払いの統合設定と通貨が有効であることを確認してください。 |
次に何をすべきか: 予約リンクをボット、Web サイト、またはフォローアップ メールに埋め込みます。
高度なスケジューリング
1 回限りのリンク、分析、埋め込み、有料イベントを使用する
これの目的: スケジュールに一時的な空き状況、レポート、埋め込み予約、または支払いが必要な場合にこれを使用します。
始める前に- 最初に少なくとも 1 つのイベント タイプを作成します。
- 1 回限りのリンクを多用する前に、カレンダーを接続してください。
- 有料イベントを有効にする前に、返金/キャンセル ポリシーを定義します。
1
一回限りのリンクを作成する
1 回限りのリンクを開き、提供されているスロットまたはルールを選択して、リンクを生成します。
期待される結果: 受信者は選択された空室状況のみから予約できます。
2
スケジュールの埋め込み
予約フローを Web サイトに表示する必要がある場合は、イベント カードの埋め込みオプションを使用します。
期待される結果: 予約 UI は、訪問者がコンバージョンするページに配置できます。
3
スケジュール分析のレビュー
スケジュール内の分析を開きます。
期待される結果: 予約数、完了傾向、イベントタイプのパフォーマンスを確認できます。
4
有料イベントを有効にする
イベント エディターを開き、価格、通貨、支払い動作を設定します。
期待される結果: 訪問者はイベントの設定に従って支払いステップを完了する必要があります。
5
予約の監査
予約を開いて、今後のエントリ、完了したエントリ、キャンセルされたエントリ、および再スケジュールされたエントリを確認します。
期待される結果: チームは出席とフォローアップを管理できます。
テスト方法: 公開ページ、または埋め込みページ (使用されている場合) を通じて予約します。両方が同じタイプの予約レコードを作成することを確認します。
| 問題 | 修正 |
|---|
| 1 回限りのリンクにより間違ったスロットが公開される | より小さいスロット セットまたはより厳密な日付範囲を使用してリンクを再生成します。 |
| 埋め込み予約が狭すぎる | 埋め込みをより広いコンテンツ コンテナに配置し、モバイル レイアウトを確認します。 |
| 分析が空っぽに見える | 実際の予約を作成するか待機します。分析は予約記録に依存します。 |
次に何をすべきか: スケジュールの結果をレポートと分析に接続します。
1日付範囲またはカスタム日付を選択します。
2会話、満足度、言語、チャネル、コンバージョンの指標を読み取ります。
3オフライン分析のために CSV をエクスポートします。
1日次、週次、または月次のレポート頻度を選択します。
2レポート受信者を追加します。
3インスタント レポートを送信して配信をテストします。
分析レビュー
分析を読み取り、パフォーマンス データをエクスポートする
これの目的: これを週次レビュー、起動チェック、サポート品質レビュー、およびコンバージョン分析に使用します。
始める前に- メトリクスを読み取る前に日付範囲を選択します。
- どのボットまたはチャネルを評価しているかを把握します。
- 本番環境のパフォーマンスを報告する場合は、プライベート テストの日付を除外します。
1
オープンアナリティクス
サイドバーの「分析」をクリックします。
期待される結果: ダッシュボードのメトリクスとグラフ パネルが表示されます。
2
日付範囲を選択してください
今日、7 日、30 日、またはカスタムの日付を選択します。
期待される結果: すべてのチャートが選択した期間に更新されます。
3
コアメトリクスの読み取り
conversations、音声時間、満足度、コンバージョン、チャネル ミックスを確認します。
期待される結果: あなたは顧客とのやり取りの量と質を理解しています。
4
レビューの傾向
会話の傾向、満足度の変化、よくある質問、言語/チャネルのパターンを確認します。
期待される結果: ボットの指示や人員配置を改善すべき箇所を特定できます。
5
CSV をエクスポート
チームがスプレッドシート分析を必要とする場合は、Export CSV を使用します。
期待される結果: CSV には、選択した日付範囲と指標が含まれます。
6
発見を変化に変える
データに基づいて、ボットの指示、ナレッジ、ウィジェット設定、またはサポート範囲を更新します。
期待される結果: 分析は具体的な製品の改善につながります。
テスト方法: 小さなカスタム日付 CSV をエクスポートし、日付範囲と指標がダッシュボードに表示されている内容と一致していることを確認します。
| 問題 | 修正 |
|---|
| 指標が高すぎるようです | 選択した日付範囲にステージング/テスト conversations が含まれているかどうかを確認してください。 |
| 満足は空っぽだ | ウィジェット設定で評価を有効にし、訪問者が評価を残すまで待ちます。 |
| 音声通話時間が期待と一致しない | 音声モードが対象のボットでのみ有効になっていることを確認します。 |
次に何をすべきか: 電子メール レポートを定期的に確認できるようにスケジュールを設定します。
レポート
定期的な電子メールレポートとテスト配信を構成する
これの目的: 所有者、マネージャー、またはクライアントが自動パフォーマンス概要を必要とする場合にこれを使用します。
始める前に- 誰がレポートを受け取るかを決定します。
- 確認済みの電子メール アドレスを使用します。
- ビジネスレビューのリズムに合ったペースを選択してください。
1
「設定」を開き、「レポート」を開きます
[設定] に移動して [レポート] タブを選択するか、利用可能な場合はレポート リダイレクトを使用します。
期待される結果: レポートの頻度、受信者、履歴が表示されます。
2
ケイデンスの選択
日次、週次、または月次レポートを有効にします。
期待される結果: レポート スケジュールはワークスペースに保存されます。
3
受信者の追加
レポートを受信する電子メール アドレスを入力します。
期待される結果: レポートは適切な関係者に送信されます。
4
インスタントレポートを送信する
[今すぐ送信] または同等のインスタント レポート アクションをクリックします。
期待される結果: 検証のためにレポート電子メールがすぐに送信されます。
5
レポート履歴を確認する
レポートが送信された後、履歴パネルを確認してください。
期待される結果: 配送状況やタイミングを確認できます。
テスト方法: テスト受信者にインスタント レポートを送信し、受信とフォーマットを確認します。
| 問題 | 修正 |
|---|
| 報告メールが届かない | 受信者のスペル、スパムフォルダー、レポート履歴ステータスを確認してください。 |
| 間違った人が報告を受ける | 受信者を更新し、次回のスケジュールされた送信の前に保存します。 |
| レポート内容がうるさく感じる | 予想される日付範囲を調整し、アナリティクスを使用してより詳細な手動レビューを行います。 |
次に何をすべきか: レポートの頻度をボット改善の動作リズムとして使用します。
1現在の計画、トライアル状態、usage 制限を確認します。
2アップグレードする前にプランの機能を比較してください。
3請求ポータルを開いて、請求書、支払い方法、キャンセル、または再アクティブ化を行います。
1プロフィールと言語には「一般」を使用します。
2招待と役割にはチームを使用します。
32FA、API キー、および危険ゾーンのアクションにはセキュリティを使用します。
1プログラムに参加して紹介リンクを作成してください。
2キャンペーンの紹介リンクをコピーします。
3支払いメールを設定し、対象となる支払いをリクエストします。
請求
プランの開始、アップグレード、キャンセル、または再アクティブ化
これの目的: これは、ワークスペースの試用版のアクティブ化、制限の追加、請求書、支払いの更新、またはサブスクリプションの変更が必要な場合に使用します。
始める前に- アカウント所有者または請求管理者は、請求アクションを実行する必要があります。
- どの機能がプランゲートされているかを確認します: 音声、クローン音声、カスタム アバター、API、チーム、CRM、チャネル。
- 支払い方法と請求書の変更には、安全な請求ポータルを使用してください。
1
オープンビリング
サイドバーの「請求」をクリックします。
期待される結果: 現在のプラン、トライアル状態、usage 制限、およびプラン カードが表示されます。
2
プランを比較する
chat、音声、チーム、API、アバター、統合、スケジュール、およびサポート制限を確認します。
期待される結果: どのプランで必要な機能が利用できるかがわかります。
3
請求間隔を選択してください
トグルが使用可能な場合は、月ごとまたは年ごとを選択します。
期待される結果: 選択した期間の価格と割引額が更新されます。
4
アップグレードするかチェックアウトを開始する
ご希望のプランを選択し、チェックアウトを完了してください。
期待される結果: 支払い確認後にサブスクリプションが有効になります。
5
カスタマーポータルを開く
支払い方法、請求書、キャンセル、または再アクティブ化には、請求ポータルを使用します。
期待される結果: 機密性の高い請求アクションは、安全なプロバイダー ポータルで行われます。
6
機能へのアクセスを確認する
ロックされていた機能に戻り、アプリをリロードします。
期待される結果: プランに含まれている場合は、ロック解除された機能を利用できるようになりました。
テスト方法: アップグレード後、音声クローンや API キーなど、以前にロックされていた機能を開き、ロックが解除されていることを確認します。
| 問題 | 修正 |
|---|
| アップグレード後も機能がロックされたままになる | アプリを更新し、サブスクリプションが同期されるまで少し待ってから、[請求] をもう一度確認します。 |
| チェックアウトがキャンセルされました | [請求] に戻り、チェックアウトを再度開始します。チェックアウトをキャンセルした後は、プランの変更は行われません。 |
| 請求書またはカードの変更が必要です | アプリ内で支払いの詳細を編集するのではなく、カスタマー ポータルを開きます。 |
次に何をすべきか: チームメイトを招待し、所有者のアカウントを確保します。
チームとセキュリティ
チームメイトの招待、役割の設定、プロフィールの編集、2FA の有効化、設定の管理
これの目的: ワークスペースがソロセットアップからチーム操作に移行するときにこれを使用します。
始める前に- 招待状を送信する前に、チームメイトの各役割を理解してください。
- 最小特権アクセス (所有者、管理者、編集者、閲覧者) を使用します。
- 認証アプリを 2FA に対応できるように準備します。
1
設定を開く
サイドバーの「設定」をクリックします。
期待される結果: [全般]、[通知]、[チーム]、[レポート]、[開発者]、[セキュリティ]、および関連するタブが表示されます。
2
プロフィールと言語を編集する
「全般」で表示名、プロフィール情報、優先言語を更新します。
期待される結果: アプリはユーザーを正しく識別し、可能な場合は選択された言語を使用します。
3
チームメンバーを招待する
「チーム」を開き、電子メールを入力し、役割を選択して、招待を送信します。
期待される結果: チームメイトは招待リンクを受け取り、承認されるまで保留中として表示されます。
4
役割の権限を設定する
フル コントロールには所有者、管理には管理者、コンテンツの変更にはエディター、読み取り専用アクセスにはビューアーを使用します。
期待される結果: 各ユーザーは、自分の責任に応じて適切なアクセス権を持ちます。
5
通知を構成する
電子メール、ブラウザ、プッシュ、ライブサポート、請求、レポート通知を選択します。
期待される結果: 不必要なノイズを発生させることなく、適切な人がアラートを受け取ります。
6
2FA を有効にする
セキュリティを開き、2 要素認証を有効にし、コードをスキャンして、回復の詳細を保存します。
期待される結果: アカウントには、パスワード ログイン後に 2 番目の要素が必要です。
7
危険地帯での行動は慎重に行う
アカウントを破壊するアクションを起こす前に、必要なデータをエクスポートし、アクティブなウィジェット/統合を確認します。
期待される結果: ワークスペースにより、偶発的なデータ損失が回避されます。
テスト方法: テスト チームメイトを招待し、別のブラウザで招待を受け入れ、ロールが意図した機能のみを公開していることを確認します。
| 問題 | 修正 |
|---|
| 招待メールがありません | スパムをチェックし、招待を再送信し、アドレスを確認します。 |
| チームメイトが見すぎている | 役割を下げ、ボットのアクセス設定を見直します。 |
| 2FA セットアップが失敗する | それに依存する前に、デバイスの時間を確認し、QR コードを再スキャンし、回復の詳細を保存してください。 |
次に何をすべきか: API キーは、それを必要とするユーザーとサービスに対してのみ構成してください。
アフィリエイト
アフィリエイトに参加し、紹介リンクをコピーし、支払いメールを設定し、支払いをリクエストします
これの目的: パートナーまたは顧客が新しい sem.chat ユーザーを紹介し、コミッション活動を追跡したい場合にこれを使用します。
始める前に- 紹介属性を所有する必要があるアカウントを使用してください。
- 支払いをリクエストする前に、支払いメールを準備してください。
- 紹介キャンペーンを公開する前にプログラム ルールを確認してください。
1
オープンアフィリエイト
サイドバーの「アフィリエイト」をクリックするか、そこにリンクされている場合は「設定」からアフィリエイトタブを開きます。
期待される結果: アフィリエイト プログラム ページには、参加、紹介、支払い、履歴の領域が表示されます。
2
プログラムに参加する
アカウントがまだ参加していない場合は、「参加」をクリックします。
期待される結果: 紹介コードと紹介リンクが作成されます。
3
紹介リンクをコピーする
一意のリンクをコピーし、コンテンツ、キャンペーン、またはパートナー メッセージで使用します。
期待される結果: リンクを介したサインアップは、アフィリエイト アカウントに関連付けることができます。
4
支払いメールを設定する
支払いメールを入力して保存します。
期待される結果: 対象となる支払いを正しくルーティングできます。
5
紹介とコミッションを確認する
紹介リスト、コミッション状況、支払い履歴を確認します。
期待される結果: 保留中のもの、対象となるもの、またはすでに支払われているものがわかります。
6
支払いをリクエストする
プログラムのルールと最低額が満たされたら、「支払いのリクエスト」をクリックします。
期待される結果: 支払い要求は処理のために記録されます。
テスト方法: プライベート ブラウザで紹介リンクを開き、紹介追跡を使用して予想されるサインアップ フローに到達することを確認します。
| 問題 | 修正 |
|---|
| 紹介リンクがありません | まずプログラムに参加するか、参加後にアフィリエイト ページを更新してください。 |
| 支払いリクエストは利用できません | 最低支払いしきい値、対象となるコミッションの状態、支払いメールを確認してください。 |
| 紹介が帰属されていない | 訪問者が正確な紹介リンクを使用し、追跡パラメータを削除しなかったことを確認します。 |
次に何をすべきか: 必要に応じて、分析とレポートを使用して、紹介された顧客への影響を監視します。
1未読アラートを確認した後は、「すべて既読としてマーク」を使用します。
2未読、請求、ライブ サポート、またはシステム イベントでフィルタリングします。
3アラートを読んだ後、関連機能を開きます。
1新機能と修正については、リリース ノートをお読みください。
2ワークフローが変更される前に、詳細を使用してチームメイトをトレーニングします。
3UI や動作の変更に気づいたら、更新を確認してください。
通知
通知を確認し、アラートに対処する
これの目的: これは、アプリがハンドオフ、請求状態、システム イベント、レポート配信、または重要なワークスペース アクティビティを報告するときに使用します。
始める前に- 通知設定が設定で設定されていることを確認してください。
- ハンドオフ アラートが有効になっている場合は、ライブ サポートが受けられます。
- 既読のマークを付ける前に、未読のアラートを確認してください。
1
通知を開く
サイドバーまたはアプリヘッダーの通知エントリで「通知」をクリックします。
期待される結果: 通知センターには、最近のアラートが一覧表示されます。
2
アラートのフィルタリング
未読またはカテゴリのフィルターを使用して、請求、ライブ サポート、ボット、レポート、またはシステム イベントに焦点を当てます。
期待される結果: 一致するアラートのみが表示されたままになります。
3
関連ページを開く
アラートをクリックするか、そのコンテキストを使用して、請求、Live Support、レポート、または関連するボットを開きます。
期待される結果: 通知をただ読むのではなく、通知に従って行動します。
4
既読マークを付ける
単一のアラートを既読としてマークするか、レビュー後にすべて既読としてマークを使用します。
期待される結果: 未読数が減少し、レビュー済みアイテムが強調表示されなくなりました。
5
環境設定を調整する
受信するアラートが多すぎるか少なすぎる場合は、[設定]、[通知] を開きます。
期待される結果: 通知ストリームはチームのニーズに一致します。
テスト方法: ライブ サポート リクエストやインスタント レポートなどの安全なテスト イベントを作成し、通知が表示され、既読としてマークできることを確認します。
| 問題 | 修正 |
|---|
| 通知が来ない | 設定の通知設定、ブラウザの許可、イベントが実際に発生したかどうかを確認してください。 |
| アラートが多すぎます | ノイズの多いカテゴリを無効にするか、責任のあるチーム メンバーにのみカテゴリを送信します。 |
| 未読数が止まっているようです | すべての既読をマークした後、アプリを更新し、フィルターが未読アイテムを非表示にしていないことを確認します。 |
次に何をすべきか: 動作が変更された場合や新しいコントロールが追加された場合は、App Updates を確認してください。
アプリのアップデート
アプリのアップデートを使用して製品の変更を理解する
これの目的: 新しい機能を使用する前に、チームメイトが何が変更されたかを知る必要がある場合にこれを使用します。
始める前に- メジャー リリース後、または UI が変更されたときにアップデートを開きます。
- 関連する更新ノートをサポートおよびセールス ユーザーと共有します。
- 大きな変更を加えた後は、重要なワークフローを再テストします。
1
App Updates を開く
サイドバーの「App Updates」をクリックします。
期待される結果: 更新フィードには、新機能、修正、リリース ノートが表示されます。
2
最新のアップデートを読む
最新のアップデート カードまたは詳細ビューを開きます。
期待される結果: 何が変更され、それがどのワークフローに影響を与えるかがわかります。
3
変更をワークフローにマッピングする
更新がボット、ウィジェット、サポート、スケジュール、請求、または開発者に影響するかどうかを特定します。
期待される結果: 適切なチームメンバーは何を確認すべきかを知っています。
4
クリティカル パスを再テストする
更新が運用ワークフローに影響を与える場合は、このドキュメントの関連する手動手順を繰り返してください。
期待される結果: チームは、変更されたワークフローが引き続き機能することを確認しました。
5
社内で共有する
影響を受けるエリアを所有するユーザーに更新の概要を送信します。
期待される結果: チームへの導入がスムーズになり、サポートへの質問が減ります。
テスト方法: 関連する更新の後、影響を受ける機能のガイドを繰り返し、スクリーンショットまたはステップ名がまだ一致していることを確認します。
| 問題 | 修正 |
|---|
| アップデートにロックされた機能が記載されている | [請求] を開いて、現在のプランにそれが含まれているかどうかを確認します。 |
| チームが変更を逃した | App Updates レビューをリリースまたは毎週の運用ルーチンに追加します。 |
| 更新後にドキュメントが古くなったように見える | エンジニア ガイドを使用して、スクリーンショットと手順を更新します。 |
次に何をすべきか: 機能が進化するにつれて、公開ドキュメントを最新の状態に保ちます。
1「API キー」タブから API キーを生成および取り消します。
2最初のカールの例には Quick Start を使用してください。
3大容量自動化を有効にする前に、使用状況を確認してください。
API クイック スタート
API キーを生成し、最初の API 呼び出しを実行します。
これの目的: これは、レポート スクリプト、カスタム アプリ、CRM ブリッジ、外部ライブ サポート、または自動化に使用します。
始める前に- サーバーサイド環境を使用します。ブラウザ JavaScript で API キーを公開しないでください。
- 統合ごとに個別のキーを生成します。
- シークレットは一度表示されるため、キーをすぐにコピーします。
1
オープンデベロッパー
[設定] を開いて [開発者] を選択するか、利用可能な場合は開発者リダイレクトを使用します。
期待される結果: API キー、Quick Start、ドキュメント、および使用法タブが表示されます。
2
キーを生成する
「キーの生成」をクリックし、明確なラベルを付けて、すぐにコピーします。
期待される結果: キーは sk_live_ で始まり、サーバー側のリクエストで使用できます。
3
x-api-key ヘッダーを送信する
すべてのパブリック API リクエストに x-api-key を含めます。
期待される結果: パブリック API はリクエストを認証し、その範囲を所有者に限定できます。
4
ボットをリストする
action=list-bots を呼び出して、必要なボット ID を見つけます。
期待される結果: 応答では、ボット ID、名前、アクティブな状態、および構成の概要が返されます。
5
chat メッセージを送信する
POST アクション chat と botId およびメッセージ。
期待される結果: 応答は、応答、モデル、および usage 情報を返します。
6
usage を確認してください
大量のジョブを実行する前に、action=usage を呼び出します。
期待される結果: 自動化を実行する前に、現在の計画と usage の状態がわかります。
7
必要に応じてキーをローテーションする
未使用のキーを取り消し、変更されたベンダーまたはサービス用に新しいキーを生成します。
期待される結果: 古いサービスは、古い認証情報を使用し続けることはできません。
テスト方法: ローカル端末またはサーバー環境から list-bots および chat を実行し、chat が送信された場合は会話が Chat History に表示されることを確認します。
| 問題 | 修正 |
|---|
| 401または不正な応答 | x-api-key のスペルを確認し、完全なキーをコピーして、それが取り消されていないことを確認してください。 |
| ボットが見つかりません | list-bots を再度使用し、ボットが API キー所有者に属していることを確認します。 |
| ブラウザの CORS の問題 | API 呼び出しをバックエンドに移動します。 API キーはサーバー側での使用を目的としています。 |
次に何をすべきか: 焦点を当てたエンドポイント参照には /api-docs を使用し、このページはワークフロー ガイダンスとして保持してください。
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
-H "x-api-key: sk_live_your_key_here"
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
-H "x-api-key: sk_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"action": "chat",
"botId": "YOUR_BOT_ID",
"message": "What can you help me with?"
}'
ライブサポート CRM ブリッジ
ライブ サポート リクエストをポーリングまたは CRM にプッシュします
これの目的: エージェントが別のシステムで作業しているが、sem.chat が訪問者の会話を受信する場合にこれを使用します。
始める前に- CRM ブリッジにちなんで名付けられた専用の API キーを作成します。
- ポーリングと Webhook がインフラストラクチャに適合するかどうかを決定します。
- 今後の返信/解決のために、CRM に会話 ID が保存されていることを確認してください。
1
待機中のハンドオフをリストする
GET action=live-support-list、status=requested または status=all。
期待される結果: CRM は、人間の注意を必要とするオープンな conversations を受け取ります。
2
メッセージを取得する
GET アクション=live-support-messages と conversationId。
期待される結果: CRM には、スレッドの完全なコンテキストと訪問者の詳細が含まれています。
3
返信する前に主張してください
POST アクション=live-support-claim。
期待される結果: sem.chat は、会話がアクティブに処理されたものとしてマークします。
4
エージェントの返信を送信する
POST action=live-support-reply と conversationId、メッセージ、およびエージェント名。
期待される結果: 訪問者は人間の応答を受け取り、スレッドが更新されます。
5
解決するか差し戻すか
POST action=live-support-resolve 解決またはハンドバックあり。
期待される結果: 会話が待機キューから出るか、AI が制御を再開します。
6
CRM のログステータス
最新のハンドオフ ステータス、メッセージ ID、およびタイムスタンプを保存します。
期待される結果: CRM および sem.chat は引き続き監査可能です。
テスト方法: 安全なハンドオフを作成し、それを CRM にミラーリングし、ブリッジから応答して、訪問者スレッドの更新を確認します。
| 問題 | 修正 |
|---|
| CRM チケットが重複しています | CRM ブリッジの冪等キーとして conversationId を使用します。 |
| 返信が順番どおりに届きません | メッセージのタイムスタンプを保存し、複数のシステムからの同時応答を回避します。 |
| エージェントが作業中にAIが応答 | 最初にハンドオフを要求し、エージェントが完了したときにのみハンドオフを戻します。 |
次に何をすべきか: ポーリングが遅すぎる、またはコストが高すぎる場合は、Webhook を登録します。
Webhook
Webhook を登録して X-SemChat-Signature を確認する
これの目的: システムがハンドオフ、メッセージ、解決策の更新などのリアルタイム イベントを必要とする場合にこれを使用します。
始める前に- Webhook URL は HTTPS であり、パブリック インターネットからアクセス可能である必要があります。
- Webhook シークレットをすぐに保存します。一度表示されます。
- イベントを処理する前に署名を検証します。
1
Webhook を登録する
POST アクション webhook-register と URL およびイベント。
期待される結果: 応答には、Webhook の詳細とワンタイム署名シークレットが含まれます。
2
シークレットを保存する
シークレットをサーバー環境またはシークレット マネージャーに保存します。
期待される結果: 今後の配信を確認することができます。
3
署名を検証する
X-SemChat-Signature を読み取り、生のリクエスト本文に対して HMAC SHA-256 と比較します。
期待される結果: 本物の sem.chat 配達物のみが受け入れられます。
4
再試行を冪等に処理する
重複した処理を避けるために、イベント ID または会話/メッセージ ID を使用します。
期待される結果: 再試行では重複した CRM レコードは作成されません。
5
Webhook をリストする
GET アクション webhook-list を使用して、構成されたエンドポイントを監査します。
期待される結果: URL、イベント、有効な状態、および最近の配信状態を確認できます。
6
古い Webhook を削除する
POST アクション webhook-delete と Webhook ID。
期待される結果: 古いエンドポイントはイベントの受信を停止します。
テスト方法: テスト エンドポイントを登録し、ライブ サポート イベントをトリガーし、署名を検証して、ハンドラーが 2xx を返すことを確認します。
| 問題 | 修正 |
|---|
| 署名が一致しません | 解析されていない JSON ではなく、生の本体を使用して、正しい Webhook シークレットを確認してください。 |
| Webhook はイベントを受信しません | イベント リストにテストしているイベントが含まれており、エンドポイントが HTTPS であることを確認します。 |
| Webhook がタイムアウトする | 迅速に認識し、長時間の作業を非同期で処理します。 |
次に何をすべきか: エンドポイントの詳細と例については、エンジニアを /api-docs にリンクしてください。
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
-H "x-api-key: sk_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"action": "webhook-register",
"url": "https://your-crm.example.com/semchat/webhook",
"events": ["handoff.requested", "message.user", "handoff.resolved"]
}'
import crypto from 'node:crypto';
function verifySemChatSignature(rawBody, signature, secret) {
const expected = crypto
.createHmac('sha256', secret)
.update(rawBody)
.digest('hex');
return crypto.timingSafeEqual(
Buffer.from(signature || ''),
Buffer.from(expected)
);
}
エンドポイントマップ
アクションベースのパブリック API を正しく使用する
これの目的: 機能に対して適切なアクションを選択するときにこれを使用します。
始める前に- すべてのリクエストは同じパブリック API 関数 URL を使用します。
- GET アクションはクエリ パラメーターを使用します。 POST アクションは JSON 本体を使用します。
- すべてのリクエストで x-api-key を送信します。
テスト方法: API キーまたはエンドポイントの変更後に、スモーク テストとして usage および list-bots を呼び出します。
| 問題 | 修正 |
|---|
| メソッドの不一致 | エンドポイント表に示されている方法を使用します。一部のアクションは GET のみまたは POST のみです。 |
| 必要な値がありません | botId、conversationId、Webhook ID、およびアクションのスペルを確認してください。 |
次に何をすべきか: 最初のリクエストには Quick Start を使用し、次に完全な参照には /api-docs を使用します。
| 方法 | アクション | 目的 |
|---|
| GET | list-bots | API キー所有者が利用できるすべてのボットをリストします。 |
| GET | get-bot | ボット ID によって 1 つのボット構成を取得します。 |
| POST | chat | 訪問者メッセージをボットに送信し、AI 応答を返します。 |
| GET | conversations | ボットの最近の conversations を最大 100 レコードまでリストします。 |
| GET | usage | プラン、クレジット、ボット数、conversations、および API キー usage を返します。 |
| GET | live-support-list | 人間のエージェントを待機している、または人間のエージェントによって処理される conversations をリストします。 |
| GET | live-support-messages | メッセージと訪問者情報を含むハンドオフ スレッドを取得します。 |
| POST | live-support-reply | 外部システムから人間エージェントの応答を送信します。 |
| POST | live-support-claim | 待機中のハンドオフ会話を要求します。 |
| POST | live-support-resolve | ハンドオフを解決するか、制御を AI に戻します。 |
| POST | webhook-register | HTTPS Webhook エンドポイントを登録します。 |
| GET | webhook-list | シークレットを返さずに Webhook 登録を一覧表示します。 |
| POST | webhook-delete | ID によって Webhook 登録を削除します。 |
アプリ機能のワークフロー
アプリのルート、ページ、ナビゲーション項目、ドキュメントエントリを追加する
これの目的: これは、新しい顧客向けダッシュボード機能を追加するときに使用します。
始める前に- 編集する前にブランチを作成します。
- 機能がアプリ リポジトリに属しているか、パブリック sem.chat フロントエンド リポジトリに属しているかを識別します。
- 新しい構造を追加する前に、既存のルート、サイドバー、i18n、および設定パターンを検査します。
1
ルートを追加する
顧客ページの保護されたルートを使用して src/App.tsx を更新するか、ページをパブリックにする必要がある場合にのみパブリック ルートを使用して src/App.tsx を更新します。
期待される結果: URL は、NotFound にヒットせずにアプリ内で解決されます。
2
ページコンポーネントを作成または更新する
既存のページ パターン、データの読み込み、空の状態、読み込み状態、および権限を使用します。
期待される結果: この機能はダッシュボードと一貫して動作します。
3
ダッシュボードナビゲーションを追加する
必要に応じて、ラベル、アイコン、ルート、プラン ゲートを使用してサイドバー/ナビゲーション ソースを更新します。
期待される結果: ユーザーはアプリ シェルから新しいページを見つけることができます。
4
ボットビルダーのタブまたは設定を追加する
機能がボットに属している場合は、Bot Builder タブ内に追加し、既存の保存フローを通じて永続化します。
期待される結果: ボット固有の構成はボットとともに保存され、ローカル状態で取り残されることはありません。
5
Supabase スキーマ/関数の変更を追加
サーバー側の作業用にテーブル/ポリシーとエッジ機能の移行を作成します。
期待される結果: データベースとサーバーの動作は繰り返し展開できます。
6
公開されている場合は API 形状を更新します
supabase/functions/public-api/index.ts でアクション処理を追加または拡張し、x-api-key の動作を文書化します。
期待される結果: 統合ではこの機能を安全に使用できます。
7
アプリのドキュメントと公開ドキュメントを更新する
アプリ内開発者ドキュメントとこの /documentation ページをスクリーンショットとクリックごとの手順で更新します。
期待される結果: ユーザーとエンジニアは両方の場所でこの機能を確認します。
8
チェックを実行する
アプリのテスト/ビルド、公開サイトでの SEO オプティマイザー、サイトマップ チェック、ブラウザー検証を実行します。
期待される結果: この機能はローカルで動作し、パブリック サイトは引き続きクロール可能です。
テスト方法: 新しいルートを開き、機能をエンドツーエンドで使用し、コンソール/ネットワーク エラーを検査し、UI からデータベースの変更を確認します。
| 問題 | 修正 |
|---|
| ルートは機能しますが、ナビが強調表示されません | サイドバーのルートの一致とリダイレクト パスを確認します。 |
| データはローカルで動作しますが、デプロイされていません | 移行、RLS ポリシー、およびエッジ機能の環境変数を確認します。 |
| サイトマップに公開ドキュメントがありません | SEO オプティマイザーを実行し、sitemap.xml で正規の URL を調べます。 |
次に何をすべきか: UI が変更されるたびに、ドキュメントのスクリーンショットをキャプチャまたは再生成します。
ドキュメントのメンテナンス ワークフロー
製品の変更後にこの公開ドキュメント ページを更新します
これの目的: これは、スクリーンショット、ワークフロー、API の動作、またはナビゲーションが変更されるときに使用します。
始める前に- 安全なデモ データのみを使用してください。
- 実際の顧客、電子メール、支払い詳細、API キー、またはプライベート conversations を決して公開しないでください。
- まず英語版マニュアルを更新し、その後 SEO チェックの前に各ローカライズ済みドキュメントページを更新します。
1
変更されたルートを監査する
アプリのルートを開き、何が変更されたのかを視覚的かつ手順的に特定します。
期待される結果: どのガイド、スクリーンショット、トラブルシューティングの行を編集する必要があるかがわかります。
2
安全なスクリーンショットをキャプチャまたは生成する
WebP アセットをアセット/ドキュメントに保存する前に、デモ ワークスペースを使用してシークレットをマスクします。
期待される結果: スクリーンショットは正確であり、公開しても安全です。
3
ガイドを更新する
関連する「目的」、「開始する前に」、「手順」、「期待される結果」、「テスト」、「トラブルシューティング」、および「次の」セクションを編集します。
期待される結果: このガイドでは、何をクリックするか、クリックするたびに何が起こるかをユーザーに説明します。
4
必要に応じてナビゲーションを更新する
セクションをスティッキー目次、モバイル セクション ピッカー、および主要ページの場合はビジュアル インデックスに追加します。
期待される結果: 読者は新しいコンテンツをすぐに見つけることができます。
5
SEO ツールを実行する
ノード tools/seo-optimize-static-pages.js およびノード tools/seo-optimize-static-pages.js --check を実行します。
期待される結果: 正規、メタデータ、サイトマップ、ロボットの出力は正しいままです。
6
クリーンアップと差分チェックを実行する
node tools/static-translation-cleanup.js --audit および git diff --check を実行します。
期待される結果: 静的な翻訳と空白はきれいです。
7
ブラウザの検証
サイトをローカルで提供し、デスクトップとモバイルでドキュメントをテストします。
期待される結果: 画像は読み込まれ、検索は機能し、コピー ボタンは機能し、目次はハイライトされ、レイアウトは Cookie バナーと重なりません。
テスト方法: /documentation で変更された機能名を検索し、正しいガイド ブロックが表示されることを確認します。
| 問題 | 修正 |
|---|
| モバイル上でスクリーンショット マーカーがドリフトする | スクリーンショット画像内にマーカーを保持するか、応答性の高いマーカー座標を使用します。 |
| 検索で新しいガイドが見つからない | データタイトルに有用なキーワードを追加し、ユーザーが検索する正確な製品用語を含めます。 |
| ローカライズ済みドキュメントが古くなる | 英語版マニュアルを編集した後、各ローカライズ済みドキュメントページを更新し、SEO オプティマイザーを再実行して、sitemap.xml にすべてのドキュメント URL が含まれていることを確認します。 |
次に何をすべきか: ドキュメント ページ、アセット、ヘッダー/フッター リンク、.htaccess、サイトマップの変更をまとめてコミットします。
重点を置いた API リファレンスが必要ですか?
エンドポイントレベルの API の詳細については、古い /api-docs ページが引き続き利用可能です。
API ドキュメントを開く