Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Importante
- Esta é uma versão prévia do recurso pronta para produção.
- As versões prévias do recurso prontas para produção estão sujeitas aos termos de uso complementares.
[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 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 agente de vendas usa IA para gerar um resumo de cada registro 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 de registros do CRM que o agente de vendas fornece, integrando insights do seu próprio aplicativo.
Descrição da API
Você deve adicionar a descrição da API a seguir à ação. Dessa forma, o agente de Vendas pode identificar a API correta que deve ser invocada para enriquecer a funcionalidade.
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.
Operação da API
Essa API usa o Tipo de Operação: GET
Parâmetros de entrada
O agente de Vendas foi projetado para fornecer os seguintes parâmetros de entrada para suas APIs.
| Nome | Tipo/formato de dados | Obrigatório | Detalhes | Descrição a ser adicionada na ação |
|---|---|---|---|---|
| recordType | String | Yes | 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 | Yes | 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. Veja 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. Veja um exemplo: 2017-07-21T17:32:28Z. | Esta entrada indica a data de término e a hora de insights solicitados. |
| top | Integer | No | O número de insights a serem buscados. | Esta entrada indica o número de insights a serem buscados. |
| ignorar | Integer | No | O número de insights a serem ignorados. | Esta entrada indica o número de insights a serem ignorados. |
| tipo de CRM | 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 agente de 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 agente de Vendas possa analisar corretamente a saída, a estrutura de resposta deve seguir as diretrizes na tabela a seguir.
| Parâmetro | Tipo de dados | Obrigatório | Detalhes |
|---|---|---|---|
| value | Array | Yes | Uma lista de insights (objetos) definidos conforme descrito na seção Esquema para insights . |
| tem mais resultados | booleano | No | Um valor que indica se há mais resultados disponíveis. |
Esquema para insights
| Nome | Tipo de dados/Formato | Obrigatório | Detalhes | Descrição a ser adicionada na ação |
|---|---|---|---|---|
| title | String | Yes | 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 | Yes | 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" | Yes | 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 mostrar. O formato segue a especificação OpenAPI. Veja um exemplo: 2017-07-21T17:32:28Z. | Esta saída indica o tempo associado 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 de nome de propriedade e valor de propriedade 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 no idioma especificado por meio do cabeçalho { |
Esta saída indica propriedades adicionais mostradas na exibição detalhada do insight. |
Note
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.
Example
{
"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 parceiro. O título da seção é derivado do nome do conector do Microsoft Power Platform.
- Descrições da informação obtida das respostas 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 na resposta da API.
- Nome do aplicativo parceiro. O nome mostrado é o nome do conector do Microsoft Power Platform.
- Link que pode ser selecionado para exibir detalhes sobre insights no aplicativo parceiro. Baseia-se na URL do insight na resposta da API.
Informações relacionadas
Exibir resumo do registro
Enriqueça resumos de e-mail com percepções do seu aplicativo
Enriquecer rascunhos de email com links de arquivo de seu aplicativo
Enriqueça insights de oportunidade com dados do seu aplicativo
**
Enriquecer os detalhes do registro de CRM com insights da sua aplicação
Estender o agente de vendas com aplicativos parceiros
Criar extensões para o agente de Vendas