1. Chamadas de API (API Calls)
Uma chamada de API faturável (Monetizable API Call) é qualquer requisição processada feita por um usuário ou integração de terceiros às APIs externas do Pipefy para entregar dados ou realizar ações.
O que é contabilizado como API Call:
Requisições Externas: Chamadas feitas por usuários através de Personal Access Token ou Service Accounts.
GraphQL: Chamadas diretas via GraphQL.
Integradores Externos: Chamadas vindas de Zapier, Make ou qualquer integração do PIpefy que não seja nativo do Pipefy ou Workato.
Exemplos Práticos:
Cada chamada individual na mutation setTableRecordFieldValue conta como uma API Call.
Um chatbot que atualiza o Pipefy campo a campo gerará uma cobrança para cada requisição de atualização feita.
O que NÃO é contabilizado:
Chamadas internas da plataforma (ex: abrir um pipe para visualizar cards).
Chamadas feitas por Automações nativas, integrações do Pipefy ou Workato.
Chamadas feitas por apps públicos ou customizados do Outbound Labs.
Status de Retorno e Faturamento:
A contabilização depende do código HTTP retornado pela requisição:
Faixa de Status | Billable? | Justificativa |
2xx (Sucesso) | Sim | A requisição foi processada com sucesso e consumiu recursos. |
3xx (Redirecionamento) | Sim | Recursos de backend foram usados para determinar o redirecionamento. |
4xx (Erro do Cliente) | Depende | Faturável: Erros de dados ou caminho (404, 408, 422). Não Faturável: Erros de autorização (401, 403). |
5xx (Erro de Servidor) | Não | O problema é interno e o serviço não foi entregue. |
Como visualizar o consumo de Chamadas de API
Na área do início, clique no atalho Usage stats (ícone de gráfico). Isso abrirá o Painel administrativo diretamente na seção de estatísticas.
Dentro de Estatísticas de uso, clique na aba Chamadas de API. Nela você encontra o total de chamadas processadas no período selecionado. Se precisar de uma análise detalhada, clique em Baixar relatório.
Para obter mais detalhes, visite a página de Estatísticas de Utilização
2. Créditos de IA (AI Credits)
O uso de Inteligência Artificial consome créditos específicos baseados no modelo utilizado:
Custo base por execução do agente
Pipefy AI: 2 créditos de IA por execução
BYOLLM (Modelo Próprio): 1,5 créditos de IA por execução
Custos adicionais (ferramentas)
Quando um agente utiliza ferramentas adicionais (por exemplo, IDP, pesquisa na web), créditos de IA extras podem ser adicionados ao custo base.
Cada ferramenta tem seu próprio custo. Por exemplo:
IDP: +1 crédito de IA por utilização
Como visualizar o consumo de créditos de IA
Na área do início, clique no atalho Usage Stats (ícone de gráfico). Isso abrirá o Painel administrativo diretamente na seção de estatísticas.
Clique na aba Créditos de IA. Nela você encontra o total de créditos consumidos, detalhados por tipo de recurso: Agentes e Assistants. Se precisar de uma análise detalhada, clique em Baixar relatório.
Na seção Detalhes dos agentes, utilize os filtros disponíveis — Tags, Pipes, Status e Eventos — para análises mais específicas.
Nota importante: Ao contrário das Tarefas de Automação, os Créditos de IA só são consumidos quando uma execução de IA é efetivamente realizada. Gatilhos sem execução não consomem Créditos de IA.
Para obter mais detalhes, visite a página de Estatísticas de Utilização
3. Custom Integrations
Engloba integrações via Workato e Activepieces (Pipefy Native iPaaS).
Regra: Cada "task" executada consome 1 crédito de Custom Integrations.
Como visualizar Custom Integrations
A utilização de integrações personalizadas ainda não está disponível no painel de administração (em breve!).
Para acessar essas informações, você precisa entrar em contato com seu Gerente de Sucesso do Cliente (CSM) ou com a equipe de Suporte.
4. Automações (Automation Job - AJ)
Regra Geral: Toda ação disparada (triggered) via AJ conta como 1 crédito.
Lógica de Gatilho: O crédito é consumido no momento do disparo, mesmo que a ação não seja concluída por falta de critérios condicionais (ex: se o responsável do card for diferente do configurado).
Exceção: A ação generate_with_ai não é cobrada como AJ, apenas como crédito de IA.
Como visualizar o consumo de créditos de Automações
Na área do início, clique no atalho Estatísticas de uso (ícone de gráfico). Isso abrirá o Painel administrativo diretamente na seção de estatísticas.
Clique na aba Automações. Nela você encontra o total de Tarefas processadas no mês, progressão mensal e uma visão geral por período. Se precisar de uma análise detalhada, clique em Baixar relatório.
Na tabela Detalhes das automações, cada automação exibe o número de tarefas processadas, tags, pipe de origem, status, evento, acão e criado por.
Filtre por Tags, Pipes, Status, Eventos e Ações para análises específicas.
Para obter mais detalhes, visite a página de Estatísticas de Utilização
Para mais detalhes sobre os valores e limites de cada plano, acesse a página de preços do Pipefy.