Skip to content

Commit 03e61fb

Browse files
authored
Added links for Dynamics 365 + Webhooks, added more context on credential details for authorisation + backtick/case fixes
1 parent 8e50a76 commit 03e61fb

File tree

1 file changed

+12
-11
lines changed

1 file changed

+12
-11
lines changed

src/connections/destinations/catalog/actions-webhook-extensible/microsoft-integration-recipe.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Microsoft Dynamics 365 (Sales Hub) Integration Recipe
33
---
44

5-
This recipe will guide you through how to set up a custom destination for Microsoft Dynamics 365 (Sales) using Twilio Segment’s Extensible Webhook feature.
5+
This recipe will guide you through how to set up a custom destination for [Microsoft Dynamics 365 (Sales)](https://www.microsoft.com/en-us/dynamics-365/products/sales){:target="_blank"} using Twilio Segment’s [Extensible Webhooks](https://segment.com/docs/connections/destinations/catalog/actions-webhook-extensible/){:target="_blank"} feature.
66

77
## Prerequisites
88

@@ -35,20 +35,21 @@ To integrate Microsoft Dynamics 365 with Twilio Segment, ensure you have the fol
3535

3636
For authentication, you need to first create an Azure application that can authenticate users to provide access to Microsoft Dynamics API. See [Microsoft's documentation](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app?tabs=client-secret){:target="_blank"} for details on how to create an application and how to get the client secret that will later be used for authentication.
3737

38-
The redirect URI for your application is https://app.segment.com/oauth-service/webhook/callback.
38+
The redirect URI for your application is `https://app.segment.com/oauth-service/webhook/callback`.
3939

40-
To connect the Azure app with the Dynamics instance, go to the Power Platform Admin Center.
41-
Here you will need to create new app users associated with a business unit, and provide security roles.
40+
To connect the Azure app with the Dynamics instance, go to the Power Platform Admin Center. Here you will need to create new app users associated with a business unit, and provide security roles.
4241

4342
Once you have successfully created an Azure web application and associated it with a Dynamics environment, you can proceed to authentication in Segment.
4443

4544
1. Navigate to the settings page of the webhook destination in Segment.
46-
2. Select OAuth 2.0 and select Authorization Code.
45+
2. Select **OAuth 2.0** and select **Authorization Code**.
4746
3. Enter the following credential details from your web app or as listed below:
4847
- Client ID
4948
- Client secret
50-
- Access Token URL: https://login.microsoftonline.com/<directory id>/oauth2/v2.0/token
51-
- Scope: https://<dynamics>/.default
49+
- Access Token URL: `https://login.microsoftonline.com/<directory_id>/oauth2/v2.0/token`. Replace `<directory_id>` with your Azure AD tenant ID. You can be find this in the Entra admin center. For detailed steps, see [Microsoft's guide](https://learn.microsoft.com/en-us/entra/fundamentals/how-to-find-tenant){:target="_blank"}.
50+
- Example URL with a sample directory UUID: `https://login.microsoftonline.com/861e4762-e528-4faf-ad95-70847a9efbe7/oauth2/v2.0/token`
51+
- Scope: `https://<dynamics>/.default`. Replace `<dynamics>` with the domain of your Dynamics 365 instance. This appears in your web browser's address bar when using your app.
52+
- Example URL for a Dynamics 365 instance: `https://org2fd4b414.crm.dynamics.com/.default`.
5253
4. Click **Connect** to set up the OAuth connection with Microsoft.
5354

5455
Authentication will take place if the configurations are correct and the access token will automatically be generated without the need for user login.
@@ -91,7 +92,7 @@ To create or update the Account entity only, you can skip this step and directly
9192
1. Create a new Mapping in the Mappings tab and select the **Send** HTTP action.
9293
2. Choose which events you want to send to Google Search Ads 360 API using the Event filters.
9394
3. Fill out mapping fields:
94-
- Specify the URL: [Organization URI]/api/data/v9.2/accounts (this is for creating new accounts)
95+
- Specify the URL: `[Organization URI]/api/data/v9.2/accounts` (this is for creating new accounts)
9596
4. Use the mapping interface and search for the “body” parameter that was created in the insert function to select the transformed object that can be sent as the event body.
9697
5. Turn off batching for this operation.
9798

@@ -103,11 +104,11 @@ To create or update the Account entity only, you can skip this step and directly
103104
#### Troubleshooting
104105

105106
If the test fails:
106-
- review the authentication details and data mappings.
107-
- check for error messages in Segment and Search Ads.
107+
- Review the authentication details and data mappings.
108+
- Check for error messages in Segment and Search Ads.
108109

109110
### 7. Save and enable the destination
110111

111112
1. Once the test is successful, click **Save** to store your configuration.
112113
2. Toggle the destination to Enable to start sending live data to Microsoft Dynamics 365.
113-
3. Monitor the data flow to ensure that events are being delivered as expected.
114+
3. Monitor the data flow to ensure that events are being delivered as expected.

0 commit comments

Comments
 (0)