Melhorar rascunhos de e-mail com ligações de ficheiro da sua aplicação (pré-visualização)
Importante
- Esta é uma funcionalidade de pré-visualização pronta para produção.
- As pré-visualizações prontas para produção estão sujeitas a termos de utilização suplementares.
[Este artigo é uma documentação de pré-lançamento e está sujeito a alterações.]
Quando usa o Copilot para Vendas para redigir um rascunho de e-mail, ele considera a intenção do e-mail e usa as informações do CRM a partir do Salesforce ou do Dynamics 365 para criar o rascunho. Pode expandir a capacidade de criação de rascunhos de e-mails que o Copilot para Vendas fornece com ficheiros recomendados da sua própria aplicação.
Nota
Esta funcionalidade é suportada apenas para rascunhos de e-mail criados utilizando o painel lateral do Copilot para Vendas no Outlook.
Descrição da API
Tem de 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 melhorar o recurso.
Esta ação obtém ficheiros relevantes para a conversação de e-mail, que serão mostrados em rascunhos de e-mail C4S no Outlook. A ação aprimora as capacidades existentes do Copilot para vendas.
Payload de entrada
| Name | Tipo de Dados | Obrigatório | Details | Descrição a adicionar na ação |
|---|---|---|---|---|
| resourceData | Object | 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. |
| resourceType | Cadeia (de carateres) | Sim | O tipo de recurso para o qual se obtêm sugestões de conteúdo. Por exemplo, 'email-thread' ou 'teams-chat'. | Esta entrada identifica o tipo de recurso partilhado para obter ligações de ficheiros sugeridos que, neste caso, é 'email-thread'. |
| recordType | Cadeia (de carateres) | No | O tipo de registo do CRM, como conta ou oportunidade. | Esta entrada identifica o tipo de registo no CRM, que está relacionada com o tópico de e-mail. |
| recordId | Cadeia (de carateres) | No | O identificador exclusivo do registo de CRM a usar para conteúdos sugeridos. | Esta entrada fornece o identificador exclusivo do registo de CRM que está relacionado com o tópico de e-mail. |
| crmType | Cadeia (de carateres) | No | 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) | No | 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. |
| inputPrompt | Cadeia (de carateres) | No | O pedido sugerido usado atualmente dado pelo utilizador para gerar o rascunho de e-mail. Por exemplo, "Responder a uma preocupação" ou "Fazer uma proposta". | Esta entrada indica o pedido fornecido pelo utilizador durante a elaboração de um rascunho de e-mail. |
| principal | Número inteiro | No | O número de itens a obter. | Esta entrada indica o número de ligações de ficheiro a obter. |
| skip | Número inteiro | No | 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
| Property | Type | Details | 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)[] | Os endereços de e-mail dos destinatários adicionados ao 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)[] | Os endereços de e-mail dos destinatários adicionados ao 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. |
Parâmetros de saída
| Property | Tipo de Dados | Obrigatório | Details |
|---|---|---|---|
| valor | Matriz | Sim | Uma lista de ligações de ficheiro (objetos) definidos conforme descrito na resposta Esquema para sugestões de conteúdo de ficheiro ou ligação. |
| hasMoreResults | Boolean | No | Um valor que indica se estão disponíveis mais resultados. |
Esquema para resposta de sugestões de conteúdo de ficheiro ou ligação
| Name | Formato do tipo de dados | Obrigatório | Details | Descrição a adicionar na ação |
|---|---|---|---|---|
| contentType | cadeia | Sim | O tipo de conteúdo a apresentar. Para mais informações, aceda a Valores predefinidos para contentType | Esta saída indica o tipo de conteúdo incluído no rascunho do e-mail. |
| conteúdo | cadeia | Sim | Conteúdo real incluído. Pode ser uma página Web ou um URL do ficheiro. | Esta saída indica o conteúdo real que está incluído no rascunho do e-mail. Pode ser uma página Web ou um URL. |
| contentTitle | cadeia | Sim | Título do conteúdo sugerido mostrado ao utilizador. | Esta saída indica o título do conteúdo. |
| contentDescription | cadeia | Sim | Descrição do conteúdo sugerido mostrado ao utilizador. | Esta saída indica o texto a incluir ao descrever os ficheiros. |
| contentIconUrl | cadeia | No | Ícone do conteúdo sugerido mostrado ao utilizador. Se não for fornecido, é utilizado um ícone genérico. | Esta saída indica o ícone a incluir para o conteúdo. |
| additionalProperties | Object | No | Um conjunto de pares nome-valor que indica as propriedades adicionais da ligação de ficheiro relacionada que a ação devolve. | Esta saída indica propriedades adicionais como pares nome-valor de cada ligação relacionada devolvida pela ação. |
Valores predefinidos para contentType
| Valor de cadeia | Tipo de conteúdo |
|---|---|
| content-file | Ficheiro Externo (Genérico) |
| content-web | Página web externa |
| content-doc | Documento Microsoft Word |
| content-pdf | Documento PDF da Microsoft |
| content-pptx | Apresentação do Microsoft PowerPoint |
| content-xlsx | Folha de cálculo do Microsoft Excel |
Exemplo
{
"value": [
{
"contentType": 0,
"content": "https://www.bing.com",
"contentTitle": "Purchase Contract",
"contentDescription": "Purchase Contract Description",
"contentIconUrl": null,
"additionalProperties": {
"Recipients": "Logan Edwards",
"Sender Name": "Kenny Smith"
}
},
{
"contentType": 3,
"content": "https://www.microsoft.com",
"contentTitle": "Strategy Planning",
"contentDescription": "Strategy Planning Description",
"contentIconUrl": null,
"additionalProperties": {
"Recipients": "Gabriela Edwards",
"Sender Name": "Maria Smith"
}
},
{
"contentType": 1,
"content": "https://www.bing.com",
"contentTitle": "Contoso Website",
"contentDescription": "Contoso Website Description",
"contentIconUrl": null,
"additionalProperties": {
"Total Views": "100",
"Domain": "Contoso.com"
}
}
],
"hasMoreResults": false
}
O exemplo na imagem seguinte mostra um exemplo de como a saída da API é mapeada para o rascunho de e-mail.
Legenda:
- Ligações de ficheiro de aplicações parceiras.
Veja também
Resumir um tópico de e-mail utilizando informações de vendas com o Copilot no Outlook
Melhorar o resumos de e-mail com informações da sua aplicação
Melhorar informações principais de vendas com informações da sua aplicação
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
Expandir o Microsoft 365 Copilot para Vendas com aplicações de parceiros
Compilar extensões do Copilot para Vendas