ComposioHQ/Capsule-CRM-Automation

Capsule CRM Automation

Verwalten Sie Ihr Capsule CRM – erstellen und aktualisieren Sie Kontakte, führen Sie leistungsstarke Filterabfragen auf Parteien/Opportunities/Fälle durch, verfolgen Sie Aufgaben und Projekte, durchsuchen Sie Aktivitätseinträge und organisieren Sie Teambeziehungen – und das alles über natürliche Sprachbefehle.

Toolkit-Dokumentation: composio.dev/toolkits/capsule_crm

---

Einrichtung

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

   https://rube.app/mcp
   

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

---

Kern-Workflows

1. Strukturierte Filterabfragen ausführen

Fragen Sie Parteien, Opportunities oder Fälle (Projekte) mit mehreren Filterbedingungen, Operatoren und Sortierungen ab.

Tool: CAPSULE_CRM_RUN_FILTER_QUERY

Beispielaufforderung:

„Finde alle Capsule-CRM-Kontakte in Kalifornien, die mit ‚VIP‘ getaggt sind, sortiert nach Name.“

Wichtige Parameter:

• entity (erforderlich) – Einer von: parties, opportunities, kases
• filter (erforderlich) – Filterobjekt mit:
  • conditions – Array von Bedingungen, jede mit:
    • field – Feldname (z. B. "name", "email", "state", "country", "tag", "owner", "jobTitle", "addedOn")
    • operator – Einer von: "is", "is not", "starts with", "ends with", "contains", "is greater than", "is less than", "is after", "is before", "is older than", "is within last", "is within next"
    • value – Vergleichswert
  • orderBy – Array von Sortierobjekten mit field und direction ("ascending"/"descending")
• embed – Zusätzliche Daten, die in die Antwort aufgenommen werden sollen
• page / perPage – Paginierung (max. 100 pro Seite)

Wichtige Feldhinweise:

• Adressfelder (city, state, country, zip) sind auf oberster Ebene, NICHT unter "address" verschachtelt.
• Länder müssen als ISO 3166-1 alpha-2-Code angegeben werden (z. B. "US", "GB", "CA").
• Benutzerdefinierte Felder verwenden das Format custom:{fieldId}.
• Organisationsfelder verwenden das Präfix org. (z. B. org.name, org.tag).

---

2. Kontakte (Parteien) auflisten und verwalten

Rufen Sie alle Kontakte mit optionaler Filterung nach Änderungsdatum und eingebetteten zugehörigen Daten ab.

Tool: CAPSULE_CRM_LIST_PARTIES

Beispielaufforderung:

„Liste alle Capsule-CRM-Kontakte auf, die seit Januar 2025 geändert wurden, mit ihren Tags und Organisationen.“

Wichtige Parameter:

• since – ISO8601-Datum, um nach Kontakten zu filtern, die nach diesem Datum geändert wurden
• embed – Zusätzliche Daten: "tags", "fields", "organisation", "missingImportantFields"
• page / perPage – Paginierung (max. 100 pro Seite, Standard 50)

---

3. Neue Kontakte erstellen

Fügen Sie Personen oder Organisationen mit vollständigen Details wie E-Mails, Telefonnummern, Adressen, Tags und benutzerdefinierten Feldern zu Ihrem Capsule CRM hinzu.

Tool: CAPSULE_CRM_CREATE_PARTY

Beispielaufforderung:

„Erstelle eine neue Person in Capsule CRM: John Smith, VP of Sales bei Acme Corp, [email protected]“

Wichtige Parameter:

• type (erforderlich) – "person" oder "organisation"
• Für Personen: firstName, lastName, jobTitle, title
• Für Organisationen: name
• emailAddresses – Array von {address, type}-Objekten
• phoneNumbers – Array von {number, type}-Objekten
• addresses – Array von Adressobjekten mit street, city, state, country, zip, type (Home/Postal/Office/Billing/Shipping)
• organisation – Verknüpfung zu einer Organisation per {id} oder {name} (wird erstellt, falls nicht gefunden)
• tags – Array von Tags per {name} oder {id}
• fields – Werte benutzerdefinierter Felder mit {definition, value}
• websites – Array von {address, service, type}-Objekten
• owner – Besitzer-Benutzer zuweisen per {id}

---

4. Vorhandene Kontakte aktualisieren

Ändern Sie jeden Aspekt eines Parteien-Datensatzes, einschließlich Hinzufügen/Entfernen von E-Mails, Telefonnummern, Tags und benutzerdefinierten Feldern.

Tool: CAPSULE_CRM_UPDATE_PARTY

Beispielaufforderung:

„Aktualisiere Capsule-CRM-Partei 11587: füge eine geschäftliche E-Mail [email protected] hinzu und entferne das Tag ‚prospect‘.“

Wichtige Parameter:

