Обогащение сводки по записям CRM аналитикой из собственного приложения (предварительная версия)

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 Нет

Дополнительные свойства, отображаемые в подробном представлении. Имена и значения свойств указываются на естественном языке — на том языке, который указан в заголовке Accept-Language. Рассмотрим пример:

{}
"Причина состояния": "Утверждено",
"Ответственный": "Кенни Смит"
}
Эти выходные данные указывают дополнительные свойства, отображаемые в подробном представлении аналитики.

Замечание

Хотя требования к 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 сопоставляются со сводкой записи.

Снимок экрана, показывающий анатомию последних действий из партнерского приложения.

Условные обозначения:

  1. Раздел, показывающий аналитические сведения из партнерского приложения. Название раздела является производным от имени соединителя Microsoft Power Platform.
  2. Описание аналитических сведений из ответа API.
  3. Номера ссылок, которые можно выбрать для просмотра сведений об анализе.
  4. Карточка цитирования со сведениями об аналитике.
  5. Значок и заголовок аналитики. Значок извлекается из метаданных соединителя Microsoft Power Platform. Текст заголовка — это заголовок аналитики из ответа API.
  6. Дополнительные свойства аналитических сведений из ответа API.
  7. Имя партнерского приложения. Отображаемое имя — это имя соединителя Microsoft Power Platform.
  8. Ссылка, которую можно выбрать для просмотра подробных сведений в партнерском приложении. Он основан на URL-адресе аналитических сведений в ответе API.

Просмотр сводки по записи
Обогащение сводок по электронной почте с помощью аналитических сведений из приложения
Обогащение черновиков электронной почты с помощью ссылок на файлы из приложения
Обогащение аналитических сведений о возможностях с помощью данных из приложения
Обогатите сведения о записи CRM аналитическими данными из вашего приложения
Расширение агента продаж с помощью партнерских приложений
Создание расширений для агента по продажам