Enriquecer resumos de registro de CRM com insights do aplicativo (versão preliminar)
Importante
- Esta é uma versão prévia do recurso pronta para produção.
- As versões prévias prontas para produção estão sujeitas a termos de uso complementares.
[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]
Para entender melhor o contexto de uma reunião para a qual estão se preparando ou de um email que estão lendo, os vendedores querem informações relevantes de CRM (gerenciamento de relacionamento com o cliente), como dúvidas, preocupações e anotações do cliente. O Copilot para Vendas usa IA para gerar um resumo de cada registro de CRM. Este resumo destaca detalhes cruciais, como o estágio da venda, o orçamento e a data de fechamento projetada. Você pode estender a capacidade de resumo do registro de CRM que o Copilot para Vendas oferece com insights do próprio aplicativo.
Descrição da API
Você deve adicionar a seguinte descrição da API à ação. Dessa forma, o Copilot para vendas pode identificar a API correta que deve ser invocada para enriquecer a capacidade.
Essa ação obtém insights de vendas adicionais relacionados a um registro de CRM que serão mostrados no cartão de resumo do registro C4S. A ação aprimora as habilidades existentes do Copilot para Vendas.
Parâmetros de entrada
O Copilot para vendas foi projetado para oferecer os seguintes parâmetros de entrada para as APIs.
| Name | Tipo de dados/formato | Obrigatória | Details | Descrição a ser adicionada na ação |
|---|---|---|---|---|
| recordType | String | Sim | O tipo de entidade ou objeto no CRM para o qual insights relacionados, como atividades, são solicitados. O valor inclui o nome exclusivo independente do idioma da entidade ou do tipo de objeto, não o nome para exibição que pode ser localizado. Exemplos incluem conta e oportunidade. | Esta entrada indica o tipo de entidade ou objeto no CRM para o qual insights relacionados são solicitados. |
| recordId | String | Sim | O identificador exclusivo do registro de CRM. | Esta entrada indica o identificador exclusivo do registro de CRM para o qual insights relacionados são solicitados. |
| startDateTime | Cadeia de caracteres no formato "data e hora" | No | A data de início e hora para pesquisar insights. O formato segue a especificação OpenAPI. Eis um exemplo: 2017-07-21T17:32:28Z. | Esta entrada indica a data de início e a hora de insights solicitados. |
| endDateTime | Cadeia de caracteres no formato "data e hora" | No | A data de término e hora para pesquisar insights. O formato segue a especificação OpenAPI. Eis um exemplo: 2017-07-21T17:32:28Z. | Esta entrada indica a data de término e a hora de insights solicitados. |
| principais | Integer | No | O número de insights a serem buscados. | Esta entrada indica o número de insights a serem buscados. |
| skip | Integer | No | O número de insights a serem ignorados. | Esta entrada indica o número de insights a serem ignorados. |
| crmType | String | No | Os valores válidos são Dynamics 365 e Salesforce. | Esta entrada indica o tipo de CRM no qual o registro de CRM existe, para o qual os insights são solicitados. |
| crmOrgUrl | String | No | O nome do host da organização do CRM, como contoso.crm.dynamics.com. | Esta entrada indica a URL do ambiente de CRM no qual o registro de CRM existe, para o qual os insights são solicitados. |
Parâmetros de saída
O Copilot para vendas espera receber uma lista de insights (objetos) de suas APIs e espera que cada insight tenha parâmetros específicos. Para garantir que o Copilot para Vendas possa analisar corretamente o resultado, a estrutura da resposta deve seguir as diretrizes na tabela a seguir.
| Parâmetro | Tipo de dados | Obrigatória | Details |
|---|---|---|---|
| value | Matriz | Sim | Uma lista de insights (objetos) definidos conforme descrito na seção Esquema para insights. |
| hasMoreResults | Boolean | No | Um valor que indica se mais resultados estão disponíveis. |
Esquema de insights
| Name | Tipo de dados/Formato | Obrigatória | Details | Descrição a ser adicionada na ação |
|---|---|---|---|---|
| cargo | String | Sim | O título do insight no cartão de citação. Trata-se do título em linguagem natural do insight no idioma especificado no cabeçalho de solicitação Accept-Language. Aqui está um exemplo: Contrato assinado. |
Esta saída indica o título da atividade no cartão de citação. |
| Descrição | String | Sim | A descrição do insight. Ele é mostrado como marcadores no resumo do registro e é a descrição em linguagem natural do insight no idioma especificado por meio do cabeçalho Accept-Language. Veja um exemplo: Kenny, Logan e outros dois assinaram o Contrato de Renovação Contoso 2023 em 7/9/2023. |
Esta saída indica a descrição do insight. |
| dateTime | Cadeia de caracteres no formato "data e hora" | Sim | A data e a hora da atividade no formato UTC. Se a atividade tiver uma hora de início e uma hora de término, o aplicativo deverá determinar qual hora será exibida. O formato segue a especificação OpenAPI. Eis um exemplo: 2017-07-21T17:32:28Z. | Esta saída indica a hora associada ao insight. |
| url | String | No | Uma URL válida para abrir a atividade no aplicativo do parceiro. | Esta saída indica a URL para abrir o insight. |
| additionalProperties | Um objeto que tem valores Nome de Propriedade e Valor de Propriedade do tipo Cadeia de caracteres | No | Propriedades adicionais que são mostradas na exibição detalhada. Os nomes e valores de propriedade estão em linguagem natural no idioma especificado por meio do cabeçalho { |
Esta saída indica propriedades adicionais mostradas na exibição detalhada do insight. |
Observação
Embora os requisitos da API para estender as capacidades de resumo de email e resumo de registro possam parecer semelhantes, eles devem ser adicionados como ações à parte no conector.
Exemplo
{
"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
}
O exemplo na imagem a seguir mostra como a saída da API está mapeada para o resumo de registro.
Legenda:
- Seção que mostra insights do aplicativo de parceiro. O título da seção deriva do nome do conector do Microsoft Power Platform.
- Descrições do insight da resposta da API.
- Números de citação que podem ser selecionados para exibir detalhes sobre o insight.
- Cartão de citação que mostra detalhes sobre o insight.
- Ícone e título do insight. O ícone é recuperado dos metadados do conector do Microsoft Power Platform. O texto do título é o título do insight da resposta da API.
- Propriedades adicionais do insight da resposta da API.
- Nome do aplicativo parceiro. O nome mostrado é o nome do conector Microsoft Power Platform.
- Link que pode ser selecionado para exibir detalhes do insight no aplicativo de parceiro. Ele se baseia na URL do insight na resposta da API.
Informações relacionadas
Exibir resumo do registro
Adicionar novas capacidades de perguntas e respostas (Q&A) ao chat do Sales
Enriquecer os resumos do email com insights do aplicativo
Enriquecer informações-chave de vendas com insights do aplicativo
Enriquecer detalhes de registro de CRM com insights do aplicativo
Estender Copilot para Vendas do Microsoft 365 com aplicativos de parceiros
Compilar extensões do Copilot para vendas