Configurações de fluxo

Visão geral

O painel Configurações de fluxo oferece controle total sobre como seu fluxo se comporta, aparece e se integra a ferramentas externas. As configurações têm escopo definido por fluxo, o que significa que cada fluxo pode ter seu próprio domínio, metadados, colaboradores e credenciais de integração. Para acessar as configurações de fluxo:

ZappWay Dashboard
└── Sidebar Menu → Tools → ZappFlux
    └── Flow List → Select a Flow → Settings tab
        ├── General (name, icon, directory)
        ├── Metadata (title, description, OG image)
        ├── Custom Domains
        ├── Collaborators
        └── Global Integrations

Configurações Gerais

A guia Geral controla a identidade básica do seu fluxo no painel do ZappWay.

Configuração	Descrição
Nome do Projeto	O nome de exibição interno usado para identificar o fluxo na exibição de lista
Ícone	O emoji ou ícone que representa o fluxo no painel
Diretório/Pasta	A pasta à qual este fluxo pertence — use diretórios para organizar fluxos por projeto, cliente ou equipe
Status	Publicado ou Rascunho — controla se o fluxo está ativo para usuários finais
URL de fluxo	A URL pública onde o fluxo está acessível (somente leitura, com base nas configurações do seu domínio)

Alterando o nome do fluxo:

Navegue até Configurações → Geral
Clique no campo Nome do Projeto
Digite o novo nome
Clique em Salvar

Renomear um fluxo não altera seu URL público, a menos que você esteja usando o subdomínio ZappWay padrão e ainda não tenha definido um domínio personalizado. Se um domínio customizado estiver configurado, a URL será independente do nome do fluxo.

Metadados

Os metadados controlam como seu fluxo aparece nas guias do navegador, nos resultados de pesquisa e quando seu link é compartilhado em plataformas sociais e aplicativos de mensagens.

Campo	Descrição
Título da página	O título mostrado na aba do navegador e usado pelos motores de busca
Descrição	O texto resumido mostrado abaixo do título nas visualizações de links e nos resultados de pesquisa
Favicon	O pequeno ícone mostrado na guia do navegador — suporta upload de imagens (PNG, ICO, SVG)
Imagem OG (Compartilhar imagem)	A imagem em destaque exibida quando o link do fluxo é compartilhado no WhatsApp, Facebook, LinkedIn, Twitter/X, etc.
HTML personalizado	Injetar scripts ou tags personalizados em `<head>` ou `<body>` da página de fluxo

Tamanhos de metadados recomendados

Ativo	Tamanho recomendado	Formato
Favicon	32×32 px ou 64×64 px	PNG, ICO, SVG
Imagem OG	1200×630 pixels	PNG ou JPG

Sempre defina uma imagem OG. Quando os usuários compartilham seu link de fluxo no WhatsApp ou nas redes sociais, uma imagem de visualização atraente aumenta drasticamente as taxas de cliques em comparação com uma visualização em branco ou genérica.

HTML personalizado

O campo HTML personalizado permite que você injete scripts de terceiros em sua página de fluxo. Isso é comumente usado para:

Acompanhamento analítico — Google Analytics, Mixpanel, PostHog
Pixels de anúncio — Meta Pixel, tags de conversão do Google Ads, TikTok Pixel
Widgets de chat — Adicionando uma sobreposição de chat ao vivo no topo do fluxo
Ferramentas de mapa de calor — Hotjar, Microsoft Clarity
CSS personalizado — Substituindo os estilos visuais padrão do fluxo

Como adicionar HTML personalizado:

Navegue até Configurações → Metadados → HTML personalizado
Escolha o ponto de injeção: <head> (para scripts que carregam antecipadamente) ou <body> (para scripts que são executados após o carregamento da página)
Cole seu script ou tag
Clique em Salvar
Republicar o fluxo para que as alterações entrem em vigor

Injete scripts apenas de fontes confiáveis e verificadas. Scripts de terceiros maliciosos ou mal escritos podem interromper seu fluxo, expor dados do usuário ou causar vulnerabilidades de segurança. ZappWay não é responsável por problemas causados por injeções de HTML personalizado.

Domínios Personalizados

Conecte seu próprio domínio para remover a marca padrão zappflux.zappway.ai do URL público do seu fluxo e apresentar uma experiência totalmente branca aos seus usuários. Exemplo:

