Conteúdos · Atualizado em 06/10/2026
Como usar os recursos do fluxo
Cadastre recursos de texto ou JSON, importe vários de uma vez e use a chave nas mensagens do chatbot com a sintaxe resource.
Recursos são conteúdos que você guarda uma vez e reutiliza nas mensagens do chatbot. Em vez de repetir o mesmo texto em vários blocos, você cria um recurso com uma chave e o referencia.
Quando usar
Use recursos para textos que mudam com frequência ou que aparecem em muitos lugares: horário de funcionamento, política de troca, endereço da loja. Na Loja Girassol, a chave horario_loja guarda o texto do horário. Quando o horário muda, a equipe edita um só lugar.
Pré-requisitos
- Acesso à área Conteúdos do fluxo, com permissão de edição para criar, editar ou excluir.
Passo a passo
- Abra o fluxo na Gestão e entre em Conteúdos.
- No menu lateral, abra Recursos.
- Clique em Adicionar Novo.
- Em Chave, escreva o nome do recurso, como
horario_loja. - Em Tipo, escolha Texto ou JSON.
- Em Conteúdo, escreva o texto ou o JSON.
- Clique no ícone de confirmar (Salvar). A página mostra "Recurso salvo com sucesso!"
- No Builder, use o recurso em uma mensagem, escrevendo
{{resource.horario_loja}}.
Como usar o recurso numa mensagem
| Tipo | Sintaxe | O que mostra |
|---|---|---|
| Texto | {{resource.chave}} | O conteúdo inteiro do recurso |
| JSON | {{resource.chave@propriedade}} | O valor da propriedade do JSON |
O ícone de informação, ao lado do título Recursos, mostra essa explicação e o link Importar recursos. No Builder, os recursos do fluxo aparecem também na lista de variáveis, como resource.<chave>.
Regras
| Item | Regra |
|---|---|
| Chave | Obrigatória; letras, números, _ ou .; sem espaço, hífen ou emoji; até 190 caracteres |
| Tipo | Texto ou JSON |
| Conteúdo em JSON | Precisa ser um JSON válido; senão aparece "Este conteúdo deve ser um JSON válido." |
Importar vários recursos
- Clique no ícone de informação e depois em Importar recursos.
- Cole um JSON no campo JSON de recursos a importar. Pode ser uma lista de itens com chave, tipo e conteúdo ou um objeto em que cada chave vira um recurso.
- Clique em Importar.
- Leia o resultado: quantos recursos foram importados e quais itens tiveram erro.
Editar e excluir
- O lápis (Editar) abre os campos da linha. Salve ou cancele.
- A lixeira (Excluir) abre a confirmação: "Excluir o recurso ... Fluxos que o referenciam deixam de encontrá-lo."
- A lista mostra uma prévia do conteúdo, cortada em três linhas ou 200 caracteres.
Exemplo na Loja Girassol
O recurso horario_loja tem o texto "Atendemos de segunda a sábado, das 9h às 18h." O bloco de texto do menu usa "Nosso horário: {{resource.horario_loja}}". Já o recurso JSON prazos guarda {"capital":"2 dias","interior":"5 dias"}, e a mensagem "Prazo na capital: {{resource.prazos@capital}}" mostra "2 dias".
Resultado esperado
O recurso aparece na lista com chave, tipo e conteúdo. Nas mensagens, a referência é substituída pelo conteúdo.
Boas práticas
- Use chaves curtas e padronizadas:
horario_loja,politica_troca. - Teste a mensagem no Builder depois de criar o recurso.
- Antes de excluir, procure no fluxo onde a chave é usada.
Limitações
- Só existem os tipos Texto e JSON.
- O recurso vale para o fluxo em que foi criado.
- Excluir um recurso não corrige as mensagens que o referenciam.
Problemas comuns
- Aparece "A chave deve conter apenas letras, números, "_" ou "."": remova espaços, hífens e emojis.
- Aparece "Informe a chave do recurso.": a chave está vazia.
- A mensagem mostra a chave em vez do texto: confira a grafia da chave.
- A lista aparece vazia: "Você ainda não adicionou nenhum recurso."
Próximos passos
Perguntas frequentes
O que é um recurso?
Um conteúdo guardado com uma chave, como um texto de política ou um conjunto de dados, que o chatbot pode usar nas mensagens.
Como uso um recurso numa mensagem?
Escreva {{resource.chave}} no texto, trocando chave pelo nome do recurso. Para JSON, use {{resource.chave@propriedade}}.
Que caracteres a chave aceita?
Letras, números, sublinhado e ponto, sem espaços, hífen ou emojis, em até 190 caracteres.
O que acontece se eu excluir um recurso?
Os fluxos que o referenciam deixam de encontrá-lo.
Posso importar vários recursos?
Sim, em Importar recursos, colando um JSON.
Esse artigo foi útil?
Obrigado pelo retorno!