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

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

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

Создание потока с помощью 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

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

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

   

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

   

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

   

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

   

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

   

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

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-адрес, так как вам потребуется при настройке управления потенциальными клиентами на портале публикации.

   

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

Вы можете протестировать конфигурацию с помощью средства, которое может отправлять 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.

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

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

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