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

  1. Abra o fluxo na Gestão e entre em Conteúdos.
  2. No menu lateral, abra Recursos.
  3. Clique em Adicionar Novo.
  4. Em Chave, escreva o nome do recurso, como horario_loja.
  5. Em Tipo, escolha Texto ou JSON.
  6. Em Conteúdo, escreva o texto ou o JSON.
  7. Clique no ícone de confirmar (Salvar). A página mostra "Recurso salvo com sucesso!"
  8. No Builder, use o recurso em uma mensagem, escrevendo {{resource.horario_loja}}.
Área Recursos do fluxo

Como usar o recurso numa mensagem

TipoSintaxeO 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

ItemRegra
ChaveObrigatória; letras, números, _ ou .; sem espaço, hífen ou emoji; até 190 caracteres
TipoTexto ou JSON
Conteúdo em JSONPrecisa ser um JSON válido; senão aparece "Este conteúdo deve ser um JSON válido."

Importar vários recursos

  1. Clique no ícone de informação e depois em Importar recursos.
  2. 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.
  3. Clique em Importar.
  4. 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.