# Answer calls to your agent's 028 number

**Short answer:** 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

1. **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.

2. **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.

3. **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.

   ```bash
   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}'
   ```

4. **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.

5. **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](/what-we-dont-allow).

## Related

- [Confirm appointments by text with your AI agent](/use-cases/booking-confirmations-by-text)
- [Who can my agent text and email with Agentline NZ?](/help/who-can-my-agent-text)
- [How does the Agentline NZ trial work?](/help/how-the-trial-works)
- [What happens to my number when I cancel Agentline NZ?](/help/what-happens-when-i-cancel)

[Start free](https://agentline.nz/signup) · Start free with an email inbox (no card), or take a 7-day trial of Starter or Pro to get a number.