Monday.com Integration Template

Integrieren Sie Monday.com Work OS in Ihre Mid-Call-Tools mit drei mächtigen Funktionen: Items suchen, Status aktualisieren und neue Items erstellen. Perfekt für Team-Koordination, Projekt-Tracking und agile Workflows.

Überblick & Funktionen

Items suchen

  • GraphQL-basierte Board-Durchsuchung
  • Multi-Board-Queries möglich
  • Column-Value-Filtering
  • Customer-spezifische Item-Lookups

Status aktualisieren

  • Echtzeit-Status-Updates
  • Column-Value-Modifications
  • Priority und Assignment-Changes
  • Progress-Tracking-Integration

Items erstellen

  • Automatische Task-Creation aus Gespräch
  • Group-basierte Organisation
  • Custom Column-Values setzen
  • Team-Assignment und Deadline-Setting

Monday.com API & Workspace Setup

1. Monday.com API-Zugang einrichten

1

Monday.com Account & Permissions

  • Stellen Sie sicher, dass Sie Admin-Rechte in Ihrem Monday.com Account haben
  • Navigieren Sie zu “Profile” → “Admin” → “API”
  • Überprüfen Sie verfügbare Boards und deren IDs
2

API Token generieren

API-Token-Erstellung:
  1. "Profile" → "Admin" → "API"
  2. "API v2 Token" → "Generate"
  3. Token-Name: "Famulor Mid-Call Integration"
  4. Token kopieren und sicher speichern
  5. Permissions: Lesen und Schreiben für relevante Boards
3

Board-IDs und Struktur analysieren

Board-Information sammeln:
  1. Relevante Boards identifizieren:
     - Sales Pipeline Board (ID: 1234567890)
     - Support Tickets Board (ID: 2345678901)
     - Feature Requests Board (ID: 3456789012)
  
  2. Column-IDs dokumentieren:
     - Status Column: "status"
     - Priority Column: "priority" 
     - Assignee Column: "person"
     - Date Column: "date4"
  
  3. Group-IDs für Organisation:
     - "new_group" für neue Items
     - "topics" für Standard-Tasks
4

GraphQL-Schema verstehen

  • Monday.com nutzt GraphQL für alle API-Operationen
  • Queries für Daten-Abruf (search_monday_items)
  • Mutations für Änderungen (update_monday_status, create_monday_item)
  • Strukturierte Response-Handling erforderlich

Tool 1: Items suchen

Konfiguration im Famulor Interface

FeldWert
Name*Monday.com Items suchen
Beschreibung”Sucht Items nach verschiedenen Kriterien in Monday.com Boards für Status-Updates und Follow-ups”
Funktionsname*search_monday_items
Funktionsbeschreibung*“Durchsucht Monday.com Boards. Verwenden Sie dies, um bestehende Tasks zu finden, Status zu prüfen oder Kundenbezogene Items zu lokalisieren.”
HTTP-MethodePOST
Timeout (ms)5000
Endpoint*https://api.monday.com/v2

Parameter-Schema für Item-Suche

