Partilhar via

Enriquecer resumo de e-mails com sugestões de conteúdo da sua aplicação (pré-visualização)

Importante

[Este artigo é uma documentação de pré-lançamento e está sujeito a alterações.]

Quando o Copilot no Outlook e a aplicação Sales são usados em conjunto, os resumos de email apresentados no Outlook incluem informações de vendas provenientes do seu sistema de gestão de relacionamento com o cliente (CRM), como o Dynamics 365 ou o Salesforce CRM. Pode ampliar a capacidade de resumo por email que a aplicação Sales oferece com insights da sua própria aplicação.

Nota

Esta API substitui a API de Competência de Resumo de E-mail (ID da operação: scp-get-email-insights) existente por uma nova versão.

Descrição da API

Tem de adicionar a seguinte descrição da API à ação. Isto ajuda a aplicação de Vendas a identificar a API correta a invocar para enriquecer a capacidade.

Esta ação obtém informações de vendas adicionais que serão mostradas na experiência de resumo de e-mails do C4S dentro do resumo do Outlook. A ação aprimora as capacidades existentes do Copilot para vendas.

Detalhes API

  • Nome da API: Competência de Resumo de E-mail Versão 2
  • ID da operação Swagger: scp-get-email-insights-v2
  • Método de operação Swagger: publicação
  • Percurso: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

Payload de entrada

Este payload vai como o corpo do pedido da API.

Nome Tipo de Dados Obrigatório Detalhes Descrição a adicionar na ação
resourceData Objeto Sim Os dados do recurso a usar para obter o conteúdo sugerido. Para a estrutura de dados, aceda ao Modelo de dados de e-mail de extensibilidade. Esta entrada identifica o conteúdo do e-mail, que é uma coleção de tópico de e-mail, assunto e outros detalhes.
Entidades Relacionadas Matriz Não A matriz de entidades relacionadas. Para a estrutura de dados, vá para Modelo de dados de entidade relacionado. Essa entrada identifica a matriz de registos do CRM, que está relacionada com o tópico de email.
crmType Cadeia (de carateres) Não O tipo de sistema de CRM, se ligado. Os valores válidos são Salesforce e Dynamics 365. Esta entrada indica o tipo de CRM em que existe o registo relacionado com o tópico de e-mail.
crmOrgUrl Cadeia (de carateres) Não O URL da organização de CRM. Esta entrada indica o URL do ambiente de CRM em que existe o registo relacionado com o tópico de e-mail.
principal Número inteiro Não O número de itens a obter. Esta entrada indica o número de ligações de ficheiro a obter.
ignorar Número inteiro Não O número de itens a ignorar. Esta entrada indica o número de itens a ignorar ao obter ligações de ficheiros sugeridos.

Modelo de dados de e-mail de extensibilidade

