PandaDoc Automation

PandaDoc-Automation

Verwalten Sie PandaDoc-Dokumenten-Workflows direkt über Claude Code. Erstellen Sie Dokumente aus hochgeladenen Dateien, verwalten Sie Empfänger und Kontakte, organisieren Sie mit Ordnern, richten Sie Ereignis-Webhooks ein, erstellen Sie Vorlagen und verfolgen Sie den Dokumentenstatus, ohne Ihr Terminal verlassen zu müssen.

Toolkit-Dokumentation: composio.dev/toolkits/pandadoc

---

Einrichtung

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

   https://rube.app/mcp
   

2. Verbinden Sie Ihr PandaDoc-Konto, wenn Sie dazu aufgefordert werden. Der Agent stellt einen OAuth-Link zur Authentifizierung bereit.
3. Stellen Sie sicher, dass Ihr PandaDoc-Arbeitsbereich den passenden Tarif für die gewünschten Funktionen hat (z. B. elektronische Signaturen, Vorlagen, Webhooks).

---

Kern-Workflows

1. Dokument aus Datei erstellen

Laden Sie eine PDF-, DOCX- oder RTF-Datei hoch, um ein neues PandaDoc-Dokument mit festgelegten Empfängern zum Signieren und Verfolgen zu erstellen.

Tool: PANDADOC_CREATE_DOCUMENT_FROM_FILE

Wichtige Parameter:

• name (erforderlich) – Dokumentenname
• recipients (erforderlich) – Array von Empfängerobjekten, jeweils mit:
  • email (erforderlich) – E-Mail des Empfängers
  • first_name, last_name – Name des Empfängers
  • role – signer (Standard), approver oder cc (muss pro Empfänger eindeutig sein)
  • signing_order – numerische Reihenfolge (wenn für einen gesetzt, muss für alle gesetzt sein)
• file – hochgeladenes Dateiobjekt mit name, mimetype und s3key
• url – alternativ eine öffentliche HTTPS-URL zur Datei
• parse_form_fields (Standardwert false) – PDF-Formularfelder parsen
• tags – Array von Zeichenfolgen zur Kategorisierung
• owner – Dokumentenbesitzer (E-Mail oder membership_id)

Beispiel-Eingabeaufforderung: „Erstelle ein PandaDoc-Dokument aus contract.pdf mit [email protected] als Unterzeichner und [email protected] als Genehmiger“

---

2. Dokumentdetails abrufen

Rufen Sie umfassende Metadaten für ein Dokument ab, einschließlich Empfänger, Felder, Tokens, Preise, Tags und Content-Block-Referenzen.

Tool: PANDADOC_GET_DOCUMENT_DETAILS

Wichtige Parameter:

• id (erforderlich) – die eindeutige Dokumentkennung (z. B. BhVzRcxH9Z2LgfPPGXFUqa)

Verwenden Sie dies, um den Dokumentstatus zu überprüfen, den Abschluss von Empfängern zu prüfen, Feldwerte einzusehen oder Metadaten für Berichte zu sammeln.

Beispiel-Eingabeaufforderung: „Rufe die vollständigen Details und den Status für das PandaDoc-Dokument BhVzRcxH9Z2LgfPPGXFUqa ab“

---

3. Kontakte verwalten

Erstellen Sie neue Kontakte oder aktualisieren Sie bestehende in PandaDoc. Kontakte werden per E-Mail abgeglichen – wenn ein Kontakt mit der angegebenen E-Mail existiert, wird er aktualisiert; andernfalls wird ein neuer erstellt.

Tool: PANDADOC_CREATE_OR_UPDATE_CONTACT

Wichtige Parameter:

• email (erforderlich) – E-Mail-Adresse des Kontakts
• first_name, last_name – Name des Kontakts
• company – Firmenname
• job_title – Rolle/Position
• phone – Telefonnummer
• street_address, city, state, postal_code, country – Adressfelder

Beispiel-Eingabeaufforderung: „Erstelle einen PandaDoc-Kontakt für [email protected] bei Acme Corp als Softwareentwickler“

---

4. Mit Ordnern organisieren

Erstellen Sie Ordner und verschieben Sie Dokumente, um Ihren PandaDoc-Arbeitsbereich zu organisieren.

Tools: PANDADOC_CREATE_FOLDER, PANDADOC_LIST_DOCUMENT_FOLDERS, PANDADOC_MOVE_DOCUMENT_TO_FOLDER

Zum Erstellen von Ordnern:

• name (erforderlich) – Ordnername
• parent_uuid – UUID des übergeordneten Ordners für verschachtelte Strukturen

Beispiel-Eingabeaufforderung: „Erstelle einen Ordner 'Q1 2026 Verträge' in PandaDoc und verschiebe das Dokument BhVzRcxH9Z hinein“

---

5. Webhooks einrichten

