n8n-nodes-revox

Community nodes for Revox — place and manage AI voice calls and assistants from n8n.

📚 Full documentation → · API Reference

Revox is an AI-powered voice calling platform: outbound calls, automated follow-ups, and call summaries. This package aligns with the Revox API and exposes Calls, Assistants, and a webhook trigger for call completion.

Installation

1. In n8n, go to Settings → Community Nodes.
2. Click Install and enter: n8n-nodes-revox.
3. Restart n8n if prompted.

Requires n8n 0.188.0 or higher.

Credentials

Create Revox API credentials in n8n:

1. Get an API key from the Revox Dashboard (API Keys).
2. In n8n: Credentials → Add Credential → search for Revox API.
3. Enter your API Key.
4. Base URL is optional (default: https://www.getrevox.com/).

All requests use Bearer token authentication.

Nodes & Operations

Revox (action node)

The Revox node has two resources. Choose one, then pick an operation.

Resource: Call

| Operation | Description | |-----------|-------------| | Place Call | Start a new AI voice call. Use an existing Assistant ID or configure inline (prompt, voice, webhook). | | Get Call | Fetch status and details for a call by Call ID. | | Get Call History | List calls with pagination (page 0-based, page_size). |

Place Call parameters

• Phone Number (required) – E.164 format, e.g. +15555555555.
• Assistant ID (optional) – If set, Revox uses this assistant; prompt/voice/webhook below are ignored.
• Prompt – System prompt for the AI (used when no Assistant ID).
• Voice – Choose from list or expression (when no Assistant ID).
• Webhook URL – Callback URL for completion events; often {{ $node["Revox Trigger"].webhookUrl }}.
• Force Now – Bypass time-zone checks and place the call immediately.

Get Call – Call ID (required).

Get Call History – Page (0-based), Page Size (sent as page_size to the API).

Resource: Assistant

| Operation | Description | |-----------|-------------| | Create | Create an assistant with name, prompt, optional first sentence, webhook URL, and voice. | | List | Return all assistants. | | Get | Get one assistant by Assistant ID. | | Update | Update an assistant’s name and/or prompt by Assistant ID. | | Delete | Delete an assistant by Assistant ID. |

Create Assistant – Name (required), Prompt (required), First Sentence, Webhook URL, Voice (optional).

Get / Update / Delete – Assistant ID (required). Update also accepts Name and Prompt.

Revox Trigger (webhook)

Receives call completion webhooks from Revox and starts the workflow.

Filter by Result – Only run when the call result matches:

• All – Every completion.
• Human – Person answered.
• Voicemail – Voicemail detected.
• IVR – Automated system.

Webhook URL – After the workflow is active (or listening for test events), the trigger exposes a URL. Use it in the Revox node (Place Call → Webhook URL) or in the Revox dashboard. In n8n you can reference it with:

{{ $node["Revox Trigger"].webhookUrl }}

Output – The trigger emits the webhook payload. Example:

{
  "call_order_id": "uuid",
  "call_id": "uuid",
  "status": "completed",
  "result": "human",
  "annotation": "Brief summary",
  "transcript": "Full transcript",
  "recording_url": "https://...",
  "started_at": "2024-01-01T12:00:00Z",
  "ended_at": "2024-01-01T12:05:00Z",
  "calls_count": 1,
  "timestamp": "2024-01-01T12:05:01Z",
  "webhookUrl": "https://your-n8n-host/webhook/..."
}

Example Workflows

• Place a call (inline config)
  Manual Trigger → Revox (Resource: Call, Place Call) — set phone number, prompt, optional voice and webhook.

• Place a call with an assistant
  Manual Trigger → Revox (Resource: Call, Place Call) — set Assistant ID (from a previous Create Assistant or dashboard).

• Notify when a call completes
  Revox Trigger → Revox (Get Call) → Slack (Send Message) — use trigger webhook URL in Place Call; on completion, fetch call details and post to Slack.

• Route by result
  Revox Trigger → Switch (by result) → [Human: CRM · Voicemail: Retry · IVR: Log].

• Manage assistants
  Manual Trigger → Revox (Resource: Assistant, Create) then use the returned assistant ID in Place Call.

More examples are in the examples/ directory.

Resources

• Revox n8n Quickstart
• Revox API Reference
• n8n Community Nodes

Support

• Docs: docs.getrevox.com
• Email: [email protected]

License

MIT