n8n-nodes-hamcall-contact

This is an n8n community node that lets you use HamCall VA Contact API in your n8n workflows.

HamCall VA is a comprehensive voice assistant and contact management platform.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Node Installation

1. Go to Settings > Community Nodes in your n8n instance
2. Select Install
3. Enter n8n-nodes-hamcall-contact in Enter npm package name
4. Agree to the risks of using community nodes
5. Select Install

Manual Installation

To install manually (for development):

1. Clone or copy this directory
2. Run npm install in the directory
3. Run npm run build
4. Link the node to your n8n installation:

   npm link
   cd ~/.n8n/nodes
   npm link n8n-nodes-hamcall-contact

Operations

This node supports the following operations:

Contact Operations

• Create: Create a new contact
• Update: Update an existing contact
• Delete: Delete a contact
• Get: Get a single contact by ID
• Get All: List all contacts with optional filters and search
• Archive: Archive or unarchive a contact (sets is_archived field)

Credentials

This node requires HamCall Contact API credentials. You need to configure:

• API Key: Your project's API token (found in Project Settings > Connection)
• Base URL: The base URL of HamCall API (default: https://api.hamkar.co)

Getting Credentials

API Key (X-API-Key)

1. Login to your HamCall account at https://panel.hamkar.co
2. Go to your Project
3. Navigate to Connection section
4. Copy the API Token
5. Use this token in n8n credentials

The API Key will be sent as X-API-Key header in all requests.

Usage

Example: Create a Contact

1. Add the "HamCall Contact" node to your workflow
2. Select "Create" operation
3. Fill in:
   • Project ID: Your project ID
   • Name: Contact name
   • Phone Number: Contact phone number
4. Optionally add:
   • Telephone Number
   • Address
   • Is Legal (for legal entities)
   • Labels (comma-separated label IDs)

Example: Get All Contacts

1. Add the "HamCall Contact" node to your workflow
2. Select "Get All" operation
3. Configure filters:
   • Project ID: Filter by specific project
   • Search: Search in name, phone, and telephone
   • Is Archived: Filter archived contacts
   • Labels: Filter by label IDs

Example: Update Contact

1. Add the "HamCall Contact" node to your workflow
2. Select "Update" operation
3. Provide:
   • Contact ID (required)
   • Fields to update (name, phone_number, address, etc.)
4. The contact will be updated with new values

Resources

• n8n community nodes documentation
• HamCall VA Documentation

Version History

• 0.1.0 - Initial release
  • Support for all Contact CRUD operations
  • JWT and API Key authentication
  • Filter and search capabilities

License

MIT

Support

For issues and questions:

• Create an issue in the repository
• Contact HamCall VA support