Обогащение сводки по записям CRM аналитикой из собственного приложения (предварительная версия)
Внимание!
- Это предварительная версия функции, готовая к развертыванию в рабочих средах.
- На предварительные версии, готовые к развертыванию в рабочих средах, распространяются дополнительные условия использования.
[Данная статья посвящена предварительному выпуску и может быть изменена.]
Чтобы лучше понять контекст встречи, к которой они готовятся, или электронного письма, которое они читают, продавцам нужна соответствующая информация об управлении отношениями с клиентами (CRM), такая как запросы, проблемы и примечания клиентов. Copilot для продаж использует ИИ для создания сводки по каждой записи CRM. В этой сводке подчеркиваются важные детали, такие как стадия продаж, бюджет и предполагаемая дата закрытия. Вы можете расширить возможность сводки по записям CRM, предоставляемую Copilot для продаж, за счет аналитики из собственного приложения.
Описание API
К действию необходимо добавить следующее описание API. Таким образом, Copilot для продаж может определить правильный API, который должен быть вызван для расширения возможностей.
Это действие получает дополнительные сведения о продажах, связанные с записью CRM, которые будут отображаться в сводной карточке записи C4S. Действие усиливает существующие навыки помощника для продаж.
Операция API
Этот API использует тип операции: GET
Входные параметры
Приложение Copilot для продаж предназначено для предоставления следующих входных параметров в ваши API.
| Полное имя | Тип/формат данных | Обязательно | Details | Описание, которое следует добавить к действию |
|---|---|---|---|---|
| recordType | String | Да | Тип сущности или объекта в CRM, для которого запрашивается соответствующая аналитика, например действия. Значение включает независимое от языка уникальное имя сущности или типа объекта, а не отображаемое имя, которое можно локализовать. Примеры: организация и возможная сделка. | Эти входные данные указывают тип сущности или объекта в CRM, для которого запрашивается аналитика. |
| recordId | String | Да | Уникальный идентификатор записи CRM. | Эти входные данные указывают уникальный идентификатор записи CRM, для которой запрашивается аналитика. |
| startDateTime | Строка в формате даты и времени | нет | Дата и время начала поиска аналитики. Формат соответствует спецификации OpenAPI. Пример: 2017-07-21T17:32:28Z. | Эти входные данные указывают дату и время начала запрошенной аналитики. |
| endDateTime | Строка в формате даты и времени | нет | Дата и время окончания поиска аналитики. Формат соответствует спецификации OpenAPI. Пример: 2017-07-21T17:32:28Z. | Эти входные данные указывают дату и время окончания запрошенной аналитики. |
| популярное | Целое | нет | Число аналитик, которые необходимо получить. | Эти входные данные указывают число аналитик, которые необходимо получить. |
| skip | Целое | нет | Количество аналитик, которые необходимо пропустить. | Эти входные данные указывают число аналитик, которые необходимо пропустить. |
| crmType | String | нет | Допустимые значения: Dynamics 365 и Salesforce. | Эти входные данные указывают тип среды CRM, в которой существует запись CRM, для которой запрашивается аналитика о продажах. |
| crmOrgUrl | String | нет | Имя узла организации CRM, например contoso.crm.dynamics.com. | Эти входные данные указывают URL-адрес среды CRM, в которой существует запись CRM, для которой запрашивается аналитика о продажах. |
Выходные параметры
Copilot для продаж ожидает получить список аналитики (объектов) из ваших API, и ожидает, что каждая аналитика будет иметь определенные параметры. Чтобы гарантировать, что Copilot для продаж сможет правильно проанализировать выходные данные, крайне важно следовать структуре ответа, описанной в следующей таблице.
| Параметр | Тип данных | Обязательно | Details |
|---|---|---|---|
| value | Массив | Да | Список аналитик (объектов), которые определены, как описано в разделе Схема для аналитики. |
| hasMoreResults | Логический | нет | Значение, указывающее, доступно ли больше результатов. |
Схема для аналитики
| Полное имя | Тип/формат данных | Обязательно | Details | Описание, которое следует добавить к действию |
|---|---|---|---|---|
| название | String | Да | Заголовок аналитики в карточке цитирования. Это заголовок аналитики на естественном языке, указанный на языке в заголовке запроса Accept-Language. Пример: Контракт подписан. |
Эти выходные данные указывают заголовок действия в карточке цитирования. |
| Описание | String | Да | Описание аналитики. Оно отображается в виде маркированных списков в сводке записи и представляет собой описание аналитических сведений на естественном языке, указанном в заголовке Accept-Language. Пример: Кенни, Логан и двое других подписали контракт на продление Contoso 2023 07.09.2023. |
Эти выходные данные указывают описание аналитики. |
| dateTime | Строка в формате даты и времени | Да | Дата и время действия в формате UTC. Если действие имеет время начала и окончания, приложение должно определить, какое время отображать. Формат соответствует спецификации OpenAPI. Пример: 2017-07-21T17:32:28Z. | Эти выходные данные указывают время, связанное с аналитикой. |
| url-адрес | String | нет | Действительный URL-адрес для открытия действия в партнерском приложении. | Эти выходные данные указывают URL-адрес для открытия аналитики. |
| additionalProperties | Объект со значениями Имя свойства и Значение свойства типа Строка | нет | Дополнительные свойства, отображаемые в подробном представлении. Имена и значения свойств указываются на естественном языке — на том языке, который указан в заголовке { |
Эти выходные данные указывают дополнительные свойства, отображаемые в подробном представлении аналитики. |
Заметка
Хотя требования к API для расширения возможностей сводки по электронной переписке и сводки по записи могут выглядеть одинаково, их необходимо добавить в соединитель как отдельные действия.
Пример
{
"value": [
{
"title": "Contract signed",
"description": "You have 5 connections in Fourth Coffee Inc",
"dateTime": "2024-05-07T03:28:38.0667701Z",
"url": null,
"additionalProperties": {
"Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
"Signed by": "Alberto Burgos, Tony",
"Signed": "9/7/23"
}
},
{
"title": "Contract signed",
"description": "Multiple stakeholders from Fourth Coffee have visited the Contoso website four times in the last four months",
"dateTime": "2024-05-07T03:28:38.0669445Z",
"url": null,
"additionalProperties": {
"Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
"Signed by": "Alberto Burgos, Tony",
"Signed": "9/7/23"
}
}
],
"hasMoreResults": false
}
На следующем изображении показан пример того, как выходные данные API сопоставляются со сводкой записи.
Условные обозначения:
- Раздел с аналитикой из партнерского приложения. Заголовок раздела основан на имени соединителя Microsoft Power Platform.
- Описания аналитики из ответа API.
- Номера цитирования, которые можно выбрать для просмотра сведений о аналитике.
- Карточка цитирования со сведениями об аналитике.
- Значок и заголовок аналитики. Значок извлекается из метаданных соединителя Microsoft Power Platform. Текст заголовка — это заголовок аналитики из ответа API.
- Дополнительные свойства аналитики из ответа API.
- Имя партнерского приложения. Отображаемое имя — это имя соединителя Microsoft Power Platform.
- Ссылка, которую можно выбрать для просмотра сведений об аналитике в партнерском приложении. Она основана на URL-адресе аналитики в ответе API.
Дополнительные сведения
Просмотр сводки по записи
Обогащение сводок по электронной переписке аналитикой из собственного приложения
Обогащение черновиков электронной почты с помощью ссылок на папки из собственного приложения
Обогащение ключевой информации о продажах аналитикой из собственного приложения
Обогащение сведений о записи CRM аналитикой из собственного приложения
Расширение Microsoft 365 Copilot для продаж с помощью партнерских приложений
Создание расширений Copilot для продаж