Skip to main content

​
Flow Settings

​
Overview

The Flow Settings panel gives you full control over how your flow behaves, appears, and integrates with external tools. Settings are scoped per-flow, meaning each flow can have its own domain, metadata, collaborators, and integration credentials. To access Flow Settings: 
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

​
General Settings

The General tab controls the basic identity of your flow within the ZappWay dashboard.
SettingDescription
Project NameThe internal display name used to identify the flow in the list view
IconThe emoji or icon representing the flow in the dashboard
Directory / FolderThe folder this flow belongs to — use directories to organize flows by project, client, or team
StatusPublished or Draft — controls whether the flow is live to end users
Flow URLThe public URL where the flow is accessible (read-only, based on your domain settings)
Changing the Flow Name:
  1. Navigate to Settings → General
  2. Click the Project Name field
  3. Enter the new name
  4. Click Save
Renaming a flow does not change its public URL unless you are using the default ZappWay subdomain and have not yet set a custom domain. If a custom domain is configured, the URL is independent of the flow name.

​
Metadata

Metadata controls how your flow appears in browser tabs, search results, and when its link is shared on social platforms and messaging apps.
FieldDescription
Page TitleThe title shown in the browser tab and used by search engines
DescriptionThe summary text shown below the title in link previews and search results
FaviconThe small icon shown in the browser tab — supports image upload (PNG, ICO, SVG)
OG Image (Share Image)The featured image displayed when the flow link is shared on WhatsApp, Facebook, LinkedIn, Twitter/X, etc.
Custom HTMLInject custom scripts or tags into the <head> or <body> of the flow page
AssetRecommended SizeFormat
Favicon32×32 px or 64×64 pxPNG, ICO, SVG
OG Image1200×630 pxPNG or JPG
Always set an OG Image. When users share your flow link on WhatsApp or social media, a compelling preview image dramatically increases click-through rates compared to a blank or generic preview.

​
Custom HTML

The Custom HTML field allows you to inject third-party scripts into your flow page. This is commonly used for:
  • Analytics tracking — Google Analytics, Mixpanel, PostHog
  • Ad pixels — Meta Pixel, Google Ads conversion tags, TikTok Pixel
  • Chat widgets — Adding a live chat overlay on top of the flow
  • Heatmap tools — Hotjar, Microsoft Clarity
  • Custom CSS — Overriding the flow’s default visual styles
How to add custom HTML:
  1. Navigate to Settings → Metadata → Custom HTML
  2. Choose the injection point: <head> (for scripts that load early) or <body> (for scripts that run after the page loads)
  3. Paste your script or tag
  4. Click Save
  5. Republish the flow for changes to take effect
Only inject scripts from trusted, verified sources. Malicious or poorly written third-party scripts can break your flow, expose user data, or cause security vulnerabilities. ZappWay is not responsible for issues caused by custom HTML injections.

​
Custom Domains

Connect your own domain to remove the default zappflux.zappway.ai branding from your flow’s public URL and present a fully white-labeled experience to your users. Example: 
Default URL:  https://flows.zappflux.zappway.ai/your-flow
Custom Domain: https://chat.yourcompany.com/your-flow

​
Setting Up a Custom Domain

Step 1: Add the domain in ZappWay
  1. Navigate to Settings → Custom Domains
  2. Click Add Domain
  3. Enter your desired domain or subdomain (e.g., chat.yourcompany.com)
  4. Click Add
Step 2: Configure DNS at your domain provider
  1. Log in to your domain registrar (GoDaddy, Cloudflare, Namecheap, etc.)
  2. Go to your DNS management panel
  3. Add a new CNAME record with the following values:
FieldValue
TypeCNAME
Name / Hostchat (or your chosen subdomain prefix)
Value / Targetcname.zappflux.com
TTL3600 (or “Auto”)
Step 3: Wait for verification
  • DNS propagation typically takes between 5 minutes and 48 hours
  • ZappWay checks the domain automatically and issues an SSL certificate once verified
  • The domain status in your settings will update from Pending to Active
