n8n-nodes-agentic-hub

This is an n8n community node package that provides integration with the Agentic Hub API for conversational AI workflows.

Installation

Community Nodes (Recommended)

1. Go to Settings > Community Nodes in your n8n instance
2. Click Install and enter: n8n-nodes-agentic-hub
3. Click Install and restart n8n

Manual Installation

# In your n8n installation directory
npm install n8n-nodes-agentic-hub

Nodes

Agentic Hub Message

Send messages to the Agentic Hub API for conversational AI workflows.

Features

• ✅ Configurable API endpoint
• ✅ Support for questions and answers (direction parameter)
• ✅ Session and conversation management
• ✅ Sentiment scoring
• ✅ Human attention flagging
• ✅ Phone number association
• ✅ Error handling and retry support

Configuration

Required Parameters:

• API URL: The Agentic Hub API endpoint (default: https://motti-ai.com:9595/api/AgenticApi/ConversationWithMessage)
• Workflow ID: Workflow identifier for the conversation
• Session ID: Unique session identifier
• Phone Number: Phone number associated with the conversation
• Query/Message: The message content to send
• Direction: Message direction (1 = Question from user, 0 = Answer from AI)

Optional Parameters (Additional Options):

• Overall Sentiment: Sentiment score for the conversation (default: 100)
• Sentiment Score: Sentiment score for the message (default: 100)
• Requires Human Attention: Flag for human intervention needed (default: false)
• Order ID: Associated order identifier (default: 0)

Example Usage

{
  "workflowId": 11,
  "sessionId": "user-session-123",
  "phoneNumber": "+1234567890",
  "query": "Hello, I need help with my order",
  "direction": 1,
  "additionalOptions": {
    "overallSentiment": 80,
    "requiresHumanAttention": false
  }
}

Response Format

The node returns:

{
  "success": true,
  "response": { /* API response */ },
  "requestBody": { /* The request that was sent */ },
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Development

Setup

npm install

Build

npm run build

Linting

npm run lint
npm run lintfix

Publishing to NPM

Prerequisites

1. Update package.json with your information:

   • Replace "Your Name" with your actual name
   • Replace "your.email@example.com" with your email
   • Replace GitHub URLs with your repository URLs

2. Create an NPM account and login:

npm login

Publish Steps

# 1. Build the package
npm run build

# 2. Test the build
npm run lint

# 3. Publish to NPM
npm publish

Version Updates

# Patch version (0.1.0 -> 0.1.1)
npm version patch

# Minor version (0.1.0 -> 0.2.0)
npm version minor

# Major version (0.1.0 -> 1.0.0)
npm version major

# Then publish
npm publish

License

MIT

Support

For issues and questions, please use the GitHub repository issues page.

Contributing

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