Event Invitations

About

Use this document type to send an event invitation when a form is submitted. The details of the event (date, time, description, etc.) are populated with answers from the form. Event invitations are usually sent by email through an email data destination, but can also be sent to any file-based destination.

Recipients can accept invites and automatically schedule events into the calendar of their mail program.

Event invitations can be used for a number of business functions:

  • Book follow-up appointments with customers
  • Schedule phone calls to follow up on Sales Leads
  • Book site visits in the calendars of field technicians

A number of document types are available, and multiple documents can be sent with a single form submission.  Read more about documents here.

iCalendar File Format

Event invitations are in an iCalendar file format. The file extension is ".ics". This file format is used for sending meeting requests, tasks, etc. When accessed through supporting software, like an email client or calendar application, recipients can respond to the invite and add it to their calendar. Supporting software includes Google Calendar, Apple Calendar, Yahoo! Calendar, and Microsoft Outlook. 

Settings

Create the document, select Event Invitation as the document type, then follow the instructions below.

"Event Invitation" document type

Document Basics

Name the document. Optionally provide a description.

Auto-Link new forms to this document

Selecting this option will add the document as an "Additional Document" to forms created or imported after this option is set.  Submissions made against auto-linked forms will be downloadable in this document format from the "Data" tab of the portal.

autolink.png

Event Details

Event Date and Time

Provide the start date and time of the event, as well as the duration (length) of the event.  These fields are required. Enter unique IDs to use the answers provided in form submissions.  Simply type the unique IDs as they appear in the form builder. Read more about unique IDs.

Required Data Types for Inputs

Each of these fields must have a particular data type in order for the date/time to be completed correctly. 

  • Date: Form question must be a date selector
  • Time: Form question must be a time selector
  • Duration (length of event in minutes): Form question must be a Number-> Integer ("1") data type

dtaefrom.png

Busy Status

Show recipient as busy during event?

This will change the recipient's status to "busy" on their calendar during the event time if the invite is accepted.  Choose from one of the following options:

  • Answer defined here: Choose Busy or Free.  The recipient will always be marked with this choice.
  • Answer from form question: Enter a unique ID to take the answer from a Yes/No question.  (yes means "busy")

Event Location

This is where the event will occur.  This location will be listed in the event invitation.

  • This can be an address ("123 Elm Street, Ottawa").
  • But any value can be handled ("ABC Corp. Main Office, Room 214").  
  • Use Data Reference Expression Language to use answers from form submissions.  
  • Optionally combine multiple expressions, like: "%a[Address], %a[City]"

  

Organizer

Choose who will be listed as the event organizer.

  • Answer from form question: Enter the question unique ID with an email data type.  This allows you to choose an organizer in a form.
  • Answer defined here:  Enter the email address of the person who will always be listed as organizer.
  • Use data record submitter's email address: The submitter of the form will be the organizer.
  • Use data record submitter's email address: The submitter of the form will be the organizer; their alternate email address will be shown.  

Event Properties

Note: Invitations received in Outlook will use the subject line and body from an Email destination as the Event title and body. For consistency across email clients, match the linked destination’s subject line and body to the options entered below.

Event Title

This is the title of the event that will be displayed in emails (unless viewing in Outlook).  

  • Use Data Reference Expression Language to reference answers in your forms.
  • Static text can also be included.
  • For example, "Follow-up Visit with %a[Customer Name]" would name the file like "Follow-up Visit with John Smith."

  

Event Message Body

Add a custom body message to the event.  

  • Compose a custom message
  • Apply formatting with the rich text editor, including styles, images, tables, and lists
  • Use Data Reference Expression Language to insert answers from your form:
    • Customize emails by inserting a contact name into greetings with "%a[unique ID]"
    • Add a signature line to the email and insert the form submitter's name with "%u"
  • Press the "Preview Body"  button to see a sample of what the body will look like. 

Example of an Event message

  

Document Timezone Source

Choose a document time zone source. This is the time zone for all dates and times in your document.

  • Team Preference Setting: Will use the time zone chosen for the team
  • Data Record: Will use the time zone of the mobile device used to submit the form
  • Custom: Choose a time zone.

Event document timezone selection

  

Advanced

Note: The following fields do not affect meeting requests sent as email messages. They only affect data written into iCalendar (.ics) files.

Filename

This will name the .ics files that are sent.  This will not affect invitations sent by email.

Tip:A recognizable file name can help you quickly search for and identify files.

  • Use Data Reference Expression Language to reference answers in your forms.
  • Static text can also be included.
  • For example, %r -- %a[Customer Name] would name the file like "20140812-180001002  -- John Smith."

filename.png

  • Some data destinations will overwrite files with duplicate names.  Make sure filenames are unique by including one or more of:
    • %r - the submission's reference number -- e.g. 20140920-1815562464
    • %r[id] - the submission's ID - e.g. 1815562464
    • %d or %t - the date or time the form was submitted

  

Document to Include inside the iCalendar file

Optionally include another document in the iCalendar file.  The document will be included as base64 data. It will not result in an email attachment.

When set up is complete, press "Create."  Link the document to a form in order to use it. 

"Create" and "Cancel" an event document