Zoho Sales IQ
Zoho Sales IQ にエージェントサービスを連携することで、Zoho Sales IQ のユーザーがエージェントと直接やり取りできるようになります。
準備
連携を行う前に、Zoho 側でいくつかのパラメータを設定する必要があります。これらのパラメータは、GPTBotsとの連携時に使用されます。
クライアントIDの作成
Zoho API Consoleにログインします。
注：アカウントが米国（US）以外のデータセンターに属している場合は、ドメインを変更する必要があります。詳細は以下をご参照ください：
| データセンター | 開発者コンソールURL |
|---|---|
| US (United States) | https://api-console.zoho.com/add |
| EU(Europe) | https://api-console.zoho.eu/add |
| IN(India) | http://api-console.zoho.in/add |
| AU(Australia) | http://api-console.zoho.com.au/add |
| CN(China) | http://api-console.zoho.com.cn/add |
| JP(Japan) | http://api-console.zoho.jp/add |
2. 既に利用可能な「アプリケーション」がある場合は、そのアプリケーションに移動し、「Client Secret」をクリックして、該当の Client ID と Client Secret をコピーしてください。これらはGPTBotsとのインテグレーション設定時に使用します。
- まだアプリケーションがない場合は、右上の ADD CLIENT（クライアントを追加） をクリックし、用途に応じてクライアントタイプを選択し、作成します。
- 新しいアプリケーションを作成する場合は、「Homepage URL」にご利用中のサービスのドメイン名を入力し、「Authorized Redirect URIs」には、現在のサービスのドメイン名 + /api/console/bot/zoho/salesiq/redirect を入力します。**CREATE** をクリックすると、クライアントが作成され、「Client ID」と「Client Secret」が発行されます。これらをコピーして、GPTBotsの設定に使用してください。
新しいアプリケーションを作成する場合は、「Homepage URL」にご利用中のサービスのドメイン名を入力し、「Authorized Redirect URIs」には、現在のサービスのドメイン名 + /api/console/bot/zoho/salesiq/redirect を入力します。**CREATE** をクリックすると、クライアントが作成され、「Client ID」と「Client Secret」が発行されます。これらをコピーして、GPTBotsの設定に使用してください。このコードブロックをポップアップで表示
注：1つのClient IDは、同時に最大20件までの認証が可能です。20件を超えると、最初に認証されたBotのZoho認証が無効になります。
インテグレーション設定
GPTBots にログインします。
組織に入り、該当するエージェントを選択し、バージョンを保存して**Publish（公開）**をクリックします。公開に成功したら、**Integrations（インテグレーション）**をクリックします。
- インテグレーション方法としてZoho Sales IQを選択します。
各種パラメータを入力します：
- Client ID と Client Secret: 必須。準備フェーズで取得したものを入力してください。
- Screen Name: 必須。ログイン中のアカウントページのURLから取得します。たとえば、https://salesiq.zoho.com/gptbots/mychats/000000000000003 というアドレスであれば、「gptbots」が Screen Name になります。
- Email: 必須。Zoho アカウントに紐づいているメールアドレスを入力してください。
- Server Region: 必須。ご利用の Zoho アカウントが属するリージョンを選択してください。
- Public Key: 任意。「Secure your webhook（Webhook のセキュリティ保護）」を有効化する場合は、先に**Integrations（インテグレーション）**をクリックしてから戻って入力してください。有効にしない場合は不要です。
- **Integrations（インテグレーション）**をクリックすると、認可ステータスのポップアップが表示されます。Acceptをクリックします。
- 認可に成功すると、GPTBots により Webhook の URL が生成されます。この段階で、**Setting（設定）**ページへ移動します。
7.Webhooksをクリックし、Data modificationsを選択してAddをクリックします。
Webhook の内容を入力します：
- Brand: Webhook を受信する対象のブランドを選択します。
- URL to be invoked: GPTBots のインテグレーション設定で取得した Webhook URL を入力します。
- Events: conversation.created および conversation.visitor.replied を選択します。入力後、**Create webhook（Webhook の作成）**をクリックします。
Secure your webhook（Webhook のセキュリティ保護）：任意。Webhook が正規の送信元から来ているかを検証できます。有効化後、「公開鍵の生成」をクリックし、「In Use（使用中）」と表示された公開鍵をコピーして、GPTBots の設定画面に貼り付けます。
Zoho Sales IQ 上で Bot と会話する
インテグレーション設定が完了すると、Zoho のサービス上で Bot と会話できるようになります。