Перейти к содержанию
Документация для разработчиков Практические руководства Поддержка Запросить демо Войти
Pushwoosh.com

Dynamics 365: создание или обновление записи

Используйте элемент Dynamics 365: создание или обновление записи, чтобы вставить или обновить одну строку Dataverse из шага journey с сопоставлением по столбцу альтернативного ключа: он обновляет строку, если значение уже существует, и создает ее, если нет. У Dataverse нет статического ключа API, поэтому этот элемент аутентифицируется через приложение Entra ID, зарегистрированное один раз для всей учетной записи. В самом элементе нет поля для токена.

Типичные варианты использования:

  • Синхронизация с Dynamics 365: создавайте или обновляйте строку по мере продвижения пользователя по journey, чтобы в вашей CRM всегда были актуальные данные.
  • Синхронизация активности в journey с CRM: устанавливайте значение в столбце, когда пользователь достигает определенного этапа, чтобы ваша команда могла фильтровать данные или создавать отчеты по ним.
  • Избегание дублирования строк: сопоставление по альтернативному ключу означает, что пользователь, который снова проходит через этот элемент, обновит ту же строку, а не создаст новую.

Перед началом работы

Anchor link to

Зарегистрируйте приложение в Entra ID и подключите его в разделе Settings > 3rd-party integrations > Microsoft Dynamics 365:

  1. В центре администрирования Microsoft Entra зарегистрируйте приложение и создайте для него секрет клиента.
  2. В центре администрирования Power Platform откройте целевую среду, добавьте приложение как Application user и назначьте ему роль безопасности, которая может создавать и обновлять строки в таблице, в которую вы планируете записывать данные.
  3. В Pushwoosh в поле Environment URL введите URL-адрес среды с https:// и без конечного пути, например https://acme.crm4.dynamics.com.
  4. В полях Directory (tenant) ID и Application (client) ID введите идентификаторы приложения со страницы обзора в Entra ID.
  5. В поле Client secret вставьте значение секрета. Оно сохраняется в режиме “только для записи”: Pushwoosh больше никогда его не покажет, поэтому для замены вставьте новый.
  6. Нажмите Connect Dynamics 365.
Форма подключения Microsoft Dynamics 365 в Настройках с URL-адресом среды, ID клиента, ID приложения и секретом

После подключения Dynamics 365 установите интеграцию, чтобы элемент появился в конструкторе journey.

Настройка элемента

Anchor link to
  1. Перетащите Dynamics 365: create or update record из раздела Integrations на левой панели на холст.
  2. Дважды щелкните по элементу и введите Step Name.
  3. В поле Environment host введите хост той же среды без https://, например acme.crm4.dynamics.com.
Окно элемента Dynamics 365: создание или обновление записи с заполненным названием шага и хостом среды, установленным на домен Dynamics
  1. В поле Table введите имя набора сущностей во множественном числе — contacts, leads или имя набора пользовательской таблицы.
Поле Table установлено на contacts
  1. В поле Alternate key column введите столбец, охватываемый альтернативным ключом в этой таблице, например pw_hwid.
Поле Alternate key column установлено на pw_hwid
  1. В поле Alternate key value введите значение для сопоставления, обычно это макрос, например {{device:hwid}}. Избегайте значений с кавычками, так как значение будет включено в URL-адрес запроса.
Поле Alternate key value установлено на макрос hwid устройства
  1. В разделе Columns добавьте по одной строке для каждого столбца Dataverse, в который нужно записать данные. Введите имя столбца и значение. Имена не должны быть пустыми и должны быть уникальными. Значение может быть фиксированным текстом или макросом пользователя, таким как {{device:hwid}} — те же макросы, что и в теле Webhook. Или нажмите Insert Dynamic Value, чтобы выбрать атрибут, созданный на предыдущем шаге этого journey, например ответ LLM или сопоставленное значение Webhook.
Таблица имен и значений столбцов, где emailaddress1 сопоставлен с макросом тега
  1. Нажмите Save.

Ответ

Anchor link to

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

Атрибуты после выполнения шага

Anchor link to

В отличие от элемента Salesforce: create or update record, этот элемент не возвращает ID строки в атрибут пользователя. Если он понадобится на последующем шаге, найдите строку снова по тому же значению альтернативного ключа.

Сбои и непредвиденные ответы

Anchor link to

Откройте Calls log в окне элемента и проверьте ответ:

  • 401 — секрет клиента для подключения был отклонен или истек срок его действия; переподключитесь в разделе Settings > 3rd-party integrations.
  • 403 — роль безопасности пользователя приложения не предоставляет доступ на создание или обновление для этой таблицы.
  • 404 — Environment host или Table не соответствует ничему в этой среде.
  • 400 — Alternate key column не определен как альтернативный ключ для этой таблицы, или имя в Columns не является реальным столбцом.

Неудачный запрос удаляет пользователя из journey. См. Errors and failed requests.

Пример сценария: Синхронизация запроса на корпоративный тариф в Dynamics 365

Anchor link to

B2B SaaS-приложение позволяет пользователю нажать Запросить корпоративный тариф в приложении. Команда хочет, чтобы этот запрос был вставлен или обновлен в Dynamics 365, с сопоставлением, чтобы повторное нажатие обновляло ту же строку, а не создавало дубликат.

  1. Добавьте элемент Trigger-based entry и настройте его на срабатывание по событию EnterprisePricingRequested.
  2. Добавьте элемент Dynamics 365: create or update record сразу после него. Установите для Table значение contacts, для Alternate key column — pw_hwid, а для Alternate key value — {{device:hwid}}. В Columns установите для emailaddress1 значение {{tag:Email}}.
  3. Нажмите Save.

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