Skip to main content

Workbooks
  • Knowledge Base
  • Customer Forum
  • Suggestions
  • Training
  • Support Portal
Login
  1. Home
  2. Support
  3. Knowledge Base
  4. Knowledge base
  5. Integrations
  6. Email Integrations
  7. Workbooks Exchange Server Sync
  8. The WESS Add-in
  9. Enabling the WESS Add-in
Support

Knowledge Base

Browse our knowledge base articles to quickly solve your issue.

  1. Home
  2. Support
  3. Knowledge Base
  4. Knowledge base
  5. Integrations
  6. Email Integrations
  7. Workbooks Exchange Server Sync
  8. The WESS Add-in
  9. Enabling the WESS Add-in
  • Welcome to the Knowledge Base
  • Introduction
    • Introduction to Workbooks
    • Using the Knowledge Base
    • Editions & Licensing
      • Renewing Licences
    • Workflow
      • Queues
    • Logging In
      • Configuring Security Policies
      • Google Authentication
      • Login Protection
      • Microsoft Azure Active Directory
        • Link Workbooks to Microsoft Azure
        • Setting up User Templates
        • Locking down your Workbooks
  • Training
    • Training Videos
    • Training Courses
  • Desktop Environment
    • Supported browsers
    • Introduction
    • Desktop
      • Setting up and configuring the Modern Theme
      • Tips & Tricks on the Desktop
    • Records
      • External Links to Workbooks records
      • Summary Timeline View
      • Tabs
      • Watching Records
      • Notes
    • Landing Pages
      • Bulk Actions
        • Scheduled Bulk Actions
      • Customising Views
        • Customising Columns
        • Filtering
          • Custom Filters
        • Calendar Views
      • Deleted Items
      • Edit Grids
    • HTML Editor
    • Welcome Messages & Bulletins
    • Exporting Data
    • Multi Language
    • Notifications & Reminders
    • Workbooks Mobile Client
      • Modern UI on Mobile/Tablet
  • Preferences
    • Introduction to Preferences
    • Setting your Preferences
      • Email Accounts
  • Activities
    • Introduction to Activities
    • Using Activities
      • Meetings
        • Integrating Workbooks and Google Calendar
          • Installing and Managing Workbooks and Google Calendar Integration
          • Synchronising your Google Calendar with Workbooks
      • Follow-on Activities
  • Cases
    • Introduction to Cases
    • Displaying & Adding Cases
    • Managing Cases
    • Case Portal
      • Installation
        • Custom Fields
        • Case Portal Configuration
          • Company Details
          • General
            • Case Portal Reports
          • New Case
          • Help Text
          • Emails
          • Advanced Features
          • Field Mappings
          • Help Dialog
          • Product Area Questions
        • Case Portal Additional Features
          • Setting up Public/Private Activity creation
          • Setup Registration Emails from a Person
          • Automatic Emails on Case Status Change
      • Using the Case Portal
        • Case Updates - Public & Private Activities
        • Inviting a Person to the Case Portal
  • Email
    • Introduction to Email
    • Working With Emails
    • Email Signatures
    • Sending Bulk Email
    • Common Email Errors
    • Email Integrations
    • Mailing Lists
  • Forecasts & Quotas
    • Introduction to Forecasts & Quotas
    • Sales Forecasts
      • Adjusting Forecasts
      • Included Forecasts
    • Sales Quotas
  • Importing Data
    • Introduction to Importing
    • Preparing your Import Data
      • Import Templates
      • Compulsory fields for Import
    • Workbooks Import Wizard
      • Uploading your data
      • Defining Field Mappings
      • Extending your Import to other Record types
      • Checking for Duplicates
      • Running and Reviewing your Import
    • Managing your Imports
      • Undoing an Import
  • Leads
    • Introduction to Leads
    • Displaying & Adding Leads
    • Converting Leads
  • Marketing
    • Introduction to Marketing
    • Marketing Campaigns
      • Displaying & Adding Campaigns
      • Campaign Management
      • Campaign Membership
      • Tracking URLs on Campaigns
      • Integrating Workbooks and Constant Contact
      • Integrating Dotmailer and Workbooks
        • Configuring Workbooks and Dotmailer
      • Integrating MailChimp and Workbooks
        • Configuring Workbooks and MailChimp
    • Mailing Lists
      • Creating Mailing Lists
    • Products
      • Pricing Schemes
      • Supply Scheme
      • Product Bundles
    • Mailshots
      • Creating a Mailshot
    • Upload Library
      • Using the Upload Library
    • Templates
      • Creating Templates
      • Creating a Template to show multiple lines
      • Extra Template Placeholders
    • Workbooks Web Insights
      • Tracking Code
        • Restricting Page Tracking
      • Setting up the Plugin
      • Viewing Web Insights Data on your Form Layouts
      • Domain Names and Online Activities
      • Gator Popup
      • Reporting incorrect Leads created through Web Insights
      • Reporting on Web Insights data
      • Using UTM Values
      • Why aren’t Online Activities being created in the database?
      • Why is GatorLeads recording online activities in a foreign language?
    • Using HubSpot with Workbooks
    • Event Management
      • Introduction to Event Management
      • Enabling the Event Management Module
      • Using Event Records
        • Event Records
        • Event Sessions
        • Event Speakers
        • Event Sponsors
        • Event Products
        • Event Tickets
        • Event Attendees
      • The Event Management Portal
        • Introduction to the Event Management Portal
        • Prerequisites for installation
        • Accessing the Plugin
        • Installing the Event Management Portal
        • Amending Event Portal Parameters
        • Adding Custom CSS to the Event Portal
      • On The Day Registration App
      • Setup On the Day Registration App
    • Compliance Records
      • Introduction to Compliance Records
      • Enabling Compliance Records
      • Creating Compliance Records
      • Using Compliance Records
    • GatorMail Integration
      • Setting up the Integration
      • Sending Mailshots using GatorMail
        • Creating a GatorMail Mailshot without a Marketing Campaign
      • Gator Smart Forms
      • GatorMail - Dynamic Content
        • Dynamic Content Example - Dynamic Sender
      • GatorMail Domain Setup
      • GatorMail Field Mappings
        • GatorMail Hard Bounces
      • Managing your GatorMail Account
      • Setting up GatorMail Workflows
        • Spotler Data Sync
        • Triggered Mailshots
      • GatorCreator
      • GatorSurveys
  • Opportunities
    • Introduction to Opportunities
    • Displaying & Adding Opportunities
    • Opportunity Line Items
    • Opportunity Relationships
  • Integrations
    • Mapping
      • Introduction to the Mapping Module
      • Using the Mapping Module
      • Changing the size/colour of Map Pins
    • Electronic Signing Tools
      • Docusign Integration
        • DocuSign Functionality
          • Copy Document on Signature
          • Update Related Records
          • Sending Multiple Documents
          • People, Organisations & Cases with DocuSign
          • Invoice Payments with DocuSign
          • Managing DocuSign Documents
        • Setting up the DocuSign Integration
          • Authentication with DocuSign
          • Production vs Sandbox
          • Creating a Document with a DocuSign Template
          • Creating a Document with a Workbooks PDF
          • DocuSign Fields
          • DocuSign Settings
          • Form Layout Configuration
        • DocuSign - Worked Examples
          • Taking Payments
          • Updating Related Records
          • Multiple Document Sends
          • Creating a Template for Cases
          • Creating a Template for Organisations
          • Creating a Template for People
          • Unified PDF for Transaction Documents
        • DocuSign - Reporting
          • Multiple Send Report Grid
          • Document Review Report
          • Monitoring Integration Errors
      • Adobe Sign Integration
        • Introduction to Adobe Sign
        • Authentication with Adobe Sign
        • Installing the Integration
        • Integration Monitoring & Error Handling
        • Setup of Adobe Sign
        • Adobe Sign Fields & Form Layout Configuration
        • Optional Custom Fields for Adobe Sign
        • Adobe Sign Button Process
        • Using the Adobe Sign Integration
    • Creditsafe Integration
      • Installing the Creditsafe Plugin
      • Configuring Organisations to use the Creditsafe Integration
      • An example of how to use the Creditsafe Integration
    • Zapier
      • Introduction to Zapier
      • Available Triggers and Actions
      • Linking your Workbooks Account to Zapier
      • Setting up Zaps
        • Posted Invoices to Xero Invoices
        • Xero payments to Workbooks Tasks
        • New Case to Google Drive folder
        • New Case to Basecamp Project
        • New Workbooks Case to JIRA Ticket
        • Jira Issue to new Case
        • 123FormBuilder Form Entry to Case
        • Eventbrite Attendee to Sales Lead and Task
        • Facebook Ad Leads to Sales Leads
        • Wufoo Form Entry to Sales Lead
        • Posted Credit Note to Task
        • QuickBooks Online
          • Initial Setup
            • Authentication with QuickBooks Online
          • People & Organisations to QuickBooks Customers
          • POSTED Workbooks Invoice to QuickBooks Online
          • QuickBooks Online Payment to Workbooks Invoice & Task
          • QuickBooks Sales Tax Code Lookup
        • Survey Monkey responses to Tasks
      • Multistep Zaps
    • Email Integrations
      • Email Dropbox
        • Setting up your Dropbox
        • Using your Dropbox
      • Workbooks Exchange Server Sync
        • WESS System Requirements
        • Setting up the WESS
        • Synchronising Emails
        • Synchronising People & Contacts
        • Synchronising Tasks & Meetings
        • WESS Troubleshooting
        • The WESS Add-in
          • Introduction to the WESS Add-in
          • Enabling the WESS Add-in
          • Customising the WESS Add-In
          • Managing Emails with the WESS Add-in
            • Relating Emails to Specific Records
          • Managing Contacts with the WESS Add-in
          • Managing Records with the WESS Add-in
            • Creating Records with the WESS Add-in
      • Workbooks Outlook Connector
        • Introduction to the Outlook Connector
        • Before downloading the Outlook Connector
          • System Requirements
          • Enabling the Outlook Connector
        • Download/update the Outlook Connector
        • Installing the Outlook Connector
          • Uninstalling the Outlook Connector
        • Using the Outlook Connector
          • Configuring the Outlook Connector's Settings
          • Identifying Records in Workbooks created in Outlook
        • Outlook Connector Troubleshooting
    • Event & Webinar Integration Tools
      • GoToWebinar
        • Installation
          • GoToWebinar Fields & Processes
          • Setting up Process Buttons for GoToWebinar
        • Authentication
          • Multiple GoToWebinar Accounts
          • Removing GoToWebinar Accounts
        • Create/Update & Cancel Webinars from Events
        • Event Attendees as Webinar Registrants
        • Event Speakers as Webinar Panelists
        • Retrieve Webinar Data
      • ON24
        • Installation
          • ON24 Fields & Processes
          • Setting Up Process Buttons for ON24
        • Authentication with ON24
          • Removing ON24 Accounts
        • Create Webcasts from Events
        • Event Attendees as Webcast Registrants
        • Retrieve Webcast Data
          • Reporting: Survey Responses
          • Reporting: Poll Responses
        • Retrieve Survey Data
        • Engagement Hub Interactions
    • Microsoft Office
      • Azure Active Directory
      • Excel
      • Outlook
      • Power BI
      • SharePoint
        • Installation
          • Custom Fields & Processes
        • Setup
          • Sharepoint Configuration
            • Allow SharePoint to Display in iFrames
          • Authentication
          • SharePoint Integration Settings
        • Using the SharePoint Integration
      • Word
        • Introduction to the Word Add-in
        • Deploying the Word Add-in
        • Creating Word Add-in Templates
          • Example Word Add-in Templates
        • Using Word Add-in Templates
        • Word Add-in Tips and Tricks
    • Outreach
      • Installation
        • Outreach Fields & Processes
        • Create Outreach Custom Field Mappings
          • Configure Outreach Field Dynamic Picklist
        • Sync Outreach Mappings
      • Outreach Authentication
        • Remove Outreach Account
      • Sync People to Outreach Prospects
        • People Field Mappings
      • Sync Organisations to Outreach Accounts
        • Organisation Field Mappings
      • Sync Workbooks Opportunities to Outreach
        • Opportunity Field Mappings
      • Sync Outreach Tasks/Calls/Meetings to Workbooks
      • Sync Deleted Workbooks Records
      • Outreach Email Events to Online Activities
    • Scribe/Workbooks Connector
      • Connection Setup
      • Connector Control Blocks
      • Worked Example - Create, Read, Update & Delete
  • People & Organisations
    • Introduction to People & Organisations
    • Organisations
      • Displaying & Adding Organisations
      • Customers & Suppliers
    • People
      • Displaying & Adding People
      • Adding People to Outlook
    • Relationships
      • Change Employer Wizard
      • Direct Relationships
      • Third Party Relationships
    • De-duplication and Merge
      • Data Quality
    • Using Postcode Lookup
    • Data Enrichment
      • Introduction to Data Enrichment
      • Setting up Data Enrichment
  • Reporting
    • Introduction to Reporting
      • Creating Reports
        • Standard Workbooks Reports
        • Creating a Pre-populated Report
        • Creating a Report from a Template
          • Report Templates
        • Creating a Blank Report
        • Auto-refreshing Report Views
      • Sharing Reports
    • Using Reports
      • Reporting Explained
        • Adding Targets, Conditional Formatting and CSS Styling
          • Calculated Targets
        • Reporting with multiple currencies
        • Drilling into Summary Views
        • Improving Report Performance & Run Time
      • Displaying reports within Record Views
      • Displaying Reports
        • Reporting Views (Reports on Landing Pages)
      • Adding a Report view to a Dashboard
    • Charts
      • Creating & Using Charts
        • Bar Charts
          • Targets on Bar Charts
        • Line Charts
        • Pie Charts
        • Dial Charts
    • Exporting Reports
      • Emailing Scheduled Reports
    • Advanced Reporting
      • Using Calculated Columns
        • Introduction to the IF Statement
        • Introduction to the CASE Statement
        • Applying Search filters in Calculated Columns
        • Comments in Calculated Columns
        • Financial Year Reporting
        • Introduction to Date Functions in Reports
        • Using Calculated Criteria
      • Audit Reporting
  • Dashboards
    • Adding Elements to Dashboards
      • Configuring Dashboard Elements
    • Dashboard Views
    • Dashboard Fields
    • Creating a Sales Dashboard
    • Adding a Dashboard as a Record Tab
  • Transaction Documents
    • Introduction to Transaction Documents
      • Displaying & Adding Transaction Documents
      • Copying Transaction Documents
      • Transaction Documents Fields Help
      • Transaction Documents Line Items Help
      • Printing & Sending Transaction Documents
      • Managing Transaction Document Currencies
      • Managing Transaction Document Statuses
    • Credit Notes
    • Customer Orders
    • Invoices
    • Quotations
    • Supplier Orders
    • Contract Management
      • Displaying & Adding Contracts
      • Using Contracts with Cases
    • Sagelink
  • Auditing
    • Auditing
  • Configuration
    • Introduction to System Administration
      • Quick Start Wizard
    • Users & Security
      • Users
        • Setting up your Users
        • Disabling Users
        • Profile Pictures
      • User Groups
        • Capabilities
        • Creating & Modifying User Groups
      • Permissions
        • Sharing Policies & Mandatory Permissions
          • Configuring the Advanced Security Module
            • Configuring the Advanced Security Module: Segmenting Users by function
            • Configuring the Advanced Security Module: Segmenting Users by location
      • Account Settings
      • Licences & Modules
    • Database
      • Databases
      • Storage Usage
      • Prefixes & Numbering
        • Modifying Object References
      • Export Database
      • Database Settings
    • Accounting
      • Accounting Periods
      • Exchange Rates
        • Setting Exchange Rates
      • Tax Regimes
        • Setting Tax Rates
        • Sales Tax Rulesets
          • Using Sales Tax Rulesets
      • Own Organisations
        • Setting up your Own Organisation
    • Email & Integration
      • Email Settings
        • Setting up your Email Server
        • Using Workbooks Server to send Emails
      • API Keys
      • Web to Case and Web to Lead
        • Setting up a Web2Case Form
        • Setting up a Web2Lead Form
        • Using Web Forms in Workbooks
        • Editing a Web Key Form
      • Preference Centre
      • MailChimp, Constant Contact & dotMailer
      • Loqate
      • Bank Account Validation
    • Customisation
      • Creating & Modifying Picklists
      • Record Types
        • Creating Custom Fields
          • Dynamic Linked Items & Picklists
          • Constrained Dynamic Linked Items (DLI) & Picklists
          • Creating relationships with Dynamic Linked Items (DLIs)
          • Linking Custom Field Values
          • Showing Linked Records in Tabs
        • Report-based Custom Fields
        • Linked Fields & Reference Fields
        • Record Templates
        • Form Layouts
          • Customising an Organisation form
          • Read-only Assigned to Fields
          • Card View
        • Customising relationships between parties
          • Configuring Custom Party Relationships
        • Opportunity Stages
      • Custom Records
        • Enabling Custom Records
        • Creating Custom Record Types
          • Editing Custom Record Types
        • Using Custom Records
    • Automation
      • Plugins
      • Processes
        • Process Logging
      • Workbooks Scripts
        • Script Library
        • How Workbooks Runs Scripts
        • Workbooks Script External Access
      • API Data
      • Triggers and Webhooks
        • Configuring Triggers and Webhooks
    • PDF Configuration
      • Modifying Document Templates
        • Adding Terms & Conditions to your Documents
        • Multi-line Value Tags
      • Modifying Default Colours & Images
      • Creating Custom Document Templates
  • Contact Support
    • Contacting Workbooks Support
    • Workbooks CRM Advisory Packs
    • Introduction to the Administrator Service
  • Releases & Roadmap
    • Roadmap
    • March 2021 Release
    • December 2020 Release
    • September 2020 Release
    • April 2020 Release
    • January 2020 Release
    • September 2019 Release
    • February 2019 - Event Management Release
    • January 2019 Release
    • October 2018 Release
    • May 2018 Release
    • February 2018 Release
    • January 2018 Release
    • November 2017 Release
    • September 2017 Release
    • June 2017 Release
    • March 2017 Release
    • December 2016 Release
    • August 2016 Release
    • January 2016 Release
  • Workbooks Glossary
    • Workbooks Glossary

