Description

n8n-nodes-cribops

This is an n8n community node. It lets you use Cribops in your n8n workflows.

Cribops is the platform where teams build, deploy, and scale AI-powered automation agents for customer service, support, and business operations.

> Note: This integration requires an active subscription with Cribops.com. Sign up for an account to obtain your API credentials.

Features

• Scalable Automation: Build resilient workflows with AI agents that handle customer interactions at scale
• AWS Service Integration: Leverage AWS SQS queues and SNS topics for enterprise-grade message processing
• Real-time Communication: HTTP webhooks enable instant bidirectional messaging between n8n and Cribops agents
• Smart Agent Routing: Dynamic agent selection ensures messages reach the right automation specialist
• Context Preservation: Maintains full conversation history across complex multi-step workflows
• Enterprise Security: Dual authentication with API tokens and AWS credentials for secure cloud operations
• File Processing: Handle documents, images, and attachments through S3 presigned URLs
• Event-Driven Triggers: Filter and respond to specific event types for targeted automation

Nodes Included

1. Cribops Node

Execute operations on Cribops automation agents:

• Send Messages: Dispatch requests to AI agents with file attachments and metadata
• Manage Conversations: Reply to ongoing conversations while maintaining full context
• Agent Operations: List available agents, retrieve agent details, and route dynamically
• Real-time Status: Send typing indicators to show processing activity
• Custom Properties: Attach metadata for workflow-specific data handling

2. Cribops Trigger Node

Receive and process events from Cribops automation platform:

• Webhook Reception: Instantly receive messages from users and agents
• Smart Filtering: Process only relevant events (user messages, agent responses, attachments)
• Secure Validation: Verify webhook authenticity with secret tokens
• Data Enrichment: Automatically include routing information for seamless replies
• Queue Integration: Future support for AWS SQS polling for guaranteed message delivery
• Topic Subscriptions: Future support for AWS SNS for event broadcasting

Installation

Prerequisites

• Node.js >= 20.15
• n8n >= 1.0.0
• Active Cribops subscription (visit cribops.com to sign up)
• Cribops API access token (available in your Cribops dashboard)

Via npm (Recommended)

npm install n8n-nodes-cribops

Via n8n GUI (For verified community nodes)

1. Go to Settings → Community Nodes
2. Click Install a Community Node
3. Enter: n8n-nodes-cribops
4. Click Install

Manual Installation

Clone the repository
git clone https://github.com/CloudBedrock/n8n-nodes-cribops.git
cd n8n-nodes-cribops
Install dependencies
npm install
Build the package
npm run build
Link globally for testing
npm link

Configuration

1. Cribops API Credentials

Create a new credential in n8n:

