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

  • Esta es una característica en vista previa lista para producción.
  • Las versiones preliminares listas para producción están sujetas a condiciones de uso complementarias.

[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 función de detalles de registros de gestión de relaciones con los clientes (CRM) que ofrece Copilot para ventas con información de su propia aplicación.

Descripción de API

Debe agregar la siguiente descripción de API a la acción. De esta manera, Copilot para ventas puede identificar la API correcta que se debe invocar para enriquecer la capacidad.

Esta acción obtiene los registros relacionados con un registro de CRM. La acción mejora las capacidades existentes de Copilot para ventas.

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. El valor incluye el nombre único independiente del lenguaje de la entidad o el tipo de objeto, no el nombre para mostrar que se puede localizar. Algunos ejemplos son la cuenta y la oportunidad. Esta entrada identifica el tipo de registro en CRM para el cual se solicitan los registros relacionados.
recordId String Sí El 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 para omitir. Esta entrada indica el número de registros que se deben omitir al obtener registros relacionados.
crmType String No Tipo de sistema CRM. Los valores válidos con Salesforce y Dynamics 365. Esta entrada indica el tipo de CRM del que se obtienen los registros relacionados.
crmOrgUrl String No El nombre de host de la organización de CRM, como 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 hasta cinco extensiones de conector en el sidecar de Outlook.

Parámetros de salida

Copilot para ventas espera recibir una lista de información (objetos) de sus API y espera que cada información tenga parámetros específicos. Para garantizar que Copilot para ventas pueda analizar correctamente la salida, la estructura de la respuesta debe cumplir las directrices de la tabla siguiente.

Parámetro Tipo de datos Obligatorio Details
Valor Matriz Sí Una lista de información (objetos) que se define como se describe en la sección Esquema de informaciones.
hasMoreResults Booleana No Un valor que indica si hay más resultados.

Esquema para la información

Name Tipo de datos/formato Obligatorio Details Descripción que debe agregarse a la acción
recordId String Sí El identificador único del registro. Esta salida identifica de forma única cada registro relacionado devuelto por la acción.
recordTypeDisplayName String Sí El nombre para mostrar del tipo de registro, como Contrato. Debe estar localizado en el idioma que se especifica a través del encabezado Accept-Language. Esta salida indica el nombre de tipo de registro de cada registro relacionado devuelto por la acción.
recordTypePluralDisplayName String Sí El nombre en plural para mostrar del tipo de registro, como Contratos. Debe estar localizado en el idioma que se especifica a través del encabezado Accept-Language. Esta salida indica el nombre para mostrar plural del tipo de registro de cada registro relacionado devuelto por la acción.
recordType String Sí El nombre de sistema para el tipo de registro, como Contrato. Esta salida indica el tipo de registro de cada registro relacionado devuelto por la acción.
recordTitle String Sí El nombre del registro, como contrato de renovación 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 partner. Esta salida indica la URL de cada registro relacionado devuelto por la acción.
additionalProperties Un objeto que tiene valores Nombre de propiedad y Valor de propiedad del tipo Cadena No

Propiedades adicionales que se muestran en la vista detallada. Los nombres y valores de propiedad están en lenguaje natural en el idioma que se especifica a través del encabezado Accept-Language. A continuación se muestra un 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
}

El ejemplo de 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 los registros relacionados de la aplicación de partner.
  2. Título e icono de la tarjeta. El icono se recupera de los metadatos del conector Microsoft Power Platform. El título es el nombre del conector de Microsoft Power Platform.
  3. Títulos de registro relacionados de la respuesta de la API. Dos propiedades adicionales de la respuesta de la API se representan como campos clave de cada registro relacionado.
  4. Botón "Más acciones" que se puede usar para copiar un vínculo al registro o para ver los detalles del registro en la aplicación asociada. El vínculo se basa en la URL del registro relacionado en la respuesta de la API.
  5. Propiedades adicionales del registro relacionado de la respuesta de la API.

Ver detalles de registros
Agregar una nueva capacidad de preguntas y respuestas al chat de ventas
Enriquecer resúmenes 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 resúmenes del registro de CRM con información de su aplicación
Ampliar Microsoft 365 Copilot para ventas con aplicaciones de partners
Crear extensiones Copilot para ventas