Обогащение сводки по электронной переписке аналитикой из собственного приложения (предварительная версия)
Внимание!
- Это предварительная версия функции, готовая к развертыванию в рабочих средах.
- На предварительные версии, готовые к развертыванию в рабочих средах, распространяются дополнительные условия использования.
[Данная статья посвящена предварительному выпуску и может быть изменена.]
Если Copilot в Outlook и Copilot для продаж используются вместе, сводки по электронной почте, отображаемые в Outlook, включают сведения о продажах, полученные из системы управления отношениями с клиентами (CRM), такой как Dynamics 365 или Salesforce CRM. Вы можете расширить возможность сводки по электронной переписке, предоставляемую Copilot для продаж, за счет аналитики из собственного приложения.
Описание API
К действию необходимо добавить следующее описание API. Таким образом, Copilot для продаж может определить правильный API, который должен быть вызван для расширения возможностей.
Это действие получает дополнительную аналитику о продажах, которая будет отображаться в сводке по электронной почте C4S в сводке Outlook. Действие усиливает существующие навыки помощника для продаж.
Операция API
Этот API использует тип операции: GET
Входные параметры
Приложение Copilot для продаж предназначено для предоставления следующих входных параметров в ваши API.
| Полное имя | Тип/формат данных | Обязательно | Details | Описание, которое следует добавить к действию |
|---|---|---|---|---|
| recordType | String | нет | Тип записей в CRM. Запись может указывать на организацию, возможную сделку, интерес или контакт, связанный с сообщением электронной почты. | Эти входные данные определяют тип записей в CRM, который связан с сообщением электронной почты, по которому составлена сводка. |
| recordId | String | нет | ИД записи в CRM, для которого запрашиваются связанные записи. | Эти входные данные предоставляют уникальный идентификатор записи CRM, который связан с сообщением электронной почты, по которому составлена сводка. |
| crmType | String | нет | Тип системы CRM. Допустимые значения: Salesforce и Dynamics 365. | Эти входные данные указывают тип системы CRM, в которой существует запись, связанная с сообщением электронной почты, по которому составлена сводка. |
| crmOrgUrl | String | нет | URL-адрес организации CRM. | Эти входные данные указывают URL-адрес среды CRM, в которой существует запись, связанная с сообщением электронной почты, по которому составлена сводка. |
| emailContacts | String | Да | Список адресов электронной почты участников, разделенный запятыми: kenny@contoso.com,logan@contoso.com. |
Эти входные данные указывают список всех соответствующих адресов электронной почты участников в текущей цепочке сообщений электронной почты. |
| Верх | Целое | нет | Число аналитик, которые необходимо получить. | Эти входные данные указывают число аналитик, которые необходимо получить. |
| Пропустить | Целое | нет | Количество аналитик, которые необходимо пропустить. | Эти входные данные указывают число элементов, которые можно пропустить при получении аналитики. |
Выходные параметры
Copilot для продаж ожидает получить список аналитики (объектов) из ваших API, и ожидает, что каждая аналитика будет иметь определенные параметры. Чтобы гарантировать, что Copilot для продаж сможет правильно проанализировать выходные данные, крайне важно следовать структуре ответа, описанной в следующей таблице.
| Параметр | Тип данных | Обязательно | Details |
|---|---|---|---|
| value | Массив | Да | Список аналитик (объектов), которые определены, как описано в разделе Схема для аналитики. Примечание. Хотя параметр значения включает список аналитик, в сводке обогащения электронной почты используется только первая аналитика. |
| hasMoreResults | Логический | нет | Значение, указывающее, доступно ли больше результатов. |
Схема для аналитики
| Полное имя | Тип/формат данных | Обязательно | Details | Описание, которое следует добавить к действию |
|---|---|---|---|---|
| Title | Строка до 20 символов | Да | Заголовок аналитики по продажам. | Эти выходные данные указывают заголовок раздела партнера и должны включать только имя партнера. |
| Description | String | Да | Аналитика, предоставляемая пользователям, такая как Ваши коллеги Мона Кейн, Рэй Танака и Даниэла Смит, работали с ними раньше. | Эти выходные данные указывают текст, который вы хотите включить в сводку по электронной переписке. |
Заметка
Хотя требования к API для расширения возможностей сводки по электронной переписке и сводки по записи могут выглядеть одинаково, их необходимо добавить в соединитель как отдельные действия.
Пример
{
"value": [
{
"title": "From Contoso Customer Insights",
"description": "Your colleagues Mona Kane, Ray Tanaka, and Daniela Smith have worked with them before."
}
],
"hasMoreResults": false
}
На следующем изображении показан пример того, как выходные данные API сопоставляются со сводкой по электронной переписке.
Условные обозначения:
- Заголовок аналитики. Аналитики с одинаковым именем сгруппированы вместе.
- Описание аналитики. У каждой аналитики есть одно описание.
Дополнительные сведения
Составьте сводку по цепочке писем, используя информацию о продажах, с помощью Copilot в Outlook
Обогащение ключевой информации о продажах аналитикой из собственного приложения
Обогащение сведений о записи CRM аналитикой из собственного приложения
Обогащение сводок по записи CRM аналитикой из собственного приложения
Расширение Microsoft 365 Copilot для продаж с помощью партнерских приложений
Обогащение черновиков электронной почты с помощью ссылок на папки из собственного приложения
Создание расширений Copilot для продаж