n8n-nodes-agentic-hub/README.md

n8n community node for Agentic Hub API integration - Send messages to conversational AI workflows

![Banner image](https://user-images.githubusercontent.com/10284570/173569848-c624317f-42b1-45a6-ab09-f0ea3c247648.png)

# n8n-nodes-agentic-hub

This is an n8n community node that provides integration with the Agentic Hub API for conversation management and agent operations.

## Features

- **Message Operations**: Send incoming and outgoing messages to conversations
- **Agent Operations**: Retrieve agent information and manage agents
- **Credential Management**: Secure API authentication with API Key and Company ID
- **Flexible Configuration**: Support for workflow management and conversation tracking

## Installation

Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

```bash
npm install n8n-nodes-agentic-hub
```

## Operations

### Message Resource

#### Send Incoming Message

Send a message from a user to the conversation system.

**Required Parameters:**

- Session ID: Unique identifier for the conversation session
- Phone Number: Phone number associated with the conversation
- Query/Message: The message content to send

**Optional Parameters:**

- WorkflowPublicId: UUID identifier for the workflow
- Additional Options: Sentiment scores, human attention flags, order ID

#### Send Outgoing Message

Send a message from the system to a user.

**Required Parameters:**

- Session ID: Unique identifier for the conversation session
- Phone Number: Phone number associated with the conversation
- Query/Message: The message content to send

**Optional Parameters:**

- WorkflowPublicId: UUID identifier for the workflow
- Additional Options: Sentiment scores, human attention flags, order ID

### Agent Resource

#### Get Agent Info

Retrieve information about a specific agent.

**Required Parameters:**

- WorkflowPublicId: UUID identifier for the workflow
- AgentPublicId: UUID identifier for the specific agent

#### Get All Agents

Retrieve all agents associated with a workflow.

**Required Parameters:**

- WorkflowPublicId: UUID identifier for the workflow

## Credentials

This node requires the following credentials:

- **API Key**: Your Agentic Hub API authentication key
- **Company ID**: Your company identifier for the Agentic Hub service

## Configuration

### Setting up Credentials

1. In n8n, go to **Settings** → **Credentials**
2. Click **Add Credential** and search for "Agentic Hub API"
3. Enter your API Key and Company ID
4. Test the connection and save

### Using the Node

1. Add the "Agentic Hub Message" node to your workflow
2. Select the **Resource** (Message or Agent)
3. Choose the appropriate **Operation**
4. Configure the required parameters
5. Set up your credentials

## API Endpoints

- **Messages**: `POST https://motti-ai.com:9595/api/AgenticApi/ConversationWithMessage`
- **Get Agent Info**: `GET https://motti-ai.com:9595/api/Agent/{agentPublicId}?workflowPublicId={workflowPublicId}`
- **Get All Agents**: `GET https://motti-ai.com:9595/api/Agent/workflow/{workflowPublicId}`

## Examples

### Send Incoming Message

```json
{
	"resource": "message",
	"operation": "sendIncoming",
	"sessionId": "session-123",
	"phoneNumber": "+1234567890",
	"query": "Hello, I need help with my order"
}
```

### Get Agent Information

```json
{
	"resource": "agent",
	"operation": "getAgentInfo",
	"agentWorkflowPublicId": "workflow-uuid-123",
	"agentPublicId": "agent-uuid-456"
}
```

## Version History

- **2.0.0**: Added Resource/Operation structure with Message and Agent resources
- **1.4.1**: Simplified credentials and required fields
- **1.3.1**: Added WorkflowPublicId support
- **1.2.1**: Updated direction options
- **1.1.2**: Removed credential test functionality
- **1.0.4**: Added subtitle with direction display
- **1.0.0**: Initial stable release

## Resources

- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
- [Agentic Hub API Documentation](https://motti-ai.com:9595/swagger)

## License

[MIT](LICENSE.md)

## Author

**Elad Amrani AI**

- Email: elad@builddiz.com
- GitHub: [@Elad-builddiz](https://github.com/Elad-builddiz)
- Repository: [n8n-nodes-agentic-hub](https://github.com/Elad-builddiz/n8n-nodes-agentic-hub)

## Development

### Prerequisites

- Node.js 18.x or later
- npm 9.x or later

### Setup

```bash
# Clone the repository
git clone https://github.com/Elad-builddiz/n8n-nodes-agentic-hub.git
cd n8n-nodes-agentic-hub

# Install dependencies
npm install

# Build the project
npm run build

# Run linting
npm run lint

# Publish to npm
npm publish
```

## Support

For issues, questions, or contributions:

1. **GitHub Issues**: [Open an issue](https://github.com/Elad-builddiz/n8n-nodes-agentic-hub/issues)
2. **Email**: elad@builddiz.com
3. **n8n Community**: [n8n Community Forum](https://community.n8n.io/)

## Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

Please follow the existing code style and include appropriate documentation for new features.