Propriedade Tipo Detalhes Descrição a adicionar na ação
plaintextBody Cadeia (de carateres) O corpo completo do e-mail inclui todas as mensagens anteriores do tópico de e-mail nele contido. Esta entrada fornece todo o conteúdo do tópico de e-mail em formato de texto.
fullHtmlBody Cadeia (de carateres) A versão HTML completa do corpo do e-mail que inclui todas as mensagens anteriores do tópico de e-mail nele contido. Esta entrada fornece todo o conteúdo do tópico de e-mail em formato HTML.
requerente Cadeia (de carateres) Assunto do e-mail. Esta entrada fornece o assunto do e-mail.
de Cadeia (de carateres) Endereço de e-mail do remetente. Esta entrada fornece o endereço de e-mail do remetente.
para Cadeia (de carateres)[] Endereços de e-mail do destinatário. Esta entrada fornece o endereço de e-mail do destinatário.
cc Cadeia (de carateres)[] Endereços de e-mail do destinatário adicionados no campo Cc do e-mail. Esta entrada fornece todos os endereços de e-mail do destinatário que estão incluídos no campo Cc do e-mail.
bcc Cadeia (de carateres)[] Endereços de e-mail do destinatário adicionados no campo Bcc do e-mail. Esta entrada fornece todos os endereços de e-mail do destinatário que são adicionado ao campo Bcc do e-mail.
sentDateTime DateTimeOffset A data e a hora do e-mail no formato UTC, juntamente com a propriedade Offset. Para obter mais informações, aceda a Estrutura de DateTimeOffset (Sistema) Esta entrada fornece o carimbo de data/hora do e-mail.
ID da mensagem Cadeia (de carateres) O ID de mensagem do Graph do e-mail. Esta entrada fornece o ID da mensagem do e-mail.
conversationId Cadeia (de carateres) O ID de conversação do Graph do tópico do e-mail. Esta entrada fornece o ID da conversação do tópico do e-mail.
Propriedade Tipo Obrigatório Detalhes Descrição a adicionar na ação
identificador da entidade Cadeia (de carateres) Sim O tipo de registo do CRM, como conta ou oportunidade. Esta entrada fornece o identificador exclusivo do registo de CRM que está relacionado com o tópico de e-mail.
entityType Cadeia (de carateres) Sim O identificador exclusivo do registo de CRM a usar para conteúdos sugeridos. Esta entrada identifica o tipo de registo no CRM, que está relacionada com o tópico de e-mail.
entitySource Cadeia (de carateres) Não Esta entrada indica a origem da entidade, atualmente contém valores "conectados" ou vazios. Esta entrada indica o tipo de origem da entidade.

Parâmetros de saída

A aplicação 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 a aplicação Sales consegue analisar corretamente a saída, a estrutura de resposta deve seguir as diretrizes da tabela seguinte.

Parâmetro Tipo de dados Obrigatório Detalhes
valor Matriz Sim

Uma lista de informações (objetos) que são definidas conforme descrito na secção Esquema para informações.

Nota: Embora este parâmetro inclua uma lista de informações, apenas a primeira informação é utilizada no resumo do melhoramento de e-mail para a experiência de tela do Outlook.
hasMoreResults booleano Não Um valor que indica se estão disponíveis mais resultados.

Esquema para informações

Nome Tipo de dados/formato Obrigatório Detalhes Descrição a adicionar na ação
informações Cadeia (de carateres) Sim As informações que são entregues aos utilizadores, como Os seus colegas Mona Kane, Ray Tanaka e Daniela Smith, já trabalharam com eles anteriormente. Esta saída indica o texto que pretende incluir no resumo do e-mail.

Exemplo

{
    "value": [
        {
            "insight": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
        },
        {
            "insight": "The email was opened three times in the last month."
        }
    ],
    "hasMoreResults": false
}

O exemplo na imagem a seguir mostra como a saída da API é mapeada para o resumo de e-mail no painel lateral.

Captura de ecrã a mostrar informações de aplicações de parceiros no resumo de e-mails.

Legenda:

  1. Título das informações. As informações que têm o mesmo título são agrupadas.
  2. Descrições de informações. Cada informação tem uma descrição.

O exemplo na imagem a seguir mostra como a saída da API é mapeada para o resumo de e-mail no corpo de e-mail.

Captura de ecrã que mostra informações de aplicações parceiras no corpo do e-mail.

Legenda:

  1. Título das informações. As informações que têm o mesmo título são agrupadas.
  2. Descrição das informações. Cada informação tem uma descrição.

Resumir um tópico de e-mail utilizando informações de vendas com o Copilot no Outlook
Enriqueça insights de oportunidades com dados de seu aplicativo
Melhorar detalhes do registo CRM com informações da sua aplicação
Melhorar os resumos do registo CRM com informações da sua aplicação
Amplie as Vendas no Microsoft 365 Copilot com aplicações parceiras
Melhorar rascunhos de e-mail com ligações de ficheiro da sua aplicação
Construir extensões para Vendas no Microsoft 365 Copilot

  • Last updated on