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

zerver/webhooks/errbit/doc.md

@@ -0,0 +1,26 @@
+# Zulip Errbit integration
+
+Get Zulip notifications for the Errbit error tracker!
+
+{start_tabs}
+
+1. {!create-an-incoming-webhook.md!}
+
+1. {!generate-webhook-url-basic.md!}
+
+1. Go to your project's settings on the Errbit site. Click on the
+   **Edit** button for your Errbit app, and select **Webhook**.
+
+1. Enter the URL generated above, and toggle **Enabled**.
+
+1. Select **Save**.
+
+{end_tabs}
+
+{!congrats.md!}
+
+![](/static/images/integrations/errbit/001.png)
+
+### Related documentation
+
+{!webhooks-url-specification.md!}

zerver/webhooks/errbit/fixtures/error_message.json

@@ -0,0 +1,40 @@
+{
+    "problem": {
+        "url": "https://errbit.example.com/apps/5e1ed1ff1a603f3916f4f0de/problems/5e1fe93e1a603f3916f4f0e3",
+        "_id": "5e1fe93e1a603f3916f4f0e3",
+        "app_id": "5e1ed1ff1a603f3916f4f0de",
+        "app_name": "ZulipIntegrationTest",
+        "comments_count": 0,
+        "created_at": "2020-01-15T23:40:30.989-05:00",
+        "environment": "ErrbitEnvName",
+        "error_class": "IllegalStateException",
+        "first_notice_at": "2020-01-15T23:40:30.987-05:00",
+        "hosts": {
+            "382b0f5185773fa0f67a8ed8056c7759": {
+                "count": 5,
+                "value": "N/A"
+            }
+        },
+        "issue_link": null,
+        "issue_type": null,
+        "last_notice_at": "2020-01-16T00:30:04.835-05:00",
+        "message": "Invalid state error",
+        "messages": {
+            "f721d9a468a891c5138eeb52c8b3831e": {
+                "count": 5,
+                "value": "Invalid state error"
+            }
+        },
+        "notices_count": 5,
+        "resolved": false,
+        "resolved_at": null,
+        "updated_at": "2020-01-15T23:45:19.246-05:00",
+        "user_agents": {
+            "382b0f5185773fa0f67a8ed8056c7759": {
+                "count": 5,
+                "value": "N/A"
+            }
+        },
+        "where": "unknown"
+    }
+}

zerver/webhooks/errbit/tests.py

@@ -0,0 +1,8 @@
+from zerver.lib.test_classes import WebhookTestCase
+
+
+class ErrBitHookTests(WebhookTestCase):
+    def test_errbit_error_message(self) -> None:
+        expected_topic_name = "ZulipIntegrationTest / ErrbitEnvName"
+        expected_message = '[IllegalStateException](https://errbit.example.com/apps/5e1ed1ff1a603f3916f4f0de/problems/5e1fe93e1a603f3916f4f0e3): "Invalid state error" occurred.'
+        self.check_webhook("error_message", expected_topic_name, expected_message)

zerver/webhooks/errbit/view.py

@@ -0,0 +1,40 @@
+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
+
+ERRBIT_TOPIC_TEMPLATE = "{project_name}"
+ERRBIT_MESSAGE_TEMPLATE = '[{error_class}]({error_url}): "{error_message}" occurred.'
+
+
+@webhook_view("Errbit")
+@typed_endpoint
+def api_errbit_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:
+    project = payload["problem"]["app_name"].tame(check_string)
+    project += " / " + payload["problem"]["environment"].tame(check_string)
+    return ERRBIT_TOPIC_TEMPLATE.format(project_name=project)
+
+
+def get_body(payload: WildValue) -> str:
+    data = {
+        "error_url": payload["problem"]["url"].tame(check_string),
+        "error_class": payload["problem"]["error_class"].tame(check_string),
+        "error_message": payload["problem"]["message"].tame(check_string),
+    }
+    return ERRBIT_MESSAGE_TEMPLATE.format(**data)