Обогащение черновиков электронной почты с помощью ссылок на папки из собственного приложения (предварительная версия)
Внимание!
- Это предварительная версия функции, готовая к развертыванию в рабочих средах.
- На предварительные версии, готовые к развертыванию в рабочих средах, распространяются дополнительные условия использования.
[Данная статья посвящена предварительному выпуску и может быть изменена.]
Когда вы используете Copilot для продаж для черновика электронного письма, он учитывает его назначение и использует информацию CRM из Salesforce или Dynamics 365 для создания черновика. Вы можете расширить возможность создания черновиков электронной почты, предоставляемую Copilot для продаж, за счет рекомендуемых файлов из собственного приложения.
Заметка
Эта функция поддерживается только для черновиков сообщений электронной почты, созданных с помощью боковой панели Copilot для продаж в Outlook.
Описание API
К действию необходимо добавить следующее описание API. Таким образом, Copilot для продаж может определить правильный API, который должен быть вызван для расширения возможностей.
Это действие получает файлы, относящиеся к разговору по электронной почте, которые будут отображаться в черновиках сообщений электронной почты C4S в Outlook. Действие усиливает существующие навыки помощника для продаж.
Входные полезные данные
| Полное имя | Тип данных | Обязательно | Details | Описание, которое следует добавить к действию |
|---|---|---|---|---|
| resourceData | Object | Да | Данные ресурса, которые будут использоваться для получения предлагаемого содержимого. Сведения о структуре данных см. в разделе Расширяемость модели данных электронной почты. | Эти входные данные определяют содержимое сообщения электронной почты, которое представляет собой набор цепочек сообщений электронной почты, темы и других сведений. |
| resourceType | String | Да | Тип ресурса, для которого будут извлекаться предложения по содержимому. Например, «email-thread» или «teams-chat». | Эти входные данные определяют тип ресурса, общего для получения предлагаемых ссылок на файлы, который в данном случае является «email-thread». |
| recordType | String | нет | Тип записи CRM, например организация или возможная сделка. | Эти входные данные определяют тип записей в CRM, который связан с цепочкой сообщений электронной почты. |
| recordId | String | нет | Уникальный идентификатор записи CRM, используемой для предлагаемого содержимого. | Эти входные данные предоставляют уникальный идентификатор записи CRM, который связан с цепочкой сообщений электронной почты. |
| crmType | String | нет | Тип CRM-системы, если она подключена. Допустимые значения: Salesforce и Dynamics 365. | Эти входные данные указывают тип системы CRM, в которой существует запись, связанная с цепочкой сообщений электронной почты. |
| crmOrgUrl | String | нет | URL-адрес организации CRM. | Эти входные данные указывают URL-адрес среды CRM, в которой существует запись, связанная с цепочкой сообщений электронной почты. |
| inputPrompt | String | нет | Используемый в настоящее время предлагаемый запрос, предоставленный пользователем для создания черновика сообщения электронной почты. Например, «Ответить на вопрос» или «Внести предложение». | Эти входные данные указывают на запрос, предоставленный пользователем при составлении черновика сообщения электронной почты. |
| популярное | Целое | нет | Количество элементов для получения. | Эти входные данные указывают число ссылок на файлы, которые необходимо получить. |
| skip | Целое | нет | Количество элементов, которые необходимо пропустить. | Эти входные данные указывают число элементов, которые можно пропустить при получении предлагаемых ссылок на файлы. |
Расширяемость модели данных электронной почты
| Свойство | Type | Details | Описание, которое следует добавить к действию |
|---|---|---|---|
| plaintextBody | String | Полный текст сообщения электронной почты включает в себя все предыдущие сообщения цепочки электронной почты. | Эти входные данные предоставляют все содержимое из цепочки сообщений электронной почты в текстовом формате. |
| fullHtmlBody | String | Полная версия HTML текста сообщения электронной почты, который включает в себя все предыдущие сообщения цепочки электронной почты. | Эти входные данные предоставляют все содержимое из цепочки сообщений электронной почты в формате HTML. |
| субъект | String | Тема сообщения электронной почты. | Эти входные данные предоставляют тему сообщения электронной почты. |
| от | String | Адрес электронной почты отправителя. | В этих входных данных указывается адрес электронной почты отправителя. |
| до | String[] | Адрес электронной почты получателя. | В этих входных данных указывается адрес электронной почты получателя. |
| копия | String[] | Адреса электронной почты получателей, добавленные в поле «Копия» письма. | Эти входные данные содержат все адреса электронной почты получателя, включенные в поле «Копия» сообщения электронной почты. |
| Скрытая копия | String[] | Адреса электронной почты получателей, добавленные в поле «Скрытая копия» письма. | Эти входные данные содержат все адреса электронной почты получателя, включенные в поле «Скрытая копия» сообщения электронной почты. |
| sentDateTime | DateTimeOffset | Дата и время сообщения электронной почты в формате UTC вместе со свойством «Смещение». Дополнительные сведения см. в разделе «Структура DateTimeOffset (система)» | Эти входные данные предоставляют метку времени сообщения электронной почты. |
| ИД сообщения | String | ИД сообщения Graph эл. письма. | Эти входные данные предоставляют ИД сообщения эл. письма. |
| conversationId | String | ИД разговора Graph цепочки эл. писем. | Эти входные данные предоставляют ИД разговора цепочки эл. писем. |
Выходные параметры
| Свойство | Тип данных | Обязательно | Details |
|---|---|---|---|
| value | Массив | Да | Список ссылок на файлы (объекты), которые определены, как описано в ответе «Схема» с предложениями содержимого файлов или ссылок. |
| hasMoreResults | Логический | нет | Значение, указывающее, доступно ли больше результатов. |
Схема для ответа на предложения содержимого файла или ссылки
| Полное имя | Формат типа данных | Обязательно | Details | Описание, которое следует добавить к действию |
|---|---|---|---|---|
| contentType | string | Да | Тип содержимого для отображения. Дополнительные сведения см. в разделе Предопределенные значения для contentType | Эти выходные данные указывают тип содержимого, включенного в черновик сообщения электронной почты. |
| контент | string | Да | Актуальное содержимое добавлено. Это может быть либо веб-страница, либо URL-адрес файла. | Эти выходные данные указывают фактическое содержимое, включенное в черновик сообщения электронной почты. Это может быть либо веб-страница, либо URL-адрес. |
| contentTitle | string | Да | Заголовок предлагаемого содержимого, показываемого пользователю. | Эти выходные данные указывают заголовок содержимого. |
| contentDescription | string | Да | Описание предлагаемого содержимого, показываемого пользователю. | В этих выходных данных указывается текст, который должен быть включен при описании файлов. |
| contentIconUrl | string | нет | Значок предлагаемого содержимого, показываемого пользователю. Если он не указан, используется общий значок. | В этих выходных данных указывается значок, который должен быть включен в содержимое. |
| additionalProperties | Object | нет | Набор пар "имя-значение", которые указывают на дополнительные свойства связанной ссылки на файл, которую возвращает действие. | Эти выходные данные указывают дополнительные свойства в виде пар "имя-значение" каждой связанной ссылки, возвращаемой действием. |
Предопределенные значения для contentType
| Строковый параметр | Тип содержимого |
|---|---|
| content-file | Внешний файл (общий) |
| content-web | Внешняя веб-страница |
| content-doc | Microsoft Word-документ |
| content-pdf | PDF-документ Microsoft |
| content-pptx | Презентация Microsoft PowerPoint |
| content-xlsx | Таблица Microsoft Excel |
Пример
{
"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
}
На следующем изображении показан пример того, как выходные данные API сопоставляются с черновиком электронной почты.
Условные обозначения:
- Ссылки на файлы из приложений партнеров.
См. также
Составьте сводку по цепочке писем, используя информацию о продажах, с помощью Copilot в Outlook
Обогащение сводок по электронной переписке аналитикой из собственного приложения
Обогащение ключевой информации о продажах аналитикой из собственного приложения
Обогащение сведений о записи CRM аналитикой из собственного приложения
Обогащение сводок по записи CRM аналитикой из собственного приложения
Расширение Microsoft 365 Copilot для продаж с помощью партнерских приложений
Создание расширений Copilot для продаж