Entradas (Inputs)

Blocos de Entrada pedem alguma coisa ao cliente e armazenam a resposta numa variável. O fluxo espera a resposta antes de continuar.

✏️

Texto

text input

Entrada

O que faz: Pede texto livre. Pode ser campo único ou textarea para textos longos.

Configurações:

• isLong — true vira textarea (multi-linha)
• Placeholder — texto da caixa de input
• Botão — label do botão de enviar
• Variable ID — onde salvar a resposta

Gotchas:

• Sem validação — qualquer string passa. Use Condição depois pra validar.

🔘

Botões

choice input

Entrada

O que faz: Mostra múltiplas opções clicáveis. O cliente escolhe e o fluxo segue baseado na escolha.

Configurações:

• Items — lista de botões. Cada um tem content (label) e payload (valor enviado, opcional)
• isMultipleChoice — permitir várias seleções
• Button label — só se múltipla escolha (label do botão Enviar final)
• isSearchable — mostra caixa de busca para filtrar (útil quando há muitos)
• Search placeholder — texto da busca
• Display condition (por item) — esconder/mostrar botão baseado em variável

Como o fluxo segue: cada botão tem sua própria saída no canvas — você liga cada uma a um caminho diferente.

Gotchas:

• WhatsApp suporta só 3 botões num bloco (use Listas pra mais)
• Em Telegram, botões também viram quick replies se forem poucos

✉️

E-mail

email input

Entrada

O que faz: Pede e-mail e valida o formato.

Configurações:

• Placeholder, button label — labels custom
• Retry message — o que dizer se a pessoa digitar errado
• Variable ID — salvar resposta

Gotchas:

• Validação só checa formato, não confirma se o e-mail existe. Para confirmação real, mande um link.

🔢

Número

number input

Entrada

O que faz: Pede um número com validação min/max e step.

Configurações:

• Min, Max — limites (podem ser variáveis)
• Step — incremento (ex: 0.01 pra duas casas decimais)
• Variable ID — salvar valor

🔗

URL

url input

Entrada

O que faz: Pede uma URL e valida formato.

Gotchas: valida só o formato, não checa se o site responde.

📅

Data

date input

Entrada

O que faz: Mostra um date picker. Pode aceitar data única, intervalo, com ou sem hora.

Configurações:

• hasTime — incluir hora
• isRange — escolher intervalo (de / até)
• format — formato da string final (ex: YYYY-MM-DD)
• min, max — limites
• Labels — botão e textos "from"/"to"

Gotchas:

• WhatsApp não tem date picker nativo — vira input texto com instrução
• Web Widget mostra calendário visual

📞

Telefone

phone number input

Entrada

O que faz: Pede número com seletor de país e validação.

Configurações:

• Default country code — pré-seleciona país (BR, US, etc.)
• Retry message

Gotchas:

• Validação é client-side. Pra confirmar que o número existe, mande SMS de validação.

⭐

Avaliação

rating input

Entrada

O que faz: CSAT visual — 5 estrelas, 5 números, 10 ícones, etc.

Configurações:

• Button type — Icons (estrelas/corações) ou Numbers
• Length — quantas opções (default 5)
• Starts at — começa em 0 ou 1
• Custom icon — SVG customizado (ex: pizza pra avaliar restaurante)
• Labels left/right — descrição dos extremos ("Ruim" / "Excelente")
• One-click submit — ao clicar uma vez, já submete (sem botão)

Gotchas:

• One-click é rápido mas o cliente não consegue corrigir.

🖼️

Foto / Picture choice

picture choice input

Entrada

O que faz: Apresenta imagens como opções. Cada item tem foto + título + descrição.

Configurações:

• Items — lista de imagens com título e descrição
• isMultipleChoice — múltipla seleção
• isSearchable — busca por título
• Dynamic items — gerar items a partir de variáveis (3 listas: títulos, descrições, URLs)

Gotchas:

• Imagens grandes deixam render lento — use thumbnails (max 800x800)
• Em WhatsApp não vira "picture choice" nativo — vira lista de opções

📁

Arquivo

file input

Entrada

O que faz: Permite o cliente fazer upload de arquivo.

Configurações:

• isRequired — opcional ou obrigatório
• isMultipleAllowed — vários arquivos
• Visibility — Auto, Public, Private (afeta acesso ao link gerado)
• Labels — placeholder, botão, sucesso

Gotchas:

• Tamanho máximo varia por canal: WhatsApp 100 MB, Web 25 MB

💳

Pagamento (Stripe)

payment input

Entrada

O que faz: Cobra pagamento via Stripe direto na conversa.

Configurações:

• Provider — só Stripe por enquanto
• Credentials ID — credencial Stripe configurada
• Currency — BRL, USD, etc.
• Amount — valor em centavos (pode ser variável)
• Additional info — nome, e-mail, endereço pré-preenchidos
• Labels — botão, mensagem de sucesso, erro

Gotchas:

• PCI compliance fica com a Stripe — você nunca vê o cartão
• Só funciona em Web Widget (canais móveis abrem link)

Como cada entrada salva variável

Todo bloco de entrada tem o campo Variable ID. Se você não definir, o sistema gera uma automaticamente. Mas pra usar a resposta depois, você precisa dar um nome explícito.

Próximos passos

• Variáveis e contexto
• Lógica — validar e ramificar respostas