> For the complete documentation index, see [llms.txt](https://docs.sentiance.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sentiance.com/sentiance-insights/engagement.md).

# Engagement

The Engagement product offering sits on top of Sentiance's Insights and can used to build coaching modules to increase user engagement and retention in your applications.

{% hint style="info" %}
In the Engagement section of documentation, 'trip' and 'transport' both refer to a journey someone takes, whether it's by walking, driving, or biking. We use these terms interchangeably to keep the language consistent and adaptable to different modes of travel
{% endhint %}

## Available features

The Engagement platform contains the following features. All features can be implemented separately, or together with any of the other features.

Select a feature to discover more details and learn how to integrate it.

* [User Adaptive Score](/sentiance-insights/engagement/user-adaptive-score.md): Adapts to individual user behavior to provide scores.
* [Streaks](/sentiance-insights/engagement/streaks.md): Encourages better driving habits by rewarding users for consistent safe driving behaviors
* [Challenges](/sentiance-insights/engagement/challenges.md): Engages users with driving-related challenges, designed to promote safer driving practices and improve overall driving behavior through engaging and goal-oriented tasks
* [Reward System](/sentiance-insights/engagement/reward-system.md): Awards users with visual tokens of achievement for completing specific milestones or activities.
* [Communication Campaigns](/sentiance-insights/engagement/communication-campaign.md): Engages users with targeted messages and notifications, enhancing interaction and retention.
* [Social Groups](/sentiance-insights/engagement/social-groups.md): Enables users to connect with others by sharing live locations, managing points of interest, and participating in behaviour comparison within private, invitation-only groups
* Transport Scores: Offers detailed insights based on transportation behavior, including adaptive scores, focused scores, etc., aimed at enhancing understanding and improvement of driving and transportation habits.
* Event Logs (Engagement): Allows users to submit logs, with some logs carrying special meanings related to the operation of the other engagement features,

## Querying the platform

Just like the rest of the cloud platform, the engagement features can be accessed and queried through our GraphQL (GQL) API. All engagement features can be queried through our GraphQL (GQL) API, specifically through the subquery at path `user.engagement`

```graphql
query User($user_id: String) {
  user(user_id: $user_id) {
    engagement {
      // Specify the engagement feature and details you wish to query
    }
  }
}
```

## Sample Wireframe

<figure><img src="/files/VPquYqeQTBL9BkuuCZ4D" alt=""><figcaption></figcaption></figure>

***

Additional helpful links

* [Accessing via the Cloud API](/sentiance-insights/accessing-sentiance-insights/via-cloud-api.md)
* [Sentiance Graphql V4](https://graphqldocs.sentiance.com/)
* [Sentiance Graphql V4 > Engagement](https://graphqldocs.sentiance.com/#definition-Engagement)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sentiance.com/sentiance-insights/engagement.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.