Skill de Reembolso Benepass
Automatize o fluxo completo de reembolso do Benepass — desde o login até o envio — usando automação de navegador, integração com Gmail para códigos de verificação e upload de arquivos para comprovantes.
Pré-requisitos
- Habilite o acesso ao navegador (ferramenta de computador) para navegar no Benepass
- Habilite a execução de código e criação de arquivos — necessário para salvar e fazer upload de arquivos de comprovante
- Configure o MCP do Gmail para buscar códigos de verificação por email
- Determine o email via MCP do Gmail; se o acesso ao Gmail não estiver disponível, solicite-o
- Obtenha uma imagem do comprovante (captura de tela, foto ou PDF)
Passo 1: Extrair Detalhes do Comprovante
Antes de navegar para o Benepass, extraia os principais detalhes da imagem do comprovante ou mensagem:
- Valor (ex.: R$ 84,99)
- Comerciante (ex.: Verizon, DoorDash, Lyft)
- Memo/Nota — aplique o memo fornecido, ou use uma descrição curta padrão (ex.: "Wi-Fi de casa", "Almoço", "Carona para o escritório")
- Categoria do benefício — selecione a categoria especificada; deduza do contexto quando estiver confiante, caso contrário, peça esclarecimento (veja Passo 4)
Passo 2: Fazer Login no Benepass
2a. Navegar e inserir email
Navegar para: https://app.getbenepass.com
- Clique no campo de entrada de email e digite o endereço de email
- Duas opções de login aparecem: "Fazer login com G-Suite" e "Fazer login com código de email"
- Clique em "Fazer login com código de email"
2b. Buscar código de verificação no Gmail
Aguarde o prompt "Insira o código de verificação" com 6 caixas de entrada aparecer.
Busque o código via MCP do Gmail:
Consulta de pesquisa no Gmail: "from:benepass código de verificação"
maxResults: 1
- Extraia o código de 6 dígitos do trecho do email (procure por "Seu código de verificação é: XXXXXX")
- Digite o código de 6 dígitos na entrada de verificação — a página envia automaticamente após todos os 6 dígitos serem inseridos
- Aguarde 3-5 segundos para o painel carregar
2c. Verificar sucesso do login
Verifique se o painel carrega com uma saudação, saldos de conta e cartões de insights para confirmar o sucesso do login.
Importante: Trate códigos de verificação expirados da seguinte forma:
- Clique em "Não recebeu? Reenviar" na página de verificação
- Aguarde 5 segundos, depois pesquise novamente no Gmail por um código mais recente
Passo 3: Iniciar Reembolso
- Clique no botão "Obter reembolso" na barra lateral esquerda
- Aguarde o formulário de reembolso carregar com duas seções:
- Selecionar benefício (menu suspenso)
- Inserir detalhes (valor, comerciante, nota, comprovante)
Passo 4: Selecionar Benefício
- Clique no menu suspenso "Selecionar benefício"
- Selecione a categoria especificada; deduza do contexto quando estiver confiante, caso contrário, peça esclarecimento
- Leia as opções de benefício disponíveis diretamente do menu suspenso — as categorias variam por empregador
- Verifique se o saldo exibido para o benefício selecionado cobre o valor do reembolso
Passo 5: Preencher Detalhes
Campo de valor
CRÍTICO: Limpe qualquer valor pré-preenchido do campo de valor antes de inserir o valor correto.
- Clique triplo no campo de valor para selecionar qualquer valor existente
- Digite o valor correto (ex.:
84,99) - NÃO inclua o símbolo
R$— insira apenas o número
Campo de comerciante
- Clique no campo de entrada do comerciante
- Digite o nome do comerciante (ex.:
Verizon,DoorDash,Lyft)
Campo de nota (Opcional, mas recomendado)
- Clique no campo de entrada da nota
- Digite o memo (ex.:
Wi-Fi de casa,Almoço,Carona para o escritório)
Passo 6: Fazer Upload do Comprovante
CRÍTICO: A entrada de arquivo é um elemento oculto com id="fileInput". A zona de soltar visível não é clicável — use a entrada oculta. Se nenhum elemento com id="fileInput" for encontrado, procure por qualquer <input type="file"> na página.
- Use
read_pagecomfilter: interactivepara encontrar o elemento de entrada de arquivo - Procure por:
<input id="fileInput" class="hidden" type="file"> - Use a ferramenta
upload_filecom a referência para aquela entrada oculta:
upload_file:
file_path: <caminho para o arquivo do comprovante>
ref: <ref para fileInput>
- Após o upload, verifique:
- O rótulo Comprovante não está mais vermelho (estava vermelho antes do upload)
- Uma seção "Arquivos enviados" aparece mostrando o nome do arquivo e tamanho
- Uma miniatura de pré-visualização do comprovante está visível
Passo 7: Enviar
- Role para baixo para ver o botão "Enviar reembolso"
- Antes de clicar em enviar, apresente um resumo para confirmação:
- Categoria do benefício
- Valor
- Comerciante
- Memo/nota
- Nome do arquivo do comprovante
- Saldo restante do benefício após este envio
- Aguarde aprovação explícita antes de prosseguir
- Clique em "Enviar reembolso"
- Aguarde 3 segundos para processamento
Verificar sucesso do envio
Após o envio, a página redireciona para uma visualização de detalhes da despesa mostrando:
- Estado: Pendente
- Método de pagamento: Reembolso
- Benefício: O nome do benefício selecionado
- Progresso do pagamento: Valor pendente = o valor enviado
Relate a confirmação.
Solução de Problemas
Sessão expirada
Trate a expiração da sessão reiniciando a partir do Passo 2 (login) quando ocorrerem erros ou a página redirecionar para o login.
Código de verificação não funciona
Trate códigos de verificação expirados: clique em "Não recebeu? Reenviar", aguarde alguns segundos, depois pesquise novamente no Gmail por um código mais recente. Certifique-se de buscar o email mais recente (use maxResults: 1 com ordenação padrão).
Peculiaridade do campo de valor
Sempre clique triplo no campo de valor para selecionar todo o texto existente antes de digitar o novo valor — isso evita concatenação (ex.: 32184,99).
Upload não registrando
Se o upload do comprovante não parecer funcionar:
- Releia a página com
read_pagepara encontrar a referência dofileInput - Se
fileInputnão for encontrado, procure por qualquer elemento<input type="file"> - Tente novamente o upload com
upload_fileusando a referência correta - Verifique se a seção "Arquivos enviados" aparece após o upload
Saldo do benefício insuficiente
Se o benefício selecionado não tiver saldo suficiente, relate o problema e pergunte se deseja usar uma categoria de benefício diferente.