Integrações
Blocos de Integração conectam o fluxo a sistemas externos: HTTP, Sheets, IA, e-mail, analytics, automação no-code.
WebhookO que faz: Faz uma requisição HTTP a qualquer endpoint e mapeia a resposta de volta pra variáveis.
Configurações:
- URL — endpoint
- Method — GET, POST, PUT, DELETE, PATCH, etc. (default POST)
- Headers — lista key/value
- Query params — lista key/value
- Body — string (JSON ou texto)
- Is custom body — usar editor avançado de body
- Is executed on client — rodar no browser (CORS aplica)
- Timeout — em segundos (1-120)
- Response variable mapping — pra cada variável: bodyPath (ex:
data.user.name) - Variables for test — sample pra testar no construtor
Gotchas:
- CORS bloqueia requests do browser pra domínios sem
Access-Control-Allow-Origin - bodyPath usa notação
.(ex:data.items[0].name) - Timeout é server-side; em produção respeita
Google SheetsO que faz: Lê ou escreve em planilhas Google. Suporta GET (consultar), INSERT (adicionar), UPDATE (modificar).
Configurações comuns:
- Credentials ID — OAuth Google configurado
- Spreadsheet ID — da URL da planilha
- Sheet ID — qual aba
Para Get:
- Filter — condições (mesma sintaxe do bloco Condição)
- Cells to extract — pra cada coluna: nome da coluna + variável onde salvar
- Total rows to extract —
All,First,Last,Random
Para Insert/Update:
- Cells to insert/upsert — pra cada coluna: valor (ou variável)
Gotchas:
- Cell names são case-sensitive na header da planilha
- Filtros muito complexos podem dar timeout em sheets gigantes (>10k linhas)
OpenAIO que faz: Chama APIs OpenAI: chat completion, TTS (text-to-speech), geração de imagem.
Configurações chat completion:
- Credentials ID — chave OpenAI
- Base URL, API version — pra OpenAI-compatible (Azure OpenAI, etc.)
- Model —
gpt-4o,gpt-3.5-turbo, etc. - Messages — array com
role(system/user/assistant) econtent - Temperature — 0 a 2
- Response mapping —
Message contentouTotal tokens→ variável
Configurações speech (TTS):
- Voice — alloy / echo / fable / onyx / nova / shimmer
- Input — texto a falar
- Save URL — variável com URL do MP3 gerado
Configurações image:
- Prompt — descrição da imagem
- Size — 256x256, 512x512, 1024x1024
Gotchas:
- Tokens custam — controle prompt size
- Imagem fica num CDN temporário; baixe se quiser persistir
EmailO que faz: Envia e-mail via SMTP configurado.
Configurações:
- Credentials ID — SMTP
- Recipients, CC, BCC, Reply-to
- Subject — pode ter variáveis
- Body — HTML ou texto
- Is body code — JS dinâmico
- Attachments variable ID — variável com URLs pra anexar
Gotchas:
- Variáveis no subject usam template syntax
{{var}} - Anexos precisam ser URLs publicamente acessíveis
Google AnalyticsO que faz: Dispara evento GA4.
Configurações:
- Tracking ID —
G-XXXXXXX - Category, action, label — strings (template OK)
- Value — número
- Send to — destino secundário (raro)
ZapierO que faz: Manda webhook pro seu zap. Usa schema do Webhook por baixo.
Make.comO que faz: Manda webhook pro Make. Schema idêntico ao Webhook.
PabblyO que faz: Webhook pro Pabbly Connect. Schema idêntico ao Webhook.
PixelO que faz: Dispara evento de Meta Pixel (Facebook Pixel) para tracking de conversão.
Configurações:
- Pixel ID — Meta Pixel
- Event type —
Lead,Purchase,AddToCart,Subscribe,Custom, etc. - Custom name — se evento
Custom - Params — pra cada parâmetro: key + value
Gotchas:
- Pixel precisa estar instalado na página primeiro
- Parâmetros variam por evento; consulte docs do Meta
Zemantic AIO que faz: Busca semântica em knowledge base do Zemantic.
Configurações:
- Credentials ID, Project ID
- Query — pergunta
- Prompt, System prompt — modificar geração do summary
- Max results — quantos retornar
- Response mapping —
SummaryouResults→ variável
Próximos passos
- Tickets — sistema interno de chamados
- Customizados — blocos Cosmo-específicos