> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Widgets

> Specialized interactive tools for your workspace.

Widgets are blocks built for a single live task. Where embedded components mostly display data, a widget floats over your workspace and does one job: place a call, work a conversation, run an agent.

## Key Characteristics

* **Task-Focused**: Each widget is built to excel at a single primary function (e.g., making a phone call, managing a conversation).
* **Global or Local**: Widgets can be pinned globally to the Custral sidebar/footer or embedded within specific pages.
* **Real-Time**: They often handle live data streams, such as audio for calls or message updates for chat.

## The Widget Bar

All widgets are managed through the **Widget Bar**, a persistent dock located at the edge of your workspace (inspired by high-performance utility docks).

* **Quick Access**: Toggle widgets on and off with a single click or keyboard shortcut.
* **Persistent State**: Widgets maintain their state (e.g., an active call or a chat history) even as you navigate between different pages in Custral.
* **Unified Controls**: Common settings like volume, notifications, and AI model selection are accessible directly from the bar.

## Core Custral Widgets

Custral includes several high-performance widgets to boost team productivity:

<CardGroup cols={2}>
  <Card title="Conversation" icon="comments" href="/blocks/widgets/conversation">
    A unified interface for managing customer communications across email, SMS, and chat.
  </Card>

  <Card title="Dialer" icon="phone" href="/blocks/widgets/dialer">
    A fully integrated VoIP dialer for making and receiving calls directly within Custral.
  </Card>

  <Card title="AI Agent" icon="robot" href="/blocks/widgets/agent">
    A persistent AI assistant that can answer questions, summarize data, and execute tasks.
  </Card>
</CardGroup>

## Usage

Widgets work best when they're within reach during normal work:

1. **Global Search & Action**: The AI Agent widget allows users to query the entire Custral database from anywhere in the app.
2. **Omnichannel Support**: The Conversation widget centralizes all support tickets and messages, allowing for rapid response.
3. **Sales Outreach**: The Dialer widget enables sales teams to move through lead lists quickly without switching context.

## Configuration

Each widget has its own settings, which often include:

| Setting             | What it does                                                                                     |
| ------------------- | ------------------------------------------------------------------------------------------------ |
| Provider settings   | Connect any external service the widget relies on (for example a phone provider for the Dialer). |
| Display preferences | Display modes, notification settings, and default views.                                         |
| Permissions         | Which teams or roles can use the widget.                                                         |

***

Learn more about the specific capabilities of the [Conversation](/blocks/widgets/conversation), [Dialer](/blocks/widgets/dialer), and [Agent](/blocks/widgets/agent) widgets in their respective sections.


## Related topics

- [Widget](/dev/webhooks/events/widget.md)
- [Install the widget](/comms/chat/widget-install.md)
- [Chat & Widget](/comms/chat/overview.md)
- [Widget windows](/start/widget-windows.md)
- [Conversation Widget](/blocks/widgets/conversation.md)