n8n-nodes-whoz/README.md

N8N community node for Whoz talent management platform

# n8n-nodes-whoz

This is an n8n community node that allows you to integrate with the Whoz talent management platform.

[Whoz](https://www.whoz.com) is a cloud solution that enables professional services to orchestrate and optimize strategic deployment of talents and teams on projects.

## Installation

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

## Operations

### Whoz Node

The main Whoz node supports the following operations:

#### Account Operations
- **Create Account**: Create a new company/organization account
- **Update Account**: Update an existing account
- **Delete Account**: Soft delete an account
- **Get Account**: Retrieve account details by ID
- **Get Many Accounts**: Search accounts by external IDs

#### Billing Item Operations
- **Create Billing Item**: Create a new billing item
- **Update Billing Item**: Update an existing billing item
- **Delete Billing Item**: Soft delete a billing item
- **Validate Billing Item**: Validate a billing item
- **Restore Billing Item**: Restore a deleted billing item
- **Get Many Billing Items**: List billing items with filters

#### Dossier Operations  
- **Create Dossier**: Create a new opportunity/deal
- **Update Dossier**: Update an existing dossier
- **Delete Dossier**: Soft delete a dossier
- **Get Dossier**: Retrieve dossier details by ID
- **Get Many Dossiers**: Search dossiers by external IDs

#### Talent Operations
- **Create Talent**: Create a new talent profile
- **Update Talent**: Update an existing talent profile  
- **Delete Talent**: Soft delete a talent profile
- **Get Talent**: Retrieve talent details by ID
- **Get Many Talents**: Search talents by external IDs

#### Task Operations
- **Create Task**: Create a new task/requirement
- **Update Task**: Update an existing task
- **Delete Task**: Soft delete a task
- **Get Task**: Retrieve task details by ID

### Whoz Trigger

The Whoz Trigger node supports webhook-based triggers for:

#### Talent Events
- **Talent Created**
- **Talent Updated**

#### Account Events
- **Account Created**

#### Deal Events
- **Deal Created**
- **Deal Updated**
- **Deal Deleted**
- **Deal Restored**

#### Opportunity Events
- **Opportunity Created**
- **Opportunity Updated**
- **Opportunity Won**
- **Opportunity Lost**
- **Opportunity Restored**

#### Task Events
- **Task Created**
- **Task Updated**
- **Task Assigned**
- **Task Unassigned**
- **Task Started**
- **Task Stopped**
- **Task Cancelled**
- **Task Uncancelled**
- **Task Deleted**

#### Project Events
- **Project Created**

## Credentials

This node uses OAuth2 authentication with the Whoz API. You'll need:

1. **Client ID**: Your Whoz API Client ID
2. **Client Secret**: Your Whoz API Client Secret  
3. **Environment**: Choose between Production (`www.whoz.com`) or Sandbox (`sandbox.whoz.com`)

To obtain API credentials, contact [Whoz support](https://knowledge.whoz.com).

## Features

- ✅ **Complete API V15 Support**: All operations use the latest Whoz API
- ✅ **OAuth2 Authentication**: Secure authentication with production/sandbox support
- ✅ **Comprehensive Operations**: 24 CRUD operations across 5 resources
- ✅ **Webhook Triggers**: 24 real-time event triggers
- ✅ **Bulk Operations**: Efficient bulk talent management
- ✅ **External ID Support**: Easy integration with external systems
- ✅ **Soft Deletes**: Safe deletion with restoration capabilities
- ✅ **Multi-currency**: Support for multiple currencies
- ✅ **Address Support**: Complete address handling with GPS coordinates
- ✅ **Skill Management**: Advanced skill and qualification handling

## Compatibility

- n8n version: 1.40.0 or later
- Node.js version: 18.10 or later

## Resources

- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
- [Whoz API Documentation](https://developer.whoz.com/docs/whoz-api)
- [Whoz Knowledge Base](https://knowledge.whoz.com)

## License

[MIT](https://github.com/whoz/whoz-platform/blob/main/LICENSE.md)

## Version History

### 1.0.0 (Current)
- ✅ Complete implementation with 24 CRUD operations
- ✅ Full webhook trigger support for 24 events
- ✅ OAuth2 authentication with production/sandbox environments
- ✅ Comprehensive field coverage for all resources
- ✅ TypeScript support with full type definitions
- ✅ Compatible with N8N community node standards