snapshot of https://github.com/zulip/zulip.git @ 48c69911c7dd4e03b20552eb3bd77ad8151c1357 (2026-09-15)

zerver/webhooks/airbrake/doc.md

@@ -0,0 +1,25 @@
+# Zulip Airbrake integration
+
+Get Zulip notifications for your Airbrake bug tracker!
+
+{start_tabs}
+
+1. {!create-an-incoming-webhook.md!}
+
+1. {!generate-webhook-url-basic.md!}
+
+1. Go to your project's settings on the Airbrake site. Click on the
+   **Integration** section, and select **Webhook**.
+
+1. Enter the URL you generated, and check **Enabled**.
+   Click **Save**.
+
+{end_tabs}
+
+{!congrats.md!}
+
+![](/static/images/integrations/airbrake/001.png)
+
+### Related documentation
+
+{!webhooks-url-specification.md!}

zerver/webhooks/airbrake/fixtures/error_message.json

@@ -0,0 +1,25 @@
+{
+  "error": {
+    "id": "1705190192091077626",
+    "error_message": "Error message from logger",
+    "error_class": "ZeroDivisionError",
+    "file": "file.py",
+    "line_number": 2,
+    "project": {
+      "id": 125209,
+      "name": "ZulipIntegrationTest"
+    },
+    "last_notice": {
+      "id": "1705189516072954676",
+      "request_url": null,
+      "backtrace": [
+        "file.py:2:in \u003cmodule\u003e"
+      ]
+    },
+    "environment": "dev",
+    "first_occurred_at": "2016-06-10T17:07:10.760639Z",
+    "last_occurred_at": "2016-06-10T17:07:10.76Z",
+    "times_occurred": 1
+  },
+  "airbrake_error_url": "https:\/\/zulip.airbrake.io\/projects\/125209\/groups\/1705190192091077626"
+}

zerver/webhooks/airbrake/tests.py

@@ -0,0 +1,8 @@
+from zerver.lib.test_classes import WebhookTestCase
+
+
+class AirbrakeHookTests(WebhookTestCase):
+    def test_airbrake_error_message(self) -> None:
+        expected_topic_name = "ZulipIntegrationTest"
+        expected_message = '[ZeroDivisionError](https://zulip.airbrake.io/projects/125209/groups/1705190192091077626): "Error message from logger" occurred.'
+        self.check_webhook("error_message", expected_topic_name, expected_message)

zerver/webhooks/airbrake/view.py

@@ -0,0 +1,41 @@
+# Webhooks for external integrations.
+from django.http import HttpRequest, HttpResponse
+
+from zerver.decorator import webhook_view
+from zerver.lib.response import json_success
+from zerver.lib.typed_endpoint import JsonBodyPayload, typed_endpoint
+from zerver.lib.validator import WildValue, check_string
+from zerver.lib.webhooks.common import check_send_webhook_message
+from zerver.models import UserProfile
+
+AIRBRAKE_TOPIC_TEMPLATE = "{project_name}"
+AIRBRAKE_MESSAGE_TEMPLATE = '[{error_class}]({error_url}): "{error_message}" occurred.'
+
+
+@webhook_view("Airbrake")
+@typed_endpoint
+def api_airbrake_webhook(
+    request: HttpRequest,
+    user_profile: UserProfile,
+    *,
+    payload: JsonBodyPayload[WildValue],
+) -> HttpResponse:
+    topic_name = get_topic(payload)
+    body = get_body(payload)
+    check_send_webhook_message(request, user_profile, topic_name, body)
+    return json_success(request)
+
+
+def get_topic(payload: WildValue) -> str:
+    return AIRBRAKE_TOPIC_TEMPLATE.format(
+        project_name=payload["error"]["project"]["name"].tame(check_string)
+    )
+
+
+def get_body(payload: WildValue) -> str:
+    data = {
+        "error_url": payload["airbrake_error_url"].tame(check_string),
+        "error_class": payload["error"]["error_class"].tame(check_string),
+        "error_message": payload["error"]["error_message"].tame(check_string),
+    }
+    return AIRBRAKE_MESSAGE_TEMPLATE.format(**data)