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, specifically focusing on managing conversation results when using the "Result" resource. The "Delete Result" operation allows users to delete a specific conversation result from a typebot. This is useful for cleaning up old or unwanted conversation data, maintaining privacy, or managing storage.

Practical scenarios include:

  • Automatically deleting conversation results after processing them elsewhere.
  • Removing test or erroneous conversation data.
  • Managing data retention policies by programmatically deleting results.

Properties

Name Meaning
Result ID The unique identifier of the conversation result to delete.
Additional Fields A collection of optional fields (not typically used for delete operation).

Note: For the "Delete Result" operation, only the Result ID is required and relevant.

Output

The node outputs a JSON object representing the response from the Typebot API after attempting to delete the specified result. Typically, this will confirm successful deletion or provide error details if the operation failed.

Example output structure:

{
  "json": {
    // API response confirming deletion or error message
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Typebot API.
  • Needs configuration of the Typebot API URL and authentication token within n8n credentials.
  • The node sends HTTP requests to the Typebot API endpoints to perform operations.

Troubleshooting

  • Common issues:

    • Invalid or missing Result ID: The API will reject requests without a valid result identifier.
    • Authentication errors: Ensure the API key and token are correctly configured.
    • Network or endpoint errors: Verify the API URL and network connectivity.

  • Error messages:

    • "Unknown result operation: deleteResult": Indicates a misconfiguration in the operation parameter; ensure "Delete Result" is selected.
    • API errors returned in the JSON response will be passed through; check the message for details.

  • Resolution tips:

    • Double-check the Result ID value.
    • Confirm that the API credentials have sufficient permissions.
    • Use the "Continue On Fail" option in the node settings to handle errors gracefully during batch operations.

Links and References

Discussion