How to setup Tessitura responses for Pages

Send Page responses back to Tessitura! WordFly sends RSVP and Survey Page responses back to Tessitura through the integration. Configure how you want Page responses to update in the database.

 

Topics covered in this article:

Getting Started with the Pages integration

How will the Pages integration work?

How to use CorrelationID

Configure the Pages stored procedure in Tessitura

Frequently asked questions about Tessitura responses for Pages

 

 

Getting Started with the Pages integration

 

RSVP and Survey responses are collected in WordFly Pages and sent back to Tessitura through the Pages integration.

 

Prerequisites

Organizations that want to use the Pages integration will need to:

 

 

 

How will the Pages integration work?

 

The Pages integration will work similarly to other integration processes that your organization may already be using (ex, the preferences integration).

 

Page responses will be collected in WordFly and sent back to Tessitura to update new local tables in the impressario database. A new stored procedure will be configured to update Page responses on the constituent record in any way your organization wants to have it reflected.

 

New database tables

LT_WF_PAGE: Stores the Page name, URL, ID etc identifying the Page that was created in WordFly. The PageSetGuid is a unique value for each Page. This table is populated when responses are sent back to Tessitura by WordFly. The first response will populate that table.

Here are the PageTypeIds
1 RSVP
2 Survey
3 Landing

 

LT_WF_PAGE_FIELD: Stores the fields for the Page created in WordFly (ex, any survey or other questions asked). The PageFieldGuid is a unique value for each Page question.

 

LT_WF_PAGE_RESPONSE: Stores when someone responded to a Page, along with customer number, email address.

 

LT_WF_PAGE_FIELD_RESPONSE: Stores Page field responses, including RSVP Yes/No.

 

New stored procedures

LP_WF_PAGE_RESPONSE_CREATE: Creates the Page & Page Response.

 

LP_WF_PAGEFIELD_RESPONSE_CREATE: Creates the Page Field & Page Field Responses.

 

LP_WF_PAGE_RESPONSE_CUSTOM: Provides hook for custom processing where you can take all the data from the tables and update constituent records with the information.

 

Sample Data

The following is some sample Pages data that would populate in the new local tables in the impressario database.

 

LT_WF_PAGE: A Page

 

LT_WF_PAGE_FIELD: Questions on a Page

 


LT_WF_PAGE_RESPONSE: Customer's response to a Page

 

LT_WF_PAGE_FIELD_RESPONSE: Customer's answers to each Question

 

Sample View

 

 

Pages Integration Data Processing

The following steps illustrate how Page data is processed in the impressario database.

 

1. Execute LP_WF_PAGE_RESPONSE_CREATE and retrieve PageId & PageResponseId from results
2. For each PageResponse.fieldResponse, execute LP_WF_PAGEFIELD_RESPONSE_CREATE;
3. Execute LP_WF_PAGE_RESPONSE_CUSTOM

 

 

 

How to use CorrelationID

 

Organizations may setup a Tessitura ID for any In Progress (unpublished) Page in WordFly. This field is passed back as CorrelationID and provides organizations with additional data processing options.

 

In WordFly, set a Tessitura ID under Page Settings. From the dropdown, select Activity or Attribute, then input a value in the open field. Select Done when you are finished.

 

Examples

  • Activity would most likely be a Special Activity ID from system table TR_SPECIAL_ACTIVITY.
  • Attribute would most likely be a valid Attribute ID from T_KEYWORD.

 

What to expect when using Tessitura ID for a Page:

  • The CorrelationId field is a way to configure any custom data you want to have passed back with the responses. The integration simply passes this data through to the database. No validation is made.
  • The different types in the UI (Activity and Attribute) are there to help users in a systematic way and to keep the data standardized to avoid confusion.
  • The ID can be numbers and letters. It can be up to 5000 characters in length.
  • The ID should not include ":" as a delimiter.
  • The ID cannot be changed after Page responses have started collecting and sending back to Tessitura.
  • The data is written with the first Page response collected.
  • The ID is written to [impresario].[dbo].[LT_WF_PAGE].[CorrelationId]
  • This is how the data is passed back to the database:
Activity:123
Attribute:123

  • Configure the LP_WF_PAGE_RESPONSE_CUSTOM stored procedure to parse the data as you need to use it.

 

The CorrelationID itself is fairly extensible because it is just a string, and has a high character limit! You can update this value with a convention to pass more data back with it.

For example:

"<activityType>_<activityDate>" and have values such as "12345_04-05-2019"


Use this field to add any data you want to the id!

 

 

 

Configure the Pages stored procedure in Tessitura

 

The LP_WF_PAGE_RESPONSE_CUSTOM stored procedure is the only procedure your organization will need to customize.

  • There will be some sample code in this procedure showing organizations how to get at the data in the tables.
  • There is a RETURN statement in the stored procedure that needs to be commented out for the procedure to run automatically when called.
  • Further customization of writing where data shows on constituent records will need to be done by your team.
  • You can work with Tessitura support on troubleshooting your setup or with Tessitura consulting on specific customization.

 

Configuration example:

  • RSVP data could create a special activity, CSI or an attribute on the constituent record.
  • Survey responses could add attributes on the constituent record.

 

 

 

FAQs about Tessitura responses for Pages

We've put together answers to frequently asked questions here. If your question is not answered, feel free to email us to get answers.

 

How long will it take to set up the new integration for Page responses?

Every organization will take a different amount of time to set up Page responses. The steps are very simple and straightforward. You will have to discuss the steps with your team to gather an accurate estimate.

 

Can we link directly to an RSVP and Survey Page to collect responses in Tessitura?

Tracking Page responses requires sending a WordFly email campaign and using a unique subscriber mailing ID tracking tag at the end of your Page link. Only tracked Pages can send data back to Tessitura for specific subscribers. Learn more

 

How long does it take for RSVP and Survey Page responses to appear in Tessitura?

There is a new stored procedure LP_WF_PAGE_RESPONSE_CUSTOM handling Page response updates and it will be running all the time once it is configured. Expect to see Page responses on customer records in 1-2 hours from the time the response was collected by your WordFly Page.

 

Here are some more details about event processing that are helpful to know:

  • WordFly response processing is controlled by a software robot that processes responses until all event processing is finished and then takes a short break (90 minutes) before running again. Once responses are available and the robot is processing events it will continue to process the responses until those are done.
  • The robot may never stop processing events because events for high-volume sending organizations deploying on a daily/consistent basis because events are continuously coming in.
  • Small test campaigns may in theory take longer process if the robot is "on a break" and not running at the time when the response was received, generating a delay of up to 90 minutes.

 

What data is required in order for Page responses to update in Tessitura?

The new stored procedure LP_WF_PAGE_RESPONSE_CUSTOM requires customer number in the list data for sending Page responses back to Tessitura successfully.

 

RSVP Page: Why is the first row blank for LT_WF_PAGE_FIELD?

This first row correlates to the "Can you attend?" question for RSVP Pages. This is currently an empty row but this may change in the future.

 

 

Have more questions? Submit a request