Kommo-Automation

Was macht Kommo-Automation?

Verwalten Sie Ihre Kommo CRM-Vertriebspipeline – listen und filtern Sie Leads, navigieren Sie durch Pipeline-Stufen, erstellen und aktualisieren Sie Deals, weisen Sie Aufgaben zu und arbeiten Sie mit benutzerdefinierten Feldern – alles über natürliche Sprachbefehle.

Toolkit-Dokumentation: composio.dev/toolkits/kommo

---

Einrichtung

1. Fügen Sie den Composio MCP-Server zu Ihrer Client-Konfiguration hinzu:

   https://rube.app/mcp
   

2. Verbinden Sie Ihr Kommo-Konto, wenn Sie dazu aufgefordert werden (OAuth-Authentifizierung).
3. Beginnen Sie, natürliche Sprachbefehle zur Verwaltung Ihres CRM zu erteilen.

---

Kern-Workflows

1. Pipelines und Stufen navigieren

Listen Sie alle Lead-Pipelines auf und tauchen Sie dann in bestimmte Pipeline-Stufen ein, um die Struktur Ihres Verkaufstrichters zu verstehen.

Tools: KOMMO_LIST_LEADS_PIPELINES, KOMMO_LIST_PIPELINE_STAGES

Beispiel-Prompt:

„Zeige mir alle meine Kommo-Pipelines und die Stufen in meiner Hauptvertriebspipeline“

Wichtige Parameter für Pipelines auflisten: Keine erforderlich.

Wichtige Parameter für Stufen auflisten:

• pipeline_id (erforderlich) – Die Pipeline-ID, für die Stufen aufgelistet werden sollen
• with_description – Beschreibungen der Stufen in die Antwort einbeziehen (boolesch)

---

2. Leads auflisten und filtern

Rufen Sie Leads mit leistungsstarken Filtern nach Pipeline, Status, Datumsbereichen, verantwortlichen Benutzern, Preis und mehr ab.

Tool: KOMMO_LIST_LEADS

Beispiel-Prompt:

„Zeige alle Leads in Pipeline 12345, die diese Woche erstellt wurden, sortiert nach neuesten zuerst“

Wichtige Parameter:

• query – Freitextsuche über alle ausgefüllten Felder
• filter_pipeline_ids – Nach Pipeline-IDs filtern (Array von Ganzzahlen)
• filter_status – Nach Status innerhalb einer Pipeline filtern: {"pipeline_id": 123, "status_id": 456}
• filter_responsible_user_ids – Nach IDs zugewiesener Benutzer filtern
• filter_names – Nach Lead-Namen filtern
• filter_price – Nach Deal-Wert filtern
• filter_created_at – Datumsbereich: {"from": <unix_timestamp>, "to": <unix_timestamp>}
• filter_updated_at – Datumsbereich für letzte Aktualisierung
• filter_closed_at – Datumsbereich für Abschluss
• order_by_created_at – Sortierung: „asc“ oder „desc“
• order_by_updated_at – Nach Aktualisierungsdatum sortieren
• limit – Maximal 250 pro Seite
• page – Seitennummer für Paginierung
• with_params – Zusätzliche Daten: „contacts“, „loss_reason“, „catalog_elements“, „source_id“

---

3. Neue Leads erstellen

Fügen Sie Ihrem Kommo-Pipeline neue Deals mit benutzerdefinierten Feldern, Tags und Pipeline-Platzierung hinzu.

Tool: KOMMO_CREATE_LEAD

Beispiel-Prompt:

„Erstelle einen neuen Lead namens 'Acme Corp Deal' im Wert von 50.000 $ in Pipeline 12345“

Wichtige Parameter:

• name (erforderlich) – Name des Leads/Deals
• price – Deal-Wert (Ganzzahl)
• pipeline_id – Pipeline, zu der der Lead hinzugefügt werden soll
• status_id – Stufe innerhalb der Pipeline (standardmäßig erste Stufe der Hauptpipeline)
• responsible_user_id – ID des zugewiesenen Benutzers
• custom_fields_values – Array von Objekten mit benutzerdefinierten Feldwerten
• tags_to_add – Array von Tags (nach Name oder ID)
• created_by – Benutzer-ID des Erstellers (0 für Roboter)
• loss_reason_id – Grund für den Verlust (falls zutreffend)

