Enriquecer los resúmenes de registros de CRM con información de su aplicación (versión preliminar)
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].
Para comprender mejor el contexto de una reunión para la que se están preparando o un correo electrónico que están leyendo, los vendedores quieren información relevante sobre la gestión de las relaciones con los clientes (CRM), como consultas, inquietudes y notas de los clientes. Copilot para ventas utiliza IA para generar un resumen de cada registro de CRM. Este resumen destaca detalles cruciales, como la etapa de ventas, el presupuesto y la fecha de cierre proyectada. Puede ampliar la capacidad de resumen del registro de CRM proporcionada por 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 información de ventas adicional relacionada con un registro de CRM que se mostrará en la tarjeta de resumen de registros de C4S. La acción mejora las capacidades existentes de copiloto 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 solicita información relacionada, como actividades. 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 indica la entidad o el tipo de objeto en CRM para el cual se solicita información. |
| recordId | String | Sí | El identificador único del registro CRM. | Esta entrada indica el identificador único del registro CRM para el que se solicita información. |
| startDateTime | Cadena con formato de fecha y hora | No | Fecha y hora de inicio para buscar información. El formato sigue la especificación OpenAPI. A continuación, tiene un ejemplo: 2017-07-21T17:32:28Z. | Esta entrada indica la fecha y hora de inicio de la información solicitada. |
| endDateTime | Cadena con formato de fecha y hora | No | Fecha y hora de finalización para buscar información. El formato sigue la especificación OpenAPI. A continuación, tiene un ejemplo: 2017-07-21T17:32:28Z. | Esta entrada indica la fecha y hora de finalización de la información solicitada. |
| top | Número entero | No | Número de informaciones para capturar. | Esta entrada indica la cantidad de información que se debe recuperar. |
| skip | Número entero | No | El número de conocimientos a omitir. | Esta entrada indica la cantidad de información que se debe omitir. |
| crmType | String | No | Los valores válidos con Salesforce y Dynamics 365. | Esta entrada indica el tipo de CRM en el que existe el registro de CRM, para el cual se solicita información. |
| 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 en el que existe el registro CRM para el que se solicita información. |
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 |
|---|---|---|---|---|
| nombre | String | Sí | Título de la información en la tarjeta de cita. Es el título en lenguaje natural de la idea en el lenguaje especificado en el encabezado de solicitud de Accept-Language. A continuación se muestra un ejemplo de Contrato firmado. |
Esta salida indica el título de la actividad en la tarjeta de citas. |
| Descripción | String | Sí | La descripción de la conclusión. Se muestra como viñetas en el resumen del registro y es la descripción en lenguaje natural de la información en el idioma que se especifica a través del encabezado de Accept-Language. Ejemplo: Kenny, Logan y otros dos firmaron el contrato de renovación Contoso 2023 el 9/7/2023. |
Esta salida indica la descripción de la información. |
| dateTime | Cadena con formato de fecha y hora | Sí | La fecha y la hora de la actividad en formato UTC. Si la actividad tiene una hora de inicio y una hora de finalización, la aplicación debe determinar qué hora mostrar. El formato sigue la especificación OpenAPI. A continuación, tiene un ejemplo: 2017-07-21T17:32:28Z. | Esta salida indica el tiempo asociado con la información. |
| Dirección URL | String | No | Una URL válida para abrir la actividad en la aplicación del partner. | Este resultado indica la URL para abrir la informació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 { |
Este resultado indica propiedades adicionales que se muestran en la vista detallada de la información. |
Nota
Si bien los requisitos de API para ampliar las capacidades de resumen de correo electrónico y resumen de registros pueden parecer similares, deben agregarse como acciones independientes en el conector.
Ejemplo
{
"value": [
{
"title": "Contract signed",
"description": "You have 5 connections in Fourth Coffee Inc",
"dateTime": "2024-05-07T03:28:38.0667701Z",
"url": null,
"additionalProperties": {
"Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
"Signed by": "Alberto Burgos, Tony",
"Signed": "9/7/23"
}
},
{
"title": "Contract signed",
"description": "Multiple stakeholders from Fourth Coffee have visited the Contoso website four times in the last four months",
"dateTime": "2024-05-07T03:28:38.0669445Z",
"url": null,
"additionalProperties": {
"Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
"Signed by": "Alberto Burgos, Tony",
"Signed": "9/7/23"
}
}
],
"hasMoreResults": false
}
El ejemplo de la imagen siguiente muestra cómo se asigna la salida de la API al resumen del registro.
Leyenda:
- Sección que muestra los resultados de la aplicación de los partners. El título de la sección se deriva del nombre del conector de Microsoft Power Platform.
- Descripciones de información de la respuesta de la API.
- Números de cita que se pueden seleccionar para ver detalles sobre la información.
- Tarjeta de cita que muestra detalles sobre la información.
- Icono y título de la información. El icono se recupera de los metadatos del conector Microsoft Power Platform. El texto del título es el título de la información de la respuesta de la API.
- Propiedades adicionales de la información de la respuesta de la API.
- Nombre de la aplicación de asociado. El nombre que aparece es el del conector de Microsoft Power Platform.
- Vínculo que puede seleccionarse para ver los detalles de la información en la aplicación del socio. Se basa en la URL de la información en la respuesta de la API.
Información relacionada
Ver el resumen del registro
Enriquecer resúmenes del correo electrónico con información valiosa de su aplicación
Enriquezca los borradores de correo electrónico con vínculos de archivos de su aplicación
Enriquezca la información clave de ventas con información de su aplicación
Enriquecer los detalles de los registros de CRM con información de su aplicación
Ampliar Microsoft 365 Copilot para ventas con aplicaciones de partners
Crear extensiones Copilot para ventas