ComposioHQ/PandaDoc-Automation

Automação PandaDoc

Gerencie fluxos de trabalho de documentos do PandaDoc diretamente do Claude Code. Crie documentos a partir de arquivos enviados, gerencie destinatários e contatos, organize com pastas, configure webhooks de eventos, crie modelos e acompanhe o status dos documentos sem sair do seu terminal.

Documentação do toolkit: composio.dev/toolkits/pandadoc

---

Configuração

1. Adicione o servidor MCP do Composio à sua configuração:

   https://rube.app/mcp
   

2. Conecte sua conta PandaDoc quando solicitado. O agente fornecerá um link OAuth para autenticação.
3. Certifique-se de que seu espaço de trabalho PandaDoc tenha o plano adequado para os recursos que você precisa (por exemplo, assinaturas eletrônicas, modelos, webhooks).

---

Fluxos de Trabalho Principais

1. Criar Documento a partir de Arquivo

Envie um arquivo PDF, DOCX ou RTF para criar um novo documento PandaDoc com destinatários designados para assinatura e acompanhamento.

Ferramenta: PANDADOC_CREATE_DOCUMENT_FROM_FILE

Parâmetros principais:

• name (obrigatório) -- nome do documento
• recipients (obrigatório) -- array de objetos de destinatários, cada um com:
  • email (obrigatório) -- e-mail do destinatário
  • first_name, last_name -- nome do destinatário
  • role -- signer (padrão), approver ou cc (deve ser único por destinatário)
  • signing_order -- ordem numérica (se definido para um, deve ser definido para todos)
• file -- objeto de arquivo enviado com name, mimetype e s3key
• url -- alternativamente, uma URL HTTPS pública para o arquivo
• parse_form_fields (padrão falso) -- analisar campos de formulário PDF
• tags -- array de strings para categorização
• owner -- proprietário do documento (e-mail ou membership_id)

Exemplo de prompt: "Crie um documento PandaDoc a partir de contract.pdf com [email protected] como signatário e [email protected] como aprovador"

---

2. Obter Detalhes do Documento

Busque metadados abrangentes de um documento, incluindo destinatários, campos, tokens, preços, tags e referências de blocos de conteúdo.

Ferramenta: PANDADOC_GET_DOCUMENT_DETAILS

Parâmetros principais:

• id (obrigatório) -- o identificador único do documento (ex.: BhVzRcxH9Z2LgfPPGXFUqa)

Use isso para verificar o status do documento, inspecionar a conclusão dos destinatários, revisar valores de campos ou coletar metadados para relatórios.

Exemplo de prompt: "Obtenha todos os detalhes e status do documento PandaDoc BhVzRcxH9Z2LgfPPGXFUqa"

---

3. Gerenciar Contatos

Crie novos contatos ou atualize os existentes no PandaDoc. Os contatos são correspondidos por e-mail -- se um contato com o e-mail fornecido existir, ele é atualizado; caso contrário, um novo é criado.

Ferramenta: PANDADOC_CREATE_OR_UPDATE_CONTACT

Parâmetros principais:

• email (obrigatório) -- endereço de e-mail do contato
• first_name, last_name -- nome do contato
• company -- nome da empresa
• job_title -- cargo/função
• phone -- número de telefone
• street_address, city, state, postal_code, country -- campos de endereço

Exemplo de prompt: "Crie um contato no PandaDoc para [email protected] na Acme Corp como Engenheiro de Software"

---

4. Organizar com Pastas

Crie pastas e mova documentos para organizar seu espaço de trabalho PandaDoc.

Ferramentas: PANDADOC_CREATE_FOLDER, PANDADOC_LIST_DOCUMENT_FOLDERS, PANDADOC_MOVE_DOCUMENT_TO_FOLDER

Para criar pastas:

• name (obrigatório) -- nome da pasta
• parent_uuid -- UUID da pasta pai para estruturas aninhadas

Exemplo de prompt: "Crie uma pasta 'Contratos Q1 2026' no PandaDoc e mova o documento BhVzRcxH9Z para ela"

