この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

LiveChatButton

訪問者がチャットユーザとのチャットを要求できるボタンを表します。このオブジェクトは、API バージョン 24.0 以降で使用できます。

サポートされているコール

create()、describeSObjects()、query()、retrieve()、update()、upsert()

項目

項目名 詳細
Animation
型
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
自動チャット招待が画面に表示される場合に使用されるアニメーションの種別。自動チャット招待専用です。API バージョン 29.0 以降で使用できます。
可能な値は次のとおりです。
  • Appear
  • Custom
  • Fade
  • Slide
AutoGreeting
型
textarea
プロパティ
Create、Filter、Nillable、Sort、Update
説明
チャットセッションを開始するとエージェントから訪問者に自動的に送信されるテキスト。

LiveChatButton オブジェクトの AutoGreeting 項目の挨拶メッセージは、LiveChatUserConfig オブジェクトの AutoGreeting 項目の個人ユーザの挨拶メッセージを上書きします。

メモ

ChasitorIdleTimeout
型
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
顧客がエージェントのメッセージに応答しない場合にチャットがタイムアウトするまでの時間。
ChasitorIdleTimeoutWarning
型
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
顧客がエージェントのメッセージに応答しない場合に警告が表示され、タイマーが減算し始めるまでの時間。この値は ChasitorIdleTimeout 値より短くする必要があります。少なくとも 30 秒短くすることをお勧めします。
ChatPageId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
カスタムのチャットウィンドウコードを含むカスタム VisualForce ページのレコード ID。
この項目はリレーション項目です。
リレーション名
ChatPage
リレーション種別
Lookup
参照先
ApexPage
CustomAgentName
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ボタンに関連付けられたエージェントのカスタム名。API バージョン 29.0 以降で使用できます。

LiveChatButton オブジェクトの CustomAgentName 項目にあるカスタムエージェント名によって、LiveChatUserConfig オブジェクトの CustomAgentName 項目にある個人ユーザのカスタムエージェント名は上書きされます。

メモ

DeveloperName
型
string
プロパティ
Create、Filter、Group、Sort、Update
説明
API のオブジェクトの一意の名前。この名前は、アンダースコアと英数字のみを使用でき、組織内で一意にする必要があります。最初は文字であること、空白は使用しない、最後にアンダースコアを使用しない、2 つ続けてアンダースコアを使用しないという制約があります。管理パッケージでこの項目を使用することにより、パッケージインストール時の名前の競合を回避します。この項目を使用して、開発者は管理パッケージのオブジェクト名を変更し、変更はサブスクライバーの組織で反映されます。

大規模データセットを作成する場合、必ず各レコードの一意の DeveloperName を指定してください。DeveloperName が指定されていないと、Salesforce で各レコードの DeveloperName を生成している間にパフォーマンスが低下する可能性があります。

メモ

HasQueue
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
エージェントが対応可能になるまで受信チャット要求をキューに入れておくことを許可するかどうかを決定します。
デフォルト値は false です。
InviteEndPosition
型
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
自動チャット招待のアニメーションが終了する画面上の位置。

カスタムアニメーションを使用する場合は、自動チャット招待の終了位置を選択する必要はありません。

メモ

自動チャット招待専用です。API バージョン 29.0 以降で使用できます。

可能な値は次のとおりです。
  • Bottom
  • BottomLeft
  • BottomRight
  • Center
  • Left
  • Right
  • Top
  • TopLeft
  • TopRight
InviteImageId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
自動チャット招待に表示される静的画像リソースのレコード ID。自動チャット招待専用です。API バージョン 29.0 以降で使用できます。
この項目はリレーション項目です。
リレーション名
InviteImage
リレーション種別
Lookup
参照先
StaticResource
InviteStartPosition
型
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
自動チャット招待のアニメーションが開始する画面上の位置。

カスタムアニメーションを使用する場合は、自動チャット招待の開始位置を選択する必要はありません。

メモ

自動チャット招待専用です。API バージョン 29.0 以降で使用できます。

