Skip to main content
Vocal Pages turn your published Ashby job postings into interactive, voice-agent career pages. Candidates talk to your agent, answer screening questions, and apply - and everything flows back into Ashby.

​
How it works

Casuro mirrors your published Ashby job postings onto a public, voice-enabled career page. A candidate opens the page, has a short conversation with your voice agent, answers your screening questions, and submits an application. Casuro then pushes the application, answers, and screening result back into Ashby - so your recruiters keep working entirely inside Ashby.
Vocal Pages are separate from the Ashby assessments integration. You can use either or both. This guide covers Vocal Pages only. For assessments, see Setup.

​
Before you start

  • Admin access in both Ashby and casuro.ai.
  • At least one published job posting in Ashby (draft postings are not mirrored).

​
Step by step guide

1

Enable the Casuro jobs integration in Ashby

In Ashby, go to Admin → Integrations, find the Casuro jobs integration, and enable it. Ashby issues the API key you need right there.
The key must come from the Casuro jobs integration, not from Ashby’s generic Admin → API keys page. The integration key carries the scopes Casuro needs.
The key needs these scopes:
2

Open the Vocal Pages tab in casuro.ai

In casuro.ai, go to Admin → Integrations and open the Vocal Pages tab. Click Connect on the Ashby card.
3

Paste your API key and connect

Paste the API key from Step 1 and click Validate. Casuro checks that all three scopes are present, then lets you Connect.On connect, Casuro automatically:
  • Registers the sync webhooks in Ashby (jobPostingPublish, jobPostingUnpublish, jobPostingUpdate, jobPostingDelete).
  • Runs an initial backfill so your currently-published postings appear right away.
Webhooks register automatically - there is no manual webhook setup. In Ashby they appear marked as casuro-vocal-pages. If webhook registration ever fails, your pages still sync on an hourly schedule.
4

Configure your voice agent

Go to Admin → Vocal to brand the candidate-facing page. You get a live preview as you edit:
  • Agent name - what the voice agent calls itself (default Casuro).
  • Aura color - the animated aura around the agent.
  • Button color - the primary call-to-action color.
  • Cover image - the banner on the job card.
  • Social card - the preview image shown when a page link is shared.
Defaults are inherited from your organization’s brand settings, so you can leave any field untouched.
5

Choose your evaluation mode

Still on Admin → Vocal, pick how screening answers are handled:
  • Evaluate (default) - the agent asks your screening questions and Casuro grades each answer against pre-committed criteria, bucketing candidates (fast-track / knockout) and writing a result note back to Ashby.
  • Gather only - the agent still asks the questions and records the answers, but nothing is graded or scored. Use this when you only want to collect information.
This setting is organization-wide and applies to every vocal page.
6

Author screening questions (optional)

Open a job in the editor to tailor its screening. Add questions or prompts; when you turn an item on, Casuro auto-generates grading criteria (meets / partial / fails) that you can edit and save. Grading is blinded - the model sees only the question, criteria, and answer, never the candidate’s identity - to keep it unbiased.If you are in Gather only mode, criteria are ignored and answers are simply recorded.
7

Publish a posting - and you are live 🎉

Publish (list) a job posting in Ashby. It appears on your vocal page within seconds via webhook (or within the hour via the fallback sync). Share the page link, and candidates can start applying by voice right away.

​
Keeping pages in sync

Once connected, your vocal pages track Ashby automatically: Real-time updates arrive over webhooks. As a safety net, Casuro also reconciles every hour, so a missed webhook self-heals on the next pass.

​
Managing the connection

The Vocal Pages tab shows the live status of your connection:
  • Whether real-time webhooks are active (or falling back to hourly sync).
  • A Sync now action to force an immediate reconcile.
  • Integration logs for troubleshooting.
Disconnecting removes the webhooks from Ashby and stops mirroring new posting changes. Applications and candidate data already collected are kept.

​
Troubleshooting

Validation says a scope is missing. Re-open the Casuro jobs integration in Ashby (Admin → Integrations) and make sure it is enabled, then copy the key again. The key must include jobs:read, candidates:write, and apiKeys:write.
Status shows “syncing hourly” instead of real-time webhooks. Webhook registration needs the apiKeys:write scope. Confirm the scope is present, then use Disconnect and reconnect to re-register. Until webhooks are active, pages still sync every hour.
A posting is not showing up. Only published postings are mirrored - a draft posting will not appear. If it is published, use Sync now, or wait for the next hourly reconcile.