Resultado
Encerrar uma execução de API com uma resposta estruturada, incluindo corpo, status e cabeçalhos.
O que faz
Define a resposta final do fluxo. Permite montar ou editar uma resposta estruturada, que é devolvida quando o fluxo termina.
Quando usar: Use quando o seu fluxo precisar encerrar uma execução de API com uma resposta estruturada, incluindo corpo, status e cabeçalhos.
Exemplo de situação: Processar os dados antes de seguir para a próxima etapa.
Use este bloco apenas em fluxos que precisam responder a uma chamada de API. Em conversas de canais, use o bloco do próprio canal.
Antes de começar
Conexão necessária: Sem conexão externa obrigatória.
Nenhuma conta externa é obrigatória para usar este bloco.
Passo a passo
- Adicione Resultado ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Nenhuma conta externa é obrigatória para usar este bloco.
- Revise a ação principal descrita no cartão do bloco.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Campos
Modo dos dados
Escolha como definir a estrutura dos dados da resposta.
- Opções:
- Construtor · Editor
- Padrão:
- Construtor
Campos da resposta
Defina a estrutura dos dados da resposta. Use <variable.nome> nos nomes dos campos para referenciar variáveis do fluxo.
- Quando aparece:
- Quando o campo “Modo dos dados” for “Construtor”
Dados
Dados enviados como corpo da resposta em chamadas de API. Use <variable.nome> para referenciar variáveis do fluxo.
- Quando aparece:
- Quando o campo “Modo dos dados” for “Editor”
- Exemplo:
- { "chave": "valor" }
Código de status
Código de status HTTP (padrão: 200).
- Exemplo:
- 200
Cabeçalhos
Cabeçalhos HTTP adicionais a incluir na resposta.
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <resultado.data>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<resultado.data> | json | Dados da resposta. |
<resultado.status> | number | Código de status HTTP. |
<resultado.headers> | json | Cabeçalhos da resposta. |
Exemplo de uso
Objetivo: Processar os dados antes de seguir para a próxima etapa.
- Modo dos dados
- Construtor
- Dados
- { "chave": "valor" }
- Código de status
- 200
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <resultado.data>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
Blocos relacionados
- AgendamentoIniciar a execução automaticamente nos dias e horários programados.
- Aguardar uma pessoaPausar a execução e aguardar uma decisão ou informação fornecida por uma pessoa.
- AnotaçãoAdicionar uma anotação visual ao desenho do fluxo sem executar uma ação.
- APIExpor um endpoint HTTP legado para iniciar o fluxo; em fluxos novos, prefira o bloco Início.
- AvaliadorAvaliar um conteúdo com critérios definidos e devolver uma nota ou conclusão.
- Base de conhecimentoPesquisar semanticamente nas bases de conhecimento disponíveis.