ComposioHQ/Jotform-Automation

Automação Jotform

Automatize fluxos de trabalho do Jotform - liste e pesquise formulários, inspecione detalhes do usuário, navegue pelo histórico de atividades, gerencie pastas e rótulos e verifique limites do plano - tudo por meio de linguagem natural.

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

---

Configuração

1. Adicione o servidor MCP Rube ao seu ambiente: https://rube.app/mcp
2. Conecte sua conta do Jotform quando solicitado (autenticação via chave de API através do Composio)
3. Comece a emitir comandos em linguagem natural para automação do Jotform

---

Fluxos de Trabalho Principais

1. Listar e Pesquisar Formulários

Recupere todos os formulários criados pelo usuário autenticado com pesquisa, filtragem, ordenação e paginação.

Ferramenta: JOTFORM_GET_USER_FORMS

Parâmetros principais:

• search -- consulta de pesquisa para filtrar formulários por nome ou conteúdo
• limit -- número de formulários a retornar
• offset -- deslocamento para paginação
• orderby -- campo para ordenar
• sorting -- direção da ordenação: ASC ou DESC
• folder -- filtrar por ID da pasta

Exemplo de prompt:

"Liste todos os meus formulários do Jotform que contenham 'feedback' no nome, ordenados dos mais recentes"

---

2. Obter Detalhes da Conta do Usuário

Recupere detalhes sobre o usuário autenticado, incluindo tipo de conta, estatísticas de uso e limites.

Ferramenta: JOTFORM_GET_USER_DETAILS

Nenhum parâmetro necessário. Retorna informações da conta como nome de usuário, e-mail, tipo de conta, número de formulários, número de submissões e limites de uso.

Exemplo de prompt:

"Mostre-me os detalhes da minha conta Jotform e o uso atual"

---

3. Navegar pelo Histórico de Atividades

Busque registros de atividade do usuário para auditoria, filtrados por tipo de ação e intervalo de datas.

Ferramenta: JOTFORM_GET_USER_HISTORY

Parâmetros principais:

• action -- filtrar por tipo de ação (ex.: formCreation, userLogin, formUpdate, apiKeyCreated, userLogout)
• date -- intervalo de datas predefinido: lastWeek, lastMonth, last3Months, last6Months, lastYear, all
• startDate -- data de início personalizada no formato MM/DD/YYYY
• endDate -- data de término personalizada no formato MM/DD/YYYY
• sortBy -- ordem de classificação: ASC ou DESC

Exemplo de prompt:

"Mostre-me toda a atividade de criação de formulários do último mês, ordenados dos mais novos primeiro"

---

4. Gerenciar Pastas e Rótulos

Navegue pela estrutura de pastas/rótulos para organizar formulários.

Ferramenta: JOTFORM_GET_USER_FOLDERS

Parâmetros principais:

• add_resources -- defina como true para incluir recursos de rótulos (formulários) na resposta
• owner -- nome de usuário proprietário ou ID do workspace/equipe (condicionalmente necessário para algumas contas)

O Jotform migrou de pastas para rótulos. Esta ferramenta usa o endpoint GET /user/labels.

Exemplo de prompt:

"Liste todas as minhas pastas do Jotform com seus formulários incluídos"

---

5. Verificar Limites e Preços do Plano

Recupere detalhes sobre um plano específico do sistema Jotform para entender limites e capacidades.

Ferramenta: JOTFORM_GET_SYSTEM_PLAN

Parâmetros principais:

• planName -- o plano a ser inspecionado (obrigatório): FREE, BRONZE, SILVER, GOLD ou PLATINUM

Exemplo de prompt:

"Quais são os limites do plano GOLD do Jotform?"

---

6. Fluxo Completo de Gerenciamento de Formulários

Combine ferramentas para gerenciamento abrangente de formulários:

1. Descobrir: JOTFORM_GET_USER_DETAILS -- verifique tipo de conta e limites de uso
2. Navegar: JOTFORM_GET_USER_FORMS -- liste e pesquise formulários com filtros
3. Organizar: JOTFORM_GET_USER_FOLDERS -- visualize a estrutura de pastas com add_resources=true
4. Auditar: JOTFORM_GET_USER_HISTORY -- acompanhe atividades de criação e modificação de formulários
5. Planejar: JOTFORM_GET_SYSTEM_PLAN -- compare recursos do plano antes de fazer upgrade

Exemplo de prompt:

"Mostre-me meu uso da conta, liste meus formulários recentes e me diga se estou perto dos limites do meu plano"

---

Armadilhas Conhecidas

Armadilha	Detalhes
Autenticação via chave de API	O Jotform usa autenticação por chave de API, não OAuth -- certifique-se de que uma chave de API válida esteja configurada na conexão
Pastas migradas para rótulos	O endpoint de pastas agora mapeia para o sistema de rótulos do Jotform; o comportamento da API pode diferir da documentação legada de pastas
Formato de data no histórico	Filtros de data personalizados usam o formato MM/DD/YYYY (ex.: 01/15/2026), não ISO 8601
Nome do plano deve ser exato	Os valores de planName são enum com diferenciação de maiúsculas/minúsculas: FREE, BRONZE, SILVER, GOLD, PLATINUM
Paginação baseada em deslocamento	Formulários usam paginação limit/offset, não cursor ou baseada em página
Campo owner condicionalmente obrigatório	JOTFORM_GET_USER_FOLDERS pode exigir o parâmetro owner para contas de workspace/equipe

---

Referência Rápida

Ação	Slug da Ferramenta	Parâmetros Principais
Listar formulários	JOTFORM_GET_USER_FORMS	search, limit, offset, orderby
Obter detalhes do usuário	JOTFORM_GET_USER_DETAILS	(nenhum)
Histórico de atividades	JOTFORM_GET_USER_HISTORY	action, date, startDate, endDate
Listar pastas/rótulos	JOTFORM_GET_USER_FOLDERS	add_resources, owner
Verificar plano	JOTFORM_GET_SYSTEM_PLAN	planName

---

Desenvolvido por Composio