Enabling the WESS Add-in

The WESS Add-in can only be accessed by users that already have an active Workbooks Exchange Server Synchronisation Account, so ensure that this has been configured before attempting to enable the Add-in.

Exchange Server Configuration

As the add-in that interacts directly with your Exchange Server you can deploy it silently for all of your Users or specific groups configured within your exchange account. Before going ahead with the installation we recommend that you review the Supported Hosts page from Microsoft to ensure that your environment will support the use of the WOA.

Office 365

The Outlook Add-in can be installed for all of your users or specific groups of users using the Office 365 Admin Centre. This is the recommended method of installing the Outlook Add-in as it saves time as the Add-in can be deployed en masse, rather than installing it on a per user basis. Once configured you can then add or remove users from these groups to install or uninstall the add-in on their behalf. 

Note: You must be an Admin User on your Office 365 account to be able to do this. The Office 365 interface changes often; the images and setting names below may not exactly match.

Once you are in the Admin Centre, click 'Show all' on the left hand toolbar:

 

Expand the 'Settings' section and click on 'Add-ins':

On the resulting screen, select the 'Deploy Add-in' button:

 

This will open a new dialogue box explaining how centralised deployment works. Once on this screen click Next.

You will now be presented with three options of how you would like to deploy the WESS Add-in, you will need to choose ‘I have a URL for the manifest file’ and then enter https://wess.invisible.io/api/private/mailapp/manifest.

