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

The "Update Typebot" operation in this node allows users to modify an existing chatbot (typebot) configuration hosted on the Typebot.io platform. This includes updating the typebot's name, icon, and its entire JSON configuration. It is useful for maintaining and evolving chatbots without recreating them from scratch.

Common scenarios include:

  • Changing the chatbot's display name or icon to reflect branding updates.
  • Updating the chatbot's flow or behavior by importing a new JSON configuration.
  • Making incremental improvements or fixes to an existing chatbot setup.

Practical example:

  • A marketing team wants to update their customer support chatbot with new conversation flows and a refreshed icon. They use this node to patch the existing typebot by providing the updated JSON configuration and icon URL.

Properties

Name Meaning
Typebot ID The unique identifier of the typebot to update.
Additional Fields Collection of optional fields to customize the update:
- Stream Enabled Enable streaming for real-time responses (boolean).
- Prefilled Variables Variables to prefill in the typebot; each variable has a name and value.
- Result ID Existing result ID to continue a conversation (string).
- Theme Custom theme configuration as JSON string.
- Settings Custom settings as JSON string.
- Icon Typebot icon, either an emoji or a URL string.
- Typebot JSON Full typebot configuration as JSON string for import/update.
- Export Format Format for exporting results (CSV, JSON, Excel) — not directly relevant for update but part of additional fields.
- Filename Custom filename for file uploads (not directly relevant here).
- File Size Limit MB File size limit in megabytes for uploads (not directly relevant here).

Output

The node outputs a JSON object representing the response from the Typebot API after attempting to update the typebot. This typically includes details about the updated typebot such as its ID, name, icon, and configuration status.

If the update fails, the output JSON will contain an error message describing the issue.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Typebot.io API.
  • Needs the base API URL and an authentication token configured in the node credentials.
  • The workspace ID is used internally to scope the update request.
  • The node sends HTTP requests to the Typebot API endpoints via a proxy service.

Troubleshooting

  • Error: Unknown typebot operation
    Occurs if an unsupported operation is specified. Ensure the operation is set to "updateTypebot".

  • Invalid JSON in Typebot JSON field
    If the provided JSON configuration is malformed, the API will reject the update. Validate JSON syntax before input.

  • Authentication errors
    If API keys or tokens are missing or invalid, the request will fail. Verify credentials are correctly set up.

  • Missing required parameters
    The "Typebot ID" is mandatory. Omitting it will cause errors.

  • API rate limits or network issues
    May cause request failures. Check network connectivity and API usage limits.

Links and References

Discussion