Использование конечной точки HTTPS для управления клиентами коммерческой платформы

Если ваша система управления взаимоотношениями с клиентами (CRM) не поддерживается в центре партнеров для получения потенциальных клиентов из Microsoft AppSource и Azure Marketplace, можно использовать конечную точку HTTPS в Power Automate для обработки этих потенциальных клиентов. С помощью конечной точки HTTPS потенциальные клиенты коммерческой платформы могут быть отправлены в виде уведомления по электронной почте или их можно записать в систему CRM, поддерживаемую Power Automate.

В этой статье объясняется, как создать новый поток в Power Automate для создания URL-адреса HTTP POST, который будет использоваться для настройки потенциальных клиентов в Центре партнеров.

Заметка

Соединитель Power Automate, используемый в этих инструкциях, требует платной подписки в Power Automate. Прежде чем настроить этот поток, убедитесь, что вы учли это.

Создание потока с помощью Power Automate

  1. Откройте веб-страницу Power Automate. Выберите Вход. Если у вас еще нет учетной записи, выберите зарегистрируйтесь бесплатно, чтобы создать ее.

  2. Войдите, выберите Мои потокии перейдите из среды Майкрософт (по умолчанию) в среду Dataverse (CRM).

    Показывает, как войти в

  3. В разделе + Создатьвыберите + Мгновенный облачный поток.

    Показывает, как выбрать Мои потоки, а затем Мгновенный облачный поток.

  4. Присвойте потоку имя, а затем в разделе Выберите, как активировать этот поток, выберите При получении HTTP-запроса.

    Показывает, как создать кнопку

  5. Выберите шаг потока, чтобы развернуть его.

    Поясняет, как расширить шаг потока.

  6. Используйте один из следующих методов, чтобы сконфигурировать схему JSON текста запроса:

    • Скопируйте схему JSON в текстовое поле Схема JSON тела запроса.
    • Выберите Использовать пример полезной нагрузки для создания схемы. В текстовом поле Введите или вставьте пример JSON payload вставьте пример JSON. Выберите Готово, чтобы создать схему.

    схемы JSON

    {
      "$schema": "https://json-schema.org/draft-04/schema#",
      "definitions": {},
      "id": "http://example.com/example.json",
      "properties": {
        "ActionCode": {
          "id": "/properties/ActionCode",
          "type": "string"
        },
        "OfferTitle": {
          "id": "/properties/OfferTitle",
          "type": "string"
        },
        "LeadSource": {
          "id": "/properties/LeadSource",
          "type": "string"
        },
        "Description": {
          "id": "/properties/Description",
          "type": "string"
        },
        "UserDetails": {
          "id": "/properties/UserDetails",
          "properties": {
            "Company": {
              "id": "/properties/UserDetails/properties/Company",
              "type": "string"
            },
            "Country": {
              "id": "/properties/UserDetails/properties/Country",
              "type": "string"
            },
            "Email": {
              "id": "/properties/UserDetails/properties/Email",
              "type": "string"
            },
            "FirstName": {
              "id": "/properties/UserDetails/properties/FirstName",
              "type": "string"
            },
            "LastName": {
              "id": "/properties/UserDetails/properties/LastName",
              "type": "string"
            },
            "Phone": {
              "id": "/properties/UserDetails/properties/Phone",
              "type": "string"
            },
            "Title": {
              "id": "/properties/UserDetails/properties/Title",
              "type": "string"
            }
          },
          "type": "object"
        }
      },
      "type": "object"
    }
    

    пример JSON

    {
      "UserDetails": {
        "FirstName": "Some",
        "LastName": "One",
        "Email": "someone@contoso.com",
        "Phone": "16175555555",
        "Country": "USA",
        "Company": "Contoso",
        "Title": "Esquire"
     },
      "LeadSource": "AzureMarketplace",
      "ActionCode": "INS",
      "OfferTitle": "Test Microsoft",
      "Description": "Test run through Power Automate"
    }
    

Заметка

На этом этапе конфигурации можно выбрать подключение к системе CRM или настроить уведомление по электронной почте. Следуйте остальным инструкциям на основе вашего выбора.

Подключение к системе CRM

  1. Выберите + Новый шаг.

  2. Найдите и выберите систему CRM в поле Соединители поиска и действия. На следующем экране показывается Создание новой записи (Microsoft Dataverse) в качестве примера.

    Показывает, как создать новую запись.

  3. Выберите вкладку Действия с командой Добавить новую строку.

    Показывает, как выбрать

  4. Выберите lead из раскрывающегося списка имени таблицы.

    Показывает, как выбрать потенциальных клиентов.

  5. В Power Automate показана форма предоставления сведений о потенциальных клиентах. Элементы из входного запроса можно сопоставить, выбрав добавить динамическое содержимое. На следующем экране показан OfferTitle в качестве примера.

    Показывает, как добавить динамическое содержимое.

  6. Сопоставите нужные поля и нажмите кнопку Сохранить, чтобы сохранить поток. Создается URL-адрес HTTP POST, который доступен в окне при получении HTTP-запроса. Скопируйте этот URL-адрес с помощью элемента управления копирования, расположенного справа от URL-адреса HTTP POST. Использование элемента управления копирования важно, чтобы не пропустить любую часть всего URL-адреса. Сохраните этот URL-адрес, так как вам потребуется при настройке управления потенциальными клиентами на портале публикации.

    Показывает, когда будет получен HTTP-запрос.