NOTE: Depending on the Office 365 interface, the field where you enter the URL may look like it already starts with 'https://', but you still need to include this when you enter the URL.

This will now allow you to start configuring which Users have access to the WESS Add-in. You will be able to choose from Everyone, Specific users/groups or Just me. 

Selecting Specific users/groups will create a new dropdown menu that will allow you to search for the users or groups required. Selecting the user or group will add them to the list for deployment, allowing you to select multiple users or groups.

Note: Only users with an active Office 365 Licence will be able to have the add-in assigned to them, shared mailboxes cannot have this functionality enabled.

Once you have finalised who to deploy the Add-in, press the Deploy now button at the bottom of the page. The Add-in will now be available to those users or groups.

The deployment of the Add-in may take a few minutes to complete, however, Office will notify you once the installation is complete. Users will then need to restart their Outlook in order to see the Outlook Add-in appear in their instance.

Note: It can take up to 12 hours for the Add-in to appear in a user’s Outlook and each Outlook Client must be restarted. If after 12 hours the Add-in is still not available please contact support@workbooks.com

Hosted MS Exchange

To install the WESS Add-in on a hosted MS Exchange environment you will need to first log in to your Outlook Web App page for your organisation. Once you are at the login page you will need to enter your login details and sign in.

Once logged in, select the Settings Menu (cog icon) in the top right-hand corner of the screen.

This will open a new menu, you will need to select Options.

This will open a new menu, you will need to expand the General tab and select Manage add-ins.

Select the plus (+) icon this will open a new menu asking you for the source of the install. You will need to select Add from a URL.

This will open a new dialogue box with a URL field, where you will need to enter the following URL: https://wess.invisible.io/api/private/mailapp/manifest and then press Next.

Then click Install.

 

Once complete and Users have restarted their version of Outlook they will now see the Workbooks Icon appear in the top right-hand corner of the home bar.

Selecting this button will expand the sidebar and allow users to see the relevant information for the email and contact held within Workbooks.

We recommend you use the pin icon so that the sidebar remains visible until you close your email client.

Once active the sidebar will enable you to sync emails, relate emails to other records, create and amend contacts & tasks.

  • Introduction to the WESS Add-in
  • Customising the WESS Add-In

© 2021 Workbooks.com - privacy & terms
  • Linkedin
  • Twitter
  • Youtube
  • Facebook