Skip to main content
This page covers common questions users have when building workflows, connecting integrations, and managing their HeyBreez environment.

How do I start building a workflow?

Every workflow begins with the Start node.
From there, you add Agents, Agentic Routes, logic nodes, and integrations to create the full call experience.
If you are new, follow the Getting Started section for a guided setup.

Can I test my workflow without a real phone number?

Yes.
Use Local testing to run your workflow fully inside the builder without telephony.
When you are ready, you can attach a real number for live testing.

How do I call external APIs?

Use the HTTP Request node.
You can configure:
  • method
  • URL
  • headers
  • body
  • query parameters
Responses can be passed back to the agent using the Tool Response node.

Where do I store API keys or secrets?

Use the API Keys or Credentials sections under Admin.
Never store secrets directly in workflow nodes.

Can I use multiple agents in the same workflow?

Yes.
You can create multiple agents, each with different settings, voices, instructions, or behaviors.
This is useful when different parts of the call require different capabilities.

How do I add business-specific information for the agent?

Use Knowledge Bases at the organization level.
This allows your agents to reference structured content during calls.

What happens if an HTTP request fails?

You can handle it using:
  • If nodes to check error values
  • fallback paths
  • end states
  • custom messaging
This ensures callers receive clear responses even when backend systems fail.

How do I connect a phone number?

Numbers can be managed in the deployment or telephony section depending on your setup.
Once connected, assign the number to a workflow for testing or production.

Can I update a workflow without downtime?

Yes.
Workflows can be edited at any time.
We recommend testing changes in a separate environment, then deploying the updated version when ready.

Can HeyBreez integrate with no-code tools?

Yes.
You can connect with tools like Zapier, Make, n8n, or Pipedream by sending data to their webhook URLs using the HTTP Request node.

Do you support custom integrations?

Yes.
You can integrate with any system that exposes an HTTP API.
Future native integrations will also expand available capabilities.

How do I monitor call performance?

Use analytics at the organization or project level.
You can view call history, outcomes, and performance metrics to understand how callers interact with your workflows.

Summary

This FAQ covers the most common questions about workflows, testing, integration design, and administration.
As the platform grows, more topics will be added to support both technical and non-technical users.