n8n-nodes-caplena

This is an n8n community node that lets you use Caplena in your n8n workflows.

Caplena is an AI-powered text analytics platform that helps you analyze customer feedback, survey responses, product reviews, and other text data at scale.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes (Recommended)

1. Open n8n
2. Go to Settings > Community Nodes
3. Select Install
4. Enter n8n-nodes-caplena in the npm package name
5. Click Install

Manual Installation

To get started, install the package in your n8n root directory:

npm install n8n-nodes-caplena

For Docker users:

docker exec -it <container_name> npm install n8n-nodes-caplena
docker restart <container_name>

Operations

Caplena Node (Actions)

Project Operations

• Create - Create a new project
• Get - Retrieve a specific project
• Get Many - List all projects
• Update - Update project details
• Delete - Delete a project

Row Operations

• Create - Add text data (feedback, reviews, etc.) to a project
• Get - Retrieve a specific row
• Get Many - List all rows in a project
• Update - Update row content
• Delete - Delete a row

Question Operations

• Get - Retrieve analysis results for a specific question
• Get Many - List all questions and analysis for a project

Caplena Trigger (Automated Workflows)

The trigger node automatically starts your workflow when:

• New Project - A new project is created
• New Row - New text data is added to a project
• Updated Project - A project is modified

Credentials

To use this node, you need:

1. A Caplena account
2. A Caplena API key

How to Get Your API Key

1. Log in to your Caplena account
2. Go to Settings (top right)
3. Navigate to API section
4. Copy your API key or generate a new one

Setting Up Credentials in n8n

1. In n8n, go to Credentials menu
2. Click Add Credential
3. Search for "Caplena API"
4. Enter your API key
5. Click Save

Compatibility

• n8n version: 1.0.0 or higher
• Caplena API: v2

Usage

Example 1: Analyze Survey Responses

1. Google Sheets Trigger (new responses)
2. Caplena - Create Project
3. Loop through responses
4. Caplena - Create Row (for each response)
5. Wait 5 minutes (for analysis)
6. Caplena - Get Questions (retrieve analysis)
7. Google Sheets - Write results

Example 2: Automated Feedback Processing

1. Caplena Trigger - New Row
2. Caplena - Get Questions
3. IF - Check sentiment
4. Slack - Send alert (if negative)
5. Database - Store analysis

Example 3: Monitor Customer Feedback

1. Schedule Trigger (daily)
2. CRM - Get new feedback
3. Caplena - Create Rows
4. Caplena - Get Analysis
5. Dashboard - Update metrics
6. Email - Send daily report

Features

✅ Full CRUD Operations - Complete control over projects and data
✅ Automated Triggers - React to new data automatically
✅ Pagination Support - Handle large datasets efficiently
✅ Error Handling - Graceful error management
✅ Type Safety - Full TypeScript implementation
✅ Metadata Support - Track custom fields with auxiliary columns

Resources

• Caplena Documentation
• Caplena API Documentation
• n8n Documentation
• n8n Community Forum

Support

For issues, questions, or suggestions:

• Node Issues: Open an issue on GitHub
• Caplena Support: [email protected]
• n8n Community: community.n8n.io

Version History

1.0.0 (Initial Release)

• ✅ Full Project CRUD operations
• ✅ Full Row CRUD operations
• ✅ Question read operations
• ✅ Trigger for new projects
• ✅ Trigger for new rows
• ✅ Trigger for updated projects
• ✅ Pagination support
• ✅ Comprehensive error handling

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Author

Created by the n8n community

Made with ❤️ for the n8n community