Untitled

引言

本页为开发者构建特定应用程序的 GPT Action 提供说明和指南。在继续之前，请确保您已熟悉以下信息：

此特定的 GPT Action 概述了如何连接到 Salesforce，特别是 Salesforce Service Cloud。此 Action 中详细介绍的模式允许用户直接从 ChatGPT 拉取案例数据并更新案例。为其他 Salesforce Cloud 解决方案创建 Actions 的设置过程使用相同的已连接应用程序和身份验证设置，但需要不同的 API 模式。

价值 + 示例业务用例

价值：用户现在可以利用 ChatGPT 的自然语言功能直接连接到 Salesforce

示例用例：

减少客户的平均响应时间
减少排查案例或问题的时间
结合 GPT 中的知识和说明，确保在响应客户时具有更一致的品牌声音

应用程序信息

应用程序关键链接

在开始之前，请查看应用程序中的这些链接：

应用程序先决条件

在开始之前，请确保在您的应用程序环境中完成以下步骤：

确保您拥有在 Salesforce 中创建应用程序的权限

ChatGPT 步骤

自定义 GPT 说明

创建自定义 GPT 后，请将以下文本复制到“说明”面板中。有疑问吗？请查看入门示例，了解此步骤的详细信息。

**上下文**：您的目的是从 Service Cloud 拉取信息，并将更新推送到案例。用户将向您提出问题并要求您进行更新。

**说明**：

1. 当用户要求您在 Service Cloud 中帮助他们解决案例时，请询问案例编号，并通过 getCaseDetailsFromNumber 操作将案例的详细信息拉入对话中。
2. 如果用户要求您更新案例详细信息，请使用 updateCaseStatus 操作。

**示例**：
用户：请帮助我解决 Service Cloud 中的案例 00001104。

OpenAPI 模式

创建自定义 GPT 后，请将以下文本复制到“操作”面板中。有疑问吗？请查看入门示例，了解此步骤的详细信息。

openapi: 3.1.0
info:
  title: Salesforce Service Cloud 案例更新 API
  description: 用于更新 Salesforce 中 Service Cloud 票证（案例）状态的 API。
  version: 1.0.3
servers:

  - url: https://your_instance.my.salesforce.com
    description: 您的 Salesforce 实例的基本 URL（将“your_instance”替换为您的实际 Salesforce 域）
paths:
  /services/data/v60.0/sobjects/Case/{CaseId}:
    patch:
      operationId: updateCaseStatus
      summary: 更新 Service Cloud 案例的状态
      description: 根据案例 ID 号更新 Service Cloud 票证的状态。
      parameters:

        - name: CaseId
          in: path
          required: true
          description: 要更新的案例的 ID。
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                Status:
                  type: string
                  description: 案例的新状态。
      responses:
        '204':
          description: 成功更新案例状态
        '400':
          description: 请求错误 - 输入无效或找不到案例 ID
        '401':
          description: 未授权 - 需要身份验证
        '404':
          description: 未找到 - 案例 ID 不存在
    delete:
      operationId: deleteCase
      summary: 删除 Service Cloud 案例
      description: 根据案例 ID 号删除 Service Cloud 票证。
      parameters:

        - name: CaseId
          in: path
          required: true
          description: 要删除的案例的 ID。
          schema:
            type: string
      responses:
        '204':
          description: 成功删除案例
        '400':
          description: 请求错误 - 无效的案例 ID
        '401':
          description: 未授权 - 需要身份验证
        '404':
          description: 未找到 - 案例 ID 不存在
  /services/data/v60.0/query:
    get:
      operationId: getCaseDetailsFromNumber
      summary: 使用案例编号检索案例详细信息
      description: 检索与给定案例编号关联的 Service Cloud 案例的详细信息。
      parameters:

        - name: q
          in: query
          required: true
          description: 用于根据案例编号查找案例详细信息的 SOQL 查询字符串。
          schema:
            type: string
            example: "SELECT Id, CaseNumber, Status, Subject, Description FROM Case WHERE CaseNumber = '123456'"
      responses:
        '200':
          description: 成功检索案例详细信息
          content:
            application/json:
              schema:
                type: object
                properties:
                  totalSize:
                    type: integer
                  done:
                    type: boolean
                  records:
                    type: array
                    items:
                      type: object
                      properties:
                        Id:
                          type: string
                        CaseNumber:
                          type: string
                        Status:
                          type: string
                        Subject:
                          type: string
                        Description:
                          type: string
        '400':
          description: 请求错误 - 查询无效
        '401':
          description: 未授权 - 需要身份验证
        '404':
          description: 未找到 - 案例编号不存在