Skip to main content

XMPP Webhook Bridge

Project description

Note that xmppwb is currently in early development and may contain bugs.

A bot that bridges XMPP (chats and MUCs) with webhooks, thus making it possible to interact with services outside the XMPP world. This can be used to connect XMPP to other chat services that provide a webhook API (for example Rocket.Chat, Mattermost or Slack).


xmppwb requires Python 3.4+ and depends on the following libraries, which can be installed using pip3:

pip3 install aiohttp pyyaml slixmpp

After cloning this repository you can run xmppwb like this:

python3 --help


A documented example config is provided in example.conf. A simple config file looks like this:

  password: "<bot-password>"
    - jid:
      nickname: WebhookBridge
      password: "<muc-password>"
  bind_address: ""
  port: 5000
  - xmpp:
      - muc:
      - relay_all_normal: true
        - url:<yourtoken>
          override_username: "{nick}"
        - token: <your-token2>

Note that the password is stored in cleartext, so take precautions such as restricting file permissions. It is recommended to use a dedicated JID for this bridge.


This bridge is meant to run on the same server as the application you are bridging with, as it currently uses HTTP for incoming webhooks.

To run the bridge:

python3 --config configfile.conf

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xmppwb-0.1.0.tar.gz (6.0 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page