kommo

仓库: vm0-ai/vm0-skills
安装量: 49
排名: #15063

安装

npx skills add https://github.com/vm0-ai/vm0-skills --skill kommo

Kommo API

Use the Kommo API via direct curl calls for CRM management including leads, contacts, companies, tasks, and sales pipelines.

Official docs: https://developers.kommo.com/

When to Use

Use this skill when you need to:

Manage leads - Create, list, update leads in your sales pipeline Handle contacts - Add and retrieve customer contact information Track companies - Manage company records and associations Create tasks - Schedule follow-ups and meetings View pipelines - Get sales pipeline stages and statuses Prerequisites Sign up at Kommo Create a private integration: Go to Settings > Integrations > Create Integration Select "Private integration" Go to "Keys and scopes" tab Click "Generate long-lived token" Copy the token (it cannot be retrieved again) Note your subdomain from your Kommo URL: https://{subdomain}.kommo.com export KOMMO_SUBDOMAIN="your-subdomain" # e.g., "mycompany" (not "mycompany.kommo.com") export KOMMO_API_KEY="your-long-lived-token"

Important: When using $VAR in a command that pipes to another command, wrap the command containing $VAR in bash -c '...'. Due to a Claude Code bug, environment variables are silently cleared when pipes are used directly.

bash -c 'curl -s "https://api.example.com" -H "Authorization: Bearer $API_KEY"'

How to Use

All examples below assume you have environment variables set.

The base URL is: https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4

Authentication uses Bearer token in the Authorization header.

Rate limit: Maximum 7 requests per second.

  1. List Leads

Get all leads in your account:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/leads" -H "Accept: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}"' | jq '.["_embedded"]["leads"][] | {id, name, price}'

With filters:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/leads?limit=10&page=1" -H "Accept: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}"' | jq '.["_embedded"]["leads"]'

  1. Get Lead by ID

Get a specific lead:

Replace with the actual lead ID:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/leads/" -H "Accept: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}"'

  1. Create Lead

Create a new lead:

Write to /tmp/kommo_request.json:

[{ "name": "New Lead", "price": 5000 }]

Then run:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/leads" -X POST -H "Content-Type: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}" -d @/tmp/kommo_request.json'

  1. Create Lead with Contact and Company

Create a lead with associated contact and company:

Write to /tmp/kommo_request.json:

[{ "name": "Lead with Contact", "price": 10000, "_embedded": { "contacts": [{ "first_name": "John", "last_name": "Doe" }], "companies": [{ "name": "Acme Corp" }] } }]

Then run:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/leads/complex" -X POST -H "Content-Type: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}" -d @/tmp/kommo_request.json'

  1. Update Lead

Update an existing lead:

Write to /tmp/kommo_request.json:

{ "price": 7500, "name": "Updated Lead Name" }

Then run:

Replace with the actual lead ID:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/leads/" -X PATCH -H "Content-Type: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}" -d @/tmp/kommo_request.json'

  1. List Contacts

Get all contacts:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/contacts" -H "Accept: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}"' | jq '.["_embedded"]["contacts"][] | {id, name}'

  1. Get Contact by ID

Get a specific contact:

Replace with the actual contact ID:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/contacts/" -H "Accept: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}"'

  1. Create Contact

Create a new contact:

Write to /tmp/kommo_request.json:

[{ "first_name": "Jane", "last_name": "Smith" }]

Then run:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/contacts" -X POST -H "Content-Type: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}" -d @/tmp/kommo_request.json'

  1. List Companies

Get all companies:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/companies" -H "Accept: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}"' | jq '.["_embedded"]["companies"][] | {id, name}'

  1. Create Company

Create a new company:

Write to /tmp/kommo_request.json:

[{ "name": "New Company Inc" }]

Then run:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/companies" -X POST -H "Content-Type: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}" -d @/tmp/kommo_request.json'

  1. List Tasks

Get all tasks:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/tasks" -H "Accept: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}"' | jq '.["_embedded"]["tasks"][] | {id, text, complete_till}'

  1. Create Task

Create a new task (use Unix timestamp for complete_till):

Write to /tmp/kommo_request.json:

[{ "text": "Follow up with client", "complete_till": 1735689600, "task_type_id": 1 }]

Then run:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/tasks" -X POST -H "Content-Type: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}" -d @/tmp/kommo_request.json'

Task types: 1 = Follow-up, 2 = Meeting

  1. List Pipelines

Get all sales pipelines:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/leads/pipelines" -H "Accept: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}"' | jq '.["_embedded"]["pipelines"][] | {id, name}'

  1. Get Pipeline Stages

Get stages for a specific pipeline:

Replace with the actual pipeline ID:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/leads/pipelines/" -H "Accept: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}"' | jq '.["_embedded"]["statuses"][] | {id, name}'

  1. Get Account Info

Get account information:

bash -c 'curl -s "https://${KOMMO_SUBDOMAIN}.kommo.com/api/v4/account" -H "Accept: application/json" -H "Authorization: Bearer ${KOMMO_API_KEY}"' | jq '{id, name, subdomain, currency}'

Response Format Lead Response { "id": 12345, "name": "Lead Name", "price": 5000, "responsible_user_id": 123, "pipeline_id": 456, "status_id": 789 }

Contact Response { "id": 12345, "name": "John Doe", "first_name": "John", "last_name": "Doe" }

Guidelines Rate limit: Maximum 7 requests per second, 429 returned if exceeded Array format: POST requests for creating entities expect an array of objects Use pagination: Add ?limit=N&page=N for large result sets Task timestamps: complete_till is Unix timestamp in seconds If-Modified-Since: Use this header for efficient polling of list endpoints

← 返回排行榜