tukimate

n8n community node for TukiMate API

Package Information

Downloads: 0 weekly / 0 monthly
Latest Version: 1.3.5
Author: Broobe

Available Nodes

TukiMate icon
TukiMate
Interact with TukiMate API (conversations, contacts, teams, projects, clients, sources)

Documentation

n8n-nodes-tukimate

n8n community node for TukiMate API.

Installation

In n8n Community Nodes

  1. Go to Settings > Community Nodes
  2. Select Install
  3. Enter n8n-nodes-tukimate
  4. Click Install

Manual Installation

cd ~/.n8n/custom
npm install n8n-nodes-tukimate

Credentials

To use this node, you need a TukiMate API key:

  1. Log in to your TukiMate account
  2. Go to Settings > API Keys
  3. Create a new API key
  4. Copy the key (starts with tuki_)

In n8n:

  1. Go to Credentials
  2. Click Add Credential
  3. Search for "TukiMate API"
  4. Paste your API key
  5. Save

AI Agent Support

This node can be used as a tool in n8n AI Agent workflows. Simply add it to your AI Agent's tools to enable the agent to interact with TukiMate resources.

Supported Resources & Operations

Conversation

Operation Description
List Get a list of conversations with optional filters
Get Get a single conversation by ID
Create Create a new conversation
Update Update an existing conversation
Analyze Trigger AI analysis on a conversation
Delete Delete a conversation

List Filters:

  • Search - Text search in conversation content
  • External Meeting ID - Filter by external meeting source ID (e.g., Zoom, Google Meet)
  • Team - Filter by team
  • Client - Filter by client
  • Project - Filter by project
  • Contact - Filter by contact ID
  • Participant - Filter by participant name
  • Category - Filter by category ID
  • Date From/To - Filter by date range
  • Source - Filter by source key
  • Type - Filter by conversation type
  • Has Analyses - Filter by analysis status
  • Limit/Offset - Pagination

Create/Update Fields:

  • Title, Description, Overview
  • Date/Time, Duration
  • Transcript
  • Source Key, Source Conversation ID
  • Conversation Type
  • Language
  • Tags
  • Team, Client, Project
  • Participants

Contact

Operation Description
List Get a list of contacts with optional filters
Get Get a single contact by ID
Create Create a new contact
Update Update an existing contact
Delete Delete a contact

List Filters:

  • Search - Search in name, email
  • Company - Filter by company
  • Tags - Filter by tags
  • Limit/Offset - Pagination

Create/Update Fields:

  • First Name, Last Name
  • Email, Phone, Identifier
  • Job Title, Department
  • Company Name
  • Tags

Team

Operation Description
List Get a list of teams
Get Get a single team by ID
Create Create a new team
Update Update an existing team
Delete Delete a team

Project

Operation Description
List Get a list of projects with optional status filter
Get Get a single project by ID
Create Create a new project
Update Update an existing project
Delete Delete a project

Client

Operation Description
List Get a list of clients with optional filters
Get Get a single client by ID
Create Create a new client
Update Update an existing client
Delete Delete a client

List Filters:

  • Type - corporate, individual, partner
  • Status - active, inactive, prospect
  • Limit/Offset - Pagination

Source

Operation Description
List Get a list of sources
Get Get a single source by ID
Create Create a new source
Update Update an existing source

Conversation Type

Operation Description
List Get available conversation types (read-only)

Tag

Operation Description
List Get a list of all available tags
Get Get a single tag by ID
Get Conversation Tags Get tags for a specific conversation
Search Search tags by name
Delete Delete a tag

Tag Definition

Operation Description
List Get a list of tag definitions
Create Create a new tag definition

Create Fields:

  • Name, Color, Description
  • Category (type, role, status, custom)

Category

Operation Description
List Get a list of categories
Get Get a single category by ID
Create Create a new category
Update Update an existing category
Delete Delete a category

Analysis

Operation Description
List Get a list of analyses with optional filters
Get Get a single analysis by ID

List Filters:

  • Conversation ID - Filter by conversation
  • Status - PENDING, PROCESSING, COMPLETED, FAILED
  • Limit/Offset - Pagination

Analysis Job

Operation Description
List Get a list of analysis jobs with optional filters
Get Get a single analysis job by ID

List Filters:

  • Status - QUEUED, PROCESSING, COMPLETED, FAILED
  • Search - Search term
  • Page/Page Size - Pagination

Opportunity

Operation Description
List Get a list of opportunities with optional filters
Get Get a single opportunity by ID
Create Create a new opportunity
Update Update an existing opportunity

List Filters:

  • Status - pending, approved, rejected, converted
  • Conversation ID - Filter by conversation
  • Limit/Offset - Pagination

Create/Update Fields:

  • Title, Description
  • Type - upselling, nueva_venta, renovacion_retencion, cross_sell
  • Status, Confidence
  • Estimated Value, Currency
  • Signals (comma-separated)
  • Expected Close Date
  • Conversation ID

Usage

Operation Description
Get Stats Get API usage statistics and subscription limits

Simplified Output

All List and Get operations include a Simplified Output option that returns only essential fields and excludes internal fields like tenant_id, created_at, updated_at, and deleted_at.

Fields included in simplified output:

Resource Fields
Conversation id, title, description, date_time, duration_minutes, status, team_id, project_id, client_id, source_key, conversation_type_key, ai_context, sentiment
Contact id, first_name, last_name, email, phone, company_name, job_title
Team id, name, description, color
Project id, name, description, status, client_id, ai_context
Client id, name, code, type, status, industry, website
Source id, key, label, active

Example Usage

Create a Conversation

  1. Add a TukiMate node to your workflow
  2. Select Conversation as the resource
  3. Select Create as the operation
  4. Fill in the required fields:
    • Title
    • Date/Time
    • Transcript
    • Source (e.g., "api")
  5. Optionally add:
    • Team
    • Project
    • Client
    • Participants
    • Tags
    • Language

List Conversations with Filters

  1. Add a TukiMate node
  2. Select Conversation > List
  3. Optionally filter by:
    • Search term
    • External Meeting ID
    • Team, Client, Project
    • Date range
    • Category
    • Contact
    • Limit/Offset for pagination
  4. Enable Simplified Output for cleaner responses

Find Conversation by External Meeting ID

  1. Add a TukiMate node
  2. Select Conversation > List
  3. Enter the External Meeting ID (e.g., Zoom meeting ID)
  4. Set Limit to 1

Trigger AI Analysis

  1. Add a TukiMate node
  2. Select Conversation > Analyze
  3. Enter the Conversation ID
  4. Optionally specify analysis config IDs

Get Usage Statistics

  1. Add a TukiMate node
  2. Select Usage > Get Stats
  3. View your API usage and limits

Development

This project uses Docker for builds:

# Build
docker compose run build

# Publish
docker compose run publish

License

MIT

Support

Discussion