Skip to content
Nappai Documentation

TypeForm Webhook

This component acts as a secure listener that automatically captures responses whenever someone fills out a form in Typeform. It serves as the entry point for your automation workflows, taking the raw data sent by Typeform and making it ready for further processing, analysis, or storage.

How it Works

This component creates a secure bridge between Typeform and your Nappai workflow. It operates in the background, waiting for new form submissions. When a user completes a form in Typeform, the platform sends the response data to a unique URL provided by this component.

Upon receiving the data, the component performs a quick security check to ensure the request is legitimate and comes from Typeform. Once validated, it extracts the form answers and structures them into a clear message. You can then use this message in your workflow to trigger actions, analyze data with AI, or save information to a database.

Connection & Credentials

This component requires configuring a credential in the Nappai panel before interacting with the external service:

  1. Go to the Credentials section in your Nappai panel.
  2. Create a new credential of the type Typeform API and fill in the required fields. You will need a Typeform Integration Token (password) which you can generate in your Typeform account settings.
  3. In your workflow, select the saved credential in the Credential input field of this node.

Inputs

The following fields are available to configure this component. Each field may be visible in different operations:

  • Webhook Secret: A private authentication key that ensures only valid requests from Typeform are processed. This key helps keep your webhook secure and prevents unauthorized access.

    • Visible in: All operations

  • Form ID: The unique identifier of the specific Typeform form you want to monitor. This tells the component which form’s responses to capture.

    • Visible in: All operations

  • Webhook URL: The specific endpoint URL generated by the component. You must copy this URL and paste it into your Typeform account to enable the connection.

    • Visible in: All operations

Outputs

Output Data Example

When the component successfully receives a form response, it outputs structured data in the following format: json { “answers”: [ { “id”: “your_name”, “answer”: “Juan Pérez” }, { “id”: “email_address”, “answer”: “juan@example.com” }, { “id”: “satisfaction_rating”, “answer”: 5 } ], “token”: “abc123def456”, “form”: { “title”: “Customer Feedback Form”, “id”: “form_uid_here” }, “submitted_at”: “2023-10-27T10:30:00Z” }

  • Response Form: Returns the processed form data as a structured message. This output contains all the answers and metadata from the submitted form, ready to be used by subsequent components like AI analysis, databases, or notifications.

Connectivity

This component is typically used at the beginning of a workflow to ingest external data. You should connect the Response Form output to:

  • AI Analysis Components: To interpret form answers, summarize feedback, or extract key insights.
  • Database Nodes: To save form responses permanently to a storage system.
  • Notification Components: To alert your team or trigger actions based on specific form answers.
  • Logic Branches: To route data differently depending on the content of the form responses.

Usage Example

Imagine you have a “Customer Feedback” form in Typeform and want to automatically analyze sentiment and save high-priority feedback.

  1. Drag the TypeForm Webhook component into your workflow.
  2. Configure the Credential with your Typeform Integration Token.
  3. Enter the Form ID for your customer feedback form.
  4. Copy the Webhook URL and paste it into the webhook settings of your Typeform form.
  5. Connect the Response Form output to an AI Chat component to analyze the sentiment of the answers.
  6. Connect the AI output to a Database node to save detailed feedback for your reports.

Tips and Best Practices

  • Exact Form ID: Ensure the Form ID matches the exact identifier from Typeform. An incorrect ID will prevent the webhook from receiving data.
  • Secure Your Secret: Keep the Webhook Secret confidential. Share it only within trusted systems to maintain the security of your automation.
  • Test First: Use a dummy form in Typeform during testing to ensure the webhook connection is working before relying on it in production.
  • Development Mode: This component includes features optimized for development. During testing, you may see detailed logs that can help you debug connections.

Security Considerations

  • Webhook Authentication: Always configure the Webhook Secret to validate incoming requests. This prevents unauthorized parties from sending fake data to your workflow.
  • Token Management: Store your Typeform Integration Token securely in the Nappai credentials manager. Never share tokens in plain text or expose them in public workflows.
  • Data Validation: The component automatically validates that data comes from Typeform, but it is good practice to verify critical information before processing or storing it.