A funcionalidade de Tratamento de Arquivos no Workflow permite que agentes do GOgenier recebam, enviem e processem arquivos durante a execução dos fluxos conversacionais. Os arquivos passam a fazer parte do contexto do workflow, podendo ser analisados, armazenados ou encaminhados para sistemas externos conforme as regras configuradas. 

O recurso viabiliza a troca direta de documentos na conversa, eliminando a necessidade de envio apenas por links externos e ampliando as possibilidades de automação e integração. 

1. Controle de mídia no Agente 

Antes de prosseguirmos para os casos de uso, é importante compreender o conceito de Controle de Mídia. 

No GOgenier, dentro das configurações de qualquer agente, existe uma seção denominada Controle de Mídia, localizada à direita do campo de descrição: 

Habilitar OCR: permite a leitura e extração de informações dos arquivos recebidos. 

Habilitar upload de mídia: permite o upload de arquivos de mídia para integrações. 

Ambas as opções podem ser utilizadas simultaneamente, não sendo excludentes. Isso significa que um mesmo agente pode realizar o processamento via OCR e, ao mesmo tempo, reconhecer que recebeu um arquivo, permitindo sua manipulação dentro do workflow. 

A ativação dessas duas opções é necessária para viabilizar a troca de mídias diretamente pela conversa, além de facilitar integrações e análises dos arquivos. 

2. Exemplos de casos de uso 

2.1. Envio de documentos ao usuário 

Um agente pode identificar que o usuário possui documentos pendentes, como boletos em aberto, e enviar o arquivo diretamente na conversa. Nesse cenário, o agente recupera o documento de um sistema externo e o entrega ao usuário como arquivo pronto para download. 

Para exemplificar esse comportamento, utilizaremos um agente simples: 

O fluxo abaixo se aplica a cenários reais em que o cliente envia seu CPF, o agente realiza as devidas validações e, em seguida, retorna o boleto correspondente ao documento informado: 

No exemplo, o agente realiza a busca do arquivo do boleto em uma pasta no Google Drive. No entanto, essa integração pode ser feita com qualquer outro sistema externo que permita o envio de arquivos, como CRMs ou sistemas internos do cliente. 

A lógica de integração é definida pelo fluxo do workflow atrelado ao agente e não está limitada a um provedor específico. 

2.1.2. Atuação do componente Integração API no envio dos arquivos 

No workflow em questão, a busca do arquivo é realizada por meio de uma requisição a um sistema externo (Google Drive) e o conteúdo retornado é armazenado, permitindo que o agente inteligente utilize essa informação para responder ao usuário com o arquivo correto: 

2.2. Recebimento de documentos do usuário   

Um agente pode solicitar documentos pessoais ou fiscais, como RG e CPF e, após o recebimento, os documentos podem ser armazenados automaticamente em um sistema externo, como um repositório ou CRM, por exemplo. 

Para exemplificar esse comportamento, utilizaremos um agente simples: 

O fluxo abaixo se aplica a cenários reais em que o cliente envia arquivos com informações que precisam ser salvas em um local externo, por exemplo: 

Neste caso, o agente armazena os arquivos recebidos em uma pasta no Google Drive. No entanto, essa integração pode ser feita com qualquer outro sistema externo que permita o armazenamento de arquivos, como CRMs ou sistemas internos do cliente. 

A lógica de integração é definida pelo fluxo do workflow atrelado ao agente e não está limitada a um provedor específico. 

2.2.2. Atuação do componente Integração API no recebimento dos arquivos 

No workflow em questão, o arquivo é enviado pelo usuário durante a conversa e recebido pelo agente. O conteúdo é então armazenado em uma variável do fluxo e encaminhado, por meio do componente de Integração API, para um sistema externo (como o Google Drive), onde é devidamente salvo: 

3. Variável especial {{_files}} 

Quando um usuário envia arquivos durante a conversa, eles ficam disponíveis na variável especial {{_files}}, que contém todos os arquivos recebidos, indexados numericamente. 

Cada arquivo possui as seguintes propriedades: 

Em integrações como o Google Drive, por exemplo: 

Esse mesmo modelo pode ser aplicado a qualquer API que aceite arquivos. 

3.1. Tipos de arquivos suportados 

Extensões aceitas: 

3.2. Limite de tamanho 

4. Referências e documentação complementar 

As instruções detalhadas sobre o uso da variável {{_files}} e exemplos de configuração estão disponíveis na documentação dos componentes Instruções e Integração API dentro do próprio GOgenier. Basta acessar um dos componentes mencionados e clicar no botão de ajuda: 

Ao fazer isso, uma janela lateral será expandida com informações sobre o componente. Mais abaixo, será possível encontrar as informações referentes à variável {{_files}}: 

Com isso, o Tratamento de arquivos no Workflow se consolida como um recurso essencial para fluxos que demandam troca, armazenamento e processamento de documentos, permitindo integrações flexíveis e adaptáveis a diferentes cenários e sistemas externos.