Outbound Events

Reference Guide – Variables and Macros

When integrating Bomgar with external programs, you can configure your Bomgar Appliance to send messages to an HTTP server or to an email address when specified events are triggered. This document lists the HTTP variables that can be sent by the outbound event service that resides on the appliance, describing what the messages mean as well as what triggered them. It also defines the macros that can be used in an email and lists the event emails that can include those macros.

HTTP Recipients

To configure HTTP recipients for outbound events, you should be familiar with the HTTP request concept and functionality. The variables sent by the Bomgar Appliance arrive as an HTTP POST method, and the server must respond with an HTTP 200 to indicate success. Failure to respond with an HTTP 200 will cause the appliance to re-queue the current event and retry it later. No other events will be sent until this event receives HTTP 200. This is to allow for a grace period should the event recipient need to be taken offline for a short duration; all the events it missed while offline will arrive when it comes back online. The information can be accessed by calling the method used to retrieve POST data in your coding language.

Each message contains several standard variables, as defined below:

event The name of the event that occurred. Events are furthered explained in the table below.
version Bomgar's internal version number for this schema. This number will be updated whenever the schema changes.
timestamp The Unix time stamp for the system time at which the event originated.

Each HTTP message contains the name of the event that triggered the message to be sent. Below is a comprehensive list of the possible events that would result in a post, accompanied by a brief description of each event. Note that each event includes variables in addition to the three standard variables defined above. The additional variables are also defined below.

Event and Trigger Additional Variables

support_conference_begin

A new support session has started.

lsid: The logging Session ID of this event. Corresponds to the session ID as shown in the web reports or XML API reports. Must be treated as a string.
external_key: Present only if an external key has been assigned to the session. This key can be assigned manually by the representative or programmatically and can be helpful in tracking issues in external programs.

support_conference_end

A support session has ended.

lsid: The logging Session ID of this event. Corresponds to the session ID as shown in the web reports or XML API reports. Must be treated as a string.
external_key: Present only if an external key has been assigned to the session. This key can be assigned manually by the representative or programmatically and can be helpful in tracking issues in external programs.

support_conference_owner_changed

The session has been transferred to the designated representative or team. Occurs when the session is first started, when a representative transfers a session to another representative or team, or when the primary representative leaves an active session.

lsid: The logging Session ID of this event. Corresponds to the session ID as shown in the web reports or XML API reports. Must be treated as a string.
external_key: Present only if an external key has been assigned to the session. This key can be assigned manually by the representative or programmatically and can be helpful in tracking issues in external programs.
conference_id: The unique ID assigned to the representative or team (e.g., rep:12, team:5, general).
conference_name: The name of the representative or team (e.g., John Smith, Troubleshooting, General).

support_conference_member_added

A new individual, either a customer or representative, has joined the session.

lsid: The logging Session ID of this event. Corresponds to the session ID as shown in the web reports or XML API reports. Must be treated as a string.
external_key: Present only if an external key has been assigned to the session. This key can be assigned manually by the representative or programmatically and can be helpful in tracking issues in external programs.
type: The type of individual who was added. Can be either customer or representative.
name: The display name of the individual.
user_id: Present only if the individual is a representative. The unique ID assigned to that representative.
username: Present only if the individual is a representative. The username assigned to that representative.

support_conference_member_departed

A customer or representative has left the session.

lsid: The logging Session ID of this event. Corresponds to the session ID as shown in the web reports or XML API reports. Must be treated as a string.
external_key: Present only if an external key has been assigned to the session. This key can be assigned manually by the representative or programmatically and can be helpful in tracking issues in external programs.
type: The type of individual who was added. Can be either customer or representative.
name: The display name of the individual.
user_id: Present only if the individual is a representative. The unique ID assigned to that representative.
username: Present only if the individual is a representative. The username assigned to that representative.

support_conference_customer_exit_survey_completed

The customer has submitted the customer exit survey.

lsid: The logging Session ID of this event. Corresponds to the session ID as shown in the web reports or XML API reports. Must be treated as a string.
external_key: Present only if an external key has been assigned to the session. This key can be assigned manually by the representative or programmatically and can be helpful in tracking issues in external programs.

support_conference_rep_exit_survey_completed

The primary representative has submitted the representative exit survey.

lsid: The logging Session ID of this event. Corresponds to the session ID as shown in the web reports or XML API reports. Must be treated as a string.
external_key: Present only if an external key has been assigned to the session. This key can be assigned manually by the representative or programmatically and can be helpful in tracking issues in external programs.

Email Recipients

To configure email recipients for outbound events, you must first verify that your Bomgar Appliance is configured to work with your SMTP relay server. The SMTP settings are configured from /login > Management > Email Configuration.

Within the Email Recipients section of the Outbound Events page, the Current Status displays a brief status message from the SMTP relay server. As long as the appliance is able to send messages to the relay server, the status will show OK. Otherwise, review your SMTP relay server settings. Also, if an event continues to retry and fail, set how long it should continue to retry before being dropped.

Each email message triggered by an event is completely free-form and can be modified to whatever text format the recipient requires. Below is a list of the available macros that can be used in emailed outbound events, along with which macros can be used with which events.

Macro Purpose and Availability Event

%EXTERNAL_KEY%

Present only if an external key has been assigned to the session. This key can be assigned manually by the representative or programmatically and can be helpful in tracking issues in external programs. (Subject and Body)

Support Session End

Customer Exit Survey is Completed

Representative Exit Survey is Completed

%LSID%

The logging Session ID of this event. Corresponds to the session ID as shown in the web reports or XML API reports. (Subject and Body)

Support Session End

Customer Exit Survey is Completed

Representative Exit Survey is Completed

%LSEQ%

The sequential logging number used to represent this support session. (Subject and Body)

Support Session End

Customer Exit Survey is Completed

Representative Exit Survey is Completed

%SESSION_SUMMARY%

A summary of session details, including the representative's private display name and ID; the customer's name and IP addresses; the session start time, end time, and duration; and the number of files transferred, renamed, or deleted. (Body)

Support Session End

%SESSION_NOTES%

Any session notes submitted during the support session. (Body)

Support Session End

%SESSION_CHAT%

The entire chat transcript of the support session. (Body)

Support Session End

%SYSTEM_INFORMATION%

The General Information section of the retrieved system information. System information is returned only when pulled automatically at the beginning of the session and not when specifically requested by the representative. This is to prevent overload with the large amount of dynamic data that can be retrieved from the remote system. (Body)

Support Session End

%SCREEN_SHARING_RECORDING%

The URL of the screen sharing recordings. (Body)

Support Session End

%COMMAND_SHELL_RECORDING%

The URLs to all command shell recordings. (Body)

Support Session End

%CUSTOMER_EXIT_SURVEY%

The exit survey questions presented to the customer and his or her responses. (Body)

Customer Exit Survey is Completed

%REPRESENTATIVE_EXIT_SURVEY%

The exit survey questions presented to the representative and his or her responses. (Body)

Representative Exit Survey is Completed