SSL certificates are provisioned automatically at no extra cost. You do not need to upload or manage certificates manually.

​
Domain Status Indicators

StatusMeaning
PendingDNS record has been added in ZappWay but not yet verified
VerifyingZappWay is checking the DNS record
ActiveDomain is live, SSL is provisioned, flow is accessible
FailedDNS record could not be verified — check your CNAME configuration

​
Troubleshooting Custom Domains

If your domain remains in Pending or Failed status:
  1. Double-check the CNAME record at your DNS provider — typos are the most common cause
  2. Ensure there are no conflicting A records for the same subdomain
  3. Wait up to 48 hours for full global DNS propagation
  4. Use a DNS checker tool (e.g., dnschecker.org) to verify the CNAME is resolving to cname.zappflux.com
  5. Contact support@zappway.ai if the issue persists after 48 hours

​
Collaborators

Invite team members to access and edit a specific flow without granting them access to your entire ZappWay organization.

​
Permission Levels

RolePermissions
ViewerCan view the flow editor and settings in read-only mode; cannot make changes
EditorCan edit flow blocks, settings, and metadata; can publish the flow
AdminFull access including managing collaborators and deleting the flow

​
Inviting a Collaborator

  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
The invited user receives an email with a link to accept the invitation. If they don’t have a ZappWay account, they’ll be prompted to create one.

​
Managing Existing Collaborators

  • Change Role: Click the role dropdown next to a collaborator’s name and select a new role
  • Remove Access: Click the ⋮ menu next to the collaborator and select Remove
  • Resend Invite: If an invitation has expired, click Resend next to the pending invite
Collaborators added at the flow level only have access to that specific flow. For broader organization-level access, manage team members in Settings → Team.

​
Global Integrations

The Integrations tab within Flow Settings is where you configure API credentials and connection tokens used by integration blocks throughout the flow. These credentials are stored securely and shared across all blocks within this flow.

​
Available Integrations

​
AI & Language Models

IntegrationRequired CredentialUsed For
OpenAIOpenAI API KeyChatGPT blocks, AI response generation, content classification
AnthropicAnthropic API KeyClaude AI blocks for advanced reasoning and conversation
How to add your OpenAI API Key:
  1. Navigate to Settings → Integrations → OpenAI
  2. Click Connect
  3. Paste your API key from platform.openai.com/api-keys
  4. Click Save

​
Google Services

IntegrationRequired CredentialUsed For
Google SheetsGoogle OAuth (sign in with Google)Read/write rows in spreadsheets via the Sheets block
Google AnalyticsMeasurement ID (GA4)Send events from the Analytics block
Google CalendarGoogle OAuthCheck availability, create events

​
Messaging Channels

IntegrationRequired CredentialUsed For
WhatsApp (Evolution API)API URL + API KeySend messages via Evolution API provider
WhatsApp (WPPConnect)API URL + Session TokenSend messages via WPPConnect provider
TelegramBot TokenConnect a Telegram bot to your flow

​
Automation & Webhooks

IntegrationRequired CredentialUsed For
ZapierWebhook URL (from Zapier)Trigger Zaps from within the flow
Make (Integromat)Webhook URL (from Make)Trigger Make scenarios from within the flow

​
Customer Support

IntegrationRequired CredentialUsed For
ChatwootAPI URL + Access TokenTransfer conversations to a Chatwoot inbox for human handoff

​
Email

IntegrationRequired CredentialUsed For
SMTPHost, Port, Username, PasswordSend transactional emails via your own mail server
SendGridSendGrid API KeySend transactional emails via SendGrid
API keys and credentials stored here are scoped to this flow only. If you need the same credentials across multiple flows, you must configure them individually in each flow’s Settings. Organization-wide credential management is available on Enterprise plans.

​
Testing Integrations

After saving credentials, use the Test Connection button next to each integration to verify the credentials are valid before publishing your flow. A green checkmark confirms the connection is working; a red error indicates an issue with the credentials.