---

4. Vorhandene Leads aktualisieren

Ändern Sie Lead-Eigenschaften einschließlich Name, Preis, Pipeline-Stufe, verantwortlichem Benutzer, Tags und benutzerdefinierten Feldern.

Tool: KOMMO_UPDATE_LEAD

Beispiel-Prompt:

„Verschiebe Lead 789 in Stufe 456 in Pipeline 123 und aktualisiere den Preis auf 75.000 $“

Wichtige Parameter:

• Lead-ID (erforderlich)
• Beliebig Kombination von: name, price, pipeline_id, status_id, responsible_user_id, tags_to_add, tags_to_delete, custom_fields_values

---

5. Aufgaben erstellen

Weisen Sie Folgeaufgaben zu, die mit Leads, Kontakten oder Unternehmen verknüpft sind.

Tool: KOMMO_CREATE_TASK

Beispiel-Prompt:

„Erstelle eine Aufgabe für einen Rückruf zu Lead 789, fällig morgen, zugewiesen an Benutzer 42“

Wichtige Parameter:

• Aufgabentext/-beschreibung
• Entitätstyp und ID (Lead, Kontakt, Unternehmen)
• ID des verantwortlichen Benutzers
• Fälligkeitsdatum (Unix-Zeitstempel)
• Aufgabentyp

---

6. Benutzerdefinierte Felder entdecken

Listen Sie alle benutzerdefinierten Felder für Leads, Kontakte oder Unternehmen auf, um Ihr CRM-Schema zu verstehen.

Tool: KOMMO_LIST_CUSTOM_FIELDS

Beispiel-Prompt:

„Welche benutzerdefinierten Felder sind für Leads in Kommo verfügbar?“

Wichtige Parameter:

• Entitätstyp (leads, contacts, companies)

---

Bekannte Fallstricke

• Datumsfilter verwenden Unix-Zeitstempel: Alle Datumsbereichsfilter (filter_created_at, filter_updated_at, filter_closed_at) erfordern das Unix-Zeitstempelformat in der Struktur {"from": <timestamp>, "to": <timestamp>}, keine ISO8601-Strings.
• Pipeline- und Stufen-IDs sind erforderlich: Um Leads nach Status zu filtern, benötigen Sie sowohl pipeline_id als auch status_id. Rufen Sie zuerst immer KOMMO_LIST_LEADS_PIPELINES und KOMMO_LIST_PIPELINE_STAGES auf, um gültige IDs zu ermitteln.
• Maximal 250 Leads pro Seite: Der limit-Parameter ist auf 250 begrenzt. Implementieren Sie bei großen Datensätzen eine Paginierung mit dem page-Parameter.
• Format der benutzerdefinierten Feldwerte: Benutzerdefinierte Felder verwenden ein spezifisches verschachteltes Objektformat. Verwenden Sie KOMMO_LIST_CUSTOM_FIELDS, um Feld-IDs und erwartete Wertformate zu ermitteln, bevor Sie Werte setzen.
• Statusfilter erfordert beide IDs: Der filter_status-Parameter erfordert sowohl pipeline_id als auch status_id als kombiniertes Objekt – Sie können nicht allein nach Status filtern.
• Created_by 0 bedeutet Roboter: Wenn Sie created_by oder updated_by auf 0 setzen, wird die Aktion einem Roboter/einer Automatisierung zugeschrieben, nicht einem menschlichen Benutzer.

---

Kurzreferenz

Aktion	Tool-Slug	Erforderliche Parameter
Pipelines auflisten	KOMMO_LIST_LEADS_PIPELINES	Keine
Pipeline-Stufen auflisten	KOMMO_LIST_PIPELINE_STAGES	pipeline_id
Leads auflisten	KOMMO_LIST_LEADS	Keine (optionale Filter)
Lead erstellen	KOMMO_CREATE_LEAD	name
Lead aktualisieren	KOMMO_UPDATE_LEAD	Lead-ID
Aufgabe erstellen	KOMMO_CREATE_TASK	Aufgabendetails
Benutzerdefinierte Felder auflisten	KOMMO_LIST_CUSTOM_FIELDS	Entitätstyp

---

Bereitgestellt von Composio