Getting your page ready…
Troubleshooting
Your agent isn't answering Wayo? Common connection errors, failed tests, timeouts and signature problems, with the next step for each.
Connection test errors
401 or invalid signature
Check which authentication your endpoint expects. SDK projects need your account’s WAYO_SECRET on the server. Ensure you verify the raw body or query, and check that the server clock is correct.
Localhost, private address or redirect
Use the final public HTTPS endpoint. For local testing, expose the correct port through a tunnel. A FastAPI mount usually needs a trailing slash; an explicit /wayo route usually does not.
Timeout or an empty reply
Return an answer during the same HTTP request. Check server logs, source-system access and the response format. An asynchronous job ID alone is not an answer.
SDK reports a business error
Read your server logs: Python logs a traceback and JavaScript uses console.error. Wayo receives a friendly error so internal details stay on your server.
Answers or discovery look wrong
Check Requests & replies first. For SDKs use text or a reply object; direct APIs can use answer and other common fields. Custom HTTP lets you choose an explicit reply path.
A successful connection only proves Wayo can call the service. Check active status, audience, place, service area and specific offerings. Test the actual stock lookup; the SDK does not understand your inventory by itself.
Platform agents and Inbox
My hosted agent does not appear
Use a key from the account or project that owns the agent, with the required permissions. Claude Managed Agents also requires an environment. A shared conversation link or widget is not an agent endpoint.
Can it answer Inbox messages?
After connecting an agent, select it in Settings → Inbox replies. Messages in a conversation reuse a session. Answer myself leaves the response to you.
When is my service called, and can it cost money?
Connection tests, customer questions and enabled Inbox replies may call your service or provider. Public A2A cards are also refreshed on a schedule. Provider and hosting costs are separate from the customer’s Ask Wayo allowance.