# Telegram event - Workflow trigger | Docs - nodulz

Source: https://nodulz.com/docs/nodes/telegram_trigger

Language: en

Receive bot events by webhook: messages, commands, buttons, payments and members.

## Usage and specifics

The action uses the bot token; the trigger uses a separate webhook secret. Publish and configure the bot HTTPS webhook. chat_id identifies the target chat. Custom mode exposes Bot API methods and parameters.

Technical type : `telegram_trigger`. Runtime : `nodulz`.

## Credentials and prerequisites

- [Telegram webhook](/docs/credentials) (`integration` / `telegram_webhook`). Secret containing 1 to 256 letters, numbers, _ or -. Select the same credential in the trigger and setWebhook action.

Create credentials in your nodulz instance’s Credentials area, then select them on the node. Availability depends on ownership and sharing. See the [credentials guide](/docs/credentials) for access and rotation.

## Parameters

Names below are technical keys. Defaults are not a ready-to-run configuration: complete fields required by your operation. Paths containing [] describe list items; some fields depend on the selected mode.

| Parameter | Type | Default | Values / limits |
| --- | --- | --- | --- |
| `rateLimitEnabled` | `boolean` | - | - |
| `rateLimitMax` | `number` | - | -; > 0 |
| `rateLimitWindowMs` | `number` | - | -; > 0 |
| `allowedIps` | `array` | - | -; max 256 |
| `blockedIps` | `array` | - | -; max 256 |
| `credentialId` | `string` | `""` | - |
| `events` | `array` | `[]` | - |
| `chatId` | `string` | `""` | - |
| `command` | `string` | `""` | - |
| `testPayload` | `string` | `""` | - |

## Configuration help

| Setting | Purpose and guidance |
| --- | --- |
| `events`<br>Events | Empty: all received events. Also configure allowed_updates in setWebhook: chat_member, message_reaction and message_reaction_count require explicit selection and suitable Telegram permissions. |

## Initial configuration

Initial catalog configuration example, to adapt before running. Keep secrets in credentials.

```json
{
  "credentialId": "",
  "events": [],
  "chatId": "",
  "command": "",
  "testPayload": ""
}
```

## Verification

Test with representative data. Check node output in the inspector and logs, then use editor mapping for downstream fields. A trigger test with a simulated payload does not validate external service delivery.

See also : [Expressions and data](/docs/expressions), [Executions](/docs/executions), [Node catalog](/docs/nodes).

## Explore further

- [Features - nodulz](https://nodulz.com/product/overview)
- [Node catalog - nodulz](https://nodulz.com/product/catalog)
- [MCP server - nodulz](https://nodulz.com/product/mcp)
- [Pricing - nodulz](https://nodulz.com/pricing)
- [Use cases and workflow automation - nodulz](https://nodulz.com/use-cases)
- [Choose what your workflows can do. - nodulz](https://nodulz.com/compare)
- [Documentation - nodulz](https://nodulz.com/docs)