👤 Para administradores do pipe e responsáveis pela conferência de pagamentos de pedidos de clientes
🔐 Agentes de IA disponíveis para todos os planos, conforme acesso e créditos de IA da empresa. Integrações financeiras dependem da contratação e da configuração aplicáveis.
🎯 Para conferir pagamentos, registrar inconsistências e definir quando o pedido pode avançar
Um cliente informa que pagou o pedido, mas a equipe ainda precisa consultar o sistema financeiro, conferir o valor recebido e decidir se pode liberar o atendimento. Quando essa checagem depende de consultas manuais, o pedido fica parado mesmo depois do pagamento, e diferenças de valor podem passar despercebidas.
O Agente de validação de pagamento atua na Gestão de Pedidos de Clientes para conferir os dados recebidos por integrações financeiras, identificar inconsistências e encaminhar o pedido conforme as regras da empresa. Esse fluxo reduz em 99% o tempo de processamento do pedido, diminui em até 30% os erros operacionais e permite processar até 24 vezes mais pedidos por dia com a mesma equipe. Ao terminar a leitura, você saberá preparar os dados financeiros, criar ou adaptar o agente, testar as decisões e configurar a passagem para a próxima etapa.
📖 O que você vai aprender
Conheça o agente e o resultado esperado
O agente compara o pedido com as informações de pagamento disponibilizadas pela integração financeira. A conferência deve identificar a transação correspondente, verificar se o status atende à regra de confirmação e apontar diferenças de valor. A movimentação para conclusão depende dessas verificações e dos demais requisitos do processo.
Considere o pedido 882, com pagamento por boleto. Se o retorno financeiro indicar um valor R$ 50,00 inferior ao total devido, o agente deve registrar a diferença e manter o pedido para avaliação. A equipe responsável verifica a causa e decide sobre cobrança complementar, desconto ou correção. O agente não deve atribuir a diferença a um cupom sem evidência.
O fluxo recomendado começa com o recebimento do retorno financeiro, segue pela conferência e pelo registro do parecer e termina no encaminhamento do pedido. Pagamentos confirmados e sem pendências podem avançar dentro da alçada definida; divergências seguem para revisão humana.
Um comprovante anexado é uma evidência para análise. A confirmação financeira deve vir da fonte que a empresa definiu para atestar o recebimento. Um boleto emitido ou um pagamento agendado não deve ser tratado como valor recebido.
Prepare o processo para utilizar o agente
Identifique com o Financeiro qual sistema confirma o recebimento e quais status significam pagamento efetivado. Defina também como tratar pagamentos parciais, taxas, descontos, estornos e moedas diferentes. Uma taxa descontada pelo provedor, por exemplo, precisa de uma regra que esclareça se a conferência utiliza valor bruto ou líquido.
Prepare no card as informações necessárias à comparação: identificação do pedido, referência da transação, valor devido, moeda, valor recebido, status financeiro e data da consulta. Esses são dados a mapear no seu processo, não nomes obrigatórios de campos. Reserve também destinos para o resultado da validação e o parecer com a evidência utilizada.
Configure com a pessoa responsável pela integração a consulta ao sistema financeiro e o preenchimento desses dados no Pipefy. Uma forma de organizar a entrada é gravar os valores primeiro e atualizar por último um campo que indique que o retorno está completo. Esse campo pode acionar a análise. Confira essa sequência nos testes para evitar decisões sobre dados parcialmente atualizados.
Se você utilizar Integrações Pipefy, alinhe conexão, permissões e tratamento de falhas antes de ativar a conferência. O conteúdo sobre o hub de integrações do Pipefy ajuda a entender essa camada. A conexão financeira e o agente têm configurações próprias; escrever uma instrução não cria a consulta ao gateway.
Configure e personalize o agente
Escolha como começar
Para criar do zero, abra o pipe de pedidos, acesse Agentes de IA e selecione Novo Agente de IA. Para partir da biblioteca, acesse Templates, procure uma opção relacionada à validação de pagamentos e abra Editar agente, se essa opção estiver disponível. Confira sua descrição, entradas e ações antes de utilizar essa opção como base.
Se já houver um agente no pipe, abra sua configuração e revise as mesmas áreas. Nos três caminhos, personalize Geral, Conhecimento e Comportamentos e vincule os campos reais do processo. O guia Como criar um Agente de IA detalha a criação.
Geral para definir o papel do agente
Em Nome, use Agente de validação de pagamento. Em Descreva o papel e os objetivos do Agente, adapte este texto: Você confere os pagamentos dos pedidos de clientes com base nos dados recebidos da integração financeira. Identifique a transação correspondente, aplique as regras de confirmação da empresa, registre inconsistências e encaminhe o pedido somente quando os critérios estiverem atendidos. Mantenha exceções para decisão da pessoa responsável.
Essa descrição delimita o trabalho: o agente confere e encaminha. A emissão de cobranças e a execução de operações financeiras exigem ações e autorizações específicas.
Conhecimento para aplicar as regras da empresa
Em Conhecimento, use Adicionar conhecimento para fornecer a política de confirmação de pagamentos, a relação dos status aceitos e as regras de descontos, taxas e pagamentos parciais. Registre quem decide sobre exceções e quais condições autorizam a passagem do pedido.
Quando a conferência depender de informações em outro pipe ou database, adicione a fonte pertinente e limite a consulta aos registros necessários. O retorno de cada transação deve chegar pelos dados do pedido ou pela consulta configurada; uma política anexada como Conhecimento não atualiza o status financeiro.
Comportamentos para analisar o retorno financeiro
Crie ou edite um comportamento com um nome descritivo, como Conferir pagamento do pedido. Em Adicionar um gatilho, use Um campo é atualizado para observar o campo que sinaliza o retorno financeiro completo. Se o seu fluxo só encaminha o card à conferência depois de preencher todos os dados, Um card entrar em uma fase também pode ser adequado.
No editor, digite / ou clique em + para selecionar os dados dinâmicos de entrada e as ações. Vincule a identificação do pedido, a referência da transação, os valores, a moeda e o status. Mapeie o resultado e o parecer para campos que a equipe consiga consultar antes de decidir.
Para a primeira implantação, registre a análise e mantenha a liberação com uma pessoa responsável. Depois de validar os cenários, configure Mover card apenas no ramo que atende a todas as condições e escolha a fase real de destino. Confirme também os requisitos operacionais dessa fase: pagamento confirmado não significa que separação ou entrega já terminaram.
Personalize as instruções de conferência
Use o exemplo como base, substituindo os trechos entre colchetes pelas referências reais do editor. Ajuste os resultados de saída às opções aceitas nos seus campos.
Exemplo de instrução para personalizar
Confira o pagamento do pedido em [IDENTIFICAÇÃO DO PEDIDO] utilizando [REFERÊNCIA DA TRANSAÇÃO], [STATUS FINANCEIRO], [VALOR RECEBIDO], [VALOR DEVIDO], [MOEDA] e [DATA DA CONSULTA]. Consulte no Conhecimento as regras aprovadas de confirmação e de tratamento de diferenças. Verifique se o retorno pertence ao pedido e se o status corresponde a recebimento efetivado.
Compare os valores pela regra configurada de cálculo, considerando a base bruta ou líquida aprovada e os descontos autorizados. Não suponha tolerâncias ou descontos. Se faltar identificação, houver status pendente, divergência, retorno incompleto ou falha de consulta, registre a pendência sem confirmar o pagamento.
Use a ação configurada de atualização para preencher [RESULTADO DA VALIDAÇÃO] e [PARECER]. No parecer, registre a referência da transação, o status consultado, os valores utilizados, a diferença calculada e o motivo da decisão. Não invente dados nem utilize um comprovante isolado para substituir a confirmação da fonte financeira.
Encaminhe as pendências para a revisão definida no processo. Somente se todas as condições financeiras e operacionais aprovadas estiverem atendidas, execute a ação de movimentação configurada para [FASE DE DESTINO]. Nos demais casos, mantenha o pedido para avaliação. Não gere cobranças ou links de pagamento por iniciativa própria.
Para calcular diferenças, ative Cálculos e análises e descreva a operação e a regra de arredondamento aprovada. Outra opção é receber da integração a diferença já calculada. Assim, o agente utiliza um resultado verificável na decisão. Consulte como usar Cálculos e análises para configurar essa habilidade.
Mantenha a condição de liberação junto à ação de movimentação. Uma condição aplicada apenas ao preenchimento de um campo não restringe automaticamente uma ação posterior. Para refinar a lógica, consulte Criando instruções eficazes para Agentes de IA.
Melhore as instruções com IA
Depois de personalizar regras, campos e ações, clique em Melhorar instruções. Revise a proposta e use Testar sugestão para verificar seu efeito. Você pode usar Tentar novamente, Descartar ou Substituir, conforme o resultado.
Antes de substituir, confira se a sugestão preserva as condições de liberação, o tratamento de falhas e as alçadas da equipe. A melhoria do texto deve manter as decisões que você definiu para o processo.
Escolha o modelo e ajuste Skills e Esforço
Selecione o modelo por comportamento. Comece os testes com Pipefy AI Standard para a conferência com várias condições e registro de um parecer. Considere Pro quando houver fontes conflitantes ou uma análise mais complexa, comparando a qualidade e o consumo. Confira os modelos e créditos de IA antes de ativar o uso em volume.
Em Skills, ative Cálculos e análises se o agente calcular diferenças ou somar pagamentos. Para receber um resultado numérico já calculado pela integração, essa habilidade pode ser dispensada. Ative Análise de documentos apenas se o fluxo também conferir anexos. Mantenha Pesquisa na Web desativada para esta conferência financeira.
Use o esforço padrão nos testes iniciais. Avalie Esforço Máximo apenas se a complexidade exigir uma investigação com várias fontes; essa opção ativa o modelo Pro e muda o consumo. Compare o resultado antes de adotar esse recurso para toda a operação.
Se houver comprovantes, vincule o campo de anexo e defina o que extrair e como tratar arquivos ilegíveis. O artigo Como usar IA para validar documentos no processo ajuda a estruturar essa análise. Preserve a confirmação do recebimento na fonte financeira.
Defina a revisão e as ações após a conferência
Se utilizar Solicitar validação humana, adicione essa ação pelo editor, informe um título e selecione a pessoa responsável. Garanta que o formulário de fase mostre o pedido, o retorno financeiro e o parecer. Para encaminhar o card após a decisão, configure o comportamento seguinte a partir do campo preenchido pela pessoa revisora. Veja como solicitar validação humana.
Quando uma automação do pipe executar a movimentação, mantenha nela as condições de liberação. O comportamento do agente produz a análise; a automação executa a regra de encaminhamento configurada. Revise ambos para evitar duas movimentações sobre a mesma decisão.
Para oferecer pagamento complementar, configure e teste separadamente a geração do link no provedor financeiro e o envio ao destinatário correto. Inclua autorização e tratamento de falhas. A detecção de uma diferença pelo agente não cria essa operação.
Teste o agente na prática
Use pedidos de teste e confira tanto a execução manual pelo botão Testar quanto o gatilho real. Compare os resultados com a consulta financeira e verifique o destino do card.
- Pagamento confirmado: use transação correspondente ao pedido, moeda correta e valor integral. O resultado deve registrar a evidência e seguir apenas pelo encaminhamento autorizado.
- Diferença de R$ 50,00: informe um recebimento inferior ao valor devido. A diferença deve ser calculada e registrada, com o pedido mantido para revisão e sem gerar cobrança por conta própria.
- Pagamento pendente ou agendado: confira se o agente registra a situação e aguarda confirmação, mesmo quando o cliente informa que já pagou.
- Retorno ausente ou falha de integração: simule falta de dados e erro de consulta. O agente deve indicar impossibilidade de concluir a conferência e preservar a revisão.
- Transação de outro pedido ou retorno repetido: confira o vínculo da transação e repita a atualização. O teste deve demonstrar que o fluxo não libera o pedido incorreto nem repete comunicações ou cobranças.
- Comprovante ausente ou ilegível: se houver análise documental, teste os dois casos. O agente deve registrar a limitação sem inventar dados ou confirmar o recebimento pelo anexo.
- Revisão humana: confirme o recebimento da tarefa, o acesso às evidências e o encaminhamento após cada decisão prevista, incluindo a manutenção do pedido quando a pessoa não autoriza a liberação.
Se a decisão usar dados antigos, revise a ordem de preenchimento pela integração e o campo do gatilho. Se o parecer estiver correto, mas o card avançar indevidamente, confira as condições da ação de movimentação e das automações do pipe. Use os Logs de Agentes de IA para examinar a execução.
Revise e coloque em operação
Confirme as permissões do pipe, o acesso à fonte financeira e quem acompanha falhas de consulta e divergências. Revise as regras com o Financeiro, os campos de destino, o gatilho, as ações e o consumo de créditos. Salve a configuração validada e acompanhe os primeiros pedidos com a equipe responsável.
Meça o tempo entre o retorno financeiro e o encaminhamento, a frequência de divergências e o volume de revisões. Compare as decisões do agente com a conferência humana e ajuste as instruções quando mudarem os status do provedor ou as regras comerciais.
Antes de avançar confirme que você entende:
☐ Escolhi o ponto de partida e revisei o papel do agente.
☐ Defini a fonte financeira e os critérios que confirmam o recebimento.
☐ Vinculei pedidos e transações e preparei os dados e os campos de resultado.
☐ Configurei o gatilho para analisar somente o retorno completo.
☐ Personalizei e revisei as instruções com campos e ações dinâmicos.
☐ Validei os cálculos e selecionei modelo, Skills e Esforço.
☐ Testei diferenças, pendências, falhas, repetições e revisão humana.
☐ Condicionei a movimentação à confirmação financeira e aos requisitos do processo.
Para aprofundar a criação e a governança dos seus agentes, continue na Certificação de Especialista em Inteligência Artificial do Pipefy.
