Skip to main content
All CollectionsGmail Add-in
Using the SourceWhale Gmail Add-in Integration
Using the SourceWhale Gmail Add-in Integration

This article shows you how to set-up the Gmail integration and how to use it.

Updated over 2 months ago

The Gmail Integration allows you to quickly create nudge templates with all the best SourceWhale features available directly in your Gmail.

Before continuing with this guide, you'll need to make sure the Gmail add-in is enabled on your account.

If you joined SourceWhale after May 2024, the Gmail Add-in will be automatically enabled on your account. For accounts created before May 2024, you’ll need to enable the add-in manually - follow the instructions here.


For a video walkthrough of how to use the SourceWhale Gmail Add-in, watch below.


Opening SourceWhale Add-in

  1. Click 'Compose' to open a new email and view the SourceWhale add-in.

  2. Click the Whale Tail icon on the far left of the SourceWhale add-in bar, to open out the side panel view.


Creating a Nudge Template

  1. Write your email, add a subject and recipients.

  2. Click ‘Create’ to create a new Nudge template.

  3. Write your follow up Nudge email. You can add additional Nudge follow up emails by clicking ‘Add Nudge’. You can also delete steps if needed by clicking ‘Delete’.

  4. Give your template a name and click ‘Save Nudge Template’.


Adding a Nudge Template to the Email

  1. Choose a template from the list displayed. You can see your own Nudge templates or toggle on your team’s Nudge templates.

  2. Select the chosen template by clicking on it, you’ll then see a message at the top of the email informing you that the Nudges have been applied.


Adding Personalization to a Nudge

  1. You can edit Nudges for a specific person, to do so add your personalization on the relevant Nudge in the add-in panel. You can also add or delete any steps and this will only apply to the individual you’re emailing (the Nudge template won’t be affected).

  2. Once you’ve made your changes click ‘Apply’.

  3. You’ll see a message saying ‘Your personalization have been applied’.


Using Content Coach

  1. Select the ‘Coach’ tab from the add-in.

  2. You must have at least 10+ words in the body of your email for this to work.

  3. The coach will then analyse your content and provide suggestions on how to improve.

    N.B: Content Coach only reads content in the main email body. Content in Nudge follow ups is not taken into account in the Coach score.


Tracking

  1. Open the tracking tab from the add-in.

  2. Choose whether you would like all emails to be tracked by default or whether you want to apply tracking to individual emails

    1. Track all emails: Click on the SourceWhale icon within Gmail, select track opens and track clicks as your default tracking options.

    2. Track individual emails: When opening out a new email, tick the boxes for which tracking type you require. This tracking selection will only be applied to this email.

  3. Send your email.

  4. To review the outcome of the click/open tracking, open the email in your sent box and open the SourceWhale add-in - tracks and clicks will display there.


Reviewing Sent/Pending Nudges

  1. In your sent inbox you can view emails that have pending Nudges with the ‘Pending Nudges’ label. You can also search your emails for this label to see a full list.

  2. You can also click on an individual sent email, open the SourceWhale add-in and view all the pending Nudges there as well as when they are due to be sent.

  3. The SourceWhale label means the email is being sent through SourceWhale and the contact is in SourceWhale.

  4. The blue dot lets you know if that contact is in SW, which campaign they are on and also gives you a quick view of any tracking information (if it was enabled)


Stopping Pending Nudges

  1. If you wish to stop pending Nudges, open out the email from the sent box.

  2. Click ‘Stop Nudges’, located underneath the tracking information.


Updating the Add-in

You may periodically see this message. This happens when there has been an update to the SourceWhale extension, which requires the Gmail add-in to also be updated. Updates will happen automatically if Gmail is refreshed or you sign in/out. However, for those users that leave Gmail open in the background, you are likely to see this notification which will force Gmail to refresh and the add-in to update to the latest version.


Gmail Add-in Frequently Asked Questions

  • What is the SourceWhale label for?

    This means that the email has been sent via SourceWhale, any campaign sent from the web app or any nudge email sent will have this label attached. If the recipient is a contact in SourceWhale then you can see all your messages correspondence (including nudges) in the activity feed.

  • What is the Pending Nudges label for?

    The ‘Pending Nudges’ label means that this email thread has nudges which are scheduled but are yet to be sent. To see all ‘pending nudges’ the user can search their emails with this label. When all nudge emails in a sequence have been sent, the label will disappear.

  • How can I see a list of all my pending nudges?

    You can use your email search bar to enter in ‘pending nudges’ this will bring up all emails with the ‘pending nudges’ tag. Once a nudge has been sent and is no longer pending, the label will be removed and it won’t show up in this view.

  • Do emails sent with the add-in track in the SourceWhale app?

    If the recipient is a contact in SourceWhale, the email will be tagged with the ‘SourceWhale label’. In this case, the email will pull through on that contacts activity feed on the main SourceWhale app. However, tracking of clicks and opens is not sent back to the SourceWhale app.

  • Does open/click tracking track nudge emails as well as the original email?

    Yes, when turning on click and open tracking on an email, if there are nudges attached, these emails will also be tracked. Please note, that the individual email in the thread has to be selected to show the relevant tracking information.

  • If the add-in is turned off after I have scheduled a nudge sequence, will it still send?

    Once the nudge sequence has been scheduled it will go out as planned. The only way to stop it, is to go in and click Stop Nudges or if SourceWhale disables your account.

  • If the recipient has unsubscribed from a SourceWhale campaign, will my nudges still send?

    Nudges are not impacted by unsubscribes. If a contact has unsubscribed via a SourceWhale campaign, they will still receive nudge emails.

  • What time are nudge emails sent out?

    Nudges are scheduled to send between 08:00 and 18:00 (users timezone) on the day they are due (weekdays only). Just like in the main SourceWhale app, nudges will be scheduled with short gaps. For example, if you have 5 nudges due to be sent out that day they may be scheduled at 8:00, 8:03, 8:06 etc.

  • Do nudges count towards my daily email sending limit?

    Yes, each individual nudges email sent out will count towards your daily sending limit.

  • Will CC and BCC recipients receive my nudges?

    No, CC and BCC recipients will only receive the initial email they are attached to, they will not receive any nudge follow ups.

  • Can two recipients receive my nudges?

    It is not possible to send nudge emails to 2 recipients at the same time, the add-in will only allow you to add one recipient. In cases where there is an attempt to add 2 recipients, you will be notified.

  • Are nudges tracked in the users CRM?

    Not currently no, however this is something we are considering for a V2 of the feature.

  • Will the add-in work with alias emails?

    No, the add-in can only be used with an account that sends email through SourceWhale (ie. user or superuser) and this must be your primary email address in SourceWhale.

Stuck or need some help? Click on the chat icon at the bottom right-hand corner to connect with our support team! 💬

Did this answer your question?