N8N Tools - Typebot API icon

N8N Tools - Typebot API

Complete Typebot.io integration - Self-hosted chatbot builder with visual flows
Join our community

Actions23

Overview

This node integrates with the Typebot.io API to manage and export chatbot conversation results. Specifically, the Export Results operation under the Result resource allows users to export conversation data from a specified Typebot in various formats such as CSV, JSON, or Excel. This is useful for analyzing chatbot interactions, generating reports, or archiving conversation data.

Practical scenarios include:

  • Exporting all user conversations for offline analysis.
  • Generating CSV or Excel files for sharing chatbot performance metrics with stakeholders.
  • Archiving conversation results periodically for compliance or backup purposes.

Properties

Name Meaning
Typebot ID The unique identifier of the Typebot whose results you want to export.
Additional Fields A collection of optional fields to customize the export:
- Export Format Format of the exported file. Options: CSV, JSON, Excel (XLSX).
- Filename Custom filename for the exported file (optional).
- File Size Limit MB Maximum allowed file size in megabytes (optional, default 10 MB).

Output

The node outputs a JSON object containing the response from the Typebot API export endpoint. This typically includes metadata about the exported file or a direct link to download it, depending on the API's response structure.

If the export involves file data, the output may contain references or URLs to the exported file rather than raw binary data within the node output.

Dependencies

  • Requires an API key credential for authenticating with the Typebot.io API.
  • Needs the base URL and authentication token configured in the node credentials.
  • The node sends requests to the Typebot API via a proxy service hosted at https://n8ntools.io/api/v1/proxy/typebot using an additional API key for that proxy.

Troubleshooting

  • Common issues:

    • Invalid or missing Typebot ID will cause the API call to fail.
    • Incorrect export format values may result in errors; ensure one of the supported options (csv, json, xlsx) is selected.
    • Network or authentication failures if API keys or tokens are misconfigured.

  • Error messages:

    • "Unknown result operation: exportResults" indicates the operation name was misspelled or not supported.
    • Authorization errors suggest invalid or expired API tokens.
    • File size limit exceeded errors if the export exceeds the configured maximum size.

  • Resolutions:

    • Double-check the Typebot ID and ensure it exists.
    • Verify API credentials and permissions.
    • Adjust the file size limit or filter data to reduce export size.

Links and References

Discussion