---

5. Configurar Webhooks

Crie assinaturas de webhook para receber notificações em tempo real quando eventos de documento ocorrerem.

Ferramenta: PANDADOC_CREATE_WEBHOOK

Parâmetros principais:

• name (obrigatório) -- nome descritivo para o webhook
• url (obrigatório) -- URL do endpoint para notificações
• triggers (obrigatório) -- tipos de evento: document_state_changed, recipient_completed, document_updated, etc.
• active (padrão verdadeiro) -- ativar/desativar o webhook
• payload -- dados adicionais a incluir: fields, products, metadata, tokens, pricing

Exemplo de prompt: "Configure um webhook do PandaDoc para notificar https://api.example.com/hooks quando documentos mudarem de estado ou destinatários completarem"

---

6. Criar Modelos

Crie modelos reutilizáveis a partir de arquivos PDF ou do zero com blocos de conteúdo estruturados.

Ferramenta: PANDADOC_CREATE_TEMPLATE

Parâmetros principais:

• name (obrigatório) -- nome do modelo
• file_path -- caminho para o arquivo PDF para criação do modelo
• content -- objeto de conteúdo estruturado com title e array blocks para construção do zero
• description -- descrição do modelo
• tags -- tags de categorização

Exemplo de prompt: "Crie um modelo PandaDoc chamado 'NDA Padrão' a partir do arquivo nda-template.pdf"

---

Armadilhas Conhecidas

• Papéis únicos de destinatários: A API PandaDoc não permite papéis duplicados dentro de um único documento. Cada destinatário deve ter um valor role único (ex.: signer, signer_2, approver, cc).
• Consistência da ordem de assinatura: Se você especificar signing_order para qualquer destinatário, deverá especificá-lo para TODOS os destinatários no documento. Ordenamento parcial causará erros.
• Requisitos de upload de arquivo: Deve ser fornecido file (com s3key) ou url para a criação do documento, não ambos. A URL deve ser HTTPS publicamente acessível.
• Comportamento de upsert de contato: PANDADOC_CREATE_OR_UPDATE_CONTACT corresponde por e-mail. Se você precisar atualizar o próprio e-mail de um contato, deverá criar um novo contato e lidar com o antigo separadamente.
• Formato do ID do documento: Os IDs dos documentos são strings alfanuméricas (ex.: BhVzRcxH9Z2LgfPPGXFUqa). Eles são retornados quando os documentos são criados e podem ser encontrados através do painel do PandaDoc.
• Nomeação de eventos de webhook: Os nomes dos eventos de gatilho devem corresponder exatamente (ex.: document_state_changed, não stateChanged ou state_changed). Consulte a documentação da API PandaDoc para a lista completa.
• Operações de pasta exigem UUIDs: Mover documentos requer tanto o ID do documento quanto o UUID da pasta de destino. Liste as pastas primeiro para obter o UUID correto.
• Blocos de conteúdo do modelo: Ao criar modelos do zero, o array blocks deve conter objetos de bloco de conteúdo válidos de acordo com o esquema do PandaDoc. Verifique a documentação da API deles para tipos de bloco suportados.

---

Referência Rápida

Slug da Ferramenta	Descrição
PANDADOC_CREATE_DOCUMENT_FROM_FILE	Criar um documento a partir de PDF/DOCX/RTF com destinatários
PANDADOC_GET_DOCUMENT_DETAILS	Obter metadados completos do documento, status e campos
PANDADOC_CREATE_OR_UPDATE_CONTACT	Criar ou atualizar um contato por e-mail
PANDADOC_CREATE_FOLDER	Criar uma pasta para organização de documentos
PANDADOC_LIST_DOCUMENT_FOLDERS	Listar todas as pastas de documentos
PANDADOC_MOVE_DOCUMENT_TO_FOLDER	Mover um documento para uma pasta específica
PANDADOC_CREATE_WEBHOOK	Configurar webhooks de notificação de eventos
PANDADOC_CREATE_TEMPLATE	Criar um modelo de documento reutilizável

---

Fornecido por Composio