Skip to main content
Identity & Conversation Flow

Builder Testing — Test Agent Workflows and Verify Archived Results

Written By Maruf Ansari

Last updated 2 days ago

Check how your AI Agent responds before releasing a changed conversation flow. Use Test Workflow in the Agent Builder to choose Test Audio or Test Chat, test the draft and decide whether it can use live integrations. Review audio test calls in Archived in Call Logs and chat test sessions in Archived in Chat Logs.

Test Agent & Live Test Overview

Test Workflow allows users to test an Agent's draft conversation flow without replacing its currently published version. You can choose between Test Audio for spoken call scenarios and Test Chat for text-based conversations, depending on what you need to verify.
Live Test controls whether testing uses live integration APIs to read or update information in connected systems. You can run supported inbound or outbound scenarios based on the Agent's configured capabilities, review the archived call recording or chat session, and compare the tested draft with the current release before publishing.

Note for non-technical Business users: Do not modify or test workflows independently. Contact your Agency support team to prepare and test the conversation flow with you.

Important notes

The billing, Performance and Archived rules below apply to both builder audio tests and builder chat tests.

  • Builder audio and chat tests do not affect the Performance dashboard. Do not use dashboard totals to check whether a builder test ran.

  • Builder audio and chat tests are not counted in billing for Businesses. This includes tests run with Live Test on; it is not a statement about Agency or third-party charges.

  • Builder audio tests go directly to Archived in Call Logs. Look there, not only in the regular call list.

  • Builder chat tests go directly to Archived in Chat Logs. Look there, not only in the regular chat list.

  • No Business test charge does not mean no live-data impact. With Live Test on, tests can read and write real connected-platform data, including creating patients or booking, updating and cancelling appointments where the Agent supports those actions.

  • Testing a draft does not publish it. Existing live conversations keep using the Current release until you publish a change.

Before you start

  • Identify the Agent, its inbound or outbound capabilities, and the draft you need to test.

  • Use Versions to distinguish the draft from the Current published version.

  • Plan one question or task with an observable result; use a test identity you control.

  • If testing live integrations, arrange safe test records and a way to check and correct any resulting changes in the connected platform.

Choose the draft and Live test setting

1

Open Agent → Configure, select the intended Agent, then select Edit Conversation Flow to open the Agent Builder.

2

Select the version badge, such as V1, and review the draft and Current release in Versions. Follow the Versions guide to create or compare a draft where needed.

3

Review the Live Test toggle in the toolbar. Leave it off when you do not intend to enable live integration access.

4

If your planned test needs live integration data, switch on Live Test and read the Turn on Live Test? confirmation.

5

Select Keep Off if you are not ready to allow real data changes, or Turn On Live Test only after confirming the task and records are safe to use.

Run a builder call or test

1

Select Test Workflow in the builder toolbar to open the testing panel.

2

Use Test Audio for the call test. Select the country code and enter a test phone identity you control. Select Continue and follow the remaining call in the panel.

3

Speak with the Agent and run your planned scenario using its configured inbound or outbound capabilities. Check its greeting, answers, intended task and end-of-call behavior.

4

After the test, open Call Logs → Archived for the same Agent and find the test using its time and identity. Review the available transcript, summary and outcome.

5

If Live Test was on and an integration action ran, check the resulting record in the connected platform before repeating the test.

Run a builder chat test

1

Select Test Workflow, then select Test Chat in the testing panel.

2

Under Enter your identity to continue, enter a test phone identity you control and select Continue. The supplied chat screen requests a phone identity even though Test Chat is selected; this is not evidence that a phone call is placed.

3

Use the chat conversation to try your planned question or supported task. Check the Agent's wording, knowledge answers and how it handles follow-up requests. Do not treat a text response as proof that voice or telephony actions work.

4

After the test, open Chat Logs → Archived for the same Agent and find the test session using its time and identity. Review the available transcript, summary and conversation details.

5

Review the responses shown in the panel against the expected result. If Live Test was on and an integration action ran, verify the affected record in the connected platform before repeating the scenario.

Expected result

You have tested the selected draft against a scenario the Agent supports. An audio test goes directly to Archived in Call Logs; a chat test goes directly to Archived in Chat Logs. Neither mode affects Performance or is billed to the Business. The published version remains unchanged. With Live Test on, supported integration actions may also have changed real records.

Verify the result

  1. For audio, open the archived test call in Call Logs; for chat, open the archived test session in Chat Logs. Compare the available transcript and conversation details with the outcome you planned.

  2. Confirm the Agent followed the expected inbound or outbound behavior and used the intended knowledge and task paths.

  3. For live integration testing, confirm every expected change in the connected system and check for unintended changes.

  4. Return to Versions and compare the tested draft with Current before deciding whether to publish. Follow Versions for release checks.

Troubleshooting

Problem or Symptom

Likely Cause

Solution

The test is missing from Performance.

Builder test calls are excluded.

Review Archived in Call Logs instead.

The call is missing from the regular log list.

Builder tests go directly to Archived.

Review Archived for the same Agent, time and test identity.

No Business call charge appears for the test.

Builder tests are not billed to Businesses.

This is expected; verify the archived record, not a billing charge.

The Agent cannot perform the scenario.

The selected Agent's direction or configured capabilities may not support it.

Check the inbound/outbound Agent and task configuration with the Agency support team.

A test changes a real appointment or other record.

Live Test permits supported actions to read and write real integration data.

Review and correct the affected record through the connected platform before further tests.

An integration result is unexpected with Live Test off.

Off-state integration responses are not confirmed here.

Ask the Agency support team to confirm expected behavior; do not enable live access just to troubleshoot without safe records.

You cannot find a saved builder chat test.

You may be checking the regular chat list or Call Logs.

Open Chat Logs → Archived for the same Agent and check the test time and identity. Builder chat tests are not saved in Call Logs.

Recovery or rollback

Stop further tests if the outcome is wrong. Switch Live Test off before tests that should not use live integrations. Correct the draft with the Agency support team and repeat one controlled call test; do not publish an unverified flow.

Turning Live Test off or discarding a draft does not undo changes already made in a connected system. Review the affected records and use that platform's correction process with the Agency support team. If an unwanted flow was published, follow the Versions guide to create a draft from the appropriate earlier release and review it before publishing.


Frequently Asked Questions

No. Calls tested in the builder do not affect the Performance dashboard and are not counted in billing for Businesses, including when Live Test is on.

It goes directly to Archived in Call Logs. Review the same Agent, time and test identity.

Test runs can call live integration APIs and read or write real connected-system data. Only enable it for a controlled end-to-end integration test.

The testing process follows each Agent's configured capabilities. Test inbound scenarios with an inbound Agent and outbound scenarios with an outbound Agent.

No. Builder calls are excluded from Performance and Business billing and go directly to Archived. Call Me above Performance is live-call testing that counts toward billing, appears in Call Logs and the dashboard, and may update connected platforms. Both require care with live integration actions.


Related articles


Was this helpful?

Still need help? Ask the team