---
id: apache-airflow-providers-telegram
version: "4.9.6"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# apache-airflow-providers-telegram — Provider package apache-airflow-providers-telegram for Apache Airflow

License: permissive · Maintenance: active · Downloads: 244.1K/mo

## What it is and what it does

This is an Apache Airflow provider package that bridges Airflow workflows with Telegram messaging. It wraps the python-telegram-bot library to expose Telegram functionality as Airflow operators and hooks, allowing DAGs to send notifications, alerts, and messages to Telegram channels or direct chats as part of task execution or error handling.

The package is part of the official Airflow provider ecosystem and is maintained alongside Apache Airflow itself. It depends on apache-airflow (>=2.11.0), apache-airflow-providers-common-compat (>=1.10.1), and python-telegram-bot (>=20.2). It supports Python 3.10 through 3.14 and is classified as production-stable.

Use it for:

- Send task completion or failure alerts to a Telegram channel when Airflow DAG tasks finish
- Notify on-call teams of workflow errors or SLA breaches via direct Telegram messages
- Log workflow milestones or data pipeline checkpoints to a Telegram group for visibility
- Integrate Airflow monitoring with team communication by posting scheduled reports to Telegram

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Integrates Apache Airflow with Telegram to send notifications and messages from Airflow workflows via the Telegram Bot API.

Yes, if you run Apache Airflow and need Telegram notifications. The package is actively maintained, has no known vulnerabilities, low install friction, and integrates cleanly with Airflow's provider architecture. It is production-stable and suitable for adding Telegram alerting to existing workflows.

## Install

pip install apache-airflow-providers-telegram
uv add apache-airflow-providers-telegram
poetry add apache-airflow-providers-telegram

## Installing apache-airflow-providers-telegram

Before you install: Low install friction; pure Python wheel. Maintained actively with recent release 6 days ago. Requires Apache Airflow >=2.11.0 and python-telegram-bot >=20.2.

License in practice: Licensed under Apache License 2.0 (permissive), allowing use in commercial and private projects with minimal restrictions.

Quickstart:

pip install apache-airflow-providers-telegram

from airflow.providers.telegram.operators.telegram import TelegramOperator
from airflow import DAG

with DAG('example') as dag:
    TelegramOperator(task_id='notify', text='Hello')

Requires an existing Apache Airflow installation (>=2.11.0) and a valid Telegram bot token configured in Airflow connections.

Verify before relying:

- Specific Telegram operator classes and their method signatures available in version 4.9.6
- Whether the provider supports both text messages and rich media (photos, documents, etc.)
- Configuration details for Airflow connection setup with Telegram credentials

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 244.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

airflow telegram notifications, send telegram messages from airflow, airflow telegram provider, workflow telegram alerts, airflow telegram integration, telegram bot airflow operator, airflow-provider, workflow-notifications, telegram-integration

[View on SkillFed](https://skillfed.io/packages/apache-airflow-providers-telegram) · [View on PyPI](https://pypi.org/project/apache-airflow-providers-telegram/)