Skip to main content

Como configurar o agente Verification no processo de Contas a Receber


vinicius.pereira
Community Manager

👤 Para administradores de pipe e equipes financeiras responsáveis por Contas a Receber

🔐 Disponível para todos os planos com créditos de IA

🎯 Para conferir confirmações de pagamento e encaminhar divergências antes do encerramento da cobrança

 

O cliente envia um comprovante, mas o valor depositado é diferente do faturado. Antes de encerrar a cobrança, alguém precisa conferir o título, entender a diferença e decidir se o pagamento permite a baixa. O agente Verification apoia essa conferência ao validar confirmações de pagamento, identificar inconsistências e registrar a análise no processo. Ele integra a solução de Contas a Receber com IA, que reduz em 95% o tempo para processar cobranças, liberando a equipe para avaliar as exceções.

Ao terminar a leitura, você saberá criar o agente ou adaptar uma configuração existente, fornecer os critérios da empresa, vincular os dados da cobrança e testar o tratamento de pagamentos regulares, divergentes e sem evidência suficiente. O resultado será uma primeira conferência registrada no card, com critérios claros para encaminhar cada caso ao responsável.

 

📖 O que você vai aprender

 

Conheça o agente e o resultado esperado

O Verification atua na verificação de pagamento do processo de Contas a Receber. Sua função é conferir o valor e o método de pagamento, comparar as informações com a cobrança e registrar as inconsistências encontradas. Para que essa análise ajude o fechamento, o agente precisa receber tanto a evidência do pagamento quanto os dados corretos do título.

Considere uma cobrança de R$ 5.000 e um comprovante de R$ 4.500. O cliente informa uma retenção de impostos de R$ 500, mas esse tratamento precisa ser confirmado pelo Financeiro. Configure o agente para registrar a diferença, indicar a justificativa recebida e encaminhar a revisão. A existência de uma explicação no comprovante não autoriza, por si só, o encerramento da cobrança.

O fluxo recomendado começa quando os dados da cobrança e a confirmação de pagamento estão disponíveis. O agente confere as evidências, registra o resultado e sinaliza as pendências. A pessoa responsável decide sobre retenções, descontos ou outras exceções conforme a política da empresa.

 

Prepare o processo para utilizar o agente

Identifique a etapa em que a equipe recebe a confirmação de pagamento e o momento em que pode encerrar a cobrança. Separe exemplos de títulos e comprovantes, além das regras aprovadas para pagamentos parciais, descontos, retenções, juros e diferenças de valor. Defina quem pode avaliar cada exceção e qual evidência é necessária para concluir o caso.

Organize as entradas da análise: identificação do cliente e do título, valor esperado, moeda, método de pagamento previsto e evidência recebida. Utilize os campos reais do seu processo. Se um dado estiver em outro pipe ou database, planeje o acesso à fonte correspondente e a identificação que permitirá encontrar o registro correto.

Prepare também onde registrar o resultado. Uma configuração útil reúne a situação da conferência, os valores encontrados, a diferença calculada, a justificativa e as pendências. Esses são exemplos de informações a acomodar no seu pipe, com nomes e opções definidos pela equipe. Preserve os dados originais da cobrança para que o resultado possa ser conferido.

Mantenha o comprovante de cada pagamento no card correspondente. Adicione políticas e critérios gerais em Conhecimento. Combine com a equipe qual fonte comprova a efetivação do recebimento: um comprovante enviado pelo cliente pode precisar de confirmação adicional antes da baixa.

 

Conferir um comprovante e atualizar o card são etapas do processo. Para efetuar a baixa em um sistema financeiro, configure e teste o fluxo de integração específico, com a validação e as permissões exigidas pela empresa.

 

 

Configure e personalize o agente

Escolha como começar

Para criar do zero, abra o pipe de Contas a Receber, acesse Agentes de IA e selecione Novo Agente de IA. Na configuração, defina a identidade, o conhecimento de referência e o comportamento de conferência.

Para partir da biblioteca, acesse Agentes de IA > Templates e examine as opções disponíveis. Ao escolher uma base de análise documental, selecione Editar agente e confira sua finalidade, seus gatilhos e suas ações antes de adaptá-la. Use essa base para montar a verificação de pagamentos com as regras do seu processo.

Se o pipe já possui o Verification ou outro agente dedicado à conferência, abra sua configuração na lista de Agentes de IA. Revise os vínculos com anexos, campos e destinos antes de seguir. Os três caminhos exigem a mesma preparação dos critérios e dos resultados. Consulte Como criar um Agente de IA para acompanhar a configuração.

Geral: defina quem é o agente

