{"id":23263,"library":"apache-airflow-providers-dingding","title":"Apache Airflow Provider for DingDing","description":"A provider package for Apache Airflow that integrates with DingDing (DingTalk), allowing users to send notifications, trigger alerts, and interact with DingDing chatbot via Airflow operators and hooks. Current version 3.9.4, released as part of the Airflow provider ecosystem with regular updates aligned with Airflow release cadence.","status":"active","version":"3.9.4","language":"python","source_language":"en","source_url":"https://github.com/apache/airflow/tree/main/airflow/providers/dingding","tags":["airflow","provider","dingding","dingtalk","notifications"],"install":[{"cmd":"pip install apache-airflow-providers-dingding","lang":"bash","label":"Install provider"},{"cmd":"pip install apache-airflow[dingding]","lang":"bash","label":"Install with Airflow extras"}],"dependencies":[{"reason":"Provider runs on top of Airflow; requires Airflow >=2.10.0","package":"apache-airflow","optional":false}],"imports":[{"note":"Old contrib path removed in Airflow 2.0","wrong":"from airflow.contrib.hooks.dingding_hook import DingdingHook","symbol":"DingdingHook","correct":"from airflow.providers.dingding.hooks.dingding import DingdingHook"},{"note":"Operator moved to providers in Airflow 2.0","wrong":"from airflow.operators.dingding_operator import DingdingOperator","symbol":"DingdingOperator","correct":"from airflow.providers.dingding.operators.dingding import DingdingOperator"}],"quickstart":{"code":"from airflow import DAG\nfrom airflow.providers.dingding.operators.dingding import DingdingOperator\nfrom datetime import datetime\n\nwith DAG('dingding_test', start_date=datetime(2024,1,1), schedule_interval=None, catchup=False) as dag:\n    notify = DingdingOperator(\n        task_id='send_dingding',\n        dingding_conn_id='dingding_default',\n        message_type='text',\n        message='Hello from Airflow!',\n    )","lang":"python","description":"Minimal DAG using DingdingOperator to send a text message. Requires a DingDing connection configured in Airflow."},"warnings":[{"fix":"Use Python >=3.10, or pin to provider version <3.9.0 for Python 3.8/3.9.","message":"Minimum Python version raised to 3.10; Python 3.8/3.9 no longer supported.","severity":"breaking","affected_versions":">=3.9.0"},{"fix":"Switch to DingdingOperator or use DingdingHook.send() with keyword arguments.","message":"DingdingHook.send_message() method is deprecated; use DingdingOperator or call hook with new API.","severity":"deprecated","affected_versions":">=3.7.0"},{"fix":"Set 'extra' JSON as {\"access_token\": \"your_token\"}, not the full URL.","message":"Connection secret token must be exactly the 'access_token' field; do not include the entire webhook URL.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install apache-airflow-providers-dingding` or `pip install apache-airflow[dingding]`.","cause":"Provider package not installed.","error":"ModuleNotFoundError: No module named 'airflow.providers.dingding'"},{"fix":"Add a connection with conn_id='dingding_default', conn_type='dingding', and extra={'access_token': 'your_token'}.","cause":"DingDing connection not configured in Airflow UI or environment.","error":"AirflowException: The conn_id `dingding_default` isn't defined"},{"fix":"Use `from airflow.providers.dingding.hooks.dingding import DingdingHook`.","cause":"Old import path used.","error":"AttributeError: module 'airflow.providers.dingding.hooks.dingding' has no attribute 'DingdingHook'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}