docs-archive/apache-airflow-providers-discord/1.0.0/_sources/_api/airflow/providers/discord/hooks/discord_webhook/index.rst.txt

:mod:`airflow.providers.discord.hooks.discord_webhook`
======================================================

.. py:module:: airflow.providers.discord.hooks.discord_webhook


Module Contents
---------------

.. py:class:: DiscordWebhookHook(http_conn_id: Optional[str] = None, webhook_endpoint: Optional[str] = None, message: str = '', username: Optional[str] = None, avatar_url: Optional[str] = None, tts: bool = False, proxy: Optional[str] = None, *args, **kwargs)

   Bases: :class:`airflow.providers.http.hooks.http.HttpHook`

   This hook allows you to post messages to Discord using incoming webhooks.
   Takes a Discord connection ID with a default relative webhook endpoint. The
   default endpoint can be overridden using the webhook_endpoint parameter
   (https://discordapp.com/developers/docs/resources/webhook).

   Each Discord webhook can be pre-configured to use a specific username and
   avatar_url. You can override these defaults in this hook.

   :param http_conn_id: Http connection ID with host as "https://discord.com/api/" and
                        default webhook endpoint in the extra field in the form of
                        {"webhook_endpoint": "webhooks/{webhook.id}/{webhook.token}"}
   :type http_conn_id: str
   :param webhook_endpoint: Discord webhook endpoint in the form of
                            "webhooks/{webhook.id}/{webhook.token}"
   :type webhook_endpoint: str
   :param message: The message you want to send to your Discord channel
                   (max 2000 characters)
   :type message: str
   :param username: Override the default username of the webhook
   :type username: str
   :param avatar_url: Override the default avatar of the webhook
   :type avatar_url: str
   :param tts: Is a text-to-speech message
   :type tts: bool
   :param proxy: Proxy to use to make the Discord webhook call
   :type proxy: str

   
   .. method:: _get_webhook_endpoint(self, http_conn_id: Optional[str], webhook_endpoint: Optional[str])

      Given a Discord http_conn_id, return the default webhook endpoint or override if a
      webhook_endpoint is manually supplied.

      :param http_conn_id: The provided connection ID
      :param webhook_endpoint: The manually provided webhook endpoint
      :return: Webhook endpoint (str) to use



   
   .. method:: _build_discord_payload(self)

      Construct the Discord JSON payload. All relevant parameters are combined here
      to a valid Discord JSON payload.

      :return: Discord payload (str) to send



   
   .. method:: execute(self)

      Execute the Discord webhook call