• partyId (erforderlich) – Integer-ID der zu aktualisierenden Partei
• party (erforderlich) – Objekt mit den zu aktualisierenden Feldern. Unterstützt:
  • Alle Erstellungsfelder (Name, E-Mails, Telefonnummern, Adressen usw.)
  • _delete: true bei Unterelementen, um sie zu entfernen (erfordert die id des Elements)
  • Tags: Hinzufügen per {name} oder entfernen mit {id, _delete: true}

---

5. Aufgaben verfolgen

Listen Sie Aufgaben mit Filterung nach Status und eingebetteten zugehörigen Daten auf.

Tool: CAPSULE_CRM_LIST_TASKS

Beispielaufforderung:

„Zeige alle offenen Aufgaben in Capsule CRM mit ihren verknüpften Parteien und Besitzern.“

Wichtige Parameter:

• status – Nach Status filtern: "open", "completed", "pending" (Array)
• embed – Zusätzliche Daten: "party", "opportunity", "kase", "owner", "nextTask"
• page / perPage – Paginierung (max. 100 pro Seite, Standard 50)

---

6. Projekte und Aktivitätseinträge durchsuchen

Listen Sie Projekte (Fälle) und aktuelle Aktivitätseinträge auf, einschließlich Notizen, E-Mails und abgeschlossener Aufgaben.

Tools: CAPSULE_CRM_LIST_PROJECTS, CAPSULE_CRM_LIST_ENTRIES_BY_DATE

Beispielaufforderung:

„Zeige alle offenen Projekte in Capsule CRM“ / „Zeige aktuelle Aktivitätseinträge mit Parteien-Details.“

Wichtige Parameter für Projekte:

• status – Nach "OPEN" oder "CLOSED" filtern
• search – Suchbegriff für Projektnamen/-beschreibungen
• since – ISO8601-Datum für Änderungen nach diesem Datum
• embed – "tags,fields,party,opportunity,missingImportantFields"

Wichtige Parameter für Einträge:

• embed – "party", "kase", "opportunity", "creator", "activityType"
• page / perPage – Paginierung (max. 100 pro Seite)

---

Bekannte Fallstricke

• Adressfelder sind auf oberster Ebene: Verwenden Sie beim Filtern direkt state, city, country, zip – NICHT address.state oder verschachtelte Syntax.
• Ländercodes sind ISO alpha-2: Filtern Sie nach "US", "GB", "CA" – nicht nach "United States" oder "United Kingdom".
• Benutzerdefinierte Felder verwenden spezielle Syntax: Referenzieren Sie benutzerdefinierte Felder als custom:{fieldId} in Filterbedingungen. Verwenden Sie für organisationsweite benutzerdefinierte Felder org.custom:{fieldId}.
• Projekte werden in der API als "kases" bezeichnet: Obwohl sie in der Benutzeroberfläche "Projekte" sind, lautet der API-Entitätstyp kases. Verwenden Sie kases in Filterabfragen.
• Löschoperationen erfordern Element-IDs: Wenn Sie eine Partei aktualisieren, um Unterelemente (E-Mails, Telefonnummern, Tags) zu entfernen, müssen Sie die id des Elements zusammen mit _delete: true angeben. Listen Sie die Partei zuerst auf, um die IDs der Unterelemente zu erhalten.
• Paginierung standardmäßig auf 50: Alle Listen-Endpunkte verwenden standardmäßig 50 Elemente pro Seite mit einem Maximum von 100. Implementieren Sie stets die Paginierung für vollständigen Datenabruf.
• Einbettungswerte variieren je nach Entität: Nicht alle Einbettungsoptionen funktionieren für alle Entitäten. Lesen Sie die Dokumentation für unterstützte Einbettungswerte pro Endpunkt.

---

Kurzreferenz

Aktion	Tool-Slug	Erforderliche Parameter
Filterabfrage ausführen	CAPSULE_CRM_RUN_FILTER_QUERY	entity, filter
Kontakte auflisten	CAPSULE_CRM_LIST_PARTIES	Keine (optionale Filter)
Kontakt erstellen	CAPSULE_CRM_CREATE_PARTY	type
Kontakt aktualisieren	CAPSULE_CRM_UPDATE_PARTY	partyId, party
Kontakt löschen	CAPSULE_CRM_DELETE_PARTY	party_id
Aufgaben auflisten	CAPSULE_CRM_LIST_TASKS	Keine (optionale Filter)
Projekte auflisten	CAPSULE_CRM_LIST_PROJECTS	Keine (optionale Filter)
Aktivitätseinträge auflisten	CAPSULE_CRM_LIST_ENTRIES_BY_DATE	Keine (optionale Filter)
Organisationsmitarbeiter auflisten	CAPSULE_CRM_LIST_ORG_EMPLOYEES	Organisations-ID
Gelöschte Opportunities auflisten	CAPSULE_CRM_LIST_DELETED_OPPORTUNITIES	since

---

Bereitgestellt von Composio