Настройка уведомления по электронной почте

  1. После того как вы завершили схему JSON, выберите + Создать шаг.

  2. В разделе Выбор действиявыберите Действия.

  3. На вкладке Действия выберите Отправить сообщение электронной почты (Office 365 Outlook).

    Заметка

    Если вы хотите использовать иного провайдера электронной почты, найдите и выберите Отправить уведомление по электронной почте (Почта) в качестве действия.

    Добавить действие электронной почты

  4. В окне Отправить сообщение электронной почты настройте следующие обязательные поля:

    • Для: введите по крайней мере один допустимый адрес электронной почты, куда будут отправляться заявки.
    • Тема: Power Automate предоставляет возможность добавления динамического содержимого, например LeadSource, показанного на следующем экране. Начните с ввода имени поля. Затем выберите список выбора динамического содержимого в всплывающем окне.

    Заметка

    При добавлении имен полей можно ставить двоеточие после каждого имени, а затем нажмите клавишу ВВОД, чтобы создать новую строку. После добавления имен полей можно добавить каждый связанный параметр из списка динамического выбора.

    Добавить действие электронной почты с помощью динамического содержимого

    • Основная часть: из списка динамического содержимого выберите и добавьте нужную информацию в основную часть письма. Например, используйте LastName, FirstName, Email и Company. После завершения настройки уведомления по электронной почте он выглядит как пример на следующем экране.

    Пример уведомления электронной почты

  5. Выберите Сохранить, чтобы завершить процесс. URL-адрес HTTP POST создается и доступен в окне при получении HTTP-запроса. Скопируйте этот URL-адрес с помощью элемента управления копирования, расположенного справа от URL-адреса HTTP POST. Использование этого элемента управления важно, чтобы не пропустить любую часть всего URL-адреса. Сохраните этот URL-адрес, так как вам потребуется при настройке управления потенциальными клиентами на портале публикации.

    URL-адрес HTTP POST

Тестирование

Вы можете протестировать конфигурацию с помощью средства, которое может отправлять HTTP-запросы для тестирования решения, например:

  • Visual Studio Code с расширением из Visual Studio Marketplace

  • PowerShell Invoke-RestMethod

  • Microsoft Edge — средство консоли сети

  • Бруно

  • Curl

    Осторожность

    В сценариях, в которых есть конфиденциальные данные, такие как учетные данные, секреты, маркеры доступа, ключи API и другие аналогичные сведения, обязательно используйте средство, которое защищает данные с помощью необходимых функций безопасности, работает в автономном режиме или локально, не синхронизирует данные с облаком и не требует входа в учетную запись в Сети. Таким образом, вы снижаете риск предоставления конфиденциальных данных общественности.

  1. Запустите средство и выберите создать запрос >, чтобы настроить средство для тестирования.

  2. Заполните форму "Запрос на сохранение", а затем сохраните её в созданной вами папке.

  3. В раскрывающемся списке выберите POST.

  4. Вставьте URL-адрес HTTP POST из потока, созданного в Power Automate, где указано Введите URL-адрес запроса.

  5. Вернитесь к Power Automate. Найдите поток, который вы создали для отправки лидов, выбрав "Мои потоки" в меню Power Automate. Выберите многоточие рядом с именем потока, чтобы просмотреть дополнительные параметры, и выберите Изменить.

  6. Выберите Тест в правом верхнем углу, выберите Я выполню действие триггера, а затем выберите Тест. В верхней части экрана появится сообщение, что тест начался.

  7. Вернитесь к инструменту и выберите Отправить.

  8. Вернитесь к потоку и проверьте результат. Если все работает должным образом, вы увидите сообщение, указывающее, что процесс выполнен успешно.

  9. Вы также должны получить сообщение электронной почты. Проверьте папку "Входящие" электронной почты.

    Заметка

    Если вы не видите сообщение электронной почты из теста, проверьте спам и нежелательную папку. На следующем экране вы заметите только метки полей, добавленные при настройке уведомления по электронной почте. Если бы это был фактический лид, полученный из вашего предложения, вы также увидели бы фактическую контактную информацию в тексте письма и в его теме.

    Полученное электронное сообщение

Настройте предложение для отправки потенциальных клиентов на конечную точку HTTPS.

Когда вы будете готовы настроить сведения об управлении потенциальными клиентами для предложения на портале публикации, выполните следующие действия.

  1. Войдите в Центр партнеров.

  2. Выберите предложение, и перейдите на вкладку "Настройка предложения".

  3. В разделе Потенциальные клиенты выберите Подключить.

    потенциальных клиентов

  4. Во всплывающем окне детали подключения выберите конечную точку HTTPS для назначения лидов. Вставьте URL-адрес HTTP POST из потока, который вы создали ранее, в поле URL-адреса конечной точки HTTPS.

Подробности подключения. Контактный email.

  1. Выберите ОК.

Чтобы убедиться, что вы успешно соединены с точкой назначения лидов, нажмите кнопку Проверить. В случае успеха у вас будет ведущая роль в тестировании по основному назначению.

Заметка

Прежде чем вы сможете получить потенциальные клиенты для предложения, необходимо завершить настройку остальной части предложения и опубликовать его.

При создании потенциальных клиентов корпорация Майкрософт отправляет потенциальных клиентов в поток. Потенциальные клиенты направляются в систему CRM или адрес электронной почты, настроенный вами.