Webhooks

Send POST to services like Slack or Discord.

To configure:

1. Go to Notification Configuration > Webhooks.
2. Click Create Configuration.
3. Fill form and save.
4. Test with Test.
5. Edit by clicking the name.

Add Webhook Form

• URL: Public endpoint.
• Name: Optional.
• Template: Slack, Discord, Custom.
• Body: JSON with placeholders.

Placeholders

Slack Setup

In Slack: Channel > Integrations > Incoming Webhooks > Add to Slack > Copy URL.

In Telebugs: Use Slack template, paste URL.

Slack and other notification webhooks respect the project’s severity setting. Enable Only notify for fatal and error events under the project’s Notifications settings to keep lower-severity reports out of the channel.

Example payload:

{
  "username": "Telebugs",
  "text": "{{project_name}}: {{trigger}} - {{error_type}}: {{error_message}}",
  "blocks": [
    {
      "type": "section",
      "text": {
        "type": "mrkdwn",
        "text": "*{{trigger}}* from <{{project_url}}|{{project_name}}>\n\n*{{error_type}}{{culprit}}*\n{{error_message}}\n\n*Location*\n{{location}}"
      }
    },
    {
      "type": "actions",
      "elements": [
        {
          "type": "button",
          "text": {
            "type": "plain_text",
            "text": "View"
          },
          "url": "{{view_url}}"
        }
      ]
    }
  ]
}

Discord Setup

In Discord: Server Settings > Integrations > Create Webhook > Copy URL.

In Telebugs: Use Discord template, paste URL.

Example payload:

{
  "content": "**{{trigger}}** from [{{project_name}}]({{project_url}})\n[View error]({{view_url}})",
  "embeds": [
    {
      "color": 16711680,
      "fields": [
        {
          "name": "{{error_type}}{{culprit}}",
          "value": "{{error_message}}"
        },
        {
          "name": "Location",
          "value": "{{location}}"
        }
      ]
    }
  ]
}

Microsoft Teams Setup

Microsoft Teams supports rich notifications via Incoming Webhooks using Adaptive Cards.

Create Webhook in Teams

1. In Microsoft Teams, go to the channel where you want notifications.
2. Click More options (•••) next to the channel name.
3. Select Manage channel > Edit.
4. Search for Incoming Webhook and select Add (or Configure if already added).
5. Enter a name (e.g., “Telebugs”) and optionally upload an image.
6. Click Create.
7. Copy the generated webhook URL and click Done.

In Telebugs: Use Teams template, paste URL.

Example payload:

{
  "type": "message",
  "attachments": [
    {
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "type": "AdaptiveCard",
        "version": "1.4",
        "body": [
          {
            "type": "TextBlock",
            "text": "**{{trigger}}** from [{{project_name}}]({{project_url}})",
            "wrap": true,
            "size": "Medium",
            "weight": "Bolder"
          },
          {
            "type": "TextBlock",
            "text": "**{{error_type}}{{culprit}}**",
            "wrap": true,
            "spacing": "Small"
          },
          {
            "type": "TextBlock",
            "text": "{{error_message}}",
            "wrap": true,
            "spacing": "None"
          },
          {
            "type": "TextBlock",
            "text": "**Location**",
            "wrap": true,
            "spacing": "Medium"
          },
          {
            "type": "TextBlock",
            "text": "{{location}}",
            "wrap": true,
            "spacing": "None"
          }
        ],
        "actions": [
          {
            "type": "Action.OpenUrl",
            "title": "View Error",
            "url": "{{view_url}}"
          }
        ]
      }
    }
  ]
}

This payload creates a formatted card with bold trigger/project, error details, location, and a View Error button.

Custom Webhooks

Use Custom template. Build your JSON with placeholders.

Example:

{
  "project_name": "{{project_name}}",
  "trigger": "{{trigger}}",
  "subject": "{{subject}}",
  "culprit": "{{culprit}}",
  "location": "{{location}}",
  "error_type": "{{error_type}}",
  "error_message": "{{error_message}}",
  "view_url": "{{view_url}}"
}