Skip to main content

Agent API

The Agent API allows developers to interact with the Pendo Agent that collects user interaction and displays in-app messaging in your app. The default installation provides everything needed to effectively capture auto events and deliver guides to your end-users.

Installation

To make use of the Agent API, Pendo must be correctly installed and initialized in your application. The install script or "snippet" fetches the JavaScript agent, and the initalize method must follow to start Pendo on a page. Both must complete to fully install Pendo. See a more in-depth guide to installation in the Pendo Help Center.

Agent Functionality

Additional functions allow you to control the agent and the data collected by the agent. The agent can exclude text collection, programmatically change page URLs captured in events, delay guide loading, and more to customize your installation.

Advanced functionality, like sending track events, debugging, and programmatically activating guides requires interaction with the Agent API inside your application JavaScript.

caution

Any undocumented functionality you encounter while inspecting the pendo namespace should be considered either internal or experimental and is subject to change. Don't rely on undocumented functionality.

Debugging

In Agent versions 2.10+, you can debug and troubleshoot Guides with our debugging tool. Enable the debugging extension by invoking pendo.enableDebugging() in the JavaScript console on a page that has the Pendo Agent installed. A small pink bug icon should appear in the top left corner of your window only. Click on that icon to reveal a panel of information about the currently loaded and active sub-systems running.

Agent Updates

The Agent typically releases a new version each week. Releases will first reach the Beta release track and then after a few days will be moved to the Stable track. The notes for each release can be found here.