# Tellescope Integration

> Step-by-step guide to integrate Ours Privacy with Tellescope for tracking patient interactions and clinical events while prioritizing privacy and HIPAA compliance.

Source: https://docs.oursprivacy.com/docs/tellescope

Track patient interactions and clinical events from your [Tellescope](http://tellescope.com/) account (also searched as "telescope") in Ours Privacy with analytics built for **HIPAA-regulated workflows**.

> **Recommended:** Use the [Ours Privacy Tag Manager](https://docs.oursprivacy.com/docs/tag-manager) for the simplest integration with Tellescope. It provides visual tag management, built for HIPAA-regulated sites, without requiring a third-party container.

## Setting Up Tellescope Integration

Follow these steps to set up the integration:

1. **Enable dataLayer Access on Tellescope**:
   * Contact Tellescope support to enable dataLayer pushes on your website
     * With this enabled, corresponding dataLayer pushes will be emitted for each form step
   * They will provide you with the necessary permissions and access

2. **Install Ours Privacy Tag Manager**:
   * Follow the [Tag Manager Installation Guide](https://docs.oursprivacy.com/docs/tag-manager/installation) to set up Ours Privacy Tag Manager
   * Configure your tags and triggers to capture Tellescope dataLayer events

3. **Configure Event Tracking**:
   * Create tags in the Ours Privacy Tag Manager to track relevant Tellescope events
   * Map clinical fields and patient interactions
   * Ensure proper event naming for consistency

4. **Test the Integration**:
   * Use [Preview Mode](https://docs.oursprivacy.com/docs/tag-manager/preview-mode) to test your tags
   * Verify that events are being sent to Ours Privacy
   * Check the Ours Privacy dashboard for incoming data

## Key Features

### Event Tracking

Track various Tellescope events:

* **Patient Interactions**: Monitor patient engagement and interactions
* **Clinical Events**: Track important clinical activities
* **Custom Events**: Configure additional events based on your needs

All dataLayer event types:

* Forms
  * `public_form_start` - the user submitted the first step of the form
  * `form_submitted` - the user has submitted the final step of the form.
  * `form_progress` - the user has made it to the next step in the form (fires in parallel to `public_form_start` and `form_submitted`)
* Appointments
  * `booking_widget_loaded` - the booking widget has loaded on site.
  * `selected_time` - the user has selected a time on the calendar to book an appointment
  * `completed_intake` - the user has completed the intake form for the booking
  * `completed_booking` - the user has completed the booking for the appointment

All parameter event types:

* Forms
  * `formId` - The corresponding ID of the form
  * `previousTitle` - The corresponding Title of the field that was just completed
  * `fieldId` - The corresponding ID of the next field
  * `title` - The corresponding Title of the next field
  * `status` - The corresponding Status of the next field

Things to consider:

* Some parameters are optional, meaning that if the form does not have a title or status, then those values may be exempt from the dataLayer push.
* The fieldId, title and status fields are also in reference to the next step within the process, not the step that was already completed. Meaning if a user completed step 1, the `fieldId`, `title`, and `status` values will reflect step 2 (which the user is landing on). To grab the value for the field completed, please reference `previousTitle` instead.
* Events are sent through the Ours Privacy Tag Manager to Ours Privacy so any potential PII/PHI will be scrubbed before hitting the destination. This allows the user to have full control of the events to be captured, modified, and sent.

### Data Handling

Events flow through Ours Privacy over HTTPS, so you control what each destination receives. See [Data Access and Privacy](https://docs.oursprivacy.com/docs/data-access-and-privacy).

### Clinical Analytics

Gain insights into your practice's performance:

* **Patient Engagement**: Track patient interactions and engagement
* **Clinical Activity**: Monitor clinical events and activities
* **Custom Analytics**: Create custom reports based on tracked events

## Key Benefits of the Ours Privacy Tellescope Integration

* **Built for HIPAA-regulated workflows**: Designed specifically for healthcare applications
* **Easy Implementation**: Simple tag manager-based integration
* **Secure Data Transmission**: All data flows through Ours Privacy
* **Flexible Tracking**: Configure custom events based on your needs
* **Full Self Serve Integration**: Not needed to work with the dev team at Tellescope to integrate dataLayer pushes or events.

## Data Flow

1. Tellescope events are captured through the Ours Privacy Tag Manager
2. Data flows through Ours Privacy's secure infrastructure
3. Events are processed and made available for analytics and advertising platforms
4. Data can be forwarded to other destinations, with each destination mapping controlling what it receives

For further assistance, contact [support@oursprivacy.com](mailto:support@oursprivacy.com).
