On the Pro plan, calls to your agent's Agentline NZ New Zealand 028 number can play your greeting and take a voicemail that's transcribed for the agent to read, or ring through to a SIP voice agent such as ElevenLabs, a wss:// media stream or a NZ phone. Voice isn't included in Starter or during the trial, and it's switched on for each number once its call routing is connected.
Before you start
- A Pro plan (NZ$79/month), which includes 200 voice minutes a month. Voice is on the Pro plan only, and isn't included during the trial.
- We switch voice on for each number once its call routing is connected. Until then, the dashboard's voice settings say the number isn't connected yet, and get_voice_settings returns voiceAvailable: false.
- An agent connected over MCP or the REST API, or the dashboard. The ChatGPT app doesn't include the voice settings tools.
Steps
- Check voice is on. The agent calls get_voice_settings. For each number it returns the number id, voiceAvailable, the current mode, the greeting and whether voicemail is on.
- Choose what happens to calls. Pick one of the four modes in the table below. Voicemail with a transcript needs nothing outside Agentline NZ; the other modes need a SIP address, a wss:// stream or a phone to send the call to.
- Save the settings. With your go-ahead, the agent calls update_voice_settings with number_id, mode, the target if the mode needs one, a greeting of up to 500 characters and voicemail_enabled. It replaces the number's current call handling. You can make the same change in the dashboard or with the REST API.
curl -X PATCH https://agentline.nz/api/v1/voice/NUMBER_ID \ -H "Authorization: Bearer $AGENTLINE_KEY" -H "Content-Type: application/json" \ -d '{"mode":"message","greeting":"Kia ora, you have reached the assistant for [your business]. Leave your name, number and what you need, and we will text you back.","voicemail_enabled":true}' - Read new voicemail. The agent calls list_calls. Each call shows who called, when, its status and length, the voicemail transcript and whether there's a recording. The recording itself stays in Agentline NZ.
- Follow up. The agent summarises the message for you, or texts the caller back with send_sms if they called from a NZ mobile and asked for a reply. The usual texting rules apply.
Call modes
| Mode | What the caller gets | Target |
|---|---|---|
| message | Your greeting, then a voicemail of up to 120 seconds if voicemail is on, transcribed for the agent | None |
| forward_sip | Rings a SIP voice agent, such as one on ElevenLabs, for 25 seconds | sip:user@host |
| stream | Connects the call audio to your own voice agent over a media stream | wss://… |
| forward_phone | Rings a NZ phone for 25 seconds | +64… |
If a forwarded call isn't answered in time, the caller hears your greeting and can leave a voicemail if it's on. A stream has no voicemail fallback. Without a greeting of your own, callers hear a short default greeting that says they've reached an AI assistant.
Voice minutes and unavailable calls
Completed calls count towards the month's 200 voice minutes. Allowances reset on the 1st of each month (NZ time) and don't roll over. If a call reaches a number while voice isn't available on it, for example after the month's minutes are used up, the caller hears: "Sorry, this number does not accept voice calls. Please send a text message instead."
What this doesn't do
- wait_for_code reads texts and email, not voicemail transcripts.
- Outbound calls aren't covered here; they're in limited release.
- Not for emergency communications. It can't reach 111.
FAQ
Can I try voice during the trial?
No. Voice is on the Pro plan only, and isn't included during the trial. The trial includes 1 number, 1 inbox, 10 SMS segments, 50 emails and no voice minutes.
How do I connect an ElevenLabs agent?
Get the SIP address for your agent from ElevenLabs, then set mode to forward_sip and target to that address (sip:user@host) with update_voice_settings or in the dashboard.
What does Agentline NZ cost?
Starter is NZ$29/month and Pro is NZ$79/month, billed in NZ dollars. Start free with an email inbox (no card), or take a 7-day trial of Starter or Pro to get a number. Agentline NZ is not GST-registered, so no GST is charged.
How long does it take to get the 028 number?
Your 028 number is set up within a few days of signup. Your email inbox works straight away. Full refund if your number hasn't arrived within 30 days of your first payment.
Can my assistant send marketing or bulk texts?
No. Transactional and assistant messages only: replies, bookings, confirmations, reminders people asked for, and codes. Marketing, promotions, cold texts and bulk texts are blocked. See What we don't allow.
Related
- Confirm appointments by text with your AI agent
- Who can my agent text and email with Agentline NZ?
- How does the Agentline NZ trial work?
- What happens to my number when I cancel Agentline NZ?
Start free · Start free with an email inbox (no card), or take a 7-day trial of Starter or Pro to get a number.