Enriqueça resumos de registros do CRM com informações do seu aplicativo (pré-visualização)
Importante
- Esta é uma funcionalidade de pré-visualização pronta para produção.
- As visualizações prontas para produção estão sujeitas a termos de uso suplementares.
[Este artigo é uma 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 e-mail que estão lendo, os vendedores querem informações relevantes de gerenciamento de relacionamento com o cliente (CRM), como consultas, preocupações e anotações de clientes. Copilot para Vendas usa IA para gerar um resumo de cada registro de CRM. Este resumo destaca detalhes cruciais, como o estágio de vendas, o orçamento e a data de fecho projetada. Você pode estender o recurso de resumo de registros do CRM que Copilot para Vendas fornece com informações de seu próprio aplicativo.
Descrição da API
Você deve adicionar a seguinte descrição da API à ação. Dessa forma, Copilot para Vendas pode identificar a API correta que deve ser invocada para enriquecer o recurso.
Esta ação obtém informações de vendas adicionais relacionadas a um registro CRM que serão mostradas no cartão de resumo do registro C4S. A ação reforça a capacidades existente de copiloto para vendas.
Parâmetros de entrada
O Copilot for Sales foi concebido para fornecer os seguintes parâmetros de entrada às suas APIs.
| Name | Tipo/formato de dados | Obrigatório | Details | Descrição a adicionar à ação |
|---|---|---|---|---|
| recordType | Cadeia (de carateres) | Sim | O tipo de entidade ou objeto no CRM para o qual informações relacionadas, como atividades, são solicitadas. O valor inclui o nome exclusivo independente de idioma da entidade ou tipo de objeto, não o nome a apresentar que pode ser localizado. Os exemplos incluem conta e oportunidade. | Esta entrada indica o tipo de objeto ou entidade na CRM para o qual são pedidas informações. |
| recordId | Cadeia (de carateres) | Sim | O identificador exclusivo do registro CRM. | Esta entrada indica o identificador exclusivo do registo da CRM para o qual são pedidas as informações. |
| startDateTime | String no formato 'data-hora' | No | A data e hora de início para procurar informações. O formato segue a OpenAPI especificação. Aqui está um exemplo: 2017-07-21T17:32:28Z. | Esta entrada indica a data e hora de início das informações pedidas. |
| endDateTime | String no formato 'data-hora' | No | A data e hora de término para procurar insights. O formato segue a OpenAPI especificação. Aqui está um exemplo: 2017-07-21T17:32:28Z. | Esta entrada indica a data e hora de fim das informações pedidas. |
| principal | Número inteiro | No | O número de insights a serem buscados. | Esta entrada indica o número de informações a obter. |
| skip | Número inteiro | No | O número de insights a serem ignorados. | Esta entrada indica o número de informações a ignorar. |
| crmType | Cadeia (de carateres) | No | Os valores válidos são Dynamics 365 e Salesforce. | Esta entrada indica o tipo de CRM no qual o registo da CRM existe, para o qual são pedidas as informações. |
| crmOrgUrl | Cadeia (de carateres) | No | O nome do host da organização do CRM, como contoso.crm.dynamics.com. | Esta entrada indica o URL do ambiente da CRM no qual o registo da CRM existe, para o qual são pedidas as informações. |
Parâmetros de saída
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 Copilot para Vendas possa analisar corretamente a saída, a estrutura resposta deve aderir às diretrizes da tabela a seguir.
| Parâmetro | Tipo de dados | Obrigatório | Details |
|---|---|---|---|
| valor | Matriz | Sim | Uma lista de insights (objetos) que são definidos conforme descrito na secção Esquema para insights . |
| hasMoreResults | Boolean | No | Um valor que indica se mais resultados estão disponíveis. |
Esquema para insights
| Name | Tipo/formato de dados | Obrigatório | Details | Descrição a ser adicionada na ação |
|---|---|---|---|---|
| cargo | Cadeia (de carateres) | Sim | O título do insight sobre a citação cartão. É o título em linguagem natural do insight no idioma especificado através do cabeçalho da Accept-Language solicitação. Aqui está um exemplo: Contrato assinado. |
Esta saída indica o título da atividade no cartão de citações. |
| description | Cadeia (de carateres) | 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 através do Accept-Language cabeçalho. Aqui está um exemplo: Kenny, Logan e dois outros assinaram o Contrato de Renovação da Contoso 2023 em 07/09/2023. |
Esta saída indica a descrição das informações. |
| dateTime | String no formato 'data-hora' | Sim | A data e hora da atividade em formato UTC. Se a atividade tiver uma hora de início e uma hora de término, o aplicativo deve determinar qual hora mostrar. O formato segue a OpenAPI especificação. Aqui está um exemplo: 2017-07-21T17:32:28Z. | Esta saída indica o tempo associado às informações. |
| url | Cadeia (de carateres) | No | Um URL válido para abrir a atividade no aplicativo parceiro. | Esta saída indica o URL para abrir informações. |
| additionalProperties | Um objeto que tem os valores Property Name e Property Value do tipo String | No | Propriedades adicionais que são mostradas na exibição detalhada. Os nomes e valores de propriedade estão em linguagem natural na linguagem especificada através do {
|
Esta saída indica propriedades adicionais apresentadas na vista detalhada das informações. |
Nota
Embora os requisitos da API para estender os recursos de resumo de e-mail e os recursos de resumo de registros possam parecer semelhantes, eles devem ser adicionados como ações separadas 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 é mapeada para o resumo do registro.
Legenda:
- Seção que mostra informações do aplicativo parceiro. O título da secção é derivado do nome do Microsoft Power Platform conector.
- Descrições do insight da API resposta.
- Números de citação que podem ser selecionados para visualizar detalhes sobre o insight.
- Citação cartão que mostra detalhes sobre o insight.
- Ícone e título das informações. O ícone é recuperado dos metadados do Microsoft Power Platform conector. O texto do título é o título do insight da API resposta.
- Propriedades adicionais do insight da API resposta.
- Nome da aplicação parceira. O nome mostrado é o nome do Microsoft Power Platform conector.
- Link que pode ser selecionado para visualizar detalhes de informações no aplicativo de parceiro. Baseia-se no URL do insight na API resposta.
Consulte também
Ver resumo dos registos
Adicionar novos recursos de perguntas e respostas (P&R) ao bate-papo de vendas
Enriqueça resumos por e-mail com informações do seu aplicativo
Enriqueça as principais informações de vendas com insights do seu aplicativo
Enriquecer detalhes do regista CRM com informações da sua aplicação
Estenda Microsoft 365 Copilot para vendas com aplicativos de parceiros
Criar extensões Copilot para Vendas