クイックスタート
Respondo チャットウィジェットを 2 分以内にあなたのウェブサイトへ追加できます。
1
スクリプトを追加する
ウィジェットを表示したいすべてのページで、次のスニペットを </body> の直前に貼り付けてください:
HTMLhtml
<script>
window.Respondo = window.Respondo || {};
Respondo.init = Respondo.init || function(c) { window.RespondoAIConfig = c; };
Respondo.q = Respondo.q || [];
Respondo.identify = Respondo.identify || function(d) { Respondo.q.push(['identify', d]); };
Respondo.init({
agentId: 'YOUR_AGENT_ID',
channelId: 'YOUR_CHANNEL_ID'
});
</script>
<script src="https://api.respondo.ai/widget/widget.js" async></script>YOUR_AGENT_ID と YOUR_CHANNEL_ID をチャネル設定にある Agent ID と Channel ID に置き換えてください(または、値が入力済みのスニペットをチャネルページからコピーしてください)。ウィジェットは非同期で読み込まれるため、ページのパフォーマンスに影響しません。フレームワークをお使いですか?#
同じウィジェットを、お使いのスタックに組み込みます。タブを選択してください:
このコンポーネントを、アプリのルート付近で一度だけレンダリングします:
Reacttsx
// respondo-widget.tsx — render once, near the root of your app
import { useEffect } from 'react';
export function RespondoWidget() {
useEffect(() => {
const w = window as any;
w.Respondo = w.Respondo || {};
w.Respondo.init = w.Respondo.init || function (c) { w.RespondoAIConfig = c; };
w.Respondo.q = w.Respondo.q || [];
w.Respondo.identify = w.Respondo.identify || function (d) { w.Respondo.q.push(['identify', d]); };
if (!document.querySelector('script[data-respondo]')) {
w.Respondo.init({
agentId: 'YOUR_AGENT_ID',
channelId: 'YOUR_CHANNEL_ID'
});
const s = document.createElement('script');
s.src = 'https://api.respondo.ai/widget/widget.js';
s.async = true;
s.dataset.respondo = '1';
document.body.appendChild(s);
}
}, []);
return null;
}YOUR_AGENT_ID / YOUR_CHANNEL_ID をチャネル設定にある値に置き換えてください。あるいは、値が入力済みのスニペットをチャネルページからコピーすることもできます。
2
ユーザーを識別する(推奨)
ユーザーがログインした後、 identify() を呼び出してチャットセッションをそのプロフィールに紐付けます:
JavaScriptjavascript
Respondo.identify({
email: 'user@example.com',
name: 'John Doe',
userId: 'usr_12345', // 社内のユーザー ID
metadata: { // 任意のカスタムフィールド
plan: 'premium',
company: 'Acme Inc'
},
properties: { // カスタムの連絡先プロパティ(Agent Settings で定義)
account_type: 'enterprise',
region: 'eu-west'
}
});完了!
ウィジェットは画面右下に表示されます。すべての会話は自動的に Conversations ダッシュボードへ流れ込みます。