# Salesforce Integration

## <span style="text-decoration: underline;">**Integration Overview**</span>

The Webcast Salesforce Integration offers the capability to pass webcast data into Salesforce. The Webcast Activity Feed is an integration managed by the webcast team that allows you to create / update contacts, create / update leads, update campaigns, and capture interaction data in custom objects.

## <span style="text-decoration: underline;">**Webcast Activity Feed**</span>

#### **Activity Feed Overview**

The Webcasts Activity Feed sends webcast registration, attendance and interaction data into Salesforce. This document outlines the specific data that passes with the integration, as well as setup steps required to complete the integration. The Salesforce activity feed is facilitated by [Workato](https://www.workato.com/).

<p class="callout info">The webcast activity feed is setup and managed by the webcast team, please use the [form](https://fs30.formsite.com/tpforms/21wkz6lmlv/index.html?1610153864495) to request the required support.</p>

#### **Included Data and Endpoints**

Clients are able to customize which data and endpoints listed below are included with their implementation. This will be confirmed during the meeting with a webcast integration specialist.

<div class="pointer-container" id="bkmrk-%C2%A0-0"><div class="pointer anim is-page-editable"><svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg><div class="input-group inline block"> <button class="button outline icon" data-clipboard-target="#pointer-url" title="Copy Link" type="button"><svg class="svg-icon" data-icon="copy" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg></button></div><svg class="svg-icon" data-icon="edit" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg></div></div>- Create new Salesforce Contacts 
    - Standard Webcast Registration Details
    - Custom Webcast Registration Details
- Update Existing Contacts 
    - Standard Webcast Registration Details
    - Custom Webcast Registration Details
- Create new Salesforce Leads 
    - Standard Webcast Registration Details
    - Custom Webcast Registration Details
- Update Existing Leads
    
    
    - Standard Webcast Registration Details
    - Custom Webcast Registration Details
- Webcast Interaction Data (Salesforce Custom Objects)
    
    
    - Standard Webcast Registration Details
    - Custom Webcast Registration Details
    - Webcast Viewing Session Times and Durations
    - Webcast Polling / Survey Responses
    - Webcast Q&amp;A Data
    - Webcast CE Details
- Salesforce Campaigns 
    - Add new campaign members
    - Update campaign member statuses

#### **Requirements**

- API enabled Salesforce Account
- Custom Data Objects to store webcast interaction data

#### **Custom Objects**  


**Object Name:** Webcast Registration Viewer Data

<table border="1" id="bkmrk-field-name-required-" style="width: 100%; height: 2910.38px;"><tbody><tr style="height: 79.0938px;"><td class="align-center" style="width: 13.3498%; height: 79.0938px;">**Field Name**

</td><td class="align-center" style="width: 10.9985%; height: 79.0938px;">**Required**

</td><td class="align-center" style="width: 53.0312%; height: 79.0938px;">**Description**

</td><td class="align-center" style="width: 22.6205%; height: 79.0938px;">**Field Type**

</td></tr><tr style="height: 102.141px;"><td style="width: 13.3498%; height: 102.141px;">External ID

</td><td style="width: 10.9985%; height: 102.141px;">Yes

</td><td style="width: 53.0312%; height: 102.141px;">Stores unique values which connect the data between the webcast and Salesforce

</td><td style="width: 22.6205%; height: 102.141px;">text, 255 characters (External ID)  
\*screenshot below

</td></tr><tr style="height: 56.0469px;"><td style="width: 13.3498%; height: 56.0469px;">Address1

</td><td style="width: 10.9985%; height: 56.0469px;">No

</td><td style="width: 53.0312%; height: 56.0469px;">Street Address 1

</td><td style="width: 22.6205%; height: 56.0469px;">text, 255 characters

</td></tr><tr style="height: 56.0469px;"><td style="width: 13.3498%; height: 56.0469px;">Address2

</td><td style="width: 10.9985%; height: 56.0469px;">No

</td><td style="width: 53.0312%; height: 56.0469px;">Street Address 2

</td><td style="width: 22.6205%; height: 56.0469px;">text, 255 characters

</td></tr><tr style="height: 79.0938px;"><td style="width: 13.3498%; height: 79.0938px;">Attended

</td><td style="width: 10.9985%; height: 79.0938px;">No

</td><td style="width: 53.0312%; height: 79.0938px;">Did the webcast registrant view, at least a portion, the webcast

</td><td style="width: 22.6205%; height: 79.0938px;">checkbox (default value: unchecked)

</td></tr><tr style="height: 87.0938px;"><td style="width: 13.3498%; height: 87.0938px;">Campaign Source

</td><td style="width: 10.9985%; height: 87.0938px;">No

</td><td style="width: 53.0312%; height: 87.0938px;">Track the marketing channel that drove webcast registration

</td><td style="width: 22.6205%; height: 87.0938px;">text, 255 characters

</td></tr><tr style="height: 87.0938px;"><td style="width: 13.3498%; height: 87.0938px;">Certificate Link

</td><td style="width: 10.9985%; height: 87.0938px;">No

</td><td style="width: 53.0312%; height: 87.0938px;">Link to download the user's certificate, if applicable

</td><td style="width: 22.6205%; height: 87.0938px;">text, 255 characters

</td></tr><tr style="height: 87.0938px;"><td style="width: 13.3498%; height: 87.0938px;">Certification Results

</td><td style="width: 10.9985%; height: 87.0938px;">No

</td><td style="width: 53.0312%; height: 87.0938px;">Did the user pass the requirements to receive CE credit

</td><td style="width: 22.6205%; height: 87.0938px;">text, 255 characters

</td></tr><tr style="height: 87.0938px;"><td style="width: 13.3498%; height: 87.0938px;">City

</td><td style="width: 10.9985%; height: 87.0938px;">No

</td><td style="width: 53.0312%; height: 87.0938px;">City

</td><td style="width: 22.6205%; height: 87.0938px;">text, 255 characters

</td></tr><tr style="height: 87.0938px;"><td style="width: 13.3498%; height: 87.0938px;">Company

</td><td style="width: 10.9985%; height: 87.0938px;">No

</td><td style="width: 53.0312%; height: 87.0938px;">Company

</td><td style="width: 22.6205%; height: 87.0938px;">text, 255 characters

</td></tr><tr style="height: 79.0938px;"><td style="width: 13.3498%; height: 79.0938px;">Contact

</td><td style="width: 10.9985%; height: 79.0938px;">No

</td><td style="width: 53.0312%; height: 79.0938px;">Connects the custom object record to the corresponding contact, if contact exists

</td><td style="width: 22.6205%; height: 79.0938px;">Lookup Relationship (Contact)

</td></tr><tr style="height: 87.0938px;"><td style="width: 13.3498%; height: 87.0938px;">Cost Center

</td><td style="width: 10.9985%; height: 87.0938px;">No

</td><td style="width: 53.0312%; height: 87.0938px;">Text field in the webcast setup, generally utilized to capture sponsor or billing code information

</td><td style="width: 22.6205%; height: 87.0938px;">text, 255 characters

</td></tr><tr style="height: 87.0938px;"><td style="width: 13.3498%; height: 87.0938px;">Country

</td><td style="width: 10.9985%; height: 87.0938px;">No

</td><td style="width: 53.0312%; height: 87.0938px;">Country

</td><td style="width: 22.6205%; height: 87.0938px;">text, 255 characters

</td></tr><tr style="height: 102.141px;"><td style="width: 13.3498%; height: 102.141px;">[Custom Registration](https://help.webcasts.com/books/api-saml-documentation/page/submit-registration-data-to-a-webcast-form#bkmrk-custom-webcast-regis)

</td><td style="width: 10.9985%; height: 102.141px;">No

</td><td style="width: 53.0312%; height: 102.141px;">Non-default webcast registration field. The actual field name implemented should not be "Custom Registration" but reflect the information captured

</td><td style="width: 22.6205%; height: 102.141px;">text, 255 characters

</td></tr><tr style="height: 56.0469px;"><td style="width: 13.3498%; height: 56.0469px;">Email

</td><td style="width: 10.9985%; height: 56.0469px;">No

</td><td style="width: 53.0312%; height: 56.0469px;">Email

</td><td style="width: 22.6205%; height: 56.0469px;">email

</td></tr><tr style="height: 87.0938px;"><td style="width: 13.3498%; height: 87.0938px;">Fax Number

</td><td style="width: 10.9985%; height: 87.0938px;">No

</td><td style="width: 53.0312%; height: 87.0938px;">Fax Number

</td><td style="width: 22.6205%; height: 87.0938px;">text, 255 characters

</td></tr><tr style="height: 87.0938px;"><td style="width: 13.3498%; height: 87.0938px;">First Name

</td><td style="width: 10.9985%; height: 87.0938px;">No

</td><td style="width: 53.0312%; height: 87.0938px;">First Name

</td><td style="width: 22.6205%; height: 87.0938px;">text, 255 characters

</td></tr><tr style="height: 102.141px;"><td style="width: 13.3498%; height: 102.141px;">Hidden Field

</td><td style="width: 10.9985%; height: 102.141px;">No

</td><td style="width: 53.0312%; height: 102.141px;">A registration field that is hidden on the webcast registration form. Similar to the "Custom Registration" field a different field name can be chosen for this field.

</td><td style="width: 22.6205%; height: 102.141px;">text, 255 characters

</td></tr><tr style="height: 87.0938px;"><td style="width: 13.3498%; height: 87.0938px;">IP Address

</td><td style="width: 10.9985%; height: 87.0938px;">No

</td><td style="width: 53.0312%; height: 87.0938px;">IP Address

</td><td style="width: 22.6205%; height: 87.0938px;">text, 255 characters

</td></tr><tr style="height: 87.0938px;"><td style="width: 13.3498%; height: 87.0938px;">Last Name

</td><td style="width: 10.9985%; height: 87.0938px;">No

</td><td style="width: 53.0312%; height: 87.0938px;">Last Name

</td><td style="width: 22.6205%; height: 87.0938px;">text, 255 characters

</td></tr><tr style="height: 102.141px;"><td style="width: 13.3498%; height: 102.141px;">Lead

</td><td style="width: 10.9985%; height: 102.141px;">No

</td><td style="width: 53.0312%; height: 102.141px;">Connects the custom object record to the corresponding lead, if lead exists

</td><td style="width: 22.6205%; height: 102.141px;">Lookup Relationship (Lead)

</td></tr><tr style="height: 102.141px;"><td style="width: 13.3498%; height: 102.141px;">Live Session Duration

</td><td style="width: 10.9985%; height: 102.141px;">No

</td><td style="width: 53.0312%; height: 102.141px;">The amount of time the user viewed the webcast live

</td><td style="width: 22.6205%; height: 102.141px;">number

(length: 18, decimal: 0)

</td></tr><tr style="height: 79.0938px;"><td style="width: 13.3498%; height: 79.0938px;">Mobile Number

</td><td style="width: 10.9985%; height: 79.0938px;">No

</td><td style="width: 53.0312%; height: 79.0938px;">Mobile number

</td><td style="width: 22.6205%; height: 79.0938px;">text, 255 characters

</td></tr><tr style="height: 79.0938px;"><td style="width: 13.3498%; height: 79.0938px;">OD Session Duration

</td><td style="width: 10.9985%; height: 79.0938px;">No

</td><td style="width: 53.0312%; height: 79.0938px;">The amount of time the user viewed the webcast in their most recent on-demand session

</td><td style="width: 22.6205%; height: 79.0938px;">number

(length: 18, decimal: 0)

</td></tr><tr style="height: 79.0938px;"><td style="width: 13.3498%; height: 79.0938px;">Phone Number

</td><td style="width: 10.9985%; height: 79.0938px;">No

</td><td style="width: 53.0312%; height: 79.0938px;">Phone Number

</td><td style="width: 22.6205%; height: 79.0938px;">text, 255 characters

</td></tr><tr style="height: 56.0469px;"><td style="width: 13.3498%; height: 56.0469px;">Postal Code

</td><td style="width: 10.9985%; height: 56.0469px;">No

</td><td style="width: 53.0312%; height: 56.0469px;">Postal or ZIP Code

</td><td style="width: 22.6205%; height: 56.0469px;">text, 255 characters

</td></tr><tr style="height: 79.0938px;"><td style="width: 13.3498%; height: 79.0938px;">Referrer

</td><td style="width: 10.9985%; height: 79.0938px;">No

</td><td style="width: 53.0312%; height: 79.0938px;">The address of the website the user accessed the webcast URL from, if included in the browser header.

</td><td style="width: 22.6205%; height: 79.0938px;">text, 255 characters

</td></tr><tr style="height: 79.0938px;"><td style="width: 13.3498%; height: 79.0938px;">Registration Date

</td><td style="width: 10.9985%; height: 79.0938px;">No

</td><td style="width: 53.0312%; height: 79.0938px;">Date of user registration for the webcast

</td><td style="width: 22.6205%; height: 79.0938px;">date/time

</td></tr><tr style="height: 79.0938px;"><td style="width: 13.3498%; height: 79.0938px;">Sim Live Duration

</td><td style="width: 10.9985%; height: 79.0938px;">No

</td><td style="width: 53.0312%; height: 79.0938px;">The amount of time the user viewed the webcast in their most recent simulated-live session

</td><td style="width: 22.6205%; height: 79.0938px;">number

(length: 18, decimal: 0)

</td></tr><tr style="height: 56.0469px;"><td style="width: 13.3498%; height: 56.0469px;">State

</td><td style="width: 10.9985%; height: 56.0469px;">No

</td><td style="width: 53.0312%; height: 56.0469px;">State or Province

</td><td style="width: 22.6205%; height: 56.0469px;">text, 255 characters

</td></tr><tr style="height: 56.0469px;"><td style="width: 13.3498%; height: 56.0469px;">Title

</td><td style="width: 10.9985%; height: 56.0469px;">No

</td><td style="width: 53.0312%; height: 56.0469px;">Job Title

</td><td style="width: 22.6205%; height: 56.0469px;">text, 255 characters

</td></tr><tr style="height: 133.188px;"><td style="width: 13.3498%; height: 133.188px;">Unsubscribed

</td><td style="width: 10.9985%; height: 133.188px;">No

</td><td style="width: 53.0312%; height: 133.188px;"><span data-contrast="auto">Unsubscribe to email communications for this specific webcast event ID.</span>

<span data-contrast="auto">checked(unsubscribed from communications), unchecked(did not unsubscribe from communications)</span>

</td><td style="width: 22.6205%; height: 133.188px;">checkbox (default value: unchecked)

</td></tr><tr style="height: 102.141px;"><td style="width: 13.3498%; height: 102.141px;">User Agent

</td><td style="width: 10.9985%; height: 102.141px;">No

</td><td style="width: 53.0312%; height: 102.141px;"> A characteristic string that lets servers and network peers identify the application, operating system, vendor, and/or version of the requesting user agent.

</td><td style="width: 22.6205%; height: 102.141px;">text, 255 characters

</td></tr><tr style="height: 79.0938px;"><td style="width: 13.3498%; height: 79.0938px;">Webcast Event ID

</td><td style="width: 10.9985%; height: 79.0938px;">No

</td><td style="width: 53.0312%; height: 79.0938px;">Unique id of the corresponding webcast event

</td><td style="width: 22.6205%; height: 79.0938px;">text, 255 characters

</td></tr><tr style="height: 79.0938px;"><td style="width: 13.3498%; height: 79.0938px;">Webcast Event Title

</td><td style="width: 10.9985%; height: 79.0938px;">No

</td><td style="width: 53.0312%; height: 79.0938px;">Title of the corresponding webcast event

</td><td style="width: 22.6205%; height: 79.0938px;">text, 255 characters

</td></tr></tbody></table>

[![External ID](https://help.webcasts.com/uploads/images/gallery/2023-10/scaled-1680-/tU5BZEneNhCoA2ZY-image-1698075021734.png)](https://help.webcasts.com/uploads/images/gallery/2023-10/tU5BZEneNhCoA2ZY-image-1698075021734.png)

**Object Name:** Webcast Survey QA Data

<table border="1" id="bkmrk-field-name-required--0"><tbody><tr><td class="align-center">**Field Name**

</td><td class="align-center">**Required**

</td><td class="align-center">**Description**

</td><td class="align-center">**Field Type**

</td></tr><tr><td>External ID

</td><td>Yes

</td><td>Stores unique values which connect the data between the webcast and Salesforce

</td><td>text, 255 characters (External ID)  
\*screenshot above

</td></tr><tr><td>Answer

</td><td>No

</td><td>Depending on "Record Type" it is either a viewer's response to a poll/survey or an admin's response to a viewer question

</td><td>text area, long

</td></tr><tr><td>Campaign Source

</td><td>No

</td><td>Track the marketing channel that drove webcast registration

</td><td>text, 255 characters

</td></tr><tr><td style="width: 13.3498%; height: 79.0938px;">Contact

</td><td style="width: 10.9985%; height: 79.0938px;">No

</td><td style="width: 53.0312%; height: 79.0938px;">Connects the custom object record to the corresponding contact, if contact exists

</td><td style="width: 22.6205%; height: 79.0938px;">Lookup Relationship (Contact)

</td></tr><tr><td>Email

</td><td>No

</td><td>Email

</td><td>email

</td></tr><tr><td style="width: 13.3498%; height: 102.141px;">Lead

</td><td style="width: 10.9985%; height: 102.141px;">No

</td><td style="width: 53.0312%; height: 102.141px;">Connects the custom object record to the corresponding lead, if lead exists

</td><td style="width: 22.6205%; height: 102.141px;">Lookup Relationship (Lead)

</td></tr><tr><td>Question

</td><td>No

</td><td>Depending on "Record Type" it is either a viewer question or the question for a poll/survey

</td><td>text area, long

</td></tr><tr><td>Record Type

</td><td>No

</td><td>QA: Is a viewer question

In-Event: Is a survey/poll sent during the webcast

Post-Event: Is a survey responded to after the conclusion of the webcast

</td><td>text, 255 characters

</td></tr><tr><td>Webcast Event ID

</td><td>No

</td><td>Unique id of the corresponding webcast event

</td><td>text, 255 characters

</td></tr><tr><td>Webcast Event Title

</td><td>No

</td><td>Title of the corresponding webcast event

</td><td>text, 255 characters

</td></tr></tbody></table>

<p class="callout info">If you need additional information on creating Custom Objects in Salesforce, please contact Salesforce Support.</p>

#### **Salesforce Campaigns**  


In order for the webcast registration and attendance data to update campaigns a "webcast\_id" field needs to be added to Salesforce campaigns. Enter the corresponding 7 digit webcast id into this field.

Additionally, the integration's default status fields are:

- "Registered" - for any user who has a registration for the webcast but has not yet attended. Webcast can be pre-live.
- "Attended" - for any user who as attended the webcast, either as a live, on demand or simulated live participant.

#### **Implementation Process**

<div class="pointer-container" id="bkmrk-%C2%A0-1"><div class="pointer anim is-page-editable"><svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg><div class="input-group inline block"> <button class="button outline icon" data-clipboard-target="#pointer-url" title="Copy Link" type="button"><svg class="svg-icon" data-icon="copy" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg></button></div><svg class="svg-icon" data-icon="edit" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg></div></div>To facilitate the integration implementation you will need to schedule a meeting with an integration specialist to review the specific requirements for your integration, which were outlined in the completed [form](https://fs30.formsite.com/tpforms/21wkz6lmlv/index.html?1610153864495). The integration process is handled almost entirely by the webcast team, there are a couple steps you will need to complete:

1. Create the two custom objects and add the "webcast\_id" field to campaigns in Salesforce to store webcast activity data.

2. Connect Workato to Salesforce. It is recommended that the initial integration setup be completed using a sandbox environment, if available. The connection to Workato will be completed during your implementation call, but you can review the process by watching the [Workato Connection Setup Tutorial](https://event.webcasts.com/starthere.jsp?ei=1610111&tp_key=a1951738b6).