@superhippo/n8n-nodes-ai-voice-agents

n8n-nodes-ai-voice-agent

n8n community node for the AI Voice Agent from SuperHippo. Create leads, trigger outbound calls, and react to call outcomes from your n8n workflows.

Install

In n8n: Settings → Community Nodes → Install → n8n-nodes-ai-voice-agent.

Credential — AI Voice Agent API

Create an AI Voice Agent API credential:

• Base URL — your SuperHippo AI Voice Agent API root, e.g. https://api.superhippo.com
• API Key — sent as the X-API-KEY header

Saving the credential runs a test request against GET /calls?page=1&page_size=1.

Action node — AI Voice Agent

Lead

• Create → POST /leads (fields: Name, Phone Number, Timezone; optional Email, Agent ID, Lead Metadata)
• Create and Call → POST /leads/call (same fields plus Call Delay (Seconds)) — creates/updates the lead and enqueues an outbound call

Call

• Get → GET /calls/{id}
• List → GET /calls (Page, Page Size)

Trigger node — AI Voice Agent Trigger

Starts a workflow when the AI Voice Agent reports a call event. Output is the call object from the event payload (call_id, summary, call_outcome, call_status, duration, action_items, metadata.lead_id, ...).

Setup (manual registration):

1. Add the trigger node, pick an Event (default call.ended), and activate the workflow.

2. Copy the node's production webhook URL.

3. Register it once with the AI Voice Agent:

   POST /api/custom-webhook
   X-API-KEY: <your key>
   Content-Type: application/json
   
   { "destination_url": "<webhook url>", "events": ["call.ended"] }

Only call.ended currently fires from the backend. call.started, call.joined, and call.billed are listed for forward-compatibility but are not emitted yet.

License

MIT