Default URL:  https://flows.zappflux.zappway.ai/your-flow
Custom Domain: https://chat.yourcompany.com/your-flow

Configurando um domínio personalizado

Etapa 1: Adicione o domínio no ZappWay

Navegue até Configurações → Domínios personalizados
Clique em Adicionar Domínio
Insira o domínio ou subdomínio desejado (por exemplo, chat.yourcompany.com)
Clique em Adicionar

Etapa 2: Configure o DNS no seu provedor de domínio

Faça login no seu registrador de domínio (GoDaddy, Cloudflare, Namecheap, etc.)
Vá para o seu painel de gerenciamento DNS
Adicione um novo registro CNAME com os seguintes valores:

Campo	Valor
Tipo	CNAME
Nome/Anfitrião	`chat` (ou o prefixo do subdomínio escolhido)
Valor/Meta	`cname.zappflux.zappway.ai`
TTL	3600 (ou “Automático”)

Etapa 3: Aguarde a verificação

A propagação do DNS normalmente leva entre 5 minutos e 48 horas
ZappWay verifica o domínio automaticamente e emite um certificado SSL uma vez verificado
O status do domínio nas suas configurações será atualizado de Pendente para Ativo

Os certificados SSL são provisionados automaticamente sem nenhum custo extra. Você não precisa fazer upload ou gerenciar certificados manualmente.

Indicadores de status de domínio

Estado	Significado
Pendente	Registro DNS foi adicionado no ZappWay, mas ainda não verificado
Verificando	ZappWay está verificando o registro DNS
Ativo	O domínio está ativo, o SSL está provisionado, o fluxo está acessível
Falha	Não foi possível verificar o registro DNS — verifique sua configuração CNAME

Solução de problemas de domínios personalizados

Se o seu domínio permanecer no status Pendente ou Com falha:

Verifique novamente o registro CNAME em seu provedor DNS – erros de digitação são a causa mais comum
Certifique-se de que não haja registros A conflitantes para o mesmo subdomínio
Aguarde até 48 horas pela propagação completa do DNS global
Use uma ferramenta de verificação de DNS (por exemplo, dnschecker.org) para verificar se o CNAME está resolvendo para cname.zappflux.zappway.ai
Entre em contato com support@zappway.ai se o problema persistir após 48 horas

Colaboradores

Convide membros da equipe para acessar e editar um fluxo específico sem conceder-lhes acesso a toda a sua organização ZappWay.

Níveis de permissão

Função	Permissões
Visualizador	Pode visualizar o editor de fluxo e as configurações no modo somente leitura; não é possível fazer alterações
Editor	Pode editar blocos de fluxo, configurações e metadados; pode publicar o fluxo
Administrador	Acesso total incluindo gerenciamento de colaboradores e exclusão de fluxo

Convidando um Colaborador

Navigate to Settings → Collaborators
Click Invite Collaborator
Enter the team member’s email address
Select their permission level (Viewer, Editor, or Admin)
Click Send Invite

O usuário convidado recebe um email com um link para aceitar o convite. Se eles não tiverem uma conta ZappWay, serão solicitados a criar uma.

Gerenciando colaboradores existentes

Alterar função: clique no menu suspenso de função ao lado do nome de um colaborador e selecione uma nova função
Remover acesso: clique no menu ⋮ ao lado do colaborador e selecione Remover
Reenviar convite: se um convite expirou, clique em Reenviar ao lado do convite pendente

Os colaboradores adicionados no nível do fluxo só têm acesso a esse fluxo específico. Para acesso mais amplo no nível da organização, gerencie os membros da equipe em Configurações → Equipe.

Integrações globais

A guia Integrações em Configurações de fluxo é onde você configura as credenciais de API e os tokens de conexão usados pelos blocos de integração em todo o fluxo. Essas credenciais são armazenadas de forma segura e compartilhadas entre todos os blocos deste fluxo.

Integrações disponíveis

IA e modelos de linguagem

Integração	Credencial necessária	Usado para
OpenAI	Chave de API OpenAI	Blocos ChatGPT, geração de respostas de IA, classificação de conteúdo
Antrópico	Chave API Antrópica	Blocos Claude AI para raciocínio e conversação avançados

Como adicionar sua chave de API OpenAI:

Navegue até Configurações → Integrações → OpenAI
Clique em Conectar
Cole sua chave de API em platform.openai.com/api-keys
Clique em Salvar