可能な値は次のとおりです。
  • Bottom
  • BottomLeft
  • BottomLeftBottom
  • BottomLeftLeft
  • BottomRight
  • BottomRightBottom
  • BottomRightRight
  • Left
  • Top
  • Right
  • TopLeft
  • TopLeftLeft
  • TopLeftTop
  • TopRight — 右上
  • TopRightRight
  • TopRightTop
IsActive
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
自動チャット招待の場合、自動チャット招待が有効であるかどうかを指定します。
デフォルト値は false です。
IsRoutingFlowEnabled
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
ルーティングフローが有効であるかどうかを示します。
デフォルト値は false です。
Language
型
picklist
プロパティ
Create、Defaulted on create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
チャットの言語。
可能な値は次のとおりです。
  • da — デンマーク語
  • de — ドイツ語
  • en_US — 英語
  • es — スペイン語
  • es_MX — スペイン語 (メキシコ)
  • fi — フィンランド語
  • fr — フランス語
  • it — イタリア語
  • ja — 日本語
  • ko — 韓国語
  • nl_NL — オランダ語
  • no — ノルウェー語
  • pt_BR — ポルトガル語 (ブラジル)
  • ru — ロシア語
  • sv — スウェーデン語
  • th — タイ語
  • zh_CN — 中国語 (簡体字)
  • zh_TW — 中国語 (繁体字)
MasterLabel
型
string
プロパティ
Create、Filter、Group、Sort、Update
説明
チャットボタンの表示ラベル。
NumberOfReroutingAttempts
型
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
すべてのエージェントがチャット要求を拒否した場合に、対応可能なエージェントにチャット要求を再転送できる回数を指定します。
OfflineImageId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ボタンがオフライン (無効) である場合に表示される静的画像リソースのレコード ID。
この項目はリレーション項目です。
リレーション名
OfflineImage
リレーション種別
Lookup
参照先
StaticResource
OnlineImageId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ボタンがオンライン (有効) である場合に表示される静的画像リソースのレコード ID。
この項目はリレーション項目です。
リレーション名
OnlineImage
リレーション種別
Lookup
参照先
StaticResource
OptionsHasChasitorIdleTimeout
型
boolean
プロパティ
Create、Filter、Update
説明
顧客のタイムアウトが有効になっているかどうかを示します。
OptionsHasInviteAfterAccept
型
boolean
プロパティ
Create、Filter、Update
説明
顧客が以前の自動チャット招待を受諾したか (true)、辞退した (false) 後に、その顧客に自動チャット招待を送信できるかどうかを指定します。自動チャット招待専用です。API バージョン 29.0 以降で使用できます。
OptionsHasInviteAfterReject
型
boolean
プロパティ
Create、Filter、Update
説明
顧客が以前の自動チャット招待を辞退したか (true)、受諾した (false) 後に、その顧客に自動チャット招待を送信できるかどうかを指定します。自動チャット招待専用です。API バージョン 29.0 以降で使用できます。
OptionsHasRerouteDeclinedRequest
型
boolean
プロパティ
Create、Filter、Update
説明
すべての対応可能なエージェントから拒否されたチャット要求を、対応可能なエージェントに再転送する必要があるか (true)、否か (false) を指定します。
OptionsIsAutoAccept
型
boolean
プロパティ
Create、Filter、Update
説明
チャット要求を割り当てられたエージェントが、チャット要求を自動的に受け入れる必要があるか (true)、否か (false) を指定します。[[チャット] ボタンおよび自動招待] で、RoutingType が MostAvailable または LeastActive に設定されている場合。API バージョン 30.0 以降で使用できます。
OptionsIsInviteAutoRemove
型
boolean
プロパティ
Create、Filter、Update
説明
特定の時間が経過した後に、自動チャット招待を画面から自動的に削除するか (true)、否か (false) を指定します。自動チャット招待専用です。API バージョン 29.0 以降で使用できます。
OverallQueueLength
型
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
キューが許可されたチャット要求の最大数。
PerAgentQueueLength
型
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
必要なスキルを有する各エージェントに対してキューが許可されるチャット要求の最大数。
PostchatPageId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
チャットが終了したときに表示されるカスタム VisualForce ページのレコード ID。
この項目はリレーション項目です。
リレーション名
PostchatPage
リレーション種別
Lookup
参照先
ApexPage
PostchatUrl
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
チャットが終了したときのユーザの移動先 URL。
PrechatFormPageId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
チャット開始前に表示されるカスタム VisualForce ページのレコード ID。
この項目はリレーション項目です。
リレーション名
PrechatFormPage
リレーション種別
Lookup
参照先
ApexPage
PrechatFormUrl
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
チャットが開始する前のユーザの移動先 URL。
PushTimeout
型
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
次に対応可能なエージェントに転送するまでに、エージェントがチャット要求への回答に費やすことのできる秒数。
QueueId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
このチャットボタンに使用されるキューのレコード ID。
この項目はリレーション項目です。
リレーション名
Queue
リレーション種別
Lookup
参照先
Group
RoutingConfigurationId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
このチャットボタンに使用されるルーティング設定のレコード ID。
この項目はリレーション項目です。
リレーション名
RoutingConfiguration
リレーション種別
Lookup
参照先
QueueRoutingConfig
RoutingType
型
picklist
プロパティ
Create、Filter、Group、Restricted picklist、Sort、Update
説明
チャット要求がエージェントに転送される方法。値は次のとおりです。
  • Choice — 受信チャット要求が Salesforce コンソールの Live Agent のキューに追加され、必要なスキルを有するすべてのエージェントがアクセスできます。
  • Least Active — 受信チャットが、必要なスキルを有し、アクティブなチャット数が最少のエージェントに転送されます。
  • Most Available — 受信チャットが、必要なスキルを持ち、参加可能なチャット数とアクティブなチャットセッション数の差が最大のエージェントに転送されます。たとえば、エージェント A と B のどちらも参加可能チャット数が 5 で、エージェント A はアクティブなチャットセッションが 3 つ、エージェント B はアクティブなセッションが 1 つの場合、受信チャットはエージェント B に転送されます。
  • Omni — チャットはオムニチャネルキューを使用して転送されます。
