Enriquecer os resumos do email 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.]

Quando Copilot no Outlook e Copilot para vendas são usados juntos, os resumos de email mostrados no Outlook incluem informações de vendas provenientes do seu sistema de gerenciamento de relacionamento com o cliente (CRM), como Dynamics 365 ou Salesforce CRM. Você pode estender a capacidade de resumo de email 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 que serão mostrados na experiência de resumo de email do C4S dentro do resumo 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	No	O tipo de registro no CRM. O registro pode especificar conta, oportunidade, cliente potencial ou contato relacionado ao email.	Esta entrada identifica o tipo de registro no CRM, que está relacionado ao email resumido.
recordId	String	No	A ID do registro no CRM para a qual registros relacionados são solicitados.	Esta entrada fornece o identificador exclusivo do registro de CRM relacionado ao email resumido.
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 relacionado ao email resumido existe.
crmOrgUrl	String	No	A URL da organização CRM.	Esta entrada indica a URL do ambiente de CRM no qual o registro relacionado ao email resumido existe.
emailContacts	String	Sim	Uma lista de endereços de email de participantes, como kenny@contoso.com,logan@contoso.com.	Esta entrada indica uma lista de todos os emails de participantes relevantes no thread de emails atual.
Superior	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 itens a serem ignorados durante a busca de insights.

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. Observação: embora esse parâmetro value inclua uma lista de insights, somente o primeiro insight é usado no resumo do enriquecimento de email.
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
Tĩtulo	Cadeia de caracteres de até 20 caracteres	Sim	O título do insight de vendas.	Esta saída indica o título da seção do parceiro e só deve incluir o nome do parceiro.
Description	String	Sim	O insight que é entregue aos usuários, como Seus colegas Mona Kane, Ray Tanaka e Daniela Smith já trabalharam com eles antes.	Esta saída indica o texto que você gostaria de incluir no resumo de email.

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": "From Contoso Customer Insights",
            "description": "Your colleagues Mona Kane, Ray Tanaka, and Daniela Smith have worked with them before."
        }
    ],
    "hasMoreResults": false
}

O exemplo na imagem a seguir mostra como a saída da API está mapeada para o resumo de email.

Legenda:

1. Título do insight. Os insights que tenham o mesmo título são agrupados.
2. Descrição do insight. Cada insight tem uma descrição.

Informações relacionadas

Resumir um thread de emails usando informações de vendas com o Copilot no Outlook
Adicionar novas capacidades de perguntas e respostas (Q&A) ao chat do Sales
Enriquecer informações-chave de vendas 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