Below is a list of questions we've heard from customers about CoPilot, and their answers. If you have questions that are not answered here, or in related support articles, please contact email@example.com. If you would like to suggest enhancements to the CoPilot funtionality, please post them on Gainsight's Community.
CoPilot integration with Marketo and other automated systems
Currently, CoPilot does not integrate with any other email systems. If you want to use Marketo, you can integrate it with our Rules Engine. Integration with Eloqua is on our long term roadmap.
Gainsight Email Service
The Gainsight Email Service is backed by Sendgrid. When you send emails via CoPilot, or the Rules Engine, they are handled by Sendgrid. This also includes rules engine success/failure emails sent to Admins.
Automated vs. Semi-automated Email options
CoPilot is Gainsight's automated email feature. Admins can design email templates, configure dynamic power lists (contact lists), and schedule the outreach to reach the right customers at the right time.
Gainsight also offers a semi-automated email feature called Email Assist, which is accessible to CSMs using Calls to action in the Cockpit. We recommend using Email Assist tasks when your CSMs need more control over the scheduling and contents of the email. Email Assist tasks utilize CoPilot email templates, but your CSM selects individual contacts to send the email to, and the email contents can be customized as needed. See Configure Email Tasks to Send from Cockpit for more info.
What's the difference between Adv. Outreach, standard Outreaches, Email Assist, and Gsnap functionality?
For information on how Email Assist, standard Outreaches, Adv. Outreaches, and Gsnap compare to one another, and their available functionality, refer to this table.
Use Multiple Email Platforms in Same Org
Within the same Salesforce/Gainsight org, it is possible to use CoPilot, in addition to another email platform such as Marketo.
CoPilot Email Storage
Once a CoPilot email is sent, will it be recorded in the Activity History in SFDC?
Email data is stored in Email Logs on the MDA Platform. You can also store emails as SFDC activities if you select the "Log Email to SalesForce Activity" option in the Outreach page.
Surveys and CoPilot
You can send Surveys via CoPilot. CoPIlot enables you to setup a dynamic Power List for your Survey, whereas the existing Survey functionality relies on a static list. For more information on how to send surveys via CoPilot, please read the article Send Surveys to Dynamic Contact List via CoPilot.
CoPilot Power List
What is a Power List?
The Power List is the list of contacts you want to email based on certain criteria. You can configure and set up different power lists based on your needs. For example, one power list could be all customers in a specific region, or with low usage of a specific feature.
The maximum number of contacts that can be stored in a power list is 200,000.
Who should create a Power List?
We recommend that a Gainsight Administrator configures the more complex Power List use cases for the CS team since the user needs to be familiar with the rules engine. However, if granted CoPilot permissions, a CSM can configure Power Lists. Anyone who has permission to create Power Lists can view and edit existing Power Lists in your org.
How can I remove individuals from a Power List?
Use criteria to remove individuals from a list. For example, if you have a field on your Salesforce record for “Email Opt Out” - you can bring this into the criteria. In the future, you will be able to exclude individuals from a Power List. Note: the Opt Out field must be explicitly added to your Power List; otherwise, contacts may be included in your power list in spite of being opted out on their SFDC contact record.
Is there a way to add or delete a single user from a Power List once the list is created, without going back and changing the criteria?
Not currently. The idea of a power list is to be dynamic, which means contacts in it change based on criteria automatically, versus manual edits.
Does every CSM have to set up their own power list? Or will it recognize which CSM is trying to use that list and only send it to the clients specific to them?
It depends on the use case and the message you would like to send. If a CSM wants to email only his / her customers with a specific message, then the power list can be set up to include only that CSM’s customers. However, if the content and the email is the same, then one power list can be created and in the Outreach configuration, the “From Email Address” can be set to the ‘Account → CSM’ field.
Can you schedule emails based on data stored in Salesforce fields?
Yes, this is possible based on the criteria you set up in your Power List.
In permissions, what does it mean to execute a Power List?
Executing a power list refers to refreshing the Power List. You can refresh the Power List on demand at anytime, or schedule it to refresh daily. If you are scheduling a daily outreach, you would want to refresh your power list daily.
Can CoPilot be used for non-SFDC contacts?
Yes, but you still need to associate contacts with an Account ID. CoPilot can also pull in email addresses from Usage subject areas.
How do we manage opt-outs across two different email platforms (between Marketo and CoPilot)?
CoPilot stores the email addresses for anyone who has unsubscribed within email logs in the MDA subject area (Unsubscribed Emails). You can sync this into SFDC (on the contact record) and then bring that into Marketo, so that you sync opt-outs across platforms. In CoPilot, you can filter on any email opt-outs (if it’s stored on the SFDC contact record that gets updated from Marketo), so you don't include them in your Outreaches.
If there are more than 1000 contacts in a CoPilot Power List, the table on the summary page only lists 1000. Is this a limitation in the UI?
Yes, the limitation is in the UI. The hard limit is 200,000 contacts.
Can you confirm if there is a way to send (non-marketing) email to contacts who have opted-out of emails via CoPilot?
There's no way currently to side-step the subscription preferences in CoPilot. However, you can use the Rules Engine to send out operational emails. There is an option to disable the opt-outs and send to everyone. See the article Rule to Add Email Subscription Preferences for more info.
Can I download or export a Power List?
Although there isn't an export option in CoPilot > Power Lists, you can refresh a Power List, and then you will receive an email with a csv file containing all of the contacts that currently meet the Power List criteria.
Can I upload a Power List to CoPilot?
No. Your Power List must be configured in CoPilot, which enables Gainsight to dynamically update the Power List over time, as different contacts or data match your criteria.
CoPilot Email Templates
What kinds of HTML code are accepted in Email Templates?
You can bring in any HTML code that you’ve used to build templates in Salesforce or Marketo. It is currently not possible to edit the HTML once you’ve brought it into CoPilot, however, you can use the WYSIWYG editor to update the template formatting. Basic HTML is supported, but it’s not guaranteed that all the formatting will be retained; however, you can edit the template after that. We recommend sending yourself a sample email to test how the email looks in your email client.
Can I embed an NPS survey question directly in my CoPilot email?
Not yet, but this is a planned enhancement.
How many variants can I add to a multi-variant email template?
You can create a maximum of 15 variants.
When should the original Outreach feature be used instead of the Adv. Outreach feature?
We recommend using Advanced Outreach for the majority of use cases. The original Outreach feature should still be used for emails that require the Time Identifier feature, which gives users the ability to send emails at different times to different recipients based on defined criteria. In all other cases, the Advanced Outreach feature is the recommended option. See also Adv. Outreach FAQs.
Do you need to setup the “From Email” as a universal address in SFDC?
You can key-in any email address in the “From Email” field, as well as the “Reply To” field.
Is it possible to trigger more than one Outreach in sequence to a Power List?
Yes, you can create multiple Outreaches that utilize the same Power List.
How does the recurring schedule set in the “Scheduler View” differ from the recurrence created in Outreach settings?
It is the same view. However, the “Scheduler View” is view only, whereas you can set up a one-time or recurring schedule from the Outreach settings.
Is there anything we need to configure so that the emails are not marked as spam?
To improve the deliverability of your emails, we recommend that you follow a few best practices:
- use the recipient’s first name in the email body
- offer an unsubscribe link in emails and surveys
- add your business’s mailing address in the email footer
- your IT contact should refer to the article Gainsight Email Activation for whitelabeling instructions to protect your organization’s email reputation (includes info on SPF and DKIM)
How do we get past firewalls and spam filters to ensure our emails are delivered?
On Gainsight’s side, we make sure the IP Address through which emails are sent is warmed up and has a good reputation. We also make sure once the email ID is detected as invalid, we automatically add it to a blacklist, thus maintaining the reputation of the IP address and ensuring high deliverability.
On your end, you are expected to maintain:
- Clean email lists by pruning out the invalid email addresses.
- Target the right recipients so that there is less chance of your email being marked as Spam.
- Follow email best practises
If we put an unsubscribe link in the email footer, what happens when the customer clicks unsubscribe? Does CoPilot remove that person from the Power List? Are they removed from all Power Lists? Or do we have to manually reconcile this?
We recommend using the unsubscribe feature that comes with CoPilot. The unsubscribe footer gets added automatically and the contacts who unsubscribe are not sent email across Copilot / Rules / Survey. There are two sections in the unsubscribe page, when the end-users clicks unsubscribe:
- Success communication(Copilot + Rules Engine): If the user checks this option and unsubscribes, then emails from Rules and CoPilot will not be sent.
- Surveys: If the user checks this option, then survey emails are not sent. Note: Applicable only for Gainsight email service.
- If both of the above options are checked, then no email is sent via Gainsight to that email address.
If you have multiple tokens in a single email, will it NOT send the email if any of the tokens are missing?
If tokens are missing, the email will not send if you have checked the option “Don’t send email when Token/Placeholder value is not available”.
Is there a way to track and cap the number of emails that a single user receives in a given period of time? For example, set a limit that keeps a user from receiving more than 5 outreaches per month.
At this point, you can only limit the duration between the same outreach. e.g. if you have a recurring schedule outreach, you can ensure the same contact doesn't receive the same outreach in 30, 60, or 90 days. Our product team is evaluating the possibility of adding an overall email cap. All of this can be tracked in CoPilot Analytics.
What is the difference between Outreaches and Advanced Outreaches?
The original Outreach feature is still the best option for sending one-off emails. Advanced Outreaches are designed for multi-chain email campaigns. To learn more about Advanced Outreaches, see the article Advanced Outreach FAQ or the article Introduction to Advanced Outreach.
In Analytics, does the number of clicks/opens represent unique contacts or the totals?
It represents the total clicks and opens.
Can we export the Analytics results into Excel for summary reporting?
Yes. Click the Visualization type and select Table. Then click the Settings wheel and select Export as Excel.
If you have additional questions or enhancement suggestions, please visit the Gainsight Community.
Additional Tracking - Dynamic Image Tracking Pixel
Can I add additional tracking, such as a dynamic image tracking pixels, in my CoPilot email templates?
This is not supported at this time. However, it is possible to add this option in Salesforce email templates.
For information on how to resolve common CoPilot errors, refer to Common Errors and Reasons.
Power List Troubleshooting
Tips for troubleshooting:
- If you don't see contacts in your Power List that you expect to see, please the article Email Validator and check the blacklist in case the contact has opted-out.
- If you're Power List query fails to generate results, you may not have the appropriate SFDC permission for one or more of the Power List fields.
Token mapping in CoPilot emails involves three steps, in three different areas of CoPilot.
1. CoPilot > Power Lists: add any fields you wish to tokenize under "Select list fields" (First name, Last name, CSM Name, etc.)
2. CoPilot > Email Templates: to tokenize any text in the email, click the Tag button in the email designer. Then you can edit the token properties (placeholder text, default value).
3. CoPilot > Outreaches: click the mapping icon next to any tokenized text to select the field to map to.
Why can't I add fields to the Email Logs object?
The Email Logs object is read-only to customers because Gainsight uses the object to write data to (from CoPilot outreaches for example).
Contact firstname.lastname@example.org if you need to add fields to these hidden objects, and they will connect you with a resource who can assist.
- Distribute via Survey Module: 1000 / schedule
- Distribute via Rules Engine: 200k per rule run
- Copilot: Not Applicable
Salesforce Email service:
- Distribute via Survey Module: 750 / day across all schedules
- Rules Engine: Not Applicable
- Copilot: Not Applicable
GS Email service:
- Distribute via Survey Module: 1000 / schedule
- Distribute via Rules Engine: 200k per rule run
- Copilot: 200k / Outreach schedule