Skip to main content

​
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:

​
Configurações Gerais

A guia Geral controla a identidade básica do seu fluxo no painel do ZappWay. Alterando o nome do fluxo:
  1. Navegue até Configurações → Geral
  2. Clique no campo Nome do Projeto
  3. Digite o novo nome
  4. 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.

​
Tamanhos de metadados recomendados

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:
  1. Navegue até Configurações → Metadados → HTML personalizado
  2. 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)
  3. Cole seu script ou tag
  4. Clique em Salvar
  5. 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:

​
Configurando um domínio personalizado

Etapa 1: Adicione o domínio no ZappWay
  1. Navegue até Configurações → Domínios personalizados
  2. Clique em Adicionar Domínio
  3. Insira o domínio ou subdomínio desejado (por exemplo, chat.yourcompany.com)
  4. Clique em Adicionar
Etapa 2: Configure o DNS no seu provedor de domínio
  1. Faça login no seu registrador de domínio (GoDaddy, Cloudflare, Namecheap, etc.)
  2. Vá para o seu painel de gerenciamento DNS
  3. Adicione um novo registro CNAME com os seguintes valores:
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

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

Se o seu domínio permanecer no status Pendente ou Com falha:
  1. Verifique novamente o registro CNAME em seu provedor DNS – erros de digitação são a causa mais comum
  2. Certifique-se de que não haja registros A conflitantes para o mesmo subdomínio
  3. Aguarde até 48 horas pela propagação completa do DNS global
  4. Use uma ferramenta de verificação de DNS (por exemplo, dnschecker.org) para verificar se o CNAME está resolvendo para cname.zappflux.zappway.ai
  5. 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

​
Convidando um Colaborador

  1. Navigate to Settings → Collaborators
  2. Click Invite Collaborator
  3. Enter the team member’s email address
  4. Select their permission level (Viewer, Editor, or Admin)
  5. 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

Como adicionar sua chave de API OpenAI:
  1. Navegue até Configurações → Integrações → OpenAI
  2. Clique em Conectar
  3. Cole sua chave de API em platform.openai.com/api-keys
  4. Clique em Salvar

​
Serviços do Google

​
Canais de mensagens

​
Automação e webhooks

​
Suporte ao Cliente

​
E-mail

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:
  1. Conclua suas alterações no editor de fluxo
  2. Clique em Publicar no canto superior direito do editor
  3. 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:
  1. Navegue até Configurações → Versões
  2. Uma lista de todas as versões publicadas aparece com carimbos de data e hora
  3. Clique em qualquer versão para visualizá-la
  4. 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:
  1. Certifique-se de que o fluxo foi republicado após salvar o HTML personalizado
  2. Verifique se o script foi injetado no local correto (<head> vs. <body>)
  3. Verifique no console do navegador (F12) se há erros de JavaScript do script
  4. Teste em uma janela anônima para descartar extensões do navegador bloqueando o script
  5. 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:
  1. Verifique se a chave ou token da API não expirou ou foi revogado
  2. 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)
  3. Para integrações OAuth (Google), tente desconectar e reconectar sua conta
  4. Certifique-se de que não haja espaços extras antes ou depois da credencial colada
  5. 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:
  1. Peça-lhes para verificarem a pasta de spam/lixo eletrônico
  2. Verifique se você digitou o endereço de e-mail correto no convite
  3. Clique em Reenviar ao lado do convite pendente em Configurações → Colaboradores
  4. 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