A voice agent can answer phone calls on a number from your own Twilio account. Wiro sets up the number for you, so you don't edit webhooks in Twilio yourself.
Set it up
In Twilio, buy or import a phone number that supports voice calls.
In the Twilio Console, open Account, then Keys & Credentials, then API keys & tokens, and copy the Account SID (it starts with AC) and the Auth Token from the Live credentials section. Use the Auth Token, not an API Key secret.
On the agent's Twilio card, paste both and add the number in E.164 format, such as +14155551234: a plus sign, the country code, digits only.
Save the card. Wiro writes its webhook onto each number automatically.
In Twilio, the number's Configure with setting must stay on Webhook, Twilio's default. If it's set to TwiML App or SIP Trunk, switch it back and save the card again.
Options
Hold experience: what callers hear during the 5 to 8 seconds it takes the agent to connect: silence, a spoken text, a recorded greeting, music, or a greeting followed by music.
Max call duration (seconds): 600 (10 minutes) if you leave it empty. When it's reached, the call ends.
Whitelisted callers: if you add numbers here, only those numbers reach the agent and everyone else gets a busy signal. Handy while testing.
What calls cost
Twilio bills your Twilio account for call minutes, the phone number, and the text-to-speech used for a spoken hold message.
Live call audio, the AI voice conversation itself, is paid from the wallet of the project chosen on the Wiro AI Models card (see Who pays for what my agent makes?).
The agent's text work around the call, such as preparing and following up, uses plan credits (see agent pricing).
What callers hear when something's wrong
"Thank you for calling. Our system is currently being updated. Please try again later." The agent isn't running. Start it (see Why won't my agent start?).
"This line has reached its hourly call limit. Please try again later." The agent has taken its maximum number of calls for this hour; new calls get through again once the hour is over.
A busy signal: the caller isn't on your Whitelisted callers list. Numbers there must be in E.164 format.
"Sorry, this agent is currently unavailable. Please try again later." There isn't enough credit to run the call. Check the agent's credits and the balance of the Wiro AI Models project.
"Our system is temporarily unavailable. Please try again later." The voice session couldn't start, or the call reached its maximum duration.
Twilio's own voicemail or default message: the number is set to TwiML App or SIP Trunk (see above).
Every call fails after you changed the Auth Token in Twilio: paste the new token on the card and save.
Want a voice button on your website instead of a phone number? See Can I put a voice-call button on my own website? Docs: webhook auto-configuration and Twilio Voice.