Installing Dynamics Contact Panel
The Contact Card is an embedded panel that displays eMarketeer contact information directly inside Microsoft Dynamics 365. When placed on a Contact or Lead form, it lets you view eMarketeer data for the current record without leaving Dynamics.
The Contact Card matches records by email address — it looks up the Dynamics record’s primary email in eMarketeer and shows the corresponding contact information.
Prerequisites
Before you begin:
- Your eMarketeer account must be connected to Dynamics 365. If you have not connected yet, follow the Dynamics 365 Installation Guide.
- The Contact Card web resource is automatically created in your Dynamics environment when you connect. No manual installation is needed.
- You need the System Administrator or System Customizer role in Dynamics 365 to add the web resource to forms.
Adding the Contact Card to a Contact Form
These steps use the modern Power Apps form designer.
- Sign in to Power Apps and verify you are in the correct environment.
- In the left navigation, select Tables, then open the Contact table.
- Select Forms, choose the Main form you want to edit, and click Edit.
- In the form designer, open the Components pane on the left side.
- Expand the Display section.
- Select HTML Web resource.
- Find eMarketeer Contact Card in the list and click Add. We recommend placing it in a dedicated section or tab for a clean layout.
- Select the web resource on the form to open the Properties pane on the right.
- Configure the display properties:
- Hide label: Enable (recommended for a cleaner look)
- Component height: Set to 8–10 rows (approximately 300–400px)
- Scrolling: As Necessary
- Display border: Disable (for a seamless embedded look)
- Scroll down to the Advanced section and configure:
- Enable “Pass row object-type code and unique identifier as parameters”
- Disable “Restrict cross-frame scripting where supported”
⚠️ Important: “Pass row object-type code and unique identifier as parameters” is required. Without it, the panel cannot identify which record you are viewing and will show “No record context available.”
⚠️ Important: “Restrict cross-frame scripting where supported” must be disabled. When enabled, it blocks the JavaScript that the Contact Card needs to function.
- Click Save, then click Publish.
Open any saved Contact record to verify the eMarketeer Contact Card appears and displays data.
Note: If you are using the classic form editor instead of Power Apps, select the Insert tab on the ribbon, then click Web Resource. The configuration options are the same but appear in a dialog box with tabs (General, Formatting, Dependencies) instead of a side pane.
Adding the Contact Card to a Lead Form
The same web resource works for both Contact and Lead forms. Follow the same steps as above, but open the Lead table instead of the Contact table in step 2.
The Contact Card reads the entity type automatically, so no additional configuration is needed for Lead forms.
Using the Contact Card
When you open a Contact or Lead record that has the Contact Card on the form, the panel loads automatically. It retrieves the record’s primary email address and looks up the corresponding contact in eMarketeer.
What You May See
| State | What it looks like | What it means |
|---|---|---|
| Loading | “Loading eMarketeer…” (gray centered text) | The panel is loading. Wait a few seconds. |
| Contact card with data | eMarketeer contact information | The record’s email was found in eMarketeer. |
| No matching contact | Empty panel or “no contact” message | The email on this Dynamics record does not match any contact in eMarketeer. |
| No record context | “No record context available” (gray centered text) | The panel cannot identify the current record. See Troubleshooting below. |
Note: The Contact Card only works on saved records. If you are creating a new Contact or Lead, save the record first. Dynamics does not pass the record information to the panel until the record is saved.
Troubleshooting
| Symptom | Cause | Solution |
|---|---|---|
| Web resource not found in the Components list | The connection may still be processing | Wait 2–3 minutes after connecting, then refresh the form designer. The web resource is created automatically during the connection process. |
| “No record context available” | “Pass row object-type code and unique identifier as parameters” is not enabled | Edit the form, select the web resource, and enable this setting in the Advanced section. Save and Publish the form. |
| “No record context available” on a new record | The record has not been saved yet | Save the record first. Dynamics does not pass the record ID to web resources until the record is saved. |
| “Loading eMarketeer…” stays indefinitely | Network or authentication issue | Verify the Dynamics user has internet access to app.emarketeer.com. Open the browser developer console (F12) and check the Console and Network tabs for errors. |
| Panel is blank or shows an error | “Restrict cross-frame scripting” is enabled | Edit the form, select the web resource, and disable “Restrict cross-frame scripting where supported” in the Advanced section. Save and Publish the form. |
| No contact data shown | No matching contact in eMarketeer | The panel matches by email address. Verify the Dynamics record has an email in the Email field, and that the same email exists as a contact in eMarketeer. |
| Panel missing after reconnecting | Web resource was removed during disconnect | After reconnecting, the web resource is recreated automatically. You may need to re-add it to the form by following the steps above. |
Related Articles
- Dynamics 365 Installation Guide
- Legal Basis & Subscription Sync
- Importing Contacts from Dynamics
- Journey Steps