Test and edit custom actions
Use the Test button to run a real call, read the response, and adjust, enable, or delete the action without affecting the conversation.
Watch this step in the video · Custom actions: parameters, variables and testing
Why test first
Before letting the agent use an action in front of a customer, it's worth testing it. The Test button runs a real call to your API and shows the response as-is, so you can confirm that the URL, headers, and mapping work.
Requirement
The Test button is only enabled after you save the action at least once. If you're creating a new action, click Save action first.
Steps to test
- Open AI Agents, enter the agent, and go to the Custom actions tab.
- Click the pencil (Edit) on the action you want to test.
- At the bottom of the form, click Test.
- Wait for the result: the button shows Testing... and then a panel with the response appears.
How to read the result
- A green dot and Response OK mean your API responded successfully (HTTP 2xx).
- A red dot and Failed mean an error: the panel shows the HTTP code or the failure message.
- The full JSON body is displayed. Compare it with the Field to extract you configured to confirm it points to the right value.
The Test button is limited to 10 runs per minute per user. If you exceed it, wait a few seconds before retrying.
Edit an action
- In the list, click the pencil (Edit).
- Change whatever you need: identity, method, URL, headers, body, parameters, or the field to extract.
- Click Save action. Changes apply immediately to the next conversations.
Enable, disable, or delete
- Enable/disable: use the switch on each row. A Disabled action is still saved but the agent won't use it — ideal for pausing without losing the setup.
- Delete: click the trash icon. It asks for confirmation because it cannot be undone.
If it doesn't work
- The Test button is disabled: you haven't saved the action yet; click Save action.
- Failed with a 401 or 403: check the
Authorizationheader and that the token is valid. - Failed with a timeout: your API took longer than the configured Timeout (s); raise it (up to 60 s) or check the endpoint's performance.
- Response OK but the agent doesn't use the data: adjust the Field to extract or the action's Description.
Tip: test with real contact data to catch formatting issues (e.g. phone numbers or emails) before going live.
Tip: if you're making big changes, disable the action while you adjust it so the agent doesn't use it half-configured.
Related articles
Related articles
-
Create your first AI agent
Learn what an AI agent does in Omnifox, how to give it instructions, connect it to a channel and test it in the sandbox before it talks to real customers.
-
How to write good instructions for your AI agent
Learn how to write clear instructions so your AI agent replies with the right tone, limits and actions.
-
AI Agents complete guide
AI Agents in depth, in 65 chapters: creating, instructions, tools, knowledge, behavior, tester, inbox, workflows, analytics and usage, with every setting explained.
-
Connect your AI agent to WhatsApp, Instagram, Messenger and web chat
An agent with no channels serves nobody. Connect it to your WhatsApp, Instagram, Messenger or website chat from the Connections section, then switch it on so it starts replying.
-
Start here: AI Agents in 8 minutes
AI Agents essentials in a short video: creating an agent, its instructions, tools, knowledge, channels, the tester, hours and handing over to a person.