Обогащение сведений о записи CRM аналитикой из собственного приложения (предварительная версия)
Внимание!
- Это предварительная версия функции, готовая к развертыванию в рабочих средах.
- На предварительные версии, готовые к развертыванию в рабочих средах, распространяются дополнительные условия использования.
[Данная статья посвящена предварительному выпуску и может быть изменена.]
Продавцы могут просматривать сведения о сохраненном контакте, а также связанные с ним записи, такие как организации и возможные сделки. Вы можете расширить возможности управления отношениями с клиентами (CRM), которые предоставляет Copilot для продаж, с помощью аналитики из вашего собственного приложения.
Описание API
К действию необходимо добавить следующее описание API. Таким образом, Copilot для продаж может определить правильный API, который должен быть вызван для расширения возможностей.
Это действие получает записи, связанные с записью CRM. Действие усиливает существующие навыки Copilot для продаж.
Входные параметры
Приложение Copilot для продаж предназначено для предоставления следующих входных параметров в ваши API.
| Полное имя | Тип/формат данных | Обязательно | Details | Описание, которое следует добавить к действию |
|---|---|---|---|---|
| recordType | String | Да | Тип сущности или объекта в CRM, для которого запрашиваются соответствующие записи. Значение включает независимое от языка уникальное имя сущности или типа объекта, а не отображаемое имя, которое можно локализовать. Примеры: организация и возможная сделка. | Эти входные данные определяют тип записей в CRM, для которого запрашиваются связанные записи. |
| recordId | String | Да | Уникальный идентификатор записи CRM. | Эти входные данные предоставляют уникальный идентификатор записи CRM, для которой запрашиваются связанные записи. |
| популярное | Целое | нет | Число действий, которые необходимо получить. | Эти входные данные указывают число связанных записей, которые необходимо получить. |
| skip | Целое | нет | Количество действий, которые необходимо пропустить. | Эти входные данные указывают число записей, которые можно пропустить при получении связанных записей. |
| crmType | String | нет | Тип системы CRM. Допустимые значения: Dynamics 365 и Salesforce. | Эти входные данные указывают тип среды CRM, из которой извлекаются связанные записи. |
| crmOrgUrl | String | нет | Имя узла организации CRM, например contoso.crm.dynamics.com. | Эти входные данные указывают URL-адрес среды CRM, из которой извлекаются связанные записи. |
Заметка
Эта точка расширения поддерживает отображение аналитики из нескольких расширений соединителей на боковой панели Outlook (максимальное количество — пять).
Выходные параметры
Copilot для продаж ожидает получить список аналитики (объектов) из ваших API, и ожидает, что каждая аналитика будет иметь определенные параметры. Чтобы гарантировать, что Copilot для продаж сможет правильно проанализировать выходные данные, крайне важно следовать структуре ответа, описанной в следующей таблице.
| Параметр | Тип данных | Обязательно | Details |
|---|---|---|---|
| value | Массив | Да | Список аналитик (объектов), которые определены, как описано в разделе Схема для аналитики. |
| hasMoreResults | Логический | нет | Значение, указывающее, доступно ли больше результатов. |
Схема для аналитики
| Полное имя | Тип/формат данных | Обязательно | Details | Описание, которое следует добавить к действию |
|---|---|---|---|---|
| recordId | String | Да | Уникальный идентификатор записи. | Эти выходные данные уникально идентифицируют каждую связанную запись, возвращаемую действием. |
| recordTypeDisplayName | String | Да | Отображаемое имя типа записи, например Контракт. Оно должно быть локализовано на тот язык, который указан в заголовке Accept-Language. |
Эти выходные данные указывают отображаемое имя типа записей каждой связанной записи, возвращаемой действием. |
| recordTypePluralDisplayName | String | Да | Отображаемое имя во множественном числе типа записи, например Контракты. Оно должно быть локализовано на тот язык, который указан в заголовке Accept-Language. |
Эти выходные данные указывают отображаемое имя во множественном числе для типа записей каждой связанной записи, возвращаемой действием. |
| recordType | String | Да | Системное имя типа записи, например контракт. | Эти выходные данные указывают тип каждой связанной записи, возвращаемой действием. |
| recordTitle | String | Да | Имя записи, например Контракт Contoso 2023 Renewal Contract. | Эти выходные данные указывают заголовок каждой связанной записи, возвращаемой действием. |
| url-адрес | String | нет | Действительный URL-адрес для открытия записи в партнерском приложении. | Эти выходные данные указывают URL-адрес каждой связанной записи, возвращаемой действием. |
| additionalProperties | Объект со значениями Имя свойства и Значение свойства типа Строка | нет | Дополнительные свойства, отображаемые в подробном представлении. Имена и значения свойств указываются на естественном языке — на том языке, который указан в заголовке { |
Эти выходные данные указывают дополнительные свойства в виде пар "имя-значение" каждой связанной записи, возвращаемой действием. |
Пример
{
"value": [
{
"recordId": "ID1",
"recordTypeDisplayName": "Contract",
"recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
"recordTypePluralDisplayName": "Documents",
"recordType": "contract",
"url": "https://contosohub.com/contract/id1",
"additionalProperties": {
"Status": "Signed",
"Date": "9/7/23",
"Signed by": "Alberto Burgos, Tony [last name]"
}
},
{
"recordId": "ID2",
"recordTypeDisplayName": "Contract",
"recordTitle": "ABC Company 2023 Renewal Contract",
"recordTypePluralDisplayName": "Documents",
"recordType": "contract",
"url": "https://contosohub.com/contract/id2",
"additionalProperties": {
"Status": "Delivered",
"Date": "9/3/23",
"Signed by": "Alberto Burgos"
}
}
],
"hasMoreResults": false
}
На следующем изображении показан пример того, как выходные данные API сопоставляются со связанными записями.
Условные обозначения:
- Карточка со связанными записями из партнерского приложения.
- Значок и заголовок карточки. Значок извлекается из метаданных соединителя Microsoft Power Platform. Заголовком является имя соединителя Microsoft Power Platform.
- Заголовки связанных записей из ответа API. Два дополнительных свойства из ответа API отображаются в виде ключевых полей каждой связанной записи.
- Кнопка «Дополнительные действия», с помощью которой можно скопировать ссылку на запись или просмотреть сведения о записи в партнерском приложении. Ссылка основана на URL-адресе связанной записи в ответе API.
- Дополнительные свойства связанной записи из ответа API.
Дополнительные сведения
Просмотр сведений о записи
Обогащение сводок по электронной переписке аналитикой из собственного приложения
Обогащение черновиков электронной почты с помощью ссылок на папки из собственного приложения
Обогащение ключевой информации о продажах аналитикой из собственного приложения
Обогащение сводок по записи CRM аналитикой из собственного приложения
Расширение Microsoft 365 Copilot для продаж с помощью партнерских приложений
Создание расширений Copilot для продаж