Bolhas (Bubbles)

Os blocos de Bolha mostram conteúdo pro cliente — sem esperar resposta. São o jeito de o bot "falar".

💬

Texto

text

Bolha

O que faz: Mensagem de texto livre. Aceita variáveis ({{nome}}), formatação rica (negrito, itálico, listas), emojis.

Configurações:

• Rich text — editor visual (negrito, itálico, listas, links)
• HTML — modo avançado, edição direta
• Plain text fallback — para canais que não renderizam HTML (SMS)

Visual no canvas: balão azul claro com ícone 💬.

Gotchas:

• Variáveis indefinidas aparecem como {{nome}} literal — sempre tenha um valor padrão
• Markdown não funciona em todos os canais (WhatsApp suporta *bold*, Web suporta tudo)
• Quebras de linha duplas viram parágrafos no rich text

🖼️

Imagem

image

Bolha

O que faz: Mostra uma imagem a partir de URL. Pode ser clicável.

Configurações:

• URL da imagem (HTTP ou HTTPS)
• Click link — URL pra abrir quando o cliente clica (opcional)
• Alt text — acessibilidade

Formatos aceitos: JPG, PNG, GIF, WebP. Tamanho recomendado: até 5 MB no WhatsApp.

Gotchas:

• A URL precisa ser pública e CORS-friendly
• WhatsApp dá problema com GIFs animados — use vídeo MP4 curto

🎬

Vídeo

video

Bolha

O que faz: Embeda vídeo de várias fontes — direct URL, YouTube, Vimeo, TikTok ou Gumlet.

Configurações:

• Type — url (vídeo direto) / youtube / vimeo / tiktok / gumlet
• URL ou ID do vídeo
• Aspect ratio — 16/9 (paisagem) ou 9/16 (vertical) ou 1/1 (quadrado)
• Height — em px (default 400)
• Max width — default 100%

Gotchas:

• WhatsApp não embeda YouTube — o cliente recebe um link e abre fora
• MP4 direto tem limite de 16 MB no WhatsApp
• TikTok e Vimeo só funcionam em Web Widget e Telegram

🔊

Áudio

audio

Bolha

O que faz: Toca um áudio (URL ou arquivo).

Configurações:

• URL do áudio (MP3, OGG, M4A)
• Auto-play — começar tocando sozinho

Gotchas:

• Auto-play é bloqueado por muitos navegadores em Web
• WhatsApp recebe o áudio como "nota de voz"

📎

Embed

embed

Bolha

O que faz: Embeda HTML arbitrário via <iframe>. Útil pra mapas, calendários, widgets de terceiros.

Configurações:

• URL a embedar
• Height em px

Gotchas:

• Só funciona em Web Widget (outros canais não embedam HTML)
• Site embedado precisa permitir X-Frame-Options
• Carregamento lento se for site externo pesado

Combinando bolhas

Bolhas em sequência viram mensagens encadeadas — o cliente vê uma após a outra com pequeno delay (configurável):

Próximos passos

• Entradas — pra quando você precisa do cliente responder
• Lógica — pra ramificar