​
Publishing & Versioning

​
Publishing a Flow

Changes made in the flow editor are saved automatically as drafts. They are not visible to end users until you publish. To publish:
  1. Complete your changes in the flow editor
  2. Click Publish in the top-right corner of the editor
  3. A confirmation appears indicating the flow is live
What publishing does:
  • Makes the current draft version live at the flow’s public URL
  • Saves a version snapshot (accessible in Version History)
  • Notifies connected channels that a new version is available

​
Version History

Access previous published versions of your flow:
  1. Navigate to Settings → Versions
  2. A list of all published versions appears with timestamps
  3. Click any version to preview it
  4. Click Restore to roll back to a previous version
Before making major changes to a live flow, create a duplicate. Use the Duplicate Flow option from the flow list to make a safe copy, edit the copy, and publish it only when ready.

​
Troubleshooting

​
Issue: Custom HTML Script Not Firing

Symptoms:
  • Analytics events not appearing in your tracking platform
  • Pixel not registering conversions
Solutions:
  1. Ensure the flow has been republished after saving the custom HTML
  2. Verify the script is injected in the correct location (<head> vs. <body>)
  3. Check the browser console (F12) for JavaScript errors from the script
  4. Test in an incognito window to rule out browser extensions blocking the script
  5. Confirm the script syntax is valid — a single error can prevent all custom scripts from running

​
Issue: Integration Test Fails

Symptoms:
  • “Connection failed” error when testing an integration
  • Blocks that use the integration throw errors at runtime
Solutions:
  1. Verify the API key or token has not expired or been revoked
  2. Check that the API key has the required permissions/scopes (e.g., OpenAI key must have chat completions access)
  3. For OAuth integrations (Google), try disconnecting and reconnecting your account
  4. Ensure there are no extra spaces before or after the pasted credential
  5. Contact support@zappway.ai with the integration name and error message

​
Issue: Collaborator Did Not Receive Invite

Symptoms:
  • Team member says they never received the invitation email
Solutions:
  1. Ask them to check their spam/junk folder
  2. Verify you entered the correct email address in the invite
  3. Click Resend next to the pending invite in Settings → Collaborators
  4. If the issue persists, the team member can try signing up directly at zappway.ai with that email address, then you can retry the invite

​
Best Practices

1. Fill In Metadata Before Sharing Always complete the Page Title, Description, and OG Image before sharing a flow link externally. A complete, polished preview builds trust and improves engagement. 2. Use Custom Domains for Client-Facing Flows If you’re building flows for clients or running professional campaigns, always configure a custom domain. It reinforces brand identity and avoids confusion from the ZappWay subdomain. 3. Scope Collaborator Access Carefully Grant Editor access only to users who need to make changes. Use Viewer access for stakeholders who need visibility without risk of accidental edits. 4. Rotate API Keys Periodically For security, rotate API keys (OpenAI, Stripe, etc.) every 90 days. When you update a key, update it in Settings → Integrations and test the connection before republishing. 5. Republish After Every Settings Change Changes to metadata, custom HTML, and integration credentials only take effect for end users after you publish the flow. Get in the habit of republishing immediately after saving settings changes.
Pro Tip: Use the Custom HTML field to inject a Hotjar or Microsoft Clarity session recording script on high-traffic flows. Watching real session recordings reveals exactly where users hesitate, drop off, or get confused — giving you actionable data to improve completion rates.

​
Support

Need help with Flow Settings? Contact ZappWay Support:
  • Email: support@zappway.ai
  • Include: Flow name or ID, screenshot of the issue, and steps to reproduce
Provide These Details When Reporting Issues:
  • Which settings section you were in (General, Metadata, Domain, etc.)
  • The exact error message if one appeared
  • Whether the issue affects one flow or all flows
  • Your browser and operating system
Last Updated: March 2026 Platform: ZappFlux Flow Settings | ZappWay Dashboard