Use Verification como Nome e descreva o papel com uma finalidade específica. Uma base para personalizar é: Você é um assistente de verificação de pagamentos do processo de Contas a Receber. Compare os dados da cobrança com a evidência recebida, confira valor e método de pagamento, registre diferenças e prepare a análise para a equipe financeira. Siga as regras aprovadas da empresa e encaminhe exceções para revisão.

Inclua os limites de decisão nessa descrição. Por exemplo, retenções sem regra aprovada e documentos sem dados legíveis devem gerar pendência de análise. Assim, o objetivo do agente continua claro mesmo quando o material recebido estiver incompleto.

Conhecimento: forneça critérios confiáveis

Adicione a política de conferência de pagamentos e as regras que a equipe utiliza para aceitar descontos, retenções e pagamentos parciais. Descreva quando cada documento deve ser consultado e mantenha um responsável por atualizar esses critérios.

Quando a conferência depender de dados de outro pipe ou database, disponibilize apenas as fontes pertinentes. Explique qual identificador relaciona o pagamento ao título e qual fonte prevalece em caso de conflito. A referência geral orienta a decisão; os anexos e os campos do card fornecem os dados da transação em análise.

Comportamentos: determine quando conferir

Crie ou revise um comportamento com uma finalidade clara, como Conferir confirmação de pagamento. Escolha um gatilho que represente o momento em que a análise pode começar. A entrada na fase de verificação é uma opção quando o card chega com os dados e os anexos necessários. Se o comprovante for recebido depois, avalie o gatilho de atualização do campo correspondente.

No editor, utilize / ou + para inserir as referências dinâmicas dos dados do título, do comprovante e dos destinos da análise. Selecione a ação de atualização dos campos para gravar os resultados. Planeje a atualização sem alterar o valor original faturado.

Revise também as automações do pipe que respondem a esses campos ou à movimentação do card. O comportamento do agente realiza a análise e as ações configuradas; uma automação pode executar uma regra fixa a partir do resultado. Defina essa sequência para que uma pendência não acione o encerramento da cobrança. Aprofunde essa divisão em Automações + Agentes de IA.

Personalize as instruções de verificação

Adapte o exemplo abaixo à sua política. Substitua os trechos entre colchetes por referências reais inseridas com / e configure as ações e os campos de retorno no editor.

 

Exemplo de instrução para personalizar

Analise a confirmação de pagamento em [COMPROVANTE] referente ao título identificado em [IDENTIFICAÇÃO DO TÍTULO], do cliente em [IDENTIFICAÇÃO DO CLIENTE]. Compare a evidência com [VALOR ESPERADO], [MOEDA] e [MÉTODO PREVISTO]. Consulte as regras aprovadas em Conhecimento.

Identifique o valor, a moeda, o método, a data e a referência da transação quando estiverem legíveis. Calcule a diferença entre o valor esperado e o informado no comprovante, considerando somente ajustes expressamente autorizados pela política e identificados para esse título. Informe os valores utilizados e explique o cálculo. Preserve o valor original da cobrança.

Quando houver pagamento parcial, retenção, desconto sem aprovação ou divergência de método, registre a ocorrência e a evidência necessária para revisão. Não invente dados ausentes nem aceite uma justificativa como autorização. Se o anexo estiver ausente, ilegível ou não permitir relacionar a transação ao título, registre que a conferência está pendente e explique o motivo.

Grave a situação da conferência em [RESULTADO], os valores e a diferença em [CAMPOS DE VALORES] e a justificativa em [RESUMO DA ANÁLISE], usando a ação de atualização configurada. Use exatamente as opções existentes nos campos. Encaminhe exceções para a pessoa responsável conforme o fluxo aprovado. Mantenha a cobrança aberta enquanto houver pendência. Conclua somente a análise documental quando os critérios forem atendidos; qualquer baixa depende da confirmação de recebimento e da autorização previstas no processo.

 

 

Mantenha explícita a diferença entre um resultado de conferência e a decisão de encerrar o título. Essa separação ajuda o analista a entender o que já foi verificado e o que ainda precisa ser decidido.

 

Melhore as instruções antes de aplicar

Depois de personalizar, use Melhorar instruções. Compare a sugestão com os critérios definidos, principalmente o tratamento de retenções, a preservação dos valores originais e as condições de revisão humana. Use Testar sugestão quando disponível e confira o resultado com um pagamento divergente. Se necessário, utilize Tentar novamente ou Descartar. Escolha Substituir somente quando a nova versão preservar as regras do processo. Veja como funciona o recurso Melhorar instruções.

