Description
n8n-nodes-yourang
An n8n community node to integrate yourang.ai into your workflows. Automate call handling, contact management, appointment scheduling, and AI agent configuration directly from n8n.
yourang.ai is a 24/7 AI phone assistant that handles inbound and outbound calls, schedules appointments, collects customer data, and manages interactions automatically.
Installation
Follow the n8n community nodes installation guide:
1. Open Settings > Community Nodes in your n8n instance
2. Enter n8n-nodes-yourang
3. Click Install
Credentials
1. Create an account at app.yourang.ai
2. Generate an API key from your dashboard
3. In n8n, add new Yourang API credentials with your API key
The default API base URL is https://api.yourang.ai/v1. See the full API documentation for details.
Operations
Call History
| Operation | Description |
|———–|————-|
| Get Call | Retrieve details of a specific call |
| Get Many | List calls with filters (type, status, direction, phone, contact) |
| Get Transcript | Get the transcript for a specific call |
| Get Summary | Get AI-generated summary for a call |
Contact
| Operation | Description |
|———–|————-|
| Create | Add a new contact (name, phone, email, address) |
| Get | Retrieve a contact by ID |
| Get by Phone | Retrieve a contact by phone number |
| Get Many | List contacts with search and sort filters |
| Update | Update a contact by ID |
| Update by Phone | Update a contact by phone number |
| Delete | Remove a contact by ID |
| Delete by Phone | Remove a contact by phone number |
Event
| Operation | Description |
|———–|————-|
| Get | Get details of a specific event |
| Get by Date | Get events for a specific date |
| Get Many | Get events grouped by date range |
| Update | Update an existing event |
| Update Status | Approve or reject an event |
| Delete | Delete an event |
Agent
| Operation | Description |
|———–|————-|
| Get | Get details of a specific AI agent |
| Get Many | List agents for your organization |
Agent Tool
| Operation | Description |
|———–|————-|
| Get | Get configuration for a specific agent tool |
| Get Many | List tools available for a specific agent |
| Update | Update configuration for an agent tool |
Workflow
| Operation | Description |
|———–|————-|
| Get | Get workflow details |
| Get Many | List workflows |
| Execute | Execute a workflow |
| Get Executions | List workflow executions |
| Get Execution Details | Get details of a specific execution |
Campaign
| Operation | Description |
|———–|————-|
| Get | Get campaign details |
| Get Many | List campaigns with status/search filters |
| Get Stats | Get campaign statistics |
| Pause | Pause a running campaign |
| Resume | Resume a paused campaign |
| Start | Start a campaign |
| Stop | Stop a campaign |
Catalogue
| Operation | Description |
|———–|————-|
| Create | Create a catalogue, optionally with initial items |
| Delete | Delete a catalogue (optionally preserving its items as standalone) |
| Get | Get catalogue details |
| Get Many | List catalogues with search/sort filters |
| Update | Update catalogue name or description |
Catalogue Item
| Operation | Description |
|———–|————-|
| Assign | Assign items to a catalogue, or unassign them (standalone) |
| Create | Create a catalogue item or standalone item |
| Delete | Delete an item |
| Get | Get item details |
| Get Many | List items with catalogue/search/sort/standalone filters |
| Update | Update item fields (name, price, quantity, …) |
Contact List
| Operation | Description |
|———–|————-|
| Add Contacts | Add contacts to a list by ID or phone number (optionally auto-creating missing contacts) |
| Get | Get contact list details |
| Get Contacts | List contacts in a contact list |
| Get Many | List contact lists |
| Remove Contacts | Remove contacts from a list by ID or phone number |
Order
| Operation | Description |
|———–|————-|
| Get | Get order details |
| Get Many | List orders with status/date/sort filters |
| Update | Update order status, notes, or refusal reason |
Wallet
| Operation | Description |
|———–|————-|
| Get | Get the wallet snapshot (balance) |
| Get Many Transactions | List wallet transactions with type/date filters |
Trigger
The Yourang Trigger node starts a workflow when yourang emits an event, replacing the
manual Webhook + Code parsing pattern. Select one or more events and the node receives a
typed, signed payload.
| Event | Fires when |
|——-|————|
| Call Ended | A call finished and its record was persisted |
| Call Summary Ready | The async summary of a call is ready |
| Appointment Booked | An appointment/event was created (CONFIRMED) |
| Appointment Updated | An appointment was rescheduled/approved/rejected |
| Appointment Cancelled | An appointment was cancelled |
| Contact Created | A new contact (lead) was created |
| Call Transcript Ready | The transcript of a call is available |
| Order Created | A new order was created |
| Order Status Changed | An order changed status (confirmed/completed/cancelled/refused) |
| Dialer Contact Completed | A campaign contact reached a terminal outcome |
| Dialer Campaign Completed | A dialer campaign finished processing all contacts |
On activation the node registers a subscription on yourang
(POST {baseUrl}/webhooks, e.g. https://api.yourang.ai/v1/webhooks) with the workflow’s
webhook URL; the platform returns a one-time signing secret that the node stores. On
deactivation it removes the subscription. Incoming requests are verified against the
X-Webhook-Signature (HMAC-SHA256) header and deduplicated by event_id.
Payload envelope
{
"event": "call.ended",
"event_id": "uuid",
"occurred_at": "ISO-8601",
"organization_id": "uuid",
"data": { }
}
> Requires the platform outbound-webhook API. Until it ships, turn off **Auto-Register
> Subscription** in the node options to test by POSTing the envelope to the webhook URL
> directly.
Example Use Cases
- CRM Sync — Push call history and contact data to your CRM after each call
- Appointment Automation — Create, update, and manage events from external calendars
- Call Analytics — Collect transcripts and AI summaries for reporting dashboards
- Agent Configuration — Manage AI agent tools and workflows programmatically
- Minimum n8n version: 1.0.0
- Node.js: >= 20.15
- yourang.ai — product website
- Yourang Dashboard — Manage your account and API keys
- API Documentation — Full API reference
- n8n Community Nodes — n8n docs
