n8n-nodes-kipps-voice-agent

Custom n8n community node for initiating outbound phone calls using Kipps.AI VoiceAgent.

This node allows you to start automated voice calls from n8n workflows by connecting to the Kipps.AI speech API.

Features

• Start outbound phone calls using a Kipps.AI Voicebot
• Simple configuration with minimal required fields
• Works with n8n credentials system
• Suitable for automation, testing, and call workflows

Installation

From n8n UI (Recommended)

1. Open n8n
2. Go to Settings → Community Nodes
3. Click Install
4. Search for:

n8n-nodes-kipps-voice-agent

5. Install and restart n8n if required

Manual Installation

npm install n8n-nodes-kipps-voice-agent

Restart n8n after installation.

Credentials Setup

Create a new credential of type:

Kipps.AI API

Provide your Kipps.AI API key.

The node uses header authentication:

Authorization: Api-Key <your_api_key>

Node Configuration

The node requires the following fields:

Voicebot ID

The unique ID of the Kipps.AI voicebot that will place the call.

Example:

fc248e5fa-abcdeg12-shaj

Phone Number

Destination phone number in E.164 format.

Example:

+91123456789

Room Name

Unique identifier for the call session.

This must be unique for each call.

Example:

call-12345

What This Node Does

When executed, the node sends a request to:

POST /speech/phone-call/

With payload:

{
  "voicebot": "<voicebot_id>",
  "to_phone_number": "<phone_number>",
  "room_name": "<room_name>",
  "call_origin": "outbound",
  "call_end_status": "started"
}

Example Use Cases

• Automated lead qualification calls
• Reminder and notification calls
• Testing voicebot behavior
• Workflow-driven outbound calling

Requirements

• Active Kipps.AI account
• Valid API key
• Configured Voicebot

Troubleshooting

400 Bad Request

Check:

• Phone number format includes + and country code
• Voicebot ID is valid
• Room name is unique

403 / Authorization Error

Check:

• API key is correct
• Credential is selected in the node
• Token has not expired

Development

Build the node:

npm run build

Publish a new version:

npm version patch
npm run release

License

MIT