Crm

Kommo

Learn how to use Kommo with Composio

Overview

SLUG: KOMMO

Description

Kommo CRM (formerly amoCRM) integration tool for managing customer relationships, sales pipelines, and business processes.

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
string
bearer_token
string
subdomain
stringRequired

Connecting to Kommo

Create an auth config

Use the dashboard to create an auth config for the Kommo toolkit. This allows you to connect multiple Kommo accounts to Composio for agents to use.

1

Select App

Navigate to the Kommo toolkit page and click “Setup Integration”.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using OAuth2

1from composio import Composio
2from composio.types import auth_scheme
3
4# Replace these with your actual values
5kommo_auth_config_id = "ac_YOUR_KOMMO_CONFIG_ID" # Auth config ID created above
6user_id = "0000-0000-0000"  # UUID from database/application
7
8composio = Composio()
9
10
11def authenticate_toolkit(user_id: str, auth_config_id: str):
12    connection_request = composio.connected_accounts.initiate(
13        user_id=user_id,
14        auth_config_id=auth_config_id,
15    )
16
17    print(
18        f"Visit this URL to authenticate Kommo: {connection_request.redirect_url}"
19    )
20
21    # This will wait for the auth flow to be completed
22    connection_request.wait_for_connection(timeout=15)
23    return connection_request.id
24
25
26connection_id = authenticate_toolkit(user_id, kommo_auth_config_id)
27
28# You can also verify the connection status using:
29connected_account = composio.connected_accounts.get(connection_id)
30print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Kommo toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["KOMMO"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Create Kommo Companies

Description

Action to add one or more companies into the kommo account.

Action Parameters

created_at
integer
created_by
integer
custom_fields_values
array
name
stringRequired
request_id
string
responsible_user_id
integer
tags_to_add
array
updated_at
integer
updated_by
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Kommo Contact

Description

Action to create one or more contacts in kommo crm.

Action Parameters

contacts
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Kommo Lead

Description

Action to create one or more leads in kommo crm.

Action Parameters

closed_at
integer
created_at
integer
created_by
integer
custom_fields_values
array
loss_reason_id
integer
name
stringRequired
pipeline_id
integer
price
integer
responsible_user_id
integer
status_id
integer
tags_to_add
array
tags_to_delete
array
updated_at
integer
updated_by
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Kommo Tasks

Description

Action to create a task in kommo crm.

Action Parameters

complete_till
integer
created_at
integer
created_by
integer
duration
integer
entity_id
integer
entity_type
string
responsible_user_id
integer
task_type_id
integer
text
stringRequired
updated_at
integer
updated_by
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Kommo Companies

Description

Action to list kommo companies with various filter options.

Action Parameters

filter
object
limit
integer
order
object
page
integer
query
string
with_params
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Kommo Contacts

Description

Action to list contacts in kommo crm.

Action Parameters

filter_closest_task_at
object
filter_created_at
integer
filter_created_by
array
filter_ids
array
filter_names
array
filter_responsible_user_ids
array
filter_updated_at
object
filter_updated_by
array
limit
integer
order_by_id
string
order_by_updated_at
string
page
integer
query
string
with_params
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Kommo Leads

Description

Action to list leads in kommo crm.

Action Parameters

filter_closed_at
object
filter_closest_task_at
object
filter_created_at
object
filter_created_by
array
filter_ids
array
filter_names
array
filter_pipeline_ids
array
filter_price
integer
filter_responsible_user_ids
array
filter_status
object
filter_updated_at
object
filter_updated_by
array
limit
integer
order_by_created_at
string
order_by_id
string
order_by_updated_at
string
page
integer
query
string
with_params
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Kommo Lead Pipelines

Description

Action to list lead pipelines in kommo crm.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Kommo Pipeline Stages

Description

Action to list stages of a pipeline in kommo crm.

Action Parameters

pipeline_id
integerRequired
with_description
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Kommo Company

Description

Action to update a single company in kommo crm.

Action Parameters

company_id
integerRequired
created_at
integer
created_by
integer
custom_fields_values
array
name
string
request_id
string
responsible_user_id
integer
tags_to_add
array
updated_at
integer
updated_by
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Kommo Contact

Description

Action to update contacts in kommo crm.

Action Parameters

created_at
integer
created_by
integer
custom_fields_values
array
first_name
string
id
integerRequired
last_name
string
name
string
request_id
string
responsible_user_id
integer
updated_at
integer
updated_by
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Kommo Lead

Description

Action to update a lead in kommo crm.

Action Parameters

closed_at
integer
created_at
integer
created_by
integer
custom_fields_values
array
id
integerRequired
loss_reason_id
integer
name
string
pipeline_id
integer
price
integer
request_id
string
responsible_user_id
integer
status_id
integer
tags_to_add
array
tags_to_delete
array
updated_at
integer
updated_by
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Kommo Custom Fields

Description

Action to list custom fields in kommo crm.

Action Parameters

entity_type
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Kommo Tasks

Description

Action to list tasks in kommo crm.

Action Parameters

filter_entity_ids
array
filter_entity_type
string
filter_ids
array
filter_is_completed
integer
filter_responsible_user_ids
array
filter_task_types
array
filter_updated_at
object
limit
integer
order_by_complete_till
string
order_by_created_at
string
order_by_id
string
page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Kommo Task

Description

Action to update a task in kommo crm.

Action Parameters

complete_till
integer
duration
integer
entity_id
integer
entity_type
string
id
integerRequired
is_completed
boolean
responsible_user_id
integer
result
object
task_type_id
integer
text
string

Action Response

data
objectRequired
error
string
successful
booleanRequired