Built in

Cloudflare Turnstile

Cloudflare Turnstile's bot check for the agent's chat on your website: every new visitor passes the challenge before the agent answers them. The connection holds the widget's secret key, which only SegmentStream reads, to check each challenge with Cloudflare.

Inside SegmentStream

Connected once, used everywhere.

Connections are declared in your repository and authorised in the console. The credentials stay with the platform; apps, pipelines, workflows and the agent use them under the same roles.

segmentstream.com
The console's connections page: the 43 connections declared in our workspace's code, here the public reference lists of AI and search crawlers, each connected, with the key it is declared under
Connections declared in code and authorised here. The credentials stay with the platform, never in the repository.

What the connection reaches

  • The bot check of the agent's website guests
  • Checked by SegmentStream; the website and workspace code never hold the secret key
  • Nothing to call: the connection makes no requests
Status
Built into the pipeline SDK
Connection class
TurnstileConnection
Credential
Secret key of a Turnstile widget

Connect Cloudflare Turnstile

Three steps, the same for every connection. The credential goes to the platform, never into the repository or pipeline code.

  1. 1

    Declare it in connections/connections.py

    connections/connections.py
    from segmentstream_connections import TurnstileConnection connections = (    TurnstileConnection(key="turnstile"),)
  2. 2

    Deploy

    $ segmentstream deploy
  3. 3

    Connect

    Paste the widget's secret key (Cloudflare > Turnstile > your widget) into the connection in the console, or configure it from the terminal with a hidden prompt. API-key connections need no authorisation step: once the value is set, the connection is connected.

    $ segmentstream connection configure turnstile

Use it

Code asks for the connection by its key. The platform adds the credential on the way out.

ontology/index.ts
import { connection, defineOntology } from "@segmentstream/ontology"; const turnstile = connection("turnstile", { description: "The website chat's bot check." }); export default defineOntology({  connections: [turnstile],  guest: {    channels: ["web"],    origins: ["https://www.example.com"],    botCheck: { scheme: "turnstile", connection: turnstile, input: "secret_key" },  },});

Or ask your agent

“Ask every new visitor of our website's chat to pass a bot check first.”

Part of these solutions

More in Product & engineering

Enterprise pilot

Want Cloudflare Turnstile set up for you?

Our forward-deployed engineers build one solution on your data, in your own workspace, as code you own. Tell us what you run today and what you want; your note goes straight to our founder.

  • One solution, on your data, in your own workspace
  • First version live in two weeks
  • Parity proven before anything is switched off
  • Fixed scope and price, credited to your contract if you continue

Not ready for a pilot? Send the form anyway with your question. An engineer will reply, not a sales rep.

How the pilot works

Goes to our founder’s inbox. No sales queue, no newsletter.

Connect what your company runs.

Start a pilot

Our engineers build the first version on your data in two weeks, at a fixed price.

Or build it yourself with your coding agent:

curl -fsSL https://segmentstream.com/install.sh | sh

We’ll email you product updates, tips and onboarding help. Unsubscribe anytime.