Обогащение ключевой информации о продажах аналитикой из собственного приложения (предварительная версия)
Внимание!
- Это предварительная версия функции, готовая к развертыванию в рабочих средах.
- На предварительные версии, готовые к развертыванию в рабочих средах, распространяются дополнительные условия использования.
[Данная статья посвящена предварительному выпуску и может быть изменена.]
Продавцы могут использовать Copilot для продаж, читая и создавая сообщения электронной почты в Outlook, для просмотра ключевой информации о продажах в связи с контактами, организациями и возможными сделками, связанными с сообщением электронной почты. Ключевая информация о продажах основана на одном из следующих источников:
- Возможная сделка, связанная с эл. письмом
- Наиболее релевантная возможная сделка, основанная на контактах и организациях в эл. письме
Вы можете расширить возможность ключевой информации о продажах, предоставляемую Copilot для продаж, за счет аналитики из собственного приложения.
Описание API
К действию необходимо добавить следующее описание API. Таким образом, Copilot для продаж может определить правильный API, который должен быть вызван для расширения возможностей.
Это действие получает дополнительную аналитику о продажах, которая будет отображаться на информационной карточке с ключевыми продажами C4S на боковой панели Outlook. Действие усиливает существующие навыки помощника для продаж.
Входные параметры
Приложение Copilot для продаж предназначено для предоставления следующих входных параметров в ваши API.
| Полное имя | Тип/формат данных | Обязательно | Details | Описание, которое следует добавить к действию |
|---|---|---|---|---|
| recordType | String | Да | Тип записи в управлении отношениями с клиентами (CRM). Запись может указывать на организацию, возможную сделку, интерес или контакт, связанный с сообщением электронной почты. | Эти входные данные определяют тип записей в CRM, для которого запрашивается ключевая информация о продажах. |
| recordId | String | Да | Идентификатор записи в CRM. | Эти входные данные предоставляют уникальный идентификатор записи CRM, для которого запрашивается ключевая информация о продажах. |
| crmType | String | нет | Тип системы CRM. Допустимые значения: Salesforce и Dynamics 365. | Эти входные данные указывают тип системы CRM, в которой существует запись CRM, для которой запрашивается ключевая информация о продажах. |
| crmOrgUrl | String | нет | URL-адрес организации CRM. | Эти входные данные указывают URL-адрес среды CRM, в которой существует запись CRM, для которой запрашивается ключевая информация о продажах. |
| популярное | Целое | нет | Число аналитик, которые необходимо получить. | Эти входные данные указывают число аналитик по продажам, которые необходимо получить. |
| skip | Целое | нет | Количество аналитик, которые необходимо пропустить. | Эти входные данные указывают число элементов, которые можно пропустить при получении аналитики по продажам. |
Выходные параметры
Copilot для продаж ожидает получить список аналитики (объектов) из ваших API, и ожидает, что каждая аналитика будет иметь определенные параметры. Чтобы гарантировать, что Copilot для продаж сможет правильно проанализировать выходные данные, крайне важно следовать структуре ответа, описанной в следующей таблице.
| Параметр | Тип данных | Обязательно | Details |
|---|---|---|---|
| value | Массив | Да | Список аналитик (объектов), которые определены, как описано в разделе Схема для аналитики. |
| hasMoreResults | Логический | нет | Значение, указывающее, доступно ли больше результатов. |
Схема для аналитики
| Полное имя | Тип/формат данных | Обязательно | Details | Описание, которое следует добавить к действию |
|---|---|---|---|---|
| название | String | Да | Заголовок карточки цитирования аналитики по продажам. Он должен содержать только имя партнера и может содержать до 20 символов. | Эти выходные данные указывают заголовок карточки цитирования для аналитики. |
| Описание | String | Да | Описание аналитики продаж. Оно отображается в виде маркированного списка на панели Ключевая информация для продаж и может содержать до 130 символов. Пример: Проверка: следующие шаги: согласование с временной шкалой и критериями успеха. | Эти выходные данные указывают текст аналитики, который будет включен в ключевую информацию о продажах. |
| url-адрес | String | нет | Действительный URL-адрес для открытия аналитики в партнерском приложении. | Эти выходные данные указывают URL-адрес, по которому можно получить дополнительную информацию об аналитике. |
| dateTime | Дата/время | нет | Дата и время действия в формате UTC. Если действие имеет время начала и окончания, приложение должно определить, какое время отображать. Формат соответствует спецификации OpenAPI. Пример: 2017-07-21T17:32:28Z. | Эти выходные данные указывают время, связанное с аналитикой. |
| additionalProperties | Объект со значениями Имя свойства и Значение свойства типа Строка | нет | Набор пар "имя-значение", которые указывают на дополнительные свойства связанной аналитики, которую возвращает действие. Эти сведения отображаются во всплывающей карточке, когда пользователи выбирают аналитику в области Ключевая информация для продаж. | Эти выходные данные указывают дополнительные свойства в виде пар "имя-значение" каждой связанной аналитики, возвращаемой действием. |
Пример
{
"value": [
{
"title": "Contract signed",
"description": "Kenny Smith sent Renewal Contract on 04/23/2023 related to 50 Cafe A-100 Automatic",
"dateTime": "2023-09-07T03:42:35.4662309Z",
"url": https://contosohub.com,
"additionalProperties": {
"Contract name": "Renewal contract for Fourth Coffee",
"Signed by": "Alberto Burgos, Tony Benis",
"Signed": "9/7/23",
"Related Opportunity": "50 CafeA-100 Automatic"
}
}
],
"hasMoreResults": false
}
На следующем изображении показан пример того, как выходные данные API сопоставляются с ключевой информацией по продажам.
Условные обозначения:
- Раздел с аналитикой из партнерского приложения. Заголовок раздела основан на имени соединителя Microsoft Power Platform.
- Описания аналитики из ответа API.
- Номера цитирования, которые можно выбрать для просмотра сведений о аналитике.
- Карточка цитирования со сведениями об аналитике.
- Значок и заголовок аналитики. Значок извлекается из метаданных соединителя Microsoft Power Platform. Заголовок — это заголовок аналитики из ответа API.
- Дополнительные свойства аналитики из ответа API.
- Имя партнерского приложения. Отображаемое имя — это имя соединителя Microsoft Power Platform.
- Ссылка, которую можно выбрать для просмотра сведений об аналитике в партнерском приложении. Она основана на URL-адресе аналитики в ответе API.
Дополнительные сведения
Просмотр ключевой информации о продажах в Copilot для продаж
Обогащение сводок по электронной переписке аналитикой из собственного приложения
Обогащение черновиков электронной почты с помощью ссылок на папки из собственного приложения
Обогащение сведений о записи CRM аналитикой из собственного приложения
Обогащение сводок по записи CRM аналитикой из собственного приложения
Расширение Microsoft 365 Copilot для продаж с помощью партнерских приложений
Создание расширений Copilot для продаж