Webhooks & Slack

Business plans can push audit events to your HTTPS endpoint or a Slack incoming webhook.

Setup

Add endpoints in Dashboard → Integrations. The webhook signing secret is shown once when you create an endpoint.

  1. Add a webhook URL (HTTPS required)
  2. Copy the signing secret immediately
  3. Verify X-WPAQ-Signature on every incoming request

Event payload

WPAQ POSTs JSON when an audit reaches a terminal state. A new endpoint subscribes to scan.completed unless you pass events. Delivery is one attempt, an 8 second timeout, and no retry. You can also manage endpoints with the REST API or the MCP server. Both require Business.

EventWhen
scan.completedSite Audit finished. Failed and blocked Site Audits do not send an event.
visibility.completed visibility.failed visibility.blockedAI Visibility Audit, once.
conversion.completed conversion.failed conversion.blockedConversion Audit, once.
quality.completed quality.failed quality.blockedContent Quality Audit, once.
scan.completed
{
  "event": "scan.completed",
  "data": {
    "scan_id": "abc123",
    "hostname": "example.com",
    "overall_score": 91,
    "report_url": "https://wpaq.com/site-audit/abc123",
    "audit_type": "scan",
    "audit_id": "abc123",
    "website": "example.com",
    "status": "completed",
    "score": 91,
    "api_url": "https://wpaq.com/api/v1/site-audits/abc123"
  },
  "sent_at": "2026-08-31T12:00:00+00:00"
}
visibility.completed
{
  "event": "visibility.completed",
  "data": {
    "audit_type": "visibility",
    "audit_id": "vis_example",
    "website": "example.com",
    "status": "completed",
    "score": 78,
    "report_url": "https://wpaq.com/visibility-audit/vis_example",
    "api_url": "https://wpaq.com/api/v1/ai-visibility-audits/vis_example"
  },
  "sent_at": "2026-08-31T12:00:00+00:00"
}

Conversion and Content Quality use the same data fields with audit_type conversion or quality, and report paths /conversion-audit/ and /quality-audit/. Failed and blocked events set status to match and may send score: null.

Request headers:

X-WPAQ-Event
Event name, e.g. scan.completed
X-WPAQ-Signature
HMAC-SHA256 of the raw request body, prefixed with sha256=

Delivery is best-effort, not at-least-once: each event is sent once with an 8-second timeout and no automatic retry. If your endpoint is down or slow, that delivery is lost — poll GET /api/v1/site-audits/{id} from the REST API as a reconciliation fallback for anything you can't afford to miss. Endpoints must resolve to a public HTTPS host — requests to private/internal addresses are blocked before they're sent.

Verify signatures

Reject requests when the signature does not match. Use constant-time comparison in production.

Python
import hmac, hashlib

def verify(body: bytes, secret: str, header: str) -> bool:
    expected = "sha256=" + hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, header)
OpenSSL (shell)
# BODY = raw request body bytes
# SECRET = signing secret from Integrations

python3 - <<'PY'
import hmac, hashlib, os
body = os.environ["BODY"].encode()
secret = os.environ["SECRET"].encode()
print("sha256=" + hmac.new(secret, body, hashlib.sha256).hexdigest())
PY

Slack alerts

Paste a Slack incoming webhook URL in Integrations. WPAQ posts a short message when Site Audits complete or when monitored sites change health.

  • Slack URLs are stored on your account — treat them like passwords.
  • They are not re-displayed after you save them.
  • Remove a connection anytime from Dashboard → Integrations.
  • Messages are plain text summaries, not signed payloads.

Open the report

Each payload includes report_url — a direct link to the Site Audit report. Recipients need to be signed in to the owning account unless you have shared the report separately with a share link (Pro and Business).

Webhooks · Support · WPAQ.com