​

Integração Iframe

​

Como funciona a integração

ZappWay Dashboard
└── Sidebar Menu → Tools → ZappFlux
    └── <iframe> → ZappFlux (flows, editor, settings)
        └── Automatic authentication via Bridge Session

• ✓ Não é necessária troca de conta
• ✓ Autenticação automática
• ✓ Experiência de usuário perfeita
• ✓ Contexto organizacional unificado
• ✓ Sincronização em tempo real

​

Autenticação Automática (Sessão Bridge)

​

Como funciona:

• ZappWay passa sua sessão ativa para ZappFlux via Bridge Session
• Nenhuma credencial ou chave de API é necessária de você

• ZappFlux detecta que está sendo executado dentro de um iframe ZappWay
• Permite recursos especiais de modo iframe e sincronização

• Sua conta ZappWay tem prioridade
• Mesmo que exista uma conta ZappFlux separada, o ZappWay assume o controle
• O contexto da organização é herdado do ZappWay

• Alterações feitas no ZappFlux são sincronizadas com sua organização ZappWay
• Fluxos, configurações e dados permanecem consistentes
• Não é necessária sincronização manual

​

Considerações de segurança:

• Bridge Session usa troca segura de tokens
• As sessões expiram com sua sessão ZappWay
• Nenhuma credencial persistente armazenada no iframe
• Logout automático quando você sai do ZappWay

• Os dados da organização têm o escopo adequado
• Sem vazamento de dados entre organizações
• Comunicação segura entre ZappWay e ZappFlux
• Protocolos de segurança padrão da indústria

​

Rotas disponíveis no painel

Dashboard → Tools → ZappFlux
→ Loads: /zappflux/flows (flow list)

Click "Edit" on a flow
→ Loads: /zappflux/flows/abc123/edit (flow editor)

Click "Settings" in ZappFlux
→ Loads: /zappflux/settings (configuration)

​

Abrindo em nova aba

​

Considerações importantes:

• Precisa de várias janelas do ZappFlux abertas simultaneamente
• Solução de problemas ou comparação de configurações
• Trabalhando com recursos específicos do ZappFlux ainda não em iframe
• Fins de desenvolvimento ou teste

1. Clique no botão “Abrir em nova guia” na interface do ZappFlux
2. Nova guia do navegador é aberta com URL ZappFlux
3. Se não estiver conectado ao ZappFlux separadamente, você verá a tela de login
4. Faça login com credenciais ZappFlux (separadas do ZappWay)
5. A sincronização manual pode ser necessária

• As alterações na nova guia podem não ser sincronizadas automaticamente
• O contexto da organização pode ser diferente
• Requer atualização manual para ver atualizações
• Recursos de Bridge Session indisponíveis

✓ Use ZappFlux through ZappWay dashboard (recommended)
  → Automatic sync, seamless experience

✗ Avoid opening in new tab unless necessary
  → Manual sync, potential conflicts

​

Comunicação Iframe

​

Como os dados fluem:

• Contexto da organização
• Token de autenticação do usuário
• Informações do espaço de trabalho ativo
• Preferências de tema e UI

• Eventos de criação/atualização de fluxo
• Mudanças de status
• Notificações de erros
• Dados analíticos

• Mudanças no ZappFlux são refletidas imediatamente no painel
• As alterações do painel são propagadas para o iframe do ZappFlux
• Comunicação bidirecional mantida

​

Solução de problemas de integração com Iframe

​

Problema: ZappFlux não carrega

• Iframe em branco
• Spinner de carregamento infinito
• Mensagem de erro no iframe

1. Atualize a página (F5 ou Ctrl+R / Cmd+R)
2. Limpe o cache e os cookies do navegador
3. Verifique se há erros no console do navegador
4. Desative as extensões do navegador (especialmente bloqueadores de anúncios)
5. Experimente um navegador diferente
6. Verifique a conexão com a internet

​

Problema: falha na autenticação

• O prompt de login aparece no ZappFlux
• Erro “Sessão expirada”
• Redirecionar para página de login

1. Saia e faça login novamente no ZappWay
2. Limpe os cookies de zappway.ai e zappflux.zappway.ai
3. Verifique se os cookies estão habilitados no navegador
4. Verifique se você tem uma sessão ZappWay ativa
5. Experimente o modo de navegação anônima/privada

​

Problema: alterações não salvas

• As edições não persistem
• As alterações são revertidas após a atualização
• Erro “Falha ao salvar”

1. Verifique a conexão com a internet
2. Verifique se você tem permissões de edição
3. Tente salvar novamente
4. Atualize a página e tente novamente
5. Verifique se há erros no console do navegador
6. Entre em contato com o suporte se persistir

​

Problema: desempenho lento

• O iframe carrega lentamente
• Interações lentas do editor
• Respostas atrasadas

1. Feche outras abas do navegador
2. Limpe o cache do navegador
3. Verifique a velocidade da internet
4. Desative extensões desnecessárias do navegador
5. Experimente um navegador diferente
6. Verifique os recursos do sistema (RAM, CPU)

​

Melhores práticas

​

Para uma experiência ideal:

• Prefira rotas /zappflux dentro do ZappWay
• Garante autenticação e sincronização adequadas
• Melhor experiência do usuário
• Contexto de organização automático

• Abra apenas em nova aba se necessário
• Lembre-se: sessão separada, sincronização manual necessária
• Retorne ao painel para o trabalho principal

• Use a versão mais recente do navegador
• Atualize regularmente para segurança e recursos
• Navegadores suportados: Chrome, Firefox, Safari, Edge

• Necessário para sessão Bridge
• Permitir cookies para zappway.ai e zappflux.zappway.ai
• Verifique as configurações de privacidade

• Abra o console do desenvolvedor se ocorrerem problemas
• Procure mensagens de erro
• Incluir erros ao entrar em contato com o suporte

​

Documentação Técnica

• Referência de API
• Configuração de webhook
• Guia de integração personalizado
• API do construtor de fluxo
• Recursos avançados

​

Apoiar

• E-mail: support@zappway.ai
• Incluir: tipo/versão do navegador, mensagens de erro, capturas de tela

• Qual rota você está acessando
• Mensagens de erro (do console, se disponível)
• Navegador e sistema operacional
• Etapas para reproduzir o problema
• Se o problema ocorre na nova guia ou no iframe