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.
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.

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
Declare it in connections/connections.py
connections/connections.py from segmentstream_connections import TurnstileConnection connections = ( TurnstileConnection(key="turnstile"),) - 2
Deploy
$ segmentstream deploy - 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.
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
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 worksConnect what your company runs.
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