Skip to main content

Direct Message Injection (DMI) for Gmail

Deliver revel8 simulations straight into Gmail inboxes with Direct Message Injection, instead of whitelisting sending domains.

ℹ️ Info
Part of the Getting Started guide, Step 2. Ensure deliverability.

Direct Message Injection (DMI) places revel8 simulations straight into your users' Gmail inboxes and bypasses mail filtering, so you do not need to whitelist any sending domains. You authorize revel8 in Google Workspace with domain-wide delegation, send a test email, and then switch DMI on.

⚠️ Warning
DMI replaces sending-domain whitelisting only. Simulation landing pages still have to be allowed through whatever filters your users' web traffic.

Before you begin

Have these ready:

  • A Google Workspace super administrator account.

  • Admin access to revel8.

1. Authorize revel8 in Google Workspace

These steps follow Google's guide to setting up domain-wide delegation.

  1. Open admin.google.com/ac/owl/domainwidedelegation.

  2. Click Add new.

    The domain-wide delegation page in Google Admin with the Add new button

  3. Under Client ID, enter:

    114897939228563486722

  4. Under OAuth scopes, enter:

    https://www.googleapis.com/auth/gmail.insert

  5. Click Authorize.

2. Send a test email

  1. In revel8, open Settings → Mail Delivery (in Integrations) and select the Gmail DMI tab.

  2. Under Send a test email, enter your own email address and click Send the test email.

  3. Check that the email arrives in your Gmail inbox.

The revel8 Mail Delivery page with the Gmail DMI tab, the Send a test email card and the Enable Gmail direct message injection button

If sending fails, check the client ID and scope from step 1. Google can take a while to apply a new delegation, so wait a few minutes and try again.

3. Switch on Gmail DMI

Only once the test email has arrived, click Enable Gmail direct message injection. Gmail direct message injection status changes from Inactive to Active.

Did this answer your question?

Related Articles