Actions23
- Typebot Actions
- Chat Actions
- Result Actions
- Workspace Actions
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 results 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.
Typical use cases include:
- Exporting all conversation results of a chatbot for offline analysis.
- Generating CSV or Excel files for sharing with stakeholders.
- Automating data extraction workflows that involve chatbot interaction logs.
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 to export results: CSV, JSON, or Excel (XLSX). |
| - Filename | Custom filename for the exported file (optional). |
| - File Size Limit MB | Maximum allowed file size in megabytes for uploads (default 10 MB; relevant if uploading). |
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 the exported results in the requested format.
If the export involves file downloads, the output may contain URLs or references to the exported file. The node does not directly output binary data but provides access information to the exported content.
Dependencies
- Requires an API key credential for authenticating with the Typebot.io API.
- Needs proper configuration of the API URL and authentication token within the node credentials.
- The node sends requests through a proxy service hosted at
https://n8ntools.io/api/v1/proxy/typebotwhich requires 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 or unexpected output.
- Network or authentication failures due to invalid API keys or tokens.
- Large exports might exceed file size limits or timeout.
Error messages:
"Unknown result operation": Indicates an unsupported operation was selected.- API authorization errors: Check that the API token and proxy API key are correctly configured.
- JSON parsing errors on custom fields: Ensure JSON inputs like theme or settings are valid JSON strings.
Resolutions:
- Verify all required parameters are set and valid.
- Confirm API credentials and permissions.
- Use supported export formats only.
- For large datasets, consider increasing file size limits or splitting exports.