Skip to main content

Documentation Index

Fetch the complete documentation index at: https://closedloop.sh/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Typeform Integration

Connect Typeform to ClosedLoop AI and survey responses become scored product intelligence the moment they’re submitted. NPS scores, open-ended responses, and structured answers are analyzed in real-time, enriched with CRM context, and merged with intelligence from all your other sources.

​
What Gets Imported

DataDescription
Form responsesAll answer types (text, choice, rating, email, etc.)
Customer infoIdentified via hidden fields (customer_id, email, name)
Form metadataForm ID, submission timestamp, response token
VariablesProgrammatic data passed via Typeform variables
Use Typeform’s hidden fields to pass customer identification (email, customer ID, name) with each response. This enables ClosedLoop AI to attribute responses to specific customer accounts.

​
Connection Method

Typeform uses webhook-based data delivery. You configure a webhook in Typeform that sends responses to ClosedLoop AI’s webhook endpoint. Responses are verified using HMAC-SHA256 signatures.

​
Setup Guide

  1. In ClosedLoop AI, go to Settings → API Keys
  2. Generate a new Webhook Key
  3. Copy the secret — you’ll need it in the next step
  1. Open your form in Typeform
  2. Go to Connect → Webhooks
  3. Click Add a webhook
  4. Set the Destination URL to: 
    https://mcp.closedloop.sh/webhooks/surveys/typeform
  5. Set the Secret to your ClosedLoop AI webhook secret
  6. Toggle the webhook On
  7. Click Send test request to verify the connection

​
Webhook Verification

Typeform signs webhook payloads using HMAC-SHA256 with base64 encoding. ClosedLoop AI verifies every incoming webhook:
  1. Typeform sends the signature in the typeform-signature header
  2. ClosedLoop AI computes the expected signature using your webhook secret
  3. Signatures are compared using timing-safe comparison to prevent timing attacks
  4. Requests with invalid signatures are rejected with a 401 status

​
Supported Answer Types

ClosedLoop AI processes all Typeform answer types:
TypeExample
Text / Long textOpen-ended responses
Choice / Multiple choiceSingle or multi-select answers
Rating / Opinion scaleNPS scores, satisfaction ratings
EmailRespondent email address
NumberNumeric responses
DateDate selections
Yes/NoBoolean answers
File uploadUploaded file URLs
PaymentPayment information

​
Configuration

  • Real-time delivery — Responses arrive within seconds of submission
  • Test mode — Typeform test webhooks are acknowledged but not processed
  • No polling required — Webhook-based, so there’s nothing to configure for sync timing

​
What to Expect

Once configured, ClosedLoop AI will:
  1. Receive responses in real-time as customers submit your Typeform
  2. Extract customer identity from hidden fields and variables
  3. Analyze with AI — extract product insights, scored by business impact
  4. Surface intelligence in your dashboard and via MCP alongside all your other sources

View Webhook Docs

Learn more about webhook authentication and payload formats