Compartir a través de

Enriquecer los detalles del registro de CRM con información de su aplicación (versión preliminar)

  • Artículo

Importante

[Este artículo es documentación preliminar y está sujeto a modificaciones].

Los vendedores pueden ver detalles sobre un contacto guardado, junto con sus registros asociados, como cuentas y oportunidades. Puede ampliar la capacidad de detalles del registro de CRM proporcionada por Copilot para ventas con información de su propia aplicación.

Descripción de API

Debe agregar la descripción de la API a la acción para permitir que Copilot para ventas identifique la API correcta que se debe invocar para enriquecer esta capacidad. La descripción debe ser la siguiente:

This action gets records related to a CRM record. The action enhances the existing skills of Copilot for Sales.

Parámetros de entrada

Copilot para ventas está diseñado para proporcionar los siguientes parámetros de entrada a sus API.

Name Tipo de datos / Formato Obligatorio Details Descripción que debe agregarse a la acción
recordType String Sí Tipo de entidad u objeto en CRM para el cual se solicitan registros relacionados. Incluye el nombre único independiente del idioma de la entidad u tipo de objeto, y no el nombre que se puede localizar. Por ejemplo, cuenta, oportunidad, etc. Esta entrada identifica el tipo de registro en CRM para el cual se solicitan los registros relacionados.
recordId String Sí Identificador único del registro CRM. Esta entrada proporciona el identificador único del registro CRM para el que se solicitan los registros relacionados.
top Número entero No Número de actividades para capturar. Esta entrada indica el número de registros relacionados que hay que recuperar.
skip Número entero No Número de actividades que se pueden omitir. Esta entrada indica el número de registros que se deben omitir al obtener registros relacionados.
crmType String No Los valores válidos son Dynamics 365 y Salesforce. Esta entrada indica el tipo de CRM del que se obtienen los registros relacionados.
crmOrgUrl String No Nombre de host de la organización CRM. Por ejemplo, contoso.crm.dynamics.com. Esta entrada indica la URL del entorno CRM del que se obtienen los registros relacionados.

Nota

  • Este punto de ampliación admite la representación de información desde múltiples extensiones de conector en el sidecar de Outlook, hasta un límite máximo de cinco.

Parámetros de salida

Copilot para ventas prevé recibir de sus API una lista de informaciones (objetos), cada uno con parámetros específicos. Para garantizar que Copilot para ventas pueda analizar el resultado correctamente, es fundamental seguir la estructura de respuesta que se describe a continuación.

Parámetro Tipo de datos Obligatorio Details
Valor Matriz Sí Lista de informaciones (objetos) definidos como se menciona en Esquema de informaciones
hasMoreResults Booleana No Indica si hay más resultados disponibles.

Esquema para obtener información

Name Tipo de datos / Formato Obligatorio Details Descripción que debe agregarse a la acción
recordId String Sí Identificador único del registro. Esta salida identifica de forma única cada registro relacionado devuelto por la acción.
recordTypeDisplayName String Sí Nombre del tipo de registro que debe estar traducido al idioma especificado con el encabezamiento Accept-Language. Por ejemplo, Contrato. Esta salida indica el nombre de tipo de registro de cada registro relacionado devuelto por la acción.
recordTypePluralDisplayName String Sí Nombre en plural del tipo de registro que debe estar traducido al idioma especificado con el encabezamiento Accept-Language. Por ejemplo, Contratos. Esta salida indica el nombre para mostrar plural del tipo de registro de cada registro relacionado devuelto por la acción.
recordType String Sí Nombre del sistema del tipo de registro. Por ejemplo, contrato. Esta salida indica el tipo de registro de cada registro relacionado devuelto por la acción.
recordTitle String Sí Nombre del registro. Por ejemplo, Contrato de renovación de Contoso 2023. Esta salida indica el título de registro de cada registro relacionado devuelto por la acción.
Dirección URL String No Una URL válida para abrir el registro en la aplicación del socio. Esta salida indica la URL de cada registro relacionado devuelto por la acción.
additionalProperties Objeto con nombre de propiedad y valor de propiedad de tipo cadena No Propiedades adicionales mostradas en la vista detallada. Los nombres y valores de las propiedades están en lenguaje natural en el idioma especificado con el encabezado Accept-Language. Por ejemplo,
{
"Razón del estado": "Desconectado",
"Propietario": "Kenny Smith"
}		 Este resultado indica propiedades adicionales como pares de nombre-valor de cada registro relacionado devuelto por la acción.

Ejemplo

{
  "value": [
    {
      "recordId": "ID1",
      "recordTypeDisplayName": "Contract",
      "recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
      "recordTypePluralDisplayName": "Documents",
      "recordType": "contract",
      "url": "https://contosohub.com/contract/id1",
      "additionalProperties": {
        "Status": "Signed",
        "Date": "9/7/23",
        "Signed by": "Alberto Burgos, Tony [last name]"
      }
    },
    {
      "recordId": "ID2",
      "recordTypeDisplayName": "Contract",
      "recordTitle": "ABC Company 2023 Renewal Contract",
      "recordTypePluralDisplayName": "Documents",
      "recordType": "contract",
      "url": "https://contosohub.com/contract/id2",
      "additionalProperties": {
        "Status": "Delivered",
        "Date": "9/3/23",
         "Signed by": "Alberto Burgos"
      }
    }
  ],
  "hasMoreResults": false
}

La siguiente imagen muestra un ejemplo de cómo la salida de la API se asigna a los registros relacionados.

Captura de pantalla que muestra la anatomía de los registros relacionados de una aplicación asociada.

Leyenda:

  1. Tarjeta que muestra registros relacionados de la aplicación de asociado.
  2. Título e icono de la tarjeta. El icono se recupera de los metadatos del conector Power Platform. El título de la tarjeta es el nombre del conector Power Platform.
  3. Títulos de registros relacionados de la respuesta API. Dos propiedades adicionales de la respuesta API se representan como campos clave de cada registro relacionado.
  4. Ícono de más acciones para copiar un enlace al registro o ver los detalles del registro en la aplicación del socio. El enlace se basa en la URL del registro relacionado en la respuesta de API.
  5. Propiedades adicionales del registro relacionado de la respuesta API.

Consulte también

Obtenga más información sobre los detalles del registro CRM
Agregar una nueva capacidad de preguntas y respuestas al chat de Sales
Enriquecer el resumen del correo electrónico con información valiosa de su aplicación
Enriquezca la información clave de ventas con información de su aplicación
Enriquecer los detalles del resumen de CRM con información de su aplicación
Ampliar Microsoft Copilot para ventas con aplicaciones de partners
Crear API de aplicaciones para ampliar Copilot para ventas