Escolha modelo, Skills e Esforço

Comece os testes com Pipefy AI Standard para a conferência de documentos e aplicação de regras de complexidade intermediária. Avalie Pro se os testes mostrarem necessidade de interpretar situações mais complexas, como múltiplas evidências e regras interdependentes. Compare a qualidade dos resultados e o consumo antes de escolher. O guia de modelos e créditos dos Agentes de IA ajuda nessa decisão.

Habilite Análise de documentos para a leitura dos comprovantes e Cálculos e análises quando o comportamento precisar calcular diferenças, somar pagamentos ou aplicar ajustes autorizados. Descreva a fórmula e o tratamento de valores ausentes. Consulte como usar Cálculos e Análises para configurar os resultados. Para essa conferência baseada em evidências internas, mantenha Pesquisa na Web desativada.

Comece com Esforço padrão. Avalie Máximo apenas quando a conferência exigir cruzamento complexo entre documentos e critérios e os testes justificarem essa escolha. Confira as capacidades ativadas e o consumo associado antes de colocá-lo em operação.

Defina o resultado e a decisão humana

Faça o resultado responder a três perguntas: qual pagamento foi analisado, o que foi confirmado e qual pendência impede a conclusão. Na cobrança de R$ 5.000 com comprovante de R$ 4.500, o resumo deve indicar a diferença de R$ 500 e a retenção alegada, encaminhando a validação ao responsável definido.

Se for configurar movimentação de card, selecione a fase real de destino e condicione a ação ao resultado permitido. Comece com a revisão do analista antes do encerramento. Uma confirmação em outro sistema deve entrar no fluxo por uma integração configurada e testada, preservando a identificação da transação e o retorno da operação.

 

Teste o agente na prática

Prepare cards de teste com dados fictícios que representem a rotina. Use Testar comportamento e confira os resultados antes de salvar no pipe utilizado pela equipe. Depois, valide o gatilho em um ambiente de teste, incluindo as automações que podem reagir às atualizações.

  • Pagamento regular: título e comprovante com identificação, moeda, valor e método compatíveis. Confira se o agente registra a análise com os dados corretos e respeita a confirmação exigida para o encerramento.
  • Valor divergente: cobrança de R$ 5.000 e comprovante de R$ 4.500, com retenção alegada. O agente deve calcular R$ 500 de diferença, registrar a justificativa e manter a pendência para decisão humana.
  • Método ou título incompatível: comprovante de outro título ou método diferente do previsto. Confira se o agente identifica o conflito sem atribuir o pagamento à cobrança errada.
  • Documento ausente ou ilegível: confirme que o resultado indica a impossibilidade de concluir a conferência e solicita a evidência necessária.
  • Revisão humana: registre a decisão de aceitar ou recusar um ajuste conforme a política e confira se o fluxo segue apenas após a decisão exigida, preservando o histórico.

Se a resposta vier genérica, revise as referências dinâmicas e os critérios de comparação. Se o cálculo estiver incorreto, confira a moeda, os valores de entrada e as regras de ajuste. Se o resultado estiver correto, mas não aparecer no card, revise os destinos da atualização. Consulte os Logs em Agentes de IA e as atividades do card para localizar a execução e verificar as ações realizadas.

 

Revise e coloque em operação

Confira as permissões do pipe e das fontes de conhecimento, os responsáveis pelas exceções e o acesso aos comprovantes. Revise o gatilho, as referências dinâmicas, os destinos e as regras que permitem encerrar a cobrança. Confirme também quem acompanha falhas de integração quando a baixa depende de outro sistema.

Acompanhe as primeiras execuções com a equipe financeira e compare a análise do agente com a revisão humana. Observe o tempo de conferência, os casos enviados para revisão e as cobranças encerradas com pendências. Ajuste as instruções e repita os cenários afetados sempre que a política ou o formato dos documentos mudar.

Para aprofundar a criação e a operação dos agentes, continue na Certificação de Especialista em Inteligência Artificial do Pipefy.

 

Antes de avançar, confirme que você entende:

☐ Escolhi como criar ou adaptar o agente.

☐ Organizei os dados do título, os comprovantes e os campos de resultado.

☐ Defini regras para pagamentos parciais, retenções e descontos.

☐ Vinculei dados e ações pelas referências dinâmicas do editor.

☐ Revisei a sugestão de melhoria e selecionei modelo, Skills e Esforço.

☐ Testei pagamentos regulares, divergentes e sem evidência legível.

☐ Confirmei quem decide as exceções e o que autoriza a baixa.

☐ Verifiquei o fluxo completo, incluindo automações e integrações aplicáveis.