Erstellen Sie Webhook-Abonnements, um Echtzeit-Benachrichtigungen bei Dokumentereignissen zu erhalten.

Tool: PANDADOC_CREATE_WEBHOOK

Wichtige Parameter:

• name (erforderlich) – beschreibender Name für den Webhook
• url (erforderlich) – Endpunkt-URL für Benachrichtigungen
• triggers (erforderlich) – Ereignistypen: document_state_changed, recipient_completed, document_updated usw.
• active (Standardwert true) – Webhook aktivieren/deaktivieren
• payload – zusätzliche Daten: fields, products, metadata, tokens, pricing

Beispiel-Eingabeaufforderung: „Richte einen PandaDoc-Webhook ein, um https://api.example.com/hooks zu benachrichtigen, wenn sich der Dokumentstatus ändert oder Empfänger abschließen“

---

6. Vorlagen erstellen

Erstellen Sie wiederverwendbare Vorlagen aus PDF-Dateien oder von Grund auf mit strukturierten Inhaltsblöcken.

Tool: PANDADOC_CREATE_TEMPLATE

Wichtige Parameter:

• name (erforderlich) – Vorlagenname
• file_path – Pfad zur PDF-Datei für die Vorlagenerstellung
• content – strukturiertes Inhaltsobjekt mit title und blocks-Array zum Erstellen von Grund auf
• description – Vorlagenbeschreibung
• tags – Kategorisierungs-Tags

Beispiel-Eingabeaufforderung: „Erstelle eine PandaDoc-Vorlage namens 'Standard-NDA' aus der Datei nda-template.pdf“

---

Bekannte Fallstricke

• Eindeutige Empfängerrollen: Die PandaDoc-API erlaubt keine doppelten Rollen innerhalb eines einzelnen Dokuments. Jeder Empfänger muss einen eindeutigen role-Wert haben (z. B. signer, signer_2, approver, cc).
• Konsistenz der Signierreihenfolge: Wenn Sie signing_order für einen Empfänger angeben, müssen Sie es für ALLE Empfänger im Dokument angeben. Eine teilweise Reihenfolge führt zu Fehlern.
• Anforderungen für Datei-Upload: Es muss entweder file (mit s3key) oder url für die Dokumenterstellung angegeben werden, nicht beides. Die URL muss öffentlich über HTTPS zugänglich sein.
• Kontakt-Upsert-Verhalten: PANDADOC_CREATE_OR_UPDATE_CONTACT gleicht per E-Mail ab. Wenn Sie die E-Mail-Adresse eines Kontakts selbst aktualisieren müssen, müssen Sie einen neuen Kontakt erstellen und den alten separat behandeln.
• Dokument-ID-Format: Dokument-IDs sind alphanumerische Zeichenfolgen (z. B. BhVzRcxH9Z2LgfPPGXFUqa). Sie werden bei der Erstellung von Dokumenten zurückgegeben und können über das PandaDoc-Dashboard gefunden werden.
• Benennung von Webhook-Ereignissen: Die Namen der Trigger-Ereignisse müssen exakt übereinstimmen (z. B. document_state_changed, nicht stateChanged oder state_changed). Überprüfen Sie die PandaDoc-API-Dokumentation für die vollständige Liste.
• Ordneroperationen erfordern UUIDs: Zum Verschieben von Dokumenten werden sowohl die Dokument-ID als auch die UUID des Zielordners benötigt. Listen Sie zuerst die Ordner auf, um die korrekte UUID zu erhalten.
• Vorlagen-Inhaltsblöcke: Beim Erstellen von Vorlagen von Grund auf muss das blocks-Array gültige Inhaltsblockobjekte gemäß dem PandaDoc-Schema enthalten. Überprüfen Sie deren API-Dokumentation auf unterstützte Blocktypen.

---

Kurzreferenz

Tool-Slug	Beschreibung
PANDADOC_CREATE_DOCUMENT_FROM_FILE	Erstellt ein Dokument aus PDF/DOCX/RTF mit Empfängern
PANDADOC_GET_DOCUMENT_DETAILS	Ruft vollständige Dokumentmetadaten, Status und Felder ab
PANDADOC_CREATE_OR_UPDATE_CONTACT	Erstellt oder aktualisiert einen Kontakt per E-Mail
PANDADOC_CREATE_FOLDER	Erstellt einen Ordner zur Dokumentenorganisation
PANDADOC_LIST_DOCUMENT_FOLDERS	Listet alle Dokumentenordner auf
PANDADOC_MOVE_DOCUMENT_TO_FOLDER	Verschiebt ein Dokument in einen bestimmten Ordner
PANDADOC_CREATE_WEBHOOK	Richtet Webhooks für Ereignisbenachrichtigungen ein
PANDADOC_CREATE_TEMPLATE	Erstellt eine wiederverwendbare Dokumentvorlage

---

Powered by Composio