n8n-nodes-tela

This is an n8n community node that provides seamless integration with the Tela API. It allows you to interact with Tela projects and canvases in your n8n workflows, enabling dynamic content generation and workflow automation.

TL;DR

Don't want to read? Import the sample workflow "Tela Canvas Execution with Dynamic Variables" to test this node with real Tela API integration.

What This Node Does

The Tela node enables you to:

• Execute Tela Canvases: Run AI-powered canvases with dynamic variables and get results
• Dynamic Variable Handling: Automatically detect and configure canvas variables
• File Upload Support: Handle file uploads for canvas processing
• Project Management: List and manage Tela projects and their canvases
• Workflow Integration: Seamlessly integrate Tela AI workflows into your n8n automation

Installation

Community Nodes (Recommended)

1. Go to Settings > Community Nodes
2. Select Install
3. Enter @meistrari/n8n-nodes-tela as the package name
4. Agree to the risks of using community nodes
5. Select Install

Manual Installation

For self-hosted n8n instances:

npm install @meistrari/n8n-nodes-tela

For Docker installations, follow the custom nodes guide.

Configuration

1. Create Tela API Credentials

1. Create a new credential of type "Tela API"
2. Enter your Tela API key (find this in your Tela dashboard)
3. Test the connection to verify it works

2. Configure the Node

1. Project: Select the project containing your canvas
2. Canvas: Choose the specific canvas to execute
3. Variables: Configure dynamic fields based on your canvas configuration

Operations

Execute Canvas

The main operation that runs your Tela canvas with the specified variables and returns the AI-generated results.

Use Cases:

• Generate dynamic content for emails
• Create personalized marketing materials
• Process documents with AI assistance
• Generate reports based on input data

Node Reference

Credentials

Field	Description
API Key	Your Tela API key from your dashboard

Parameters

Field	Type	Required	Description
Project	Options	Yes	Select the project containing your canvas
Canvas	Options	Yes	Select the canvas to execute
Variables	Collection	No	Dynamic fields based on your canvas configuration

Usage Examples

Example 1: Basic Canvas Execution

Input Data:

{
  "customerName": "John Doe",
  "productType": "Premium Subscription",
  "monthlyAmount": 99.99
}

Canvas Variables:

• customer_name: John Doe
• product_type: Premium Subscription
• monthly_amount: 99.99

Result: AI-generated personalized content based on your canvas configuration.

Example 2: File Processing

Input Data:

{
  "document": "binary_file_data",
  "processingType": "summarize"
}

Canvas Variables:

• document: [File upload]
• processing_type: summarize

Result: AI-processed document with summary or analysis.

Example 3: Dynamic Content Generation

Input Data:

{
  "industry": "Technology",
  "companySize": "100-500 employees",
  "challenge": "Digital transformation"
}

Canvas Variables:

• industry: Technology
• company_size: 100-500 employees
• challenge: Digital transformation

Result: Tailored content addressing specific business challenges.

Sample Workflows

Workflow 1: Automated Customer Onboarding

1. Webhook receives new customer signup
2. Tela generates personalized welcome email
3. Send Email delivers the generated content

Workflow 2: Document Processing Pipeline

1. File Upload receives document
2. Tela processes and analyzes document
3. Database stores processed results
4. Notification sends completion alert

Workflow 3: Marketing Campaign Generator

1. CRM provides customer segments
2. Tela generates personalized campaigns
3. Marketing Platform deploys campaigns
4. Analytics tracks performance

Advanced Features

Dynamic Variable Detection

The node automatically detects canvas variables and their types:

• Text variables: Standard string inputs
• File variables: Automatic file upload handling
• Required fields: Clearly marked in the interface

Smart File Handling

• Supports multiple file formats
• Automatic MIME type detection
• Secure file upload to Tela servers
• Binary data processing from n8n workflows

Load Options

• Projects: Dynamically loads available projects
• Canvases: Loads canvases based on selected project
• Variables: Auto-populates variable fields based on canvas

Compatibility

• n8n Version: 0.174.0 or later
• Node.js: 18.0.0 or later
• npm: 8.0.0 or later
• Platforms: n8n Cloud, Self-hosted instances

Troubleshooting

Common Issues

1. API Key Invalid

   • Verify your Tela API key is correct
   • Check if the key has expired
   • Ensure proper permissions

2. Project Not Loading

   • Verify API key has access to projects
   • Check Tela API status
   • Refresh credentials

3. Canvas Execution Fails

   • Verify all required variables are set
   • Check canvas configuration in Tela
   • Review API response for error details

Error Messages

• Failed to load projects: Check API key and permissions
• Failed to load canvases: Verify project ID and access
• Failed to execute canvas: Review variable configuration

Resources

• n8n Community Nodes Documentation
• Tela API Documentation
• n8n Workflow Automation
• Community Support

Support

Getting Help

• GitHub Issues: Report bugs and request features
• n8n Community: Ask questions in the community
• Documentation: Check the comprehensive docs

Development

Local Development

# Clone the repository
git clone https://github.com/meistrari/n8n-nodes-tela.git
cd n8n-nodes-tela

# Install dependencies
npm install

# Build the project
npm run build

# Link locally for testing
npm link

Testing

# Run tests
npm test

# Build and test
npm run build && npm test

Changelog

Version 1.0.14

• Added credential test method to fix n8n verification pre-checks
• Fixed n8n verification pre-checks by restructuring project to match n8n-nodes-starter template
• Moved credentials and nodes to proper directories as required by n8n
• Enhanced README documentation for n8n verification compliance
• Added comprehensive usage examples and sample workflows
• Improved installation and configuration instructions
• Added troubleshooting guide and development documentation

Version 1.0.1

• Enhanced error handling
• Improved file upload support
• Better variable validation

Version 1.0.0

• Initial release
• Basic Tela API integration
• Dynamic variable support

License

MIT