---
title: "Action widget__callout"
description: "Sends a callout message to the widget (text and extra parameters)."
---

# Action `widget__callout`

> **System ID:** `action_widget__callout`  
> Also in scenario: `widget__callout`

## Description

Sends a callout notification to the widget in real time. The required field is `text`; other fields from the node JSON are also passed to the widget. Works only for the widget channel (room `{chat_id}_{bot_id}`).

## Events (scenario branches)

| Event | When it occurs |
|-------|----------------|
| **ok** | Callout sent |
| **not_ok** | No `text`, or send failed |

## Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `text` | string | yes | — | Callout text. Supports placeholders |
| *(other)* | any | no | — | Extra fields are passed to the widget as-is |

## Configuration example

```json
{
  "text": "Payment received!",
  "type": "info",
  "duration": 5000
}
```

## Related docs

- [Actions reference](/en/actionjail/reference/actions-reference.md)