Cookbook: Send alerts to Slack

Goal: when a tracking campaign raises an alert (a big ranking drop, a new competitor ad, a visibility change), have it appear in a Slack channel automatically.

Tip

Slack is now a built-in alert channel: connect your workspace under Settings → Alerts & channels and pick a channel, no relay needed. See Alert Channels. This recipe still fits plans without alert channels, or when you want to reshape the message yourself.

You’ll need

• A campaign with alerts enabled — SERP Position Tracker, Ads Position Tracker, AI Visibility, Maps Visibility or Marketplace.
• A place to run a tiny relay — a serverless function (Cloudflare Workers, Vercel, AWS Lambda) or any small always-on endpoint.
• A Slack incoming webhook URL for the target channel.

Why a relay?

iSearchFrom delivers alerts as its own JSON payload (below). Slack’s incoming webhooks expect Slack’s format. A relay is a ~15-line function that receives iSearchFrom’s payload and reposts it to Slack as a readable message. It also keeps your Slack webhook URL private.

The payload iSearchFrom sends

When an alert fires, iSearchFrom POSTs this to your campaign’s webhook URL:

{
  "event": "tool.alert.created",
  "timestamp": "2026-07-07T14:05:00.000Z",
  "data": {
    "alertId": "…",
    "targetType": "serp_position_campaigns",
    "campaignId": "…",
    "campaignName": "Brand keywords — US",
    "type": "…",
    "severity": "…",
    "metadata": { "…": "…" }
  }
}

Delivery behavior

iSearchFrom makes 4 attempts in all, waiting about 5s, 10s and 20s between them, so a relay that is down for more than about half a minute misses the alert. A 4xx other than 408 or 429, or a redirect, is not retried. Make your relay idempotent on data.alertId if duplicate posts would bother you, and return a 2xx quickly.

Steps

Create the relay

This Cloudflare Worker receives iSearchFrom’s payload and forwards a formatted message to Slack. The Slack webhook URL is stored as a secret, never exposed to iSearchFrom.

export default {
  async fetch(request, env) {
    if (request.method !== 'POST') return new Response('ok');
    const { event, data } = await request.json();
    if (event !== 'tool.alert.created') return new Response('ignored');

    const text =
      `:rotating_light: *${data.severity ?? 'alert'}* on *${data.campaignName}*\n` +
      `Type: ${data.type} · Campaign: \`${data.campaignId}\``;

    await fetch(env.SLACK_WEBHOOK_URL, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ text })
    });
    return new Response('ok'); // 2xx tells iSearchFrom the delivery succeeded
  }
};

Deploy it and set the Slack webhook as a secret:

wrangler secret put SLACK_WEBHOOK_URL   # paste your Slack incoming-webhook URL
wrangler deploy

You’ll get a public relay URL like https://serp-alerts.your-workers.dev.

Point the campaign at the relay

Enable alerts on the campaign and set its alert webhook URL to your relay URL — in the app’s campaign alert settings, or via the campaign’s alertSettings when you create/update it through the API. See Schedules & alerts.

Trigger a test

Cause an alert (or wait for the next run to raise one). iSearchFrom posts to your relay, which forwards to Slack.

Verify

• A message appears in your Slack channel when an alert fires.
• Your relay logs show a POST with event: "tool.alert.created" and returns 2xx.
• If nothing arrives: confirm the campaign has at least four completed runs and the alert type is switched on, the webhook URL is correct and reachable, and your relay returns 2xx (5xx, 408, 429 or a timeout trigger retries, then the alert is given up; any other 4xx gives up at once).

Variations

• Rich Slack formatting — swap the { text } body for Slack Block Kit to include the metadata fields and a link back to the campaign.
• Other destinations — the same relay pattern forwards to Microsoft Teams, Discord, PagerDuty, or an internal endpoint; just change the outbound fetch.
• Filter noise — have the relay drop low-severity alerts or de-duplicate on alertId.

Related

Schedules & alertsEnabling alerts and setting thresholds.

WebhooksThe alert webhook contract in the reference.

AI Visibility alertsAlerts for AI-visibility campaigns.