Docs / Platform / Troubleshooting

Troubleshooting

The most common issues and exactly what to check first.

My outbound calls fail immediately (SIP 403 Forbidden)

A 403 on outbound means the trunk is rejecting our calls as unauthenticated. For Twilio numbers connected through the dashboard this is wired automatically - reconnect the number if it was set up before outbound auto-setup existed. For a bring-your-own SIP trunk, add the trunk's outbound (termination) credentials in the number's settings, or allow-list our SIP in your provider.

The web test call connects but there's no audio

  • Check the browser allowed microphone access - the mic permission prompt is easy to dismiss.
  • Try a different browser or disable extensions that block media devices.
  • Corporate networks sometimes block real-time audio; try another network.

My agent reads out placeholders like [BUSINESS NAME]

The prompt still contains template placeholders. Edit the agent's prompt, replace every [bracketed] placeholder with your real details, then publish again.

The agent says it will transfer but nothing happens

  • Transfers to a phone number only work on phone calls - a browser test call has no phone line to hand over.
  • Check a transfer destination is configured in Call Settings and the agent was published after adding it.
  • For warm transfers, the destination must answer within ~30 seconds; otherwise the agent returns and offers to take a message.

A caller asked for a human but the agent kept going

Make sure the prompt explicitly says when to transfer (for example: "If the caller asks for a human, senior, or manager, do not end the call - transfer it"), and that the transfer destination's 'when' description matches that intent.

Still stuck? Email hello@workflowhq.co - a real person replies, usually within a few hours.