Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Importante
- Esta é uma funcionalidade de pré-visualização pronta para produção.
- As funcionalidades de pré-visualização prontas para a produção estão sujeitas aos termos de utilização 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 se estão a preparar ou de um e-mail que estão a ler, os vendedores querem informações relevantes de CRM (gestão das relações com os clientes), como consultas, preocupações e notas de clientes. O agente de vendas utiliza IA para gerar um resumo de cada registo CRM. Este resumo destaca detalhes cruciais, como a fase de venda, o orçamento e a data de fecho projetada. Pode ampliar a capacidade de resumo de registos CRM que o agente de vendas fornece com insights da sua própria aplicação.
Descrição da API
Você deve adicionar a seguinte descrição da API à ação. Desta forma, o agente de vendas pode identificar a API correta que deve ser invocada para enriquecer a capacidade.
Esta ação obtém informações de vendas adicionais relacionadas com um registo do CRM que serão mostradas no cartão de resumo do registo C4S. A ação reforça as competências existentes do copiloto para vendas.
Operação API
Esta API usa o tipo de operação: GET
Parâmetros de entrada
O Agente de Vendas foi concebido para fornecer os seguintes parâmetros de entrada às suas APIs.
| Nome | Tipo/formato de dados | Obrigatório | Detalhes | Descrição a adicionar à ação |
|---|---|---|---|---|
| Tipo de registo | String | Yes | O tipo de entidade ou objeto no CRM para o qual são pedidas informações relacionadas, tais como atividades. O valor inclui o nome exclusivo independente de idioma da entidade ou do 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 | String | Yes | O identificador exclusivo do registo do CRM. | Esta entrada indica o identificador exclusivo do registo da CRM para o qual são pedidas as informações. |
| DataHoraDeInício | Cadeia (de carateres) no formato "data/hora" | No | A data e hora de início para procurar informações. O formato segue a especificação OpenAPI. Aqui está um exemplo: 2017-07-21T17:32:28Z. | Esta entrada indica a data e hora de início das informações pedidas. |
| endDateTime | Cadeia (de carateres) no formato "data/hora" | No | A data e hora de fim para procurar informações. O formato segue a especificação OpenAPI. Aqui está um exemplo: 2017-07-21T17:32:28Z. | Esta entrada indica a data e hora de fim das informações pedidas. |
| top | Integer | No | O número de informações a obter. | Esta entrada indica o número de informações a obter. |
| ignorar | Integer | No | O número de insights a serem ignorados. | Esta entrada indica o número de informações a ignorar. |
| 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 registo da CRM existe, para o qual são pedidas as informações. |
| crmOrgUrl | String | 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
O agente de vendas espera receber uma lista de insights (objetos) das suas APIs, e espera que cada insight tenha parâmetros específicos. Para garantir que o agente de vendas consegue analisar corretamente o resultado, a estrutura de resposta deve seguir as diretrizes da tabela seguinte.
| Parâmetro | Tipo de dados | Obrigatório | Detalhes |
|---|---|---|---|
| value | Array | Yes | Uma lista de insights (objetos) que são definidos conforme descrito na seção Esquema para insights . |
| temMaisResultados | booleano | No | Um valor que indica se mais resultados estão disponíveis. |
Esquema para perspetivas
| Nome | Tipo de dados/formato | Obrigatório | Detalhes | Descrição a ser adicionada na ação |
|---|---|---|---|---|
| título | String | Yes | O título das informações no cartão de citações. É o título em linguagem natural das informações no idioma especificado através do cabeçalho do pedido Accept-Language. Segue-se um exemplo: Contrato assinado. |
Esta saída indica o título da atividade no cartão de citações. |
| description | String | Yes | A descrição das informações. É mostrado como marcas de lista no resumo do registo e é a descrição em linguagem natural das informações no idioma especificado através do cabeçalho Accept-Language. Aqui está 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 das informações. |
| data e hora | Cadeia (de carateres) no formato "data/hora" | Yes | 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 especificação OpenAPI. Aqui está um exemplo: 2017-07-21T17:32:28Z. | Essa saída indica o tempo associado ao insight. |
| URL | String | No | Um URL válido para abrir a atividade na aplicação de 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 vista detalhada. Os nomes e valores de propriedade estão em linguagem natural no idioma especificado através do cabeçalho { |
Esta saída indica propriedades adicionais apresentadas na vista detalhada das informações. |
Observação
Embora os requisitos da API para expandir as capacidades de resumo de e-mail e de resumo de registos possam parecer semelhantes, têm de ser adicionados como ações separadas 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 um exemplo de como a saída da API é mapeada para o resumo de registos.
Legenda:
- Seção que mostra informações do aplicativo parceiro. O título da seção é derivado do nome do conector do Microsoft Power Platform.
- Descrições das perceções das respostas da API.
- Números de citação que podem ser selecionados para visualizar detalhes sobre o insight.
- Cartão de citações que mostra detalhes sobre as informações.
- Ícone e título do insight. O ícone é recuperado dos metadados do conector da Microsoft Power Platform. O texto do título é o título das informações da resposta da API.
- Propriedades adicionais da informação da resposta da API.
- Nome do aplicativo parceiro. O nome mostrado é o nome do conector da Microsoft Power Platform.
- Link que pode ser selecionado para visualizar detalhes de informações no aplicativo de parceiro. Baseia-se no URL do insight na resposta da API.
Informações relacionadas
Ver resumo de registo
Enriqueça resumos por e-mail com informações do seu aplicativo
Enriqueça rascunhos de e-mail com links de arquivos do seu aplicativo
Enriqueça insights de oportunidades com dados de seu aplicativo
Melhorar detalhes do registo CRM com informações da sua aplicação
Expandir o representante de vendas com aplicações parceiras
Construir extensões para o agente de vendas