• Credential Type: Cribops API
• API Token: Your Cribops API token (Required)
• Base URL: Your Cribops instance URL (e.g., https://api.cribops.com)
• Account ID: (Optional) Account ID for AWS service integration
• Account Secret: (Optional) Secret key for AWS service integration
• Region: (Optional) AWS region for cloud services (default: us-east-1)

2. Agent Selection

The nodes automatically populate available agents from your Cribops instance. Select the appropriate agent from the dropdown when configuring each node.

Usage Examples

Customer Support Automation

[Cribops Trigger] → [Sentiment Analysis] → [Route to Agent] → [Cribops Response]

Automatically analyze customer sentiment and route to specialized AI agents based on urgency and topic.

Document Processing Pipeline

[Cribops Trigger] → [Extract Attachment] → [OCR/Parse] → [Database] → [Cribops Response]

Process incoming documents, extract data, store in database, and respond with confirmation.

Multi-Channel Integration

[Slack] → [Format Message] → [Cribops Agent] → [Process] → [Email/SMS/Slack]

Receive requests from any channel, process with Cribops agents, and respond across multiple platforms.

Escalation Workflow

[Cribops Trigger] → [Check Complexity] → [If Complex] → [Human Review] → [Cribops Response]

Automatically escalate complex requests while handling routine inquiries with AI agents.

API Integration

Cribops Platform Endpoints

• GET /api/v1/agents – Agent selection and retrieval
• GET /api/v1/agents/{agent_id} – Get specific agent details
• POST /webhooks/agents/{agent_id}/message – HTTP webhook endpoint
• POST /api/v1/agents/{agent_id}/files – File uploads
• POST /api/v1/agents/{agent_id}/typing – Send typing indicators
• Response webhook URL provided in incoming messages for replies
• AWS SQS queue endpoints (when configured with AWS credentials)
• AWS SNS topic endpoints (when configured with AWS credentials)

Message Formats

#### Incoming User Message

{
  "conversation_id": "uuid-v4",
  "content": "Hello, I need help with...",
  "message_id": "uuid-v4",
  "user_id": "uuid-v4",
  "organization_id": "uuid-v4",
  "timestamp": "2025-01-10T16:00:00Z",
  "response_webhook": "https://api.cribops.com/webhooks/response/uuid-v4",
  "type": "user_message",
  "attachments": [
    {
      "type": "image",
      "url": "https://s3.amazonaws.com/...",
      "filename": "screenshot.png",
      "size": 1024000,
      "mime_type": "image/png"
    }
  ]
}

#### Outgoing Agent Response

{
  "conversation_id": "uuid-v4",
  "content": "I can help you with that...",
  "message_id": "external-id-123",
  "timestamp": "2025-01-10T16:01:00Z",
  "attachments": [
    {
      "type": "file",
      "url": "https://s3.amazonaws.com/...",
      "filename": "report.pdf",
      "size": 2048000,
      "mime_type": "application/pdf"
    }
  ]
}

Development

Setup

Clone repository
git clone https://github.com/CloudBedrock/n8n-nodes-cribops.git
cd n8n-nodes-cribops
Install dependencies
npm install
Start development mode
npm run dev

Building

Build TypeScript and icons
npm run build
Lint code
npm run lint
Format code
npm run format

Testing

Run tests
npm run test
Test with local n8n instance
npm link
npm link n8n-nodes-cribops
N8NCUSTOMEXTENSIONS=n8n-nodes-cribops n8n start

Configuration Examples

Environment Variables

For local development
export CRIBOPSAPIURL=http://localhost:4000
AWS configuration (optional)
export AWS_REGION=us-east-1
export AWSACCESSKEYID=youraccess_key
export AWSSECRETACCESSKEY=yoursecret_key
For n8n configuration
export N8NCUSTOMEXTENSIONS=n8n-nodes-cribops
export N8NNODESINCLUDE=n8n-nodes-cribops

Docker Configuration

FROM n8nio/n8n:latest
Install the community node
RUN npm install -g n8n-nodes-cribops
Set environment variables
ENV N8NCUSTOMEXTENSIONS=n8n-nodes-cribops

Troubleshooting

Common Issues

#### Node Not Appearing in n8n
1. Ensure the package is properly installed
2. Check that N8NCUSTOMEXTENSIONS is set correctly
3. Restart n8n after installation

#### Webhook Connection Issues
1. Verify webhook URL is correctly configured
2. Check bearer token authentication
3. Ensure Cribops platform can reach your n8n instance

#### File Upload Problems
1. Verify S3 configuration in Cribops platform
2. Check file size limits
3. Ensure proper MIME type handling

Debug Mode

Enable debug logging in n8n:

export N8NLOGLEVEL=debug
n8n start

Contributing

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

Development Guidelines

• Follow TypeScript best practices
• Add tests for new functionality
• Update documentation as needed
• Follow n8n community node guidelines

License

This n8n community node is licensed under the MIT License – see the LICENSE file for details.

Important License Clarification:

• The MIT license applies only to this n8n node integration code
• Cribops platform, services, and AI agents are licensed separately by CloudBedrock
• Use of Cribops services requires an active subscription and acceptance of Cribops Terms of Service
• CloudBedrock proprietary components and APIs remain under CloudBedrock’s commercial license
• This open-source node is a client interface and does not grant any license to use Cribops services beyond your subscription terms

Support

• Documentation: GitHub Wiki
• Issues: GitHub Issues
• Community: n8n Community
• Cribops Platform: cribops.com

Changelog

Version 0.1.5

• Initial release
• HTTP webhook support for sending and receiving messages
• File attachment handling with S3 presigned URLs
• Dynamic agent selection with search functionality
• Reply to conversation functionality with webhook context
• Typing indicator support
• Event type filtering for trigger node
• AWS credentials support for future SQS/SNS integration
• Secret token validation for webhooks
• Message metadata support

Related Projects

• n8n – Workflow automation platform
• Cribops AI – AI agent platform

—

Note: This is a community-maintained package that requires an active Cribops subscription. For official support, please contact the Cribops AI team at cribops.com.

Disclaimer

This n8n node is provided as an open-source integration tool. CloudBedrock and Cribops are registered trademarks of CloudBedrock, Inc. The use of these trademarks in this project is for identification purposes only and does not imply endorsement.