Serviços do Google

Integração	Credencial necessária	Usado para
Planilhas Google	Google OAuth (faça login com o Google)	Ler/escrever linhas em planilhas por meio do bloco Planilhas
Google Analytics	ID de medição (GA4)	Enviar eventos do bloco Analytics
Google Agenda	Google OAuth	Verifique disponibilidade, crie eventos

Canais de mensagens

Integração	Credencial necessária	Usado para
WhatsApp (API Evolution)	URL da API + chave da API	Enviar mensagens por meio do provedor Evolution API
WhatsApp (WPPConnect)	URL da API + token de sessão	Envie mensagens via provedor WPPConnect
Telegrama	Token de bot	Conecte um bot do Telegram ao seu fluxo

Automação e webhooks

Integração	Credencial necessária	Usado para
Zapier	URL do webhook (de Zapier)	Acionar Zaps de dentro do fluxo
Fazer (Integromat)	URL do webhook (de Make)	Acionar Criar cenários dentro do fluxo

Suporte ao Cliente

Integração	Credencial necessária	Usado para
Bate-papo	URL da API + token de acesso	Transferir conversas para uma caixa de entrada do Chatwoot para transferência humana

E-mail

Integração	Credencial necessária	Usado para
SMTP	Host, Porta, Nome de Usuário, Senha	Envie emails transacionais através do seu próprio servidor de email
SendGrid	Chave API SendGrid	Envie e-mails transacionais via SendGrid

As chaves e credenciais de API armazenadas aqui têm escopo apenas para esse fluxo. Se precisar das mesmas credenciais em vários fluxos, você deverá configurá-las individualmente nas Configurações de cada fluxo. O gerenciamento de credenciais em toda a organização está disponível nos planos Enterprise.

Testando Integrações

Depois de salvar as credenciais, use o botão Testar conexão ao lado de cada integração para verificar se as credenciais são válidas antes de publicar seu fluxo. Uma marca de seleção verde confirma que a conexão está funcionando; um erro vermelho indica um problema com as credenciais.

Publicação e controle de versão

Publicando um fluxo

As alterações feitas no editor de fluxo são salvas automaticamente como rascunhos. Eles não ficam visíveis para os usuários finais até que você os publique. Para publicar:

Conclua suas alterações no editor de fluxo
Clique em Publicar no canto superior direito do editor
Uma confirmação aparece indicando que o fluxo está ativo

O que a publicação faz:

Disponibiliza a versão de rascunho atual no URL público do fluxo
Salva um instantâneo da versão (acessível no Histórico de versões)
Notifica os canais conectados que uma nova versão está disponível

Histórico de versões

Acesse versões anteriores publicadas do seu fluxo:

Navegue até Configurações → Versões
Uma lista de todas as versões publicadas aparece com carimbos de data e hora
Clique em qualquer versão para visualizá-la
Clique em Restaurar para reverter para uma versão anterior

Antes de fazer grandes alterações em um fluxo ativo, crie uma duplicata. Use a opção Duplicar fluxo na lista de fluxos para fazer uma cópia segura, editar a cópia e publicá-la somente quando estiver pronta.

Solução de problemas

Problema: o script HTML personalizado não é acionado

Sintomas:

Os eventos de análise não aparecem na sua plataforma de rastreamento
Pixel não registra conversões

Soluções:

Certifique-se de que o fluxo foi republicado após salvar o HTML personalizado
Verifique se o script foi injetado no local correto (<head> vs. <body>)
Verifique no console do navegador (F12) se há erros de JavaScript do script
Teste em uma janela anônima para descartar extensões do navegador bloqueando o script
Confirme se a sintaxe do script é válida – um único erro pode impedir a execução de todos os scripts personalizados

Problema: falha no teste de integração

Sintomas:

Erro “Falha na conexão” ao testar uma integração
Blocos que usam a integração geram erros em tempo de execução

Soluções:

Verifique se a chave ou token da API não expirou ou foi revogado
Verifique se a chave API tem as permissões/escopos necessários (por exemplo, a chave OpenAI deve ter acesso às conclusões do chat)
Para integrações OAuth (Google), tente desconectar e reconectar sua conta
Certifique-se de que não haja espaços extras antes ou depois da credencial colada
Entre em contato com support@zappway.ai com o nome da integração e a mensagem de erro

Problema: o colaborador não recebeu o convite

Sintomas:

