Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Important
- Это предварительная версия функции, готовая к развертыванию в рабочих средах.
- На предварительные версии, готовые к развертыванию в рабочих средах, распространяются дополнительные условия использования.
[Эта статья является предварительной документацией и может быть изменена.]
Чтобы лучше понять контекст встречи, к которой они готовятся, или электронного письма, которое они читают, продавцам нужна соответствующая информация об управлении отношениями с клиентами (CRM), такая как запросы, проблемы и примечания клиентов. Агент продаж использует ИИ для создания сводки по каждой записи CRM. В этой сводке подчеркиваются важные детали, такие как стадия продаж, бюджет и предполагаемая дата закрытия. Вы можете расширить возможности сводки записей CRM, предоставляемые агентом по продажам, добавив аналитические сведения из вашего собственного приложения.
Описание API
Необходимо добавить в действие следующее описание API. Таким образом, агент продаж может определить правильный API, который необходимо вызвать для обогащения возможностей.
Это действие получает дополнительные сведения о продажах, связанные с записью CRM, которые будут отображаться в сводной карточке записи C4S. Действие усиливает существующие навыки помощника для продаж.
Операция API
Этот API использует тип операции: GET
Входные параметры
Агент продаж предназначен для предоставления следующих входных параметров API.
| Имя | Тип и формат данных | Обязательный | Сведения | Описание для добавления в действие |
|---|---|---|---|---|
| тип записи | String | Да | Тип сущности или объекта в CRM, для которого запрашивается соответствующая аналитика, например действия. Значение включает независимое от языка уникальное имя сущности или типа объекта, а не отображаемое имя, которое можно локализовать. Примеры: организация и возможная сделка. | Эти входные данные указывают тип сущности или объекта в CRM, для которого запрашивается аналитика. |
| recordId | String | Да | Уникальный идентификатор записи CRM. | Эти входные данные указывают уникальный идентификатор записи CRM, для которой запрашивается аналитика. |
| дата и время начала | Строка в формате даты и времени | Нет | Дата и время начала поиска аналитики. Формат соответствует спецификации OpenAPI. Ниже приведен пример : 2017-07-21T17:32:28Z. | Эти входные данные указывают дату и время начала запрошенной аналитики. |
| endDateTime | Строка в формате даты и времени | Нет | Дата и время окончания поиска аналитики. Формат соответствует спецификации OpenAPI. Ниже приведен пример : 2017-07-21T17:32:28Z. | Эти входные данные указывают дату и время окончания запрошенной аналитики. |
| top | Integer | Нет | Число аналитик, которые необходимо получить. | Эти входные данные указывают число аналитик, которые необходимо получить. |
| skip | Integer | Нет | Количество аналитик, которые необходимо пропустить. | Эти входные данные указывают число аналитик, которые необходимо пропустить. |
| тип CRM | String | Нет | Допустимые значения: Dynamics 365 и Salesforce. | Эти входные данные указывают тип среды CRM, в которой существует запись CRM, для которой запрашивается аналитика о продажах. |
| crmOrgUrl | String | Нет | Имя узла организации CRM, например contoso.crm.dynamics.com. | Эти входные данные указывают URL-адрес среды CRM, в которой существует запись CRM, для которой запрашивается аналитика о продажах. |
Выходные параметры
Агент продаж ожидает получения списка аналитических сведений (объектов) из API, и ожидает, что каждая информация будет иметь определенные параметры. Чтобы агент продаж смог правильно проанализировать выходные данные, структура ответа должна соответствовать рекомендациям в следующей таблице.
| Параметр | Тип данных | Обязательный | Сведения |
|---|---|---|---|
| value | Массив | Да | Список аналитических сведений (объектов), определенных в разделе "Схема для аналитики ". |
| hasMoreResults | Булев | Нет | Значение, указывающее, доступны ли дополнительные результаты. |
Схема для инсайтов
| Имя | Тип/формат данных | Обязательный | Сведения | Описание, которое следует добавить к действию |
|---|---|---|---|---|
| заголовок | String | Да | Заголовок аналитики в карточке цитирования. Это заголовок аналитики на естественном языке, указанный на языке в заголовке запроса Accept-Language. Пример: Контракт подписан. |
Эти выходные данные указывают заголовок действия в карточке цитирования. |
| описание | String | Да | Описание аналитики. Оно отображается в виде маркированных списков в сводке записи и представляет собой описание аналитических сведений на естественном языке, указанном в заголовке Accept-Language. Пример: Кенни, Логан и двое других подписали контракт на продление Contoso 2023 07.09.2023. |
Эти выходные данные указывают описание аналитики. |
| дата и время | Строка в формате даты и времени | Да | Дата и время действия в формате UTC. Если действие имеет как время начала, так и время окончания, приложение должно определить, какое время нужно отобразить. Формат соответствует спецификации OpenAPI. Ниже приведен пример : 2017-07-21T17:32:28Z. | Эти выходные данные указывают время, связанное с аналитикой. |
| url | String | Нет | Действительный URL-адрес для открытия действия в партнерском приложении. | Эти выходные данные указывают URL-адрес для открытия аналитики. |
| дополнительныеСвойства | Объект, имеющий значения "Имя свойства" и "Значение свойства" типа String | Нет | Дополнительные свойства, отображаемые в подробном представлении. Имена и значения свойств указываются на естественном языке — на том языке, который указан в заголовке {} |
Эти выходные данные указывают дополнительные свойства, отображаемые в подробном представлении аналитики. |
Замечание
Хотя требования к API для расширения возможностей сводки по электронной переписке и сводки по записи могут выглядеть одинаково, их необходимо добавить в соединитель как отдельные действия.
Example
{
"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 аналитическими данными из вашего приложения
Расширение агента продаж с помощью партнерских приложений
Создание расширений для агента по продажам