Esta seção explica como detectar quando um usuário envia um arquivo, obter seu link e como trabalhar com ele corretamente.

Para identificar quando um usuário enviou um anexo (como uma imagem, arquivo, vídeo ou áudio), você deve usar a condição de gatilho:

attachment_message

Após um usuário enviar um arquivo, as seguintes variáveis de sistema são geradas:

  • #{attachments}: Contém as URLs de todos os anexos da mensagem do usuário, formatadas como um array JSON. Use esta quando precisar processar vários arquivos ou lidar com a estrutura de dados programaticamente.
  • #{attachment_url}: Contém uma URL direta e em texto simples para o primeiro (ou único) anexo. Esta é a variável mais conveniente para uso imediato, como exibir o link em uma mensagem ou passá-lo para outra função.

Para entender a diferença prática, você pode exibir ambas as variáveis em uma mensagem do bot. A variável #{attachments} mostrará um array JSON estruturado, enquanto #{attachment_url} mostrará uma URL simples e clicável.

Se o seu projeto lida com vários anexos de usuários, é eficiente atribuir cada URL de anexo a uma variável dedicada.

Para fazer isso, declare uma nova variável na Calculadora do editor de blocos e atribua o valor de #{attachment_url} a ela.

Exemplo:
user_file = #{attachment_url}

Atribua o valor de attachment_url à variável url_image1.