Alert Webhooks

​

Obtaining a webhook URL

1. Go to https://app.phoebe.ai/integrations
2. Click Configure next to the service(s) you want to configure webhooks for

​

Authenticating

https://api.phoebe.ai/events/webhook/[PROVIDER]/

https://api.phoebe.ai/events/webhook/grafana/

​

Query parameter

https://api.phoebe.ai/events/webhook/grafana/?key=wak_myAccessToken

​

Bearer token

Authorization: Bearer wak_myAccessToken

​

Platform-specific instructions

​

AWS

1. Go to the Amazon SNS page, and create a new Subscription
   1. Choose the topic you want to subscribe to
   2. Choose HTTPS as the protocol
   3. Enter your webhook URL as the Endpoint
   4. Leave “Enable raw message deliver” unchecked.
   5. Note: The UI will tell you “After your subscription is created, you must confirm it.” You can ignore this; Phoebe does this automatically for you.
2. Click Create Subscription
3. Navigate back to the Subscription list view. You should see the new subscription show up as “Confirmed” after a few moments.

​

Datadog

1. Go to the integrations page in Datadog (e.g. https://app.datadoghq.eu/integrations) and install Datadog’s Webhooks Integration
2. In the Integration settings, click ”+ New” to add a new webhook
   1. Enter Phoebe for the name
   2. Enter the URL you were given in the URL field
   3. Leave Auth Method blank
   4. Copy and paste the following into the Payload field
      Copy

      Ask AI

      {
        "id": "$ID",
        "date": "$DATE",
        "title": "$EVENT_TITLE",
        "body": "$EVENT_MSG",
        "link": "$LINK",
        "last_updated": "$LAST_UPDATED",
        "event_type": "$EVENT_TYPE",
        "alert_priority": "$ALERT_PRIORITY",
        "alert_transition": "$ALERT_TRANSITION",
        "alert_cycle_key": "$ALERT_CYCLE_KEY",
        "alert_id": "$ALERT_ID",
        "alert_metric": "$ALERT_METRIC",
        "alert_query": "$ALERT_QUERY",
        "alert_status": "$ALERT_STATUS",
        "alert_title": "$ALERT_TITLE",
        "alert_type": "$ALERT_TYPE",
        "hostname": "$HOSTNAME",
        "logs_sample": $LOGS_SAMPLE,
        "metric_namespace": "$METRIC_NAMESPACE",
        "tags": "$TAGS"
      }
      
   5. Click Save
3. To send a notification to the webhook, include @webhook-Phoebe in the monitor body

​

Elastic

1. Go to Management > Stack Management > Connectors
2. Click Create connector and choose Webhook as the connector type
   1. Set the name to Phoebe
   2. Set the URL to https://api.phoebe.ai/events/webhook/elastic/
   3. Set the Authentication to None
   4. Click Add HTTP Header
      1. Set the header name to Authorization
      2. Set the header value to Bearer wak_yourAccessToken (replace yourAccessToken with the actual token you were given)
   5. Add a second header
      1. Set the header name to Content-Type
      2. Set the header value to application/json
   6. Click Save
3. Go to Management > Stack Management > Rules
4. When configuring your rule, in the Actions section choose “Phoebe (Webhook)”, and set the Message value to the following:
   Copy

   Ask AI

   {
       "date": "{{ date }}",
       "rule_name": "{{ rule.name }}",
       "rule_url": "{{ rule.url }}",
       "alert_uuid": "{{ alert.uuid }}",
       "message": "{{ context.message }}"
   }
   

​

Google Cloud Platform (GCP)

1. Go to https://console.cloud.google.com/monitoring/alerting/notifications
2. Scroll down to Webhooks and click Add New
   1. Enter your webhook endpoint URL
   2. Set the display name to Phoebe
   3. Click Test Connection
   4. Click Save
3. To send a message to the webhook:
   1. Go to https://console.cloud.google.com/monitoring/alerting
   2. Specify your webhook as one of the notification channels in an Alert policy

​

Grafana

1. In Grafana, navigate to Alerting > Contact points
2. Click Create contact point
   1. Enter Phoebe as the name
   2. Choose Webhook as the integration type
   3. Enter your webhook endpoint URL in the URL field
   4. Click Test, and ensure you get a success response
   5. Click Save contact point

​

Honeycomb

1. Go to Team Settings > Integrations
2. click Add Integration
   1. Choose Webhook as the provider type
   2. Set the name to Phoebe
   3. Enter your webhook URL in the URL field
   4. Enable Trigger Alerts, and enter the following template:
      Copy

      Ask AI

      {
         "alert_instance_id": {{ .Alert.InstanceID | quote }},
         "title": {{ .Name | quote }},
         "description": {{ .Alert.Description | quote }},
         "status": {{ .Alert.Status | quote }},
         "issue_url": {{ .URL | quote }},
         "timestamp": {{ .Alert.Timestamp | date "2006-01-02T15:04:05-07:00" | quote }}
      }
      

​

NewRelic

1. Follow the instructions at https://docs.newrelic.com/docs/alerts/get-notified/notification-integrations/#webhook
2. When configuring your webhook destination, use the following details for your webhook:
   1. Name: Phoebe
   2. URL: https://api.phoebe.ai/events/webhook/new_relic/
   3. Authorization: Bearer Token
   4. Bearer token: the key you were provided, starting wak_ (e.g. wak_abcd1234)
3. When configuring your webhook workflow, use the following template:
   Copy

   Ask AI

   {
       "issue_id": {{ json issueId }},
       "issue_url": {{ json issuePageUrl }},
       "title": {{ json annotations.title.[0] }},
       "description": {{ json annotations.description.[0] }},
       "priority": {{ json priority }},
       "impacted_entities": {{ json entitiesData.names }},
       "state": {{ json state }},
       "trigger": {{ json triggerEvent }},
       "created_at": {{ createdAt }},
       "updated_at": {{ updatedAt }},
       "closed_at": {{ closedAt }},
       "sources": {{ json accumulations.source }},
       "alert_policy_names": {{ json accumulations.policyName }},
       "alert_condition_names": {{ json accumulations.conditionName }},
       "workflow_name": {{ json workflowName }}
   }
   

​

PagerDuty

1. In PagerDuty, navigate to Integrations > Generic Webhooks (v3)
2. Click + New Webhook
3. Fill in the following fields:
   1. Webhook URL: Copy webhook URL value from https://app.phoebe.ai/integrations/PAGERDUTY/
   2. Scope: Select the desired scope.
      • For the Service scope type, select the specific Services you want to send webhooks for
   3. (Optional) Description: Enter a description if needed.
   4. Event Subscriptions:
   Copy

   Ask AI

       incident.triggered
       incident.acknowledged
       incident.resolved
   
4. Click Add Webhook

​

Sentry

1. In Sentry, Navigate to Settings > Integrations > Phoebe and click Install
2. You’ll be redirected to Phoebe to complete the installation process

1. In the “Perform these actions” section, click add action
2. Choose Send a notification via an integration
3. In the Send a notification via drop-down, choose Phoebe

​

incident.io

1. In Phoebe, navigate to Integrations > incident.io to generate your webhook URL
2. Go to Settings > Webhooks in your incident.io dashboard
3. Click Add Endpoint
4. Configure your endpoint:
   1. Enter the webhook URL you copied from Phoebe in the Endpoint URL field
   2. Under Subscribe to events, select the following event types:
      • public_incident.incident_created_v2 — triggers when a new incident is created
      • public_incident.incident_status_updated_v2 — triggers when an incident’s status changes
   3. Click Create