Skip to main content
Please find more details on the Alert Investigation here.

​
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

Phoebe webhook URLs look like this: 
https://app.phoebe.ai/events/webhook/[PROVIDER]/
For example: 
https://app.phoebe.ai/events/webhook/grafana/
For each URL, you’ll also be given an access token. You can use the access token in one of two ways, depending on the platform you’re sending alerts from:

​
Query parameter

Set the access token in a query parameter called key: 
https://app.phoebe.ai/events/webhook/grafana/?key=wak_myAccessToken

​
Bearer token

Set the access token in an Authorization header, using the Bearer scheme: 
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 
      {
  "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://app.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: 
    {
    "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: 
      {
   "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://app.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: 
    {
    "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:
        incident.triggered
    incident.acknowledged
    incident.resolved
  4. Click Add Webhook

​
Sentry

This integration requires Owner access to your Sentry organization.
Setup
  1. In Phoebe, navigate to Integrations > Sentry to generate your webhook URL
  2. In Sentry, go to Settings → Developer Settings → Custom Integrations
  3. Click Create New Integration and configure:
    • Name: Enter a descriptive name (e.g., “Phoebe AI Integration”)
    • Webhook URL: Enter the URL from step 1 (format: https://app.phoebe.ai/events/webhook/sentry/?key=YOUR_API_KEY)
    • Alert Rule Action: Enable this toggle
    • Leave Schema, Overview, and Authorized JavaScript Origins as defaults
  4. In the Webhooks section, enable:
    • issue — issue created, resolved, assigned, archived, unresolved
    • error — new errors created
    • comment — comments created, edited, deleted
  5. Click Save Changes
  6. Verify by checking the Phoebe alerts dashboard or triggering a test event in Sentry
Configuring which alerts Phoebe investigates Phoebe only automatically investigates IssueAlerts and MetricAlerts. Control which alerts Phoebe receives by configuring individual alert rules in Sentry: when creating or editing an alert rule, use the Send a notification via dropdown and select your Phoebe integration.
If events aren’t appearing in Phoebe AI, confirm your API key is correct in the Webhook URL, verify the required webhook event types are enabled, and check that your Phoebe AI account is active.