Compartilhar via

Enriquecer o resumo do email com sugestões de conteúdo do seu 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 o Copilot no Outlook e o aplicativo Sales são usados juntos, os resumos de email mostrados no Outlook incluem informações de vendas provenientes de seu sistema de CRM (gerenciamento de relacionamento com o cliente), como o Dynamics 365 ou o Salesforce CRM. Você pode estender a funcionalidade de resumo de email que o aplicativo Vendas fornece com insights de seu próprio aplicativo.

Observação

Esta API substitui a API Habilidade de Resumo do Email existente (ID da operação: scp-get-email-insights) por uma nova versão.

Descrição da API

Você deve adicionar a seguinte descrição da API à ação. Isso ajuda o aplicativo Vendas a identificar a API correta a ser invocada para enriquecer a funcionalidade.

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.

Detalhes de API

  • Nome da API: versão 2 da Habilidade de Resumo do Email
  • ID da operação do Swagger: scp-get-email-insights-v2
  • Método de operação do Swagger: postagem
  • Caminho: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

Conteúdo de entrada

Esse conteúdo vai como o corpo da solicitação API.

Nome Tipo de Dados Obrigatória Detalhes Descrição a ser adicionada na ação
dados de recursos Objeto Sim Os dados de recurso a serem usados para buscar o conteúdo sugerido. Para a estrutura de dados, vá até Modelo de dados do email de extensibilidade. Essa entrada identifica o conteúdo do email, que é uma coleção de thread de emails, assunto e outros detalhes.
entidades relacionadas Matriz Não A matriz de entidades relacionadas. Para a estrutura de dados, vá até Modelo de dados da entidade relacionada. Essa entrada identifica a matriz de registros do CRM, que está relacionada ao thread de email.
tipo de CRM fio Não O tipo de sistema CRM, se conectado. Os valores válidos são Salesforce e Dynamics 365. Esta entrada indica o tipo de CRM no qual o registro relacionado ao thread de emails existe.
crmOrgUrl fio Não A URL da organização CRM. Esta entrada indica a URL do ambiente de CRM no qual o registro relacionado ao thread de emails existe.
principais Número Inteiro Não O número de itens a serem buscados. Esta entrada indica o número de links de arquivo a serem buscados.
ignorar Número Inteiro Não O número de itens a serem ignorados. Esta entrada indica o número de itens a serem ignorados durante a busca de links de arquivo sugeridos.

Modelo de dados do email de extensibilidade

Propriedade Tipo Detalhes Descrição a ser adicionada na ação
plaintextBody fio O corpo completo do email inclui todas as mensagens anteriores do thread de emails. Esta entrada fornece todo o conteúdo do thread de emails em formato de texto.
fullHtmlBody fio A versão HTML completa do corpo do email que inclui todas as mensagens anteriores do thread de emails. Esta entrada fornece todo o conteúdo do thread de emails em formato HTML.
assunto fio Assunto do email. Esta entrada fornece o assunto do email.
de fio Endereço de email do remetente. Esta entrada fornece o endereço de email do remetente.
até Cadeia de caracteres[] Endereços de email do destinatário. Esta entrada fornece o endereço de email do destinatário.
cc Cadeia de caracteres[] Endereços de email do destinatário adicionados no campo Cc do email. Esta entrada fornece todos os endereços de email do destinatário incluídos no campo Cc do email.
bcc Cadeia de caracteres[] Endereços de email do destinatário adicionados no campo Cco do email. Esta entrada fornece todos os endereços de email do destinatário adicionados no campo Cco do email.
sentDateTime DateTimeOffset A data e a hora do email em formato UTC com a propriedade Offset. Para obter mais informações, vá até DateTimeOffset Struct (sistema) Esta entrada fornece o carimbo de data/hora do email.
ID da mensagem fio O ID da mensagem do Graph do email. Esta entrada fornece o ID da mensagem do email.
conversationId fio O ID da conversa do Graph do thread de emails. Esta entrada fornece o ID da conversa do thread de emails.
Propriedade Tipo Obrigatória Detalhes Descrição a ser adicionada na ação
ID da entidade fio Sim O tipo de registro do CRM, como conta ou oportunidade. Esta entrada fornece o identificador exclusivo do registro de CRM relacionado ao thread de emails.
tipoDeEntidade fio Sim O identificador exclusivo do registro de CRM a ser usado para conteúdo sugerido. Esta entrada identifica o tipo de registro no CRM, que está relacionado ao thread de emails.
entitySource fio Não Essa entrada indica a origem da entidade, atualmente contém valores "conectados" ou vazios. Essa entrada indica o tipo de origem da entidade.

Parâmetros de saída

O aplicativo 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 aplicativo 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ória Detalhes
value Matriz Sim

Uma lista de insights (objetos) definidos conforme descrito na seção Esquema para insights.

Observação: embora esse parâmetro inclua uma lista de insights, somente o primeiro insight é usado no resumo do enriquecimento de email para a experiência de Tela do Outlook.
tem mais resultados booleano Não Um valor que indica se mais resultados estão disponíveis.

Esquema de insights

Nome Tipo de dados/formato Obrigatória Detalhes Descrição a ser adicionada na ação
insight fio 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.

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 do email no painel lateral.

Captura de tela mostrando insights de aplicativos de parceiro no resumo do email.

Legenda:

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

O exemplo na imagem a seguir mostra como a saída da API é mapeada para o resumo do email no corpo do email.

Captura de tela mostrando insights de aplicativos parceiros no corpo do 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.

Resumir um thread de email usando informações de vendas com o Copilot no Outlook
Enriqueça insights de oportunidade com dados do seu aplicativo
Enriquecer detalhes de registro de CRM com insights do aplicativo
Enriquecer resumos de registro de CRM com insights do aplicativo
Estender vendas no Microsoft 365 Copilot com aplicativos parceiros
Enriquecer os rascunhos de email com links de arquivo do aplicativo
Criar extensões para vendas no Microsoft 365 Copilot

  • Last updated on