n8n-nodes-telli

This is an n8n community node. It lets you use telli AI phone call platform in your n8n workflows.

telli is an AI phone calling platform that lets you automate phone call operations and perform custom tasks.

n8n is a fair-code licensed workflow automation platform.

• Installation
• Actions
• Credentials
• Compatibility
• Usage
• Resources
• Development

Repository Structure

• credentials/: Contains credential definitions

  • TelliApi.credentials.ts: Defines the API key authentication for telli API

• nodes/: Contains the actual node implementations

  • Telli/: The telli node folder
    • Telli.node.ts: Main implementation of the telli node with all operations
    • telli.svg: Icon for the node in n8n

• dist/: Generated folder containing compiled JavaScript code (created after running npm run build)

• package.json: Defines package dependencies and n8n node registration information

Installation

Option 1: Install from npm

Follow the installation guide in the n8n community nodes documentation.

npm install n8n-nodes-telli

Option 2: Manual installation

1. Clone this repository to your local machine
2. Install dependencies: npm install
3. Build the code: npm run build
4. Create a custom directory in your n8n installation: mkdir -p ~/.n8n/custom
5. Create a package.json file in the custom directory:

{
  "name": "n8n-custom-nodes",
  "version": "0.1.0",
  "private": true,
  "dependencies": {
    "n8n-nodes-telli": "file:///path/to/cloned/n8n-nodes-telli"
  }
}

6. Install the dependency: cd ~/.n8n/custom && npm install
7. Restart n8n

Actions

The telli node provides the following operations, grouped by resource:

Contact

Operation	Description	API Docs
Create Contact	Create a new contact with name, phone number, email, and custom properties	Docs
Get Contact	Retrieve a contact by ID	Docs
Get Contact by External ID	Retrieve a contact using your external system's ID	Docs
List Contacts	List contacts with pagination and optional "Return All" toggle	Docs
Update Contact	Update an existing contact. Only provided fields are changed	Docs
Delete Contact	Soft-delete a contact and anonymize all PII data	Docs

Agent

Operation	Description	API Docs
Get Agent	Retrieve an agent by selecting from a dropdown or specifying an ID	Docs
List Agents	List agents with pagination and optional "Return All" toggle	Docs

Call

Operation	Description	API Docs
Schedule Call	Schedule an AI phone call at the earliest opportunity within the dialer window	Docs
Schedule Calls (Batch)	Schedule multiple calls in one request (max 50 per request)	Docs
Get Call	Retrieve call details including transcript and analysis by call ID	Docs
Initiate Call	Immediately initiate an outbound call (not recommended — prefer Schedule Call)	Docs
Remove From Auto Dialer	Remove a contact from the auto dialer queue	Docs
Remove From Auto Dialer (Batch)	Remove multiple contacts from the auto dialer queue (max 50 per request)	Docs

Contact Property

Operation	Description	API Docs
Create Contact Property	Define a new custom property for contacts (text, number, select, etc.)	Docs
Get Contact Property	Retrieve a contact property by key	Docs
List Contact Properties	List all contact properties for the account	Docs
Update Contact Property	Update an existing contact property's label, description, or options	Docs

Phone Number

Operation	Description	API Docs
List Phone Numbers	List all active phone numbers for the account	Docs
Import Phone Number	Import a phone number from your own SIP trunk provider	Docs
Replace Phone Number	Replace a phone number with a new one (old number stays active for callbacks for 30 days)	Docs
Delete Phone Number	Schedule a phone number for deletion (stays active for callbacks for 30 days)	Docs

Deprecated (v1)

These operations use the legacy v1 API and are kept for backward compatibility with existing workflows. Use the Contact resource above for new workflows.

Operation	Description	API Docs
Add Contact	Add a contact using the v1 endpoint	Docs
Add Contacts (Batch)	Add multiple contacts using the v1 batch endpoint	Docs
Get Contact	Get a contact by ID using the v1 endpoint	Docs
Get Contact by External ID	Get a contact by external ID using the v1 endpoint	Docs
Get Contacts (Batch)	Get multiple contacts using the v1 batch endpoint	Docs
Update Contact	Update a contact using the v1 endpoint	Docs
Update Contacts (Batch)	Update multiple contacts using the v1 batch endpoint	Docs

Credentials

To use the telli nodes, you need to authenticate with the telli API:

1. Sign up for an account at telli.com
2. Navigate to your account settings
3. Create an API key with the necessary permissions
4. Use this API key in the telli API credentials in n8n

Compatibility

This node has been tested with n8n version 0.171.0 and higher.

Usage

Create Contact Example

1. Add the telli node to your workflow
2. Select the Contact resource and Create Contact operation
3. Fill in the required fields (First Name, Last Name, Phone Number)
4. Optionally add email, external ID, salutation, timezone, and custom properties
5. Properties can be added using the field editor or as a JSON array: [{"key": "company", "value": "Acme"}]

Schedule Call Example

1. Add the telli node to your workflow
2. Select the Call resource and Schedule Call operation
3. Enter the Contact ID and select an Agent from the dropdown
4. Optionally set max retry days and override the from number
5. The call will be scheduled at the earliest opportunity within the agent's dialer window

List Contacts with Pagination

1. Add the telli node to your workflow
2. Select the Contact resource and List Contacts operation
3. Toggle Return All to fetch every contact, or set a Limit for a single page

Manage Contact Properties

1. Add the telli node to your workflow
2. Select the Contact Property resource
3. Use Create Contact Property to define new fields (e.g., a "Company" text field or a "Status" select field)
4. For select and multi_select types, add options using the field editor or as JSON: [{"value": "a", "label": "Option A"}]

Delete Contact Example

1. Add the telli node to your workflow
2. Select the Contact resource and Delete Contact operation
3. Enter the Contact ID
4. Warning: This soft-deletes the contact and anonymizes all PII data

Remove from Auto Dialer Example

1. Add the telli node to your workflow
2. Select the Call resource and Remove From Auto Dialer operation
3. Enter the Contact ID
4. This stops the contact from receiving automated calls without deleting their data

Resources

• n8n community nodes documentation
• telli API documentation
• telli website

Development

Making Changes and Rebuilding Locally

Refer to the n8n docs on how to run nodes locally: docs

1. Make your changes to the code (e.g., in nodes/Telli/Telli.node.ts)

2. Build the project:

npm run build

3. Copy the built files to your n8n custom directory:

cp -r dist/* ~/.n8n/custom/n8n-nodes-telli/ # or wherever your custom directory is

4. Restart n8n to see your changes:

# First kill the current n8n process (Ctrl+C), then run:
n8n start

Development Workflow Tips

• Use npm run dev to continuously build the code as you make changes
• Check for linting errors with npm run lint
• Format code with npm run format

Troubleshooting

If you don't see your changes after rebuilding and restarting n8n:

1. Check if there are any errors in the n8n logs
2. Verify that the files were correctly copied to the custom directory
3. Make sure n8n was properly restarted
4. Clear your browser cache or open n8n in an incognito window