SiteId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
静的リソースとカスタム VisualForce ページの読み込みに使用されるサイトのレコード ID。
この項目はリレーション項目です。
リレーション名
Site
リレーション種別
Lookup
参照先
Site
SkillId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
受信チャット要求を転送するために使用されるスキルのレコード ID。チャットボタンに複数のスキルを関連付けるには、SkillId 項目の 1 つのスキルを参照してから、残りのスキルの LiveChatButtonSkill 結合オブジェクトを使用します。
この項目はリレーション項目です。
リレーション名
Skill
リレーション種別
Lookup
参照先
Skill
TimeToRemoveInvite
型
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
自動招待が自動的に削除されるまで画面に留まる秒数。自動チャット招待専用です。API バージョン 29.0 以降で使用できます。
Type
型
picklist
プロパティ
Create、Filter、Group、Restricted picklist、Sort、Update
説明
顧客に表示する要素の種別。
可能な値は次のとおりです。
  • Invite — 自動招待
  • Standard — チャットボタン
WindowLanguage
型
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
標準チャットウィンドウに使用される言語。カスタムチャットウィンドウは、ユーザのブラウザの言語を使用します。
可能な値は次のとおりです。
  • da — デンマーク語
  • de — ドイツ語
  • en_US — 英語
  • es — スペイン語
  • es_MX — スペイン語 (メキシコ)
  • fi — フィンランド語
  • fr — フランス語
  • it — イタリア語
  • ja — 日本語
  • ko — 韓国語
  • nl_NL — オランダ語
  • no — ノルウェー語
  • pt_BR — ポルトガル語 (ブラジル)
  • ru — ロシア語
  • sv — スウェーデン語
  • th — タイ語
  • zh_CN — 中国語 (簡体字)
  • zh_TW — 中国語 (繁体字)

使用方法

このオブジェクトを使用して、チャットボタンと自動チャット招待をクエリおよび管理します。