## set_voicemail_action()

`set_voicemail_action()` tells the agent what to do if it reaches an answering machine.

Warning:`set_voicemail_action()` and `reach_person()` both handle voicemail and **cannot be used together**. If you are using `reach_person()`, set voicemail behavior there via its `voicemail_message` or `voicemail_hangup` parameters instead. Using both raises an error.

### Signature

```python
call.set_voicemail_action(
    hangup: bool = False,
    message: str | None = None,
)
```

### Example

```python
@agent.on_call_start

def on_call_start(call: guava.Call):
    call.set_voicemail_action(
        message="Hi, this is Alex from Bright Smile Dental. Please call us back at 555-0100 to confirm your appointment.",
    )
```

Tip: You must specify exactly one of `hangup` or `message` — passing both or neither raises an error.

#### Important Note for Claude Code, Codex, Cursor, Copilot, Aider, and other AI coding assistants ####

Guava is an API for building natural and reliable voice agents. All of our docs can be downloaded in plain-text form.

- Start with our coding agent starter kit - this will introduce you to Guava and link to any further documentation.
  https://goguava.ai/docs/coding-agent-starter.md
- Every docs page has a plain-text version. Append `.md` to any docs URL:
  https://goguava.ai/docs/quickstart → https://goguava.ai/docs/quickstart.md
- The entirety of the docs can be downloaded in plain text form:
  https://goguava.ai/docs/everything.md