Enriquecer informações-chave de vendas 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.]
Enquanto leem e redigem emails no Outlook, os vendedores podem usar o Copilot para Vendas para exibir informações-chave de vendas sobre contas, oportunidades e contatos relacionados ao email. As principais informações de vendas são baseadas em uma das seguintes fontes:
- A oportunidade conectada ao email
- A oportunidade mais relevante, com base nos contatos e contas no email
Você pode estender a capacidade das informações-chave de vendas fornecida pelo Copilot para vendas 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 que serão mostrados no cartão de informações de vendas da chave C4S no sidecar do Outlook. 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 registro no CRM (gerenciamento de relacionamento com o cliente). O registro pode especificar conta, oportunidade, cliente potencial ou contato relacionado ao email. | Esta entrada identifica o tipo de registro no CRM para o qual as informações-chave de vendas são solicitadas. |
| recordId | String | Sim | A ID do registro no CRM. | Esta entrada fornece o identificador exclusivo do registro de CRM para os quais as informações-chave de vendas são solicitadas. |
| crmType | String | No | O tipo do sistema de CRM. Os valores válidos são Salesforce e Dynamics 365. | Esta entrada indica o tipo de CRM no qual o registro de CRM existe, para o qual as informações-chave de vendas são solicitadas. |
| crmOrgUrl | String | No | A URL da organização CRM. | Esta entrada indica a URL do ambiente de CRM no qual o registro de CRM existe, para o qual as informações-chave de vendas são solicitadas. |
| principais | Integer | No | O número de insights a serem buscados. | Esta entrada indica o número de realces de vendas a serem buscados. |
| skip | Integer | No | O número de insights a serem ignorados. | Esta entrada indica o número de itens a serem ignorados durante a busca de realces de vendas. |
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 cartão de citação do insight de vendas. Ele deve incluir apenas o nome do parceiro e pode ter até 20 caracteres. | Esta saída indica o título do cartão de citação do insight. |
| Descrição | String | Sim | A descrição do insight de vendas. Ela é mostrada como um marcador no painel Informações principais de vendas e pode ter até 130 caracteres. Aqui está um exemplo: Validação: Próximas etapas: Alinhar com o cronograma e os critérios de sucesso. | Esta saída indica o texto do insight a ser incluído nas informações-chave de vendas. |
| url | String | No | Uma URL válida para abrir o insight no aplicativo do parceiro. | Esta saída indica a URL para saber mais sobre o insight. |
| dateTime | DateTime | No | 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. |
| additionalProperties | Um objeto que tem valores Nome de Propriedade e Valor de Propriedade do tipo Cadeia de caracteres | No | Um conjunto de pares nome-valor que indicam propriedades adicionais do insight relacionado retornado pela ação. Essas informações são mostradas em um cartão pop-up quando os usuários selecionam insights no painel Principais informações de vendas. | Esta saída indica propriedades adicionais como pares nome-valor de cada insight relacionado retornado pela ação. |
Exemplo
{
"value": [
{
"title": "Contract signed",
"description": "Kenny Smith sent Renewal Contract on 04/23/2023 related to 50 Cafe A-100 Automatic",
"dateTime": "2023-09-07T03:42:35.4662309Z",
"url": https://contosohub.com,
"additionalProperties": {
"Contract name": "Renewal contract for Fourth Coffee",
"Signed by": "Alberto Burgos, Tony Benis",
"Signed": "9/7/23",
"Related Opportunity": "50 CafeA-100 Automatic"
}
}
],
"hasMoreResults": false
}
O exemplo na imagem a seguir mostra como a saída da API é mapeada para as informações-chave de vendas.
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 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 informações-chave de vendas em Copilot para vendas
Adicionar novas capacidades de perguntas e respostas (Q&A) ao chat do Sales
Enriquecer os resumos do email com insights do aplicativo
Enriquecer detalhes de registro de CRM com insights do aplicativo
Enriquecer resumos 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