You can use triggers to perform automated actions in Upsales. For example, triggering a notification email to the team leader about a won deal.
This article covers:
- When triggers can be set up
- How to create a trigger
- Adding trigger criteria
- Trigger actions
- Tags in trigger actions
- Available tags
Triggers is part of the Product Workflow Automation
When triggers can be set up
Use triggers for creating, editing or removing:
- Company
- Contact
- Order
- Activity
- To-do and Phone call (accounts that use to-dos)
- Appointment
- Campaign
- Subscription (when subscriptions are activated)
- Project
- Product
- Ticket
- Your Custom Objects, under their own names
How to create a trigger
- Click Settings → Account → Business rules → Triggers:
- Click New trigger and enter a name and description:
- Select whether the trigger should run on creation and/or editing, or removal and click the of dropdown to choose what the trigger relates to. You can't change this after the trigger is saved:
- Select criteria for all or at least one that will run the trigger. To exclude match criteria, use the is/is not field:
- Add an action for what happens when the trigger criteria is met:
Adding trigger criteria
You can add many variants of match criteria.
For example, imagine you want to automatically notify your sales team when a new appointment is booked.
- Enter a trigger name and description
- Select your trigger to be run on the creation of an appointment
- Add match criteria of "Appointment type" and select the type of appointment you want to send the notification on:
- Add the action Send email and compose the email
Trigger actions
The actions are performed when the trigger's criteria are met. Which actions you can add depends on the object the trigger runs on (see Actions per object). Common actions are:
Create appointments and activities
Whenever the criteria for your trigger are met you have the option of creating an appointment. A useful feature to mention is the offset function. This lets you set the date of the appointment in the future by the number of days you select.
Update company
Whenever the criteria for your trigger are met you have the option of updating companies. This means adding or removing data like campaigns, categories, account managers, or the custom fields you've created for your Upsales account.
Send webhook
If you've got an external service you'd like to notify by a webhook, this is perfect.
Send email
This feature is meant to notify your users of important events. By default, all notification emails will be sent from no-reply@upsales.com. However, you can change the sender email address.
You can have multiple actions that are triggered at once. Each action can be added once, except Send email and Send webhook, which you can add several times.
Actions per object
Triggers that run on Creation or Editing can use these actions:
| Object | Actions |
|---|---|
| Company | Create activity, Create appointment, Update company, Send email, Send webhook |
| Contact | Create activity, Create appointment, Update company, Update contact, Send email, Send webhook |
| Order | Create activity, Create appointment, Update company, Update contact, Update order, Send email, Send webhook |
| Activity | Create activity, Update activity, Update company, Update contact, Update order, Send email, Send webhook |
| To-do | Create activity, Update to-do, Update company, Update contact, Update order, Send email, Send webhook |
| Phone call | Create activity, Update phone call, Update company, Update contact, Update order, Send email, Send webhook |
| Appointment | Create activity, Update appointment, Update company, Update order, Send email, Send webhook |
| Campaign | Create appointment, Send email, Send webhook |
| Subscription | Create activity, Update company, Update contact, Send email, Send webhook |
| Project | Create activity, Create appointment, Update company, Update contact, Send email, Send webhook |
| Product, Ticket | Send webhook |
| Custom Objects | Create activity (not for an object linked to a project), Update company, Send email, Send webhook |
In accounts that use to-dos, every object that offers Create activity also offers Plan phone call and Create to-do.
Triggers that run on Removal can use Send email and Send webhook (only Send webhook for Product and Ticket). Appointment also offers Update company, and Subscription offers the same actions as on creation.
Tags in trigger actions
Tags are a way of fetching dynamic data and placing them in your automatic trigger action. For example, by writing "Hello {{Client.Name}}!" in your action, it will render "Hello Company Inc!"
You can place tags on all trigger actions.
Available tags
The tag list in an action shows every tag you can use for the trigger's object. It includes tags for related objects, such as the company. Your own custom fields are in the list too, under their own names. These are the company and general tags:
Company
| Name in the list | Tag |
|---|---|
| Company: ID | {{Client.Id}} |
| Parent company (ID) | {{Client.ParentId}} |
| Name | {{Client.Name}} |
| Delivery address | {{Client.DeliveryAddress}} |
| Delivery address: Postcode | {{Client.DeliveryZipCode}} |
| Delivery address: Municipality | {{Client.DeliveryMunicipality}} |
| Delivery address: City | {{Client.DeliveryCity}} |
| Delivery address: State | {{Client.DeliveryState}} |
| Delivery address: Country | {{Client.DeliveryCountry}} |
| Visit address | {{Client.VisitAddress}} |
| Visit address: Postcode | {{Client.VisitZipCode}} |
| Visit address: Municipality | {{Client.VisitMunicipality}} |
| Visit address: State | {{Client.VisitState}} |
| Visit address: City | {{Client.VisitCity}} |
| Visit address: Country | {{Client.VisitCountry}} |
| Billing address | {{Client.InvoiceAddress}} |
| Billing address: Postcode | {{Client.InvoiceZipCode}} |
| Billing address: Municipality | {{Client.InvoiceMunicipality}} |
| Billing address: State | {{Client.InvoiceState}} |
| Billing address: City | {{Client.InvoiceCity}} |
| Billing address: Country | {{Client.InvoiceCountry}} |
| Postal address | {{Client.MailAddress}} |
| Postal address: Postcode | {{Client.MailZipCode}} |
| Postal address: Municipality | {{Client.MailMunicipality}} |
| Postal address: State | {{Client.MailState}} |
| Postal address: City | {{Client.MailCity}} |
| Postal address: Country | {{Client.MailCountry}} |
| Other address | {{Client.OtherAddress}} |
| Other address: Postcode | {{Client.OtherZipCode}} |
| Other address: Municipality | {{Client.OtherMunicipality}} |
| Other address: State | {{Client.OtherState}} |
| Other address: City | {{Client.OtherCity}} |
| Other address: Country | {{Client.OtherCountry}} |
| Phone | {{Client.Phone}} |
| Company: Fax | {{Client.Fax}} |
| Website | {{Client.Www}} |
| Notes | {{Client.Notes}} |
| Score | {{Client.Score}} |
| Account manager: User ID | {{Client.UserId}} |
| Account manager: Name | {{Client.UserName}} |
| Account manager: Email | {{Client.UserEmail}} |
| Account manager: Phone | {{Client.UserPhone}} |
| Account manager: Mobile phone | {{Client.UserCellPhone}} |
| Account manager: Role | {{Client.UserRole}} |
| Account manager: Title | {{Client.UserTitle}} |
| Duns number | {{Client.DunsNo}} |
| Created by: User ID | {{Client.RegById}} |
| Added by: User name | {{Client.RegByName}} |
| Created by: Email | {{Client.RegByEmail}} |
| active | {{Client.Active}} |
| Assigned user: ID | {{Client.AssignedUserId}} |
| Assigned user: Name | {{Client.AssignedUserName}} |
| Assigned user: Email | {{Client.AssignedUserEmail}} |
| Assigned user: Phone | {{Client.AssignedUserPhone}} |
| Assigned user: Role | {{Client.AssignedUserRole}} |
| Assigned user: Title | {{Client.AssignedUserTitle}} |
| Price list (code) | {{Client.PriceList}} |
| Company: Organisation number | {{Client.OrgNo}} |
| Created * | {{Client.RegistrationDate}} |
| Industry: SNI * | {{Client.SniCodeValue}} |
| Industry: SIC * | {{Client.SicCodeValue}} |
| Industry: NAICS * | {{Client.NaicsCodeValue}} |
| Industry (UK SIC) * | {{Client.UKSicCodeValue}} |
| Industry (NACE) * | {{Client.NaceCodeValue}} |
| Status * | {{Client.StatusValue}} |
| Corporate form * | {{Client.CompanyFormValue}} |
| Credit rating * | {{Client.CreditRatingValue}} |
| Industry: SNI code * | {{Client.SniCode}} |
| Industry: NACE * | {{Client.NaceCode}} |
| Industry: SIC code * | {{Client.SicCode}} |
| Industry: NAICS code * | {{Client.NaicsCode}} |
| Status (code) * | {{Client.Status}} |
| Corporate form (code) * | {{Client.CompanyForm}} |
| Credit rating (code) * | {{Client.CreditRating}} |
| Turnover * | {{Client.Turnover}} |
| Profit * | {{Client.Profit}} |
| Number of employees * | {{Client.NoEmployees}} |
| Facebook * | {{Client.Facebook}} |
| Twitter * | {{Client.Twitter}} |
| LinkedIn * | {{Client.LinkedIn}} |
* Shown when that field is active in your account.
General
| Name in the list | Tag |
|---|---|
| Today | {{General.Today}} |
| Clear field | {{General.ClearField}} |
| Current year | {{General.CurrentYear}} |
| Logged in user: ID | {{General.CurrentUserId}} |
| Logged in user: Role ID | {{General.CurrentUserRoleId}} |
| Logged in user: Name | {{General.CurrentUserName}} |
| Logged in user: Email | {{General.CurrentUserEmail}} |
| Logged in user: Phone | {{General.CurrentUserPhone}} |
| Logged in user: Mobile phone | {{General.CurrentUserCellPhone}} |
| Logged in user: Title | {{General.CurrentUserTitle}} |
| Logged in user: Default email signature | {{General.CurrentUserMailSignature}} |
| Company name | {{General.CompanyName}} |
| Company phone | {{General.CompanyPhone}} |
| Company address | {{General.CompanyAddress}} |
| Company: Postcode | {{General.CompanyZipCode}} |
| Company: City | {{General.CompanyCity}} |
| Company country | {{General.CompanyCountry}} |
| Company email disclaimer | {{General.CompanyDisclaimer}} |
| Default senders email | {{General.CompanyEmail}} |
| Company sender | {{General.CompanySender}} |