---
title: Blocos próprios (código)
slug: aura/blocos-proprios-codigo
createdAt: 2026-11-19T14:33:13.869Z
---

## 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.
