Veja como criar um agente WhatsApp para processar recibos e notas fiscais com Mistral AI, validações automáticas e integração via Twilio, em fluxo auditável.
Como criar um agente WhatsApp para processar recibos e notas fiscais
Para criar um agente WhatsApp para processar recibos, conecte WhatsApp via Twilio a um workflow automatizado que analisa imagens e PDFs usando Mistral AI. O agente valida o usuário, armazena arquivos, extrai dados relevantes e aplica políticas de aprovação automaticamente, gerando respostas em até 10 segundos. O fluxo é auditável e integra-se facilmente a sistemas internos.
Os principais componentes são o WhatsApp como canal de entrada, o workflow de análise (com etapas de verificação, extração, categorização e políticas), e bancos de dados que armazenam execuções (runs), usuários, recibos e regras de aprovação.
Como funciona a análise automática de recibos enviados por WhatsApp
Quando o usuário envia um recibo ou nota (imagem ou PDF) pelo WhatsApp, a mensagem é encaminhada para o workflow via web hook do Twilio. Esse web hook poderia ser substituído por outros nós de mensageria que aceitem arquivos, como Telegram. O arquivo é baixado a partir do link recebido da API.
O arquivo é enviado a um serviço de armazenamento, como Google Drive, que reduz o tamanho de imagens muito grandes capturadas por câmeras, melhorando a eficiência da etapa seguinte de extração.
O Mistral AI é utilizado para processar tanto imagens (formatos JPG ou PNG) quanto documentos PDF, alterando a configuração do nó conforme o tipo de arquivo. Documentos são extraídos para markdown, facilitando a posterior separação dos campos importantes.
Validação de usuários e controle de acesso para automação segura
Antes de qualquer análise, o número que enviou o recibo/transação via WhatsApp é consultado em um banco de dados de usuários. Se não for reconhecido, o fluxo envia uma resposta automática informando a necessidade de cadastro e registra a tentativa na tabela de execuções (runs), com status de "usuário não reconhecido". Isso impede processamento indevido ou acesso não autorizado a dados.
O banco de dados armazena nome e telefone, e pode ser expandido conforme necessidade. O registro detalhado de execuções facilita auditorias e resoluções rápidas de falhas ou acessos negados.
Processamento inteligente com Mistral AI e categorização de despesas
Mistral AI faz a extração dos campos principais (número da nota, data, itens, valor total, etc.) a partir do conteúdo processado. No caso de imagens, cuida-se para que estejam legíveis e sem imperfeições (amassados ou ângulos inadequados podem impactar a leitura via OCR/parse).
Após a extração, o workflow categoriza o recibo em tipos relevantes para a empresa — como refeições, combustível, viagens ou suprimentos. Essa categorização é essencial para corresponder à política de aprovação automatizada, permitindo decisões dinâmicas.
Aplicação automática de políticas de aprovação
A política de aprovação é consultada em uma tabela dedicada. Por exemplo, despesas com refeições abaixo de R$75 podem ser aprovadas automaticamente, enquanto valores acima disso requerem validação extra. O workflow compara o valor extraído do documento com a condição estabelecida e devolve ao usuário uma mensagem com o status (aprovado ou negado) e o motivo.
Segundo o exemplo, um recibo de R$58,80 enviado pelo usuário seria aprovado automaticamente conforme a política cadastrada. Todos esses dados são registrados na tabela de recibos, vinculando-os ao respectivo usuário.
Integração com sistemas de contabilidade e exportação de dados
O sistema armazena recibos extraídos no banco de dados preparado para integrar-se facilmente ao software de contabilidade. Quando necessário, os dados podem ser exportados por API ou arquivo (como Excel), respeitando o formato exigido pelo software externo, como campos de número da nota, itens, valor, etc.
Essa preparação possibilita migração fácil e elimina retrabalho, tornando o processo transparente e rastreável.
Perguntas Frequentes (FAQ)
- Quais tipos de arquivos o agente WhatsApp para processar recibos aceita? Imagens nos formatos JPG, PNG e documentos PDF podem ser enviados via WhatsApp, com tratamento automatizado de ambos os formatos.
- Como funciona a validação de usuários no sistema? O número do remetente é comparado a uma tabela de usuários. Se não estiver cadastrado, recebe retorno automático indicando o próximo passo para liberação.
- Quais IA ou APIs são usadas para análise dos documentos? A solução utiliza o Mistral AI, que processa OCR de imagens e PDFs, e adapta o modo conforme o tipo de arquivo no workflow.
- É possível personalizar as políticas de aprovação? Sim. As regras de aprovação de recibos são configuráveis na tabela de políticas, podendo incluir limites de valores, categorias ou exigências dinâmicas.
- Os dados podem ser integrados ao sistema de contabilidade da empresa? Sim. O workflow organiza os dados extraídos no formato necessário para exportação via API ou arquivo para o sistema contábil desejado.
Transforme conhecimentos em texto com Skalablog
Se você já imaginou automatizar conteúdos como este — convertendo vídeos didáticos ou processos em textos claros e bem organizados —, saiba que é possível transformar conhecimento em artigos prontos para consulta e compartilhamento. Visite Skala Blog, cole a URL do seu vídeo do YouTube, faça a transcrição e veja seu conteúdo virar um artigo detalhado.