Refer-a-Friend Technical Overview

The following section is a technical overview of the Refer-a-Friend feature and describes the Administrator activities and working methodology of the functionality.

Administrators need to consider the following points to use the Refer-a-Friend feature.

Adding Links to the Content

Connect provides flexibility to indicate the location and text displayed for the Refer-a-Friend link. Content Administrators must insert a Refer-a-Friend merge field in the desired location to add a Refer-a-Friend link. For more information about adding links to the content, please see Tips For Creating Links.

Customizing the Default Forms

Connect provides a sample Refer-a-Friend form and Thank-You page, which can be customized. For more information about customizing the pages, please see Creating and Managing Content.

Configuring System Parameters

Connect provides a set of system parameters, which allows Administrators to configure the Refer-a-Friend feature. For more information about configuring the system parameters, please see Managing System Parameters.

The following steps describe in detail the technical overview of the Refer-a-Friend feature.

1. The customer receives an email message from Connect.

2. Subsequently, the customer clicks the Refer-a-Friend link in the message. The Tracker receives the request.
   

   

3. The Tracker identifies the request and presents the referral detail form to the customer.

4. After filling up the form with referral details, such as first name, middle name, last name, email address, and forwarding note, the customer submits the form.

   • The first name and email address fields are mandatory. Content Designers must ensure that appropriate client side validations are available in the form to prevent invalid requests reaching the Connect Tracker.

5. The Tracker accepts the forwarded request and sends a Thank-You page to the customer.

6. The Tracker parses and sends the referral information to the Profiler through storage log entries.

7. The Profiler updates the referral data in the Connect database. Refer to the following table for more information on the updates to the Connect database.

---

---

Note: The Profiler validates the referring customer prior to updating the Connect database with referral details. As well, the Profiler subscribes the referred customer to the corresponding conversation.

1. The Conversation Manager picks up the referral data and sends a request to the Mail Sender.

2. The Mail Sender receives a send request from the Conversation Manager. The Mail Sender adds ‘FW:’ prefix to the subject line and the forwarding note to the top of the email content.

3. The Mail Sender sends the email message to the referral.

Connect updates the referral result in the REFERRAL_HISTORY table. Following are the error codes and their descriptions. Error codes less than 100 are considered successful referrals and error codes greater than 100 are considered unsuccessful referrals.

---

---