Membro da equipe diz que nunca recebeu o e-mail de convite

Soluções:

Peça-lhes para verificarem a pasta de spam/lixo eletrônico
Verifique se você digitou o endereço de e-mail correto no convite
Clique em Reenviar ao lado do convite pendente em Configurações → Colaboradores
Se o problema persistir, o membro da equipe pode tentar inscrever-se diretamente em zappway.ai com esse endereço de e-mail e, em seguida, tentar novamente o convite

Melhores práticas

1. Preencha os metadados antes de compartilhar Sempre preencha o título da página, a descrição e a imagem OG antes de compartilhar um link de fluxo externamente. Uma visualização completa e refinada gera confiança e melhora o engajamento. 2. Use domínios personalizados para fluxos voltados para o cliente Se você estiver criando fluxos para clientes ou executando campanhas profissionais, configure sempre um domínio personalizado. Reforça a identidade da marca e evita confusão do subdomínio ZappWay. 3. Escopo o acesso do colaborador com cuidado Conceda acesso de Editor apenas aos usuários que precisam fazer alterações. Use o acesso de visualizador para partes interessadas que precisam de visibilidade sem risco de edições acidentais. 4. Alterne as chaves de API periodicamente Por segurança, alterne as chaves de API (OpenAI, Stripe, etc.) a cada 90 dias. Ao atualizar uma chave, atualize-a em Configurações → Integrações e teste a conexão antes de republicar. 5. Republicar após cada alteração nas configurações As alterações nos metadados, no HTML personalizado e nas credenciais de integração só terão efeito para os usuários finais depois que você publicar o fluxo. Adquira o hábito de republicar imediatamente após salvar as alterações nas configurações.

Dica profissional: Use o campo HTML personalizado para injetar um script de gravação de sessão Hotjar ou Microsoft Clarity em fluxos de alto tráfego. Assistir a gravações de sessões reais revela exatamente onde os usuários hesitam, desistem ou ficam confusos – fornecendo dados acionáveis para melhorar as taxas de conclusão.

Apoiar

Precisa de ajuda com Configurações de fluxo? Entre em contato com o suporte ZappWay:

E-mail: support@zappway.ai
Incluir: nome ou ID do fluxo, captura de tela do problema e etapas para reproduzir

Forneça estes detalhes ao relatar problemas:

Em qual seção de configurações você estava (Geral, Metadados, Domínio, etc.)
A mensagem de erro exata, se alguma aparecer
Se o problema afeta um fluxo ou todos os fluxos
Seu navegador e sistema operacional

Última atualização: março de 2026 Plataforma: Configurações de fluxo do ZappFlux | Painel ZappWay

​Configurações de fluxo

​Visão geral

​Configurações Gerais

​Metadados

​Tamanhos de metadados recomendados

​HTML personalizado

​Domínios Personalizados

​Configurando um domínio personalizado

​Indicadores de status de domínio

​Solução de problemas de domínios personalizados

​Colaboradores

​Níveis de permissão

​Convidando um Colaborador

​Gerenciando colaboradores existentes

​Integrações globais

​Integrações disponíveis

​IA e modelos de linguagem

​Serviços do Google

​Canais de mensagens

​Automação e webhooks

​Suporte ao Cliente

​E-mail

​Testando Integrações

​Publicação e controle de versão

​Publicando um fluxo

​Histórico de versões

​Solução de problemas

​Problema: o script HTML personalizado não é acionado

​Problema: falha no teste de integração

​Problema: o colaborador não recebeu o convite

​Melhores práticas

​Apoiar

Configurações de fluxo

Visão geral

Configurações Gerais

Metadados

Tamanhos de metadados recomendados

HTML personalizado

Domínios Personalizados

Configurando um domínio personalizado

Indicadores de status de domínio

Solução de problemas de domínios personalizados

Colaboradores

Níveis de permissão

Convidando um Colaborador

Gerenciando colaboradores existentes

Integrações globais

Integrações disponíveis

IA e modelos de linguagem

Serviços do Google

Canais de mensagens

Automação e webhooks

Suporte ao Cliente

E-mail

Testando Integrações

Publicação e controle de versão

Publicando um fluxo

Histórico de versões

Solução de problemas

Problema: o script HTML personalizado não é acionado

Problema: falha no teste de integração

Problema: o colaborador não recebeu o convite

Melhores práticas

Apoiar