- Welcome to the Knowledge Base
- Introduction
- Training
- Desktop Environment
- Preferences
- Activities
- Cases
- Forecasts & Quotas
- Importing Data
- Leads
-
Marketing
- Introduction to Marketing
- Marketing Campaigns
- Mailing Lists
- Products
- Mailshots
- Upload Library
- Templates
-
Workbooks Web Insights
- Tracking Code
- 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
- Compliance Records
- GatorMail Integration
- Opportunities
-
Integrations
- Mapping
- Electronic Signing Tools
- 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
- Survey Monkey responses to Tasks
- Multistep Zaps
-
Email Integrations
- Email Dropbox
- Workbooks Exchange Server Sync
- Workbooks Outlook Connector
- Scribe/Workbooks Connector
- People & Organisations
- Reporting
- Dashboards
- Transaction Documents
- Auditing
-
Configuration
- Introduction to System Administration
- Users & Security
- Database
- Accounting
- Email & Integration
- Customisation
- Automation
- PDF Configuration
- Contact Support
-
Releases & Roadmap
- Roadmap
- 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
Setting up your Automation or Integration
Locating your Triggers
By following the path Start>Configuration>Automation>Triggers you will find a list of all Triggers currently located on the database.
NOTE: Workbooks comes with 16 native Triggers as can be seen in the image below.
It is best practice to check to see if a Trigger already exists that can be used for the purpose intended.
NOTE: The example below looks at using a Trigger that monitors the creation of a new Case. This Trigger already exists above but for the purposes of this example a new Trigger will be created.
Creating a new Trigger.
To create a new Trigger click the New Trigger Button located at the top left of the View above. You will be presented with a New Trigger window in which you will be asked to define the Record Type that will be monitored and the Name of the Trigger.
NOTE: It is best practice to fill in the Description column to increase the visibility of what the Trigger is being used for.
Currently Record types that Triggers are able to monitor are as follows;
- API Data
- Case Records
- Customer Contracts
- Customer Credit Notes
- Customer Invoices
- Customer Orders
- Customer Quotations
- Marketing Campaigns
- Meetings
- Online Activities
- Opportunities
- Organisations
- People
- Products
- Sales Leads
- Supplier Orders
- Tasks
At this point it is also possible to define what types of changes, if not all of them, activate the Trigger. This is done in the Fire Trigger On Section. It is also possible to enable and disable the Trigger by use of the checkbox located just above this Section.
As this example looks for any new Case created the New records only checkbox has been ticked in the Trigger Rules Section.
NOTE: If you want to restrict the actions that fire the Trigger, for example only new Case records where the Priority is high, then you will need to contact the Support team after creating the Trigger. Workbooks will then update the Ruby Rule section to meet your needs where possible.
After creating the Trigger by clicking the Create button located at the top of the image above two more tabs will become available, the Events and Subscriptions tabs.
The Events tab logs every occurrence in which the Trigger was fired. The Subscriptions tab stores all of the Webhooks associated with the Trigger.
Creating your Webhooks
By making your way to the Subscription tab of the Trigger and clicking the New Webhook button a Webhook can be created.
When creating a Webhook a Name will need to be defined as well as a Callback URL and a User to notify if the Webhook fails.
NOTE: It is best practice to fill in the Description field here as well.This is particularly useful as multiple Webhooks can be stored under a single Trigger.
The Callback URL can be Workbooks specific or from a different online application. It is a URL that refers to a Process that will be carried out when the Webhook is Triggered.
NOTE: If the URL corresponds to an external Web Process, then you must make sure that your Web Service is exposed on a standard port such as 443 or 80.
In this example it is referring to a web process located in the same Workbooks database that is designed to send an email to the Support team informing them that a new Case has been created. The complexity of the process triggered by the Callback URL is not limited allowing for an extensive range of automations to be achievable.
Like Triggers, Webhooks can be enabled and disabled by using the checkbox located below the Description field in the above image. This is again useful when multiple Webhooks are linked to a single Trigger. To conclude creating the Webhook, click the Save and Close button.
Webhooks have two additional tabs, the Events tab and the Delivery tab. If the Webhook is triggered then these events are will appear in the Events tab. It is possible to process multiple events in a single delivery to the Callback URL, each delivery that takes place will be stored within the Deliveries tab. These two levels allow for more visibility when investigating the Trigger and Webhooks.