Blocos próprios (código)
Blocos próprios (bloco Código e "Meus blocos")
Quase tudo se resolve com os blocos prontos. Sobra sempre um caso que nenhum deles cobre: recortar um pedaço do retorno de uma API, calcular prazo em dias úteis, normalizar um CPF, montar um texto com uma regra específica do órgão. É para isso que existe o bloco Código — e o jeito de transformar esse código num card na paleta que o resto da equipe usa sem ver uma linha de programação.
Quem pode o quê
Ação | Quem pode |
|---|---|
Escrever ou alterar o código de um bloco | Admin ou Superadmin |
Usar um bloco no fluxo, ligar as saídas, publicar o fluxo | Qualquer pessoa com acesso a Fluxos |
Ver o código de um bloco Código já existente | Qualquer pessoa (somente leitura) |
O bloco Código
Entra o contexto da conversa, sai o contexto alterado. Dentro do código você tem:
Nome | O que é |
|---|---|
ctx | As variáveis da conversa. Altere este dicionário — é ele que volta para o fluxo. |
msg | A mensagem que chegou. |
http | Chamadas HTTP (http.get, http.post…) — só se o bloco liberar, e só para os domínios liberados. |
log() e print() | Aparecem no teste e no simulador; nunca vão para o cliente. |
Campos do painel:
- Código — o programa. Tab indenta em vez de pular de campo.
- Variáveis disponíveis no ctx — lista de tudo que os blocos anteriores criaram; clicar num chip cola ctx["nome"] no código.
- Rodar agora — executa o código na hora, com um contexto de mentira montado a partir das variáveis do fluxo. Mostra o que foi impresso e como o ctx ficou. Dá para testar antes de existir conversa nenhuma.
- Tempo máximo (segundos, teto 30).
- Onde salvar — prefixo das variáveis de resultado. Cria {{codigo_ok}} (deu certo ou não), {{codigo_erro}} (o texto do erro) e {{codigo_log}}.
- Permitir chamadas HTTP + domínios liberados (um por linha). Sem liberar, o código não alcança a rede.
- Aviso ao cliente se falhar (opcional) — o texto que o cliente lê quando o código quebra.
Ligue duas saídas — deu certo e deu erro. Com uma só, o fluxo segue igual nos dois casos e o cliente não percebe a falha.
Publicar como bloco — "Meus blocos"
Terminou o código? Abra Publicar como bloco no mesmo painel. Você declara:
- Nome (ex.: Validar CPF) e para que serve (aparece embaixo do nome, na paleta).
- Campos que o usuário preenche — nome da variável, rótulo, tipo (texto, número, lista, sim/não) e se é obrigatório. A plataforma sugere os campos lendo os ctx["x"] do seu código; você corrige o que quiser.
- O que o bloco devolve (opcional) — só documenta o resultado no painel de quem for usar.
Publicado, ele vira um card na paleta, no grupo Meus blocos deste workspace. Quem usa arrasta o card e preenche um formulário — não vê nem edita o código.
Quando não usar código
- Dá para fazer com Decisão, Ação ou Outro sistema (API)? Use esses — quem herda o fluxo entende sem ler programação.
- Precisa consultar um sistema já cadastrado? Use o bloco Integração: ele já tem credencial cifrada, catálogo de ações e busca de opções.
- Regra que muda toda semana? Prefira campo configurável a código escondido no fluxo.