{
  "type": "object",
  "properties": {
    "board_ids": {
      "type": "array",
      "items": {"type": "integer"},
      "description": "Monday.com Board IDs zum Durchsuchen",
      "examples": [[1234567890], [1234567890, 2345678901]]
    },
    "search_term": {
      "type": "string",
      "description": "Suchbegriff für Item-Namen oder Column-Values (wird in GraphQL-Filter integriert)"
    },
    "status_filter": {
      "type": "string",
      "enum": ["", "Working on it", "Done", "Stuck", "Not Started"],
      "description": "Filtert Items nach Status-Column"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of items to return",
      "default": 20,
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": ["board_ids"]
}

Response-Mapping

{
  "items": "data.boards[0].items",
  "totalCount": "data.boards[0].items.length"
}

Tool 2: Status aktualisieren

Konfiguration im Famulor Interface

FeldWert
Name*Monday.com Status Update
Beschreibung”Aktualisiert den Status oder andere Column-Values eines Monday.com Items”
Funktionsname*update_monday_status
Funktionsbeschreibung*“Aktualisiert ein Monday.com Item. Verwenden Sie dies, um Task-Status zu ändern, Assignees zu aktualisieren oder Deadline-Änderungen vorzunehmen.”
HTTP-MethodePOST
Timeout (ms)5000
Endpoint*https://api.monday.com/v2

Parameter-Schema für Updates

{
  "type": "object",
  "properties": {
    "board_id": {
      "type": "integer",
      "description": "Monday.com Board ID des zu aktualisierenden Items"
    },
    "item_id": {
      "type": "integer", 
      "description": "Item ID (aus vorheriger Suche oder bekannt)"
    },
    "column_id": {
      "type": "string",
      "description": "Column ID für Update (z.B. 'status', 'priority', 'person')",
      "examples": ["status", "priority", "person", "date4", "text"]
    },
    "value": {
      "type": "string",
      "description": "Neuer Wert für die Column (JSON-String für komplexe Columns)"
    },
    "update_reason": {
      "type": "string",
      "description": "Grund für das Update (für Audit-Trail)",
      "examples": ["Customer Call Update", "Status Change", "Priority Escalation"]
    }
  },
  "required": ["board_id", "item_id", "column_id", "value"]
}

Response-Mapping

{
  "itemId": "data.change_column_value.id",
  "itemName": "data.change_column_value.name"
}

Tool 3: Item erstellen

Konfiguration im Famulor Interface

FeldWert
Name*Monday.com Item erstellen
Beschreibung”Erstellt ein neues Item (Task) in einem Monday.com Board basierend auf Gesprächsinhalten”
Funktionsname*create_monday_item
Funktionsbeschreibung*“Erstellt ein neues Item in Monday.com. Verwenden Sie dies für Action Items, Follow-up-Tasks oder Kundenanfragen aus dem Gespräch.”
HTTP-MethodePOST
Timeout (ms)5000
Endpoint*https://api.monday.com/v2

Parameter-Schema für Item-Creation

{
  "type": "object",
  "properties": {
    "board_id": {
      "type": "integer",
      "description": "Monday.com Board ID wo das Item erstellt werden soll"
    },
    "group_id": {
      "type": "string",
      "description": "Gruppe/Sektion ID innerhalb des Boards (z.B. 'new_group', 'topics')",
      "examples": ["new_group", "topics", "this_week", "next_week"]
    },
    "item_name": {
      "type": "string", 
      "description": "Name des neuen Items/Tasks"
    },
    "column_values": {
      "type": "string",
      "description": "JSON-String mit Column-Values für Initialisierung",
      "examples": [
        "{\"status\": {\"label\": \"Working on it\"}, \"priority\": {\"label\": \"High\"}}",
        "{\"person\": {\"personsAndTeams\": [{\"id\": 12345}]}, \"date4\": {\"date\": \"2024-01-20\"}}"
      ]
    },
    "customer_name": {
      "type": "string",
      "description": "Kundenname für Item-Kategorisierung (wird in Text-Column eingefügt)"
    },
    "phone_number": {
      "type": "string",
      "description": "Kundenkontakt für Follow-ups (wird in Text-Column eingefügt)"
    },
    "priority": {
      "type": "string",
      "enum": ["Critical", "High", "Medium", "Low"],
      "description": "Prioritätsstufe basierend auf Gesprächskontext",
      "default": "Medium"
    },
    "due_date": {
      "type": "string",
      "format": "date",
      "description": "Deadline für die Aufgabe (YYYY-MM-DD)"
    },
    "estimated_hours": {
      "type": "number",
      "description": "Geschätzte Arbeitszeit in Stunden",
      "minimum": 0.5,
      "maximum": 100
    }
  },
  "required": ["board_id", "item_name"]
}

Praktische Anwendungsszenarien

Szenario 1: Customer-Support-Workflow

1

Problem-Assessment & Item-Lookup

Kunde: "Mein Ticket SUP-123 - gibt es Updates?"

KI: "Ich schaue nach Ihrem Ticket..."

search_monday_items:
  board_ids: [2345678901]  # Support Board
  search_term: "SUP-123"

GraphQL Query:
  query { 
    boards (ids: [2345678901]) { 
      items (limit: 50) { 
        id name 
        column_values { 
          id text value 
        } 
      } 
    } 
  }
2

Status-Update basierend auf Gespräch

Wenn Problem gelöst:
  KI: "Ich markiere Ihr Ticket als erledigt..."
  
update_monday_status:
  board_id: 2345678901
  item_id: 987654321  # Aus Search-Result
  column_id: "status"
  value: "{\"label\": \"Done\"}"

GraphQL Mutation:
  mutation { 
    change_column_value (
      board_id: 2345678901, 
      item_id: 987654321, 
      column_id: "status", 
      value: "{\"label\": \"Done\"}"
    ) { 
      id name 
    } 
  }

Szenario 2: Sales-Pipeline-Management

Szenario 3: Project-Koordination

GraphQL-Queries & Mutations im Detail

Erweiterte Search-Queries

Complex Column-Value-Updates

{
  "Status": "{\"label\": \"Working on it\"}",
  "Priority": "{\"label\": \"High\"}",
  "Checkbox": "{\"checked\": \"true\"}"
}

Response-Verarbeitung

Item-Search Response

{
  "data": {
    "boards": [
      {
        "items": [
          {
            "id": "987654321",
            "name": "Demo Request - Beispiel AG",
            "column_values": [
              {
                "id": "status",
                "text": "Working on it",
                "value": "{\"label\": \"Working on it\", \"color\": \"#fdab3d\"}"
              },
              {
                "id": "person",
                "text": "Sales Team",
                "value": "{\"personsAndTeams\": [{\"id\": 12345, \"kind\": \"person\"}]}"
              }
            ],
            "created_at": "2024-01-15T10:30:00Z",
            "updated_at": "2024-01-15T14:20:00Z"
          }
        ]
      }
    ]
  }
}

Natürliche Sprachintegration

Erweiterte Monday.com Features

Automation & Workflows

Advanced Column-Types

Customer-Database-Integration:
  
Customer-Info-Columns:
  - "Customer Name": Text field
  - "Contact Email": Email field  
  - "Phone Number": Phone field
  - "Company Size": Dropdown (Small/Medium/Large)
  - "Industry": Dropdown (Tech/Healthcare/Finance/...)
  
Business-Context:
  - "Deal Size": Numbers (€)
  - "Urgency": Rating (1-5 stars)
  - "Last Contact": Date
  - "Next Follow-up": Date

Performance & Analytics

Monday.com Integration-KPIs

MetrikBeschreibungZielwert
Item Creation Success Rate% erfolgreich erstellter Items>99%
GraphQL Query PerformanceDurchschnittliche Response-Zeit<1.5 Sekunden
Update Success Rate% erfolgreiche Column-Updates>98%
Team Adoption Rate% der Items mit Mid-Call-Origin die bearbeitet werden>85%

Business Impact Tracking

1

Workflow-Efficiency

Productivity-Metriken:
  - Reduzierte Zeit von Gespräch zu Task-Assignment
  - Höhere Follow-up-Rate durch automatische Item-Creation
  - Verbesserte Team-Coordination durch structured Data
  - Reduzierte "vergessene Action Items"
2

Customer-Experience-Impact

Customer-Satisfaction:
  - Schnellere Problem-Resolution durch sofortige Ticket-Creation
  - Höhere Transparenz durch Item-Status-Sharing
  - Proaktive Updates durch Automation-Rules
  - Reduzierte "Lost in System"-Erfahrungen

Fehlerbehandlung

Monday.com GraphQL Errors


GraphQL-Komplexität: Monday.com verwendet GraphQL, was komplexere Query-Strukturen erfordert. Testen Sie alle Queries ausführlich in der Monday.com API-Playground bevor Sie sie in Production verwenden.
Productivity-Tipp: Nutzen Sie Monday.com-Automation-Rules in Kombination mit den Mid-Call-Tools um vollständige Workflow-Automation zu erreichen. Dies maximiert den ROI der Integration.