> ## Documentation Index
> Fetch the complete documentation index at: https://docs.knoxcall.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration Setup Guides

> Step-by-step guides for every card on the Settings → Integrations page — which scope each credential is read from, what to create at the provider, exactly what to paste into KnoxCall, and how to prove it works.

# Integration Setup Guides

**Settings → Integrations** is where KnoxCall is given the credentials it needs to talk to other services: the email provider that sends invitations, the Twilio account behind SMS alerts, the OAuth apps behind "Continue with Google", the collector your telemetry ships to. Every card opens a detail view, and the book icon next to its title brings you to the guide for that card on this site.

Each guide follows the same shape: what the integration powers, what to create on the provider's side (with least-privilege permissions), the exact fields to fill in on the KnoxCall form, how to verify it worked, and the things that bite.

## Two scopes

The page has a scope switch, visible to workspace admins:

| Scope               | What it is                                                                                                                                                                                                                                   | Who uses it                    |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| **This tenant**     | Credentials that belong to your workspace. They override the platform default for anything KnoxCall does *for your workspace*.                                                                                                               | Every workspace admin.         |
| **Global defaults** | The platform-wide credentials, used when no workspace override applies. On KnoxCall Cloud these are KnoxCall's own. On a self-hosted deployment they are **yours** — the operator is the admin, and this is where platform-level cards live. | Admins; self-hosted operators. |

Some cards only appear under **Global defaults** because they have no per-workspace meaning (the CAPTCHA on the login page, the gateway-wide OpenTelemetry export). Others are read at platform scope even though the card is offered under both; each guide says which. If you self-host and a card "does nothing", the first thing to check is the scope you saved it under.

<Note>
  **How credentials are stored.** Secret fields are envelope-encrypted with a key that is itself encrypted at rest, and are never sent back to the browser — once saved, the form shows masked dots and *leave blank to keep current*. Non-secret fields (a region, a from-address, an endpoint) are stored as plain metadata and shown on the list. The form refuses to store anything credential-shaped in a non-secret field.
</Note>

<Note>
  **Environment variables.** A self-hosted deployment can also supply most of these credentials as environment variables. For most integrations a **stored row wins** over the variable and the variable is only a fallback when no row exists — so deleting a row does not switch a feature off on a host that still carries the variable. Two integrations invert this: for the OpenTelemetry export and the Sentry DSNs, **the environment wins**. Each guide states the rule for its card.
</Note>

## The guides

### Sign-in

<CardGroup cols={2}>
  <Card title="OAuth sign-in methods" icon="key-round" href="/integrations/setup/oauth-sign-in">
    How the three providers share one redirect URI, what scopes are requested, and when you need your own apps.
  </Card>

  <Card title="Google" icon="chrome" href="/integrations/setup/oauth-google">
    Consent screen, OAuth client ID, redirect URI.
  </Card>

  <Card title="Microsoft Entra ID" icon="building" href="/integrations/setup/oauth-microsoft">
    App registration, client secret, and the allowed-directory list that keeps other tenants out.
  </Card>

  <Card title="GitHub" icon="github" href="/integrations/setup/oauth-github">
    An organization-owned OAuth App with one callback URL.
  </Card>
</CardGroup>

### Email, SMS and push

<CardGroup cols={2}>
  <Card title="Email" icon="mail" href="/integrations/setup/email">
    Resend, SendGrid, Postmark, Mailgun, Amazon SES or any SMTP host — the transport behind every platform email.
  </Card>

  <Card title="Twilio" icon="message-square" href="/integrations/setup/twilio">
    SMS alerts and the Verify service that proves a phone number before it can receive them.
  </Card>

  <Card title="Operator push" icon="bell" href="/integrations/setup/operator-push">
    ntfy, Telegram or Pushover, for the assistant's hand-offs to a human.
  </Card>
</CardGroup>

### AI

<CardGroup cols={2}>
  <Card title="Anthropic" icon="sparkles" href="/integrations/setup/anthropic">
    Your workspace's own key for anomaly analysis, spec analysis and the workflow copilot.
  </Card>

  <Card title="OpenAI" icon="bot" href="/integrations/setup/openai">
    The fallback provider for anomaly and spec analysis.
  </Card>

  <Card title="Presidio PII analyzer" icon="shield-check" href="/integrations/setup/presidio">
    Point the AI Gateway at your own named-entity analyzer.
  </Card>
</CardGroup>

### Observability

<CardGroup cols={2}>
  <Card title="OpenTelemetry export" icon="activity" href="/integrations/setup/opentelemetry">
    Ship the whole gateway's traces, logs and metrics to Grafana Cloud, Datadog, Honeycomb, New Relic, SigNoz, Elastic, or your own collector.
  </Card>

  <Card title="Telemetry export (per workspace)" icon="radio" href="/integrations/setup/telemetry-export">
    Only your workspace's request logs and metrics, to your own collector or SIEM.
  </Card>

  <Card title="Error tracking (Sentry)" icon="bug" href="/integrations/setup/sentry">
    Browser, backend and console DSNs, plus the org token for the issues feed.
  </Card>
</CardGroup>

### Storage and cloud

<CardGroup cols={2}>
  <Card title="S3" icon="database" href="/integrations/setup/s3">
    Request and response body archival on S3, R2 or MinIO.
  </Card>

  <Card title="DigitalOcean" icon="server" href="/integrations/setup/digitalocean">
    The API token behind static-IP egress servers.
  </Card>

  <Card title="AWS operator identity (BYOK)" icon="cloud" href="/integrations/setup/aws-operator-identity">
    The IAM identity that assumes customer KMS roles.
  </Card>
</CardGroup>

### Security and anti-abuse

<CardGroup cols={2}>
  <Card title="Cloudflare Turnstile" icon="shield" href="/integrations/setup/turnstile">
    The CAPTCHA on the login page.
  </Card>
</CardGroup>

### Platform operator

These back services the KnoxCall operator runs around the product. On a self-hosted deployment you can leave them unconfigured unless you run the same service yourself.

<CardGroup cols={2}>
  <Card title="Chatwoot" icon="message-circle" href="/integrations/setup/chatwoot">
    The support widget and assistant messages.
  </Card>

  <Card title="Google Places" icon="map-pin" href="/integrations/setup/google-places">
    Address autocomplete on signup and address forms.
  </Card>

  <Card title="Google Analytics (GA4)" icon="chart-line" href="/integrations/setup/google-analytics">
    Service-account read access for the console's web-analytics page.
  </Card>

  <Card title="Microsoft Clarity" icon="mouse-pointer-click" href="/integrations/setup/clarity">
    The data-export token for the console's insights card.
  </Card>

  <Card title="Status page" icon="signal" href="/integrations/setup/status-page">
    The admin token for the status-page Worker.
  </Card>

  <Card title="Migration signing key" icon="file-key" href="/integrations/setup/migration-signing-key">
    The RSA key behind cross-cloud Workload Identity Federation.
  </Card>
</CardGroup>

## Related

* [Self-hosted proxy — local integrations](/infrastructure/self-hosted-proxy#local-integrations) — the minimum a self-hosted deployment needs
* [Automation platforms](/integrations/overview) — Zapier, Make and n8n connectors (a different kind of integration: they call KnoxCall, rather than KnoxCall calling them)
