Accessing Engage

Note: Before your users can access Engage, it must be installed in your Oracle Eloqua instance. Once installed, the customer administrator can customize the options that appear to those using the program. Learn more about installing and configuring Engage.

You can use the following links to give your users access to Engage:

  • Direct: https://login.eloqua.com/apps/salesTools/engage/compose
  • Autologin: https://login.eloqua.com/autoLogin?LoginPrefix={prefix}&Url=/apps/salesTools/engage/compose
  • SAML: https://login.eloqua.com/auth/saml2/autologin?LoginPrefix={prefix}&ReturnUrl=/apps/salesTools/engage/compose
  • SFDC IDP: https://{podURL}/sso/sfdc/v1/svp.aspx?LP={prefix}&RU=/apps/salesTools/engage/compose

    Replace {podURL} with the URL in your browser after you have logged in successfully to Eloqua (for example, secure.p01.eloqua.com). Click here for additional information about how to determine your pod.

    LoginPrefix values are a four-character code for the company name that you enter in the Company field on the login page. To add this parameter to your URL, enter LoginPrefix={prefix} where {prefix} is replaced with the four-character company name. You can obtain your company's login prefix in Eloqua by navigating to Settings > Display Preferences > Company Defaults.

Engage URL parameters

Using the access URLs above, you can append additional information to populate your recipients and select an email template:

  • Open the Template Chooser with a specific recipient: ...?emailAddress={emailaddress}
  • Open a blank email: ...?blank=true

    This option opens a blank email if the creation of blank emails is allowed in your instance (managed in Engage Global Settings). If the creation of blank emails is not allowed, the email chooser opens and displays available templates (a blank email option is not available).

  • Open a blank personal email with a specific recipient: …?blank=true&emailAddress={emailaddress}
  • Open a specific template: ...?emailId={templateID}

    To determine the templateID, find and open the email you are looking for in Eloqua and refer to the URL. The last portion of the URL is the value you substitute into your Engage URL as your templateID.

    Example: If the Eloqua URL for the email template is https://secure.p02.eloqua.com/Main.aspx#emails&id=581, append the following to your engage URL ...?emailId=581. Your full Engage URL looks like this: https://login.eloqua.com/apps/embed/salesTools/engage?emailId=581

  • Open a specific template with a recipient: ...?emailAddress={emailaddress}&emailId={templateID}
  • For multiple recipients, use commas or semicolons to separate them:
    • ?emailAddress={emailaddress1},{emailaddress2},{emailaddress3},...
    • ?emailAddress={emailaddress1};{emailaddress2};{emailaddress3};...

The first parameter must start with ?; each parameter is separated by &.

Tip: If you are using Microsoft Edge or Sales Tools for Microsoft Outlook to access the Oracle Eloqua sign in page in an iframe, an addition should be made to trusted sites. Add https://*.eloqua.com and the URL of the site where the login page (Oracle Eloqua and/or Sales Tools) is being iframed. The browser must be closed fully and restarted before the change is recognized. For additional information, see this Topliners post about Oracle Eloqua login enhancements.

Embedding Engage pages

You can embed Engage pages into an iframe, allowing your users to access Engage directly from other apps at your organization. For example, embed Engage directly into your CRM.

When embedding Engage pages, the URL structure changes to: /apps/embed/salesTools

To learn more about embedding Engage in different CRMs, see Engage integration.

Learn more

Engage

Installing Engage

Engage integration