Поділитися через


Збагачуйте ключову інформацію про продажі статистикою зі своєї програми (попередній перегляд)

Важливо

[Ця стаття стосується інструкції до попередньої версії, і її буде змінено.]

Поки продавці читають і складають електронні листи в Outlook, вони можуть використовувати Copilot для продажів, щоб переглядати ключову інформацію про продажі про контакти, облікові записи та можливості, пов’язані з електронною поштою. Ключова інформація про продажі базується на одному з таких джерел:

  • Можливість, яка підключена до електронної пошти
  • Найактуальніша можливість, виходячи з контактів та облікових записів у листі

Ви можете розширити можливості ключової інформації про продажі, яку надає Copilot for Sales, за допомогою статистики з вашої власної програми.

Опис API

Ви повинні додати до дії наступний опис API. Таким чином, Copilot for Sales може визначити правильний API, який потрібно викликати для збагачення можливостей.

Ця дія отримує додаткові статистичні дані про продажі, які відображатимуться на картці з ключовою інформацією про продаж C4S у програмі Outlook. Дія посилює існуючі навички другого пілота для продажів.

Робота API

Цей API використовує тип операції: GET

Вхідні параметри

Copilot for Sales призначений для надання наступних вхідних параметрів для ваших API.

Ім'я Тип/формат даних Обов'язковий Докладні відомості Опис для додавання в дію
recordType String Так Тип запису в управлінні взаємовідносинами з клієнтами (CRM). У записі може бути вказано обліковий запис, потенційну угоду, потенційного клієнта або контактну особу, пов’язану з електронною поштою. Ці вхідні дані визначають тип запису в CRM, для якого запитується ключова інформація про продаж.
recordId String Так Ідентифікатор запису в CRM. Ці вхідні дані містять унікальний ідентифікатор запису CRM, для якого запитується ключова інформація про продажі.
crmType String No Тип CRM-системи. Допустимими значеннями є Salesforce і Dynamics 365. Цей вхідний сигнал вказує на тип CRM, у якому існує запис CRM, для якого запитується ключова інформація про продажі.
crmOrgUrl String No URL-адреса організації CRM. Цей вхідний сигнал вказує URL-адресу середовища CRM, у якому існує запис CRM, для якого запитується ключова інформація про продажі.
перші Ціле число No Кількість інсайтів, які потрібно отримати. Цей вхідний сигнал вказує на кількість основних моментів продажу, які потрібно отримати.
пропустити Ціле число No Кількість інсайтів, які потрібно пропустити. Цей вхідний сигнал вказує на кількість товарів, які слід пропустити під час отримання основних показників продажу.

Параметри виводу

Copilot for Sales очікує отримати список інсайтів (об’єктів) з ваших API, і він очікує, що кожен інсайт матиме конкретні параметри. Щоб гарантувати, що Copilot for Sales може правильно аналізувати вихідні дані, структура відповіді повинна дотримуватися вказівок у наступній таблиці.

Параметр Тип даних Обов'язковий Докладні відомості
значення Масив Так Список інсайтів (об’єктів), які визначені так, як описано в розділі Схема для інсайтів .
hasMoreResults Boolean No Значення, яке вказує, чи доступні додаткові результати.

Схема для інсайтів

Ім'я Тип/формат даних Обов'язковий Докладні відомості Опис для додавання в дію
заголовок String Так Назва картки цитування зі статистикою продажів. Він повинен включати тільки ім’я партнера і може мати до 20 символів. Цей вивід вказує назву картки цитування для інсайту.
опис String Так Опис інсайту продажів. Він відображається як маркер на панелі "Ключова інформація про продажі" та може містити до 130 символів. Ось приклад :Валідація: Наступні кроки: Узгодження з часовими рамками та критеріями успіху. Цей вихідний сигнал вказує на текст аналітичних даних, які мають бути включені в ключову інформацію про продаж.
URL-адреса String No Дійсна URL-адреса для відкриття статистики в партнерській програмі. У цьому виводі вказується URL-адреса, за якою можна дізнатися більше про статистику.
dateTime DateTime No Дата та час проведення активності у форматі UTC. Якщо активність має час початку та завершення, програма має визначити, о котрій годині показувати. Формат відповідає OpenAPI специфікації. Ось приклад: 2017-07-21T17:32:28Z. Цей вихід вказує на час, пов’язаний з інсайтом.
Додаткові властивості Об’єкт, який має значення Property Name та Property Value типу String No Набір пар ім’я-значення, які вказують на додаткові властивості пов’язаної статистики, яку повертає дія. Ця інформація відображається на спливаючій картці, коли користувачі вибирають статистику в області «Ключова інформація про продаж». Цей вивід вказує додаткові властивості як пари ім’я-значення кожної пов’язаної статистики, що повертається дією.

Приклад

{
    "value": [
        {
            "title": "Contract signed",
            "description": "Kenny Smith sent Renewal Contract on 04/23/2023 related to 50 Cafe A-100 Automatic",
            "dateTime": "2023-09-07T03:42:35.4662309Z",
            "url": https://contosohub.com,
            "additionalProperties": {
                "Contract name": "Renewal contract for Fourth Coffee",
                "Signed by": "Alberto Burgos, Tony Benis",
                "Signed": "9/7/23",
                 "Related Opportunity": "50 CafeA-100 Automatic"
            }
        }
    ],
    "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.

Переглядайте ключову інформацію про продажі в Copilot для продажів
Збагачуйте резюме електронною поштою інформацією з вашої програми
Збагачуйте чернетки електронних листів посиланнями на файли з вашої програми
Збагачуйте деталі запису CRM статистикою зі своєї програми
Збагачуйте зведення записів CRM статистикою зі своєї програми
Розширюйте Microsoft 365 Copilot для продажів за допомогою партнерських додатків
Створіть Copilot для розширень Sales