***

## title: Phone numbers

Use PSTN outbound when your Voice AI agent needs to call real phone numbers.

## Setup flow

1. Ensure outbound calling is enabled for your application/account.
2. Configure a valid `callerId` (rented number or verified caller ID).
3. Start the outbound scenario with `destination` and `callerId` in custom data.
4. Dial with `VoxEngine.callPSTN(destination, callerId)`.
5. On `CallEvents.Connected`, bridge the call to the Voice AI connector.

```json title="Custom data example"
{"destination":"+15551234567","callerId":"+15557654321"}
```

## Voice AI notes

* Keep outbound intros brief.
* Use transfer and hangup tools carefully and log side effects.
* Keep country-specific compliance and consent requirements in your workflow design.

## Common issues

* Caller ID is not valid for outbound in the selected region.
* Destination format is not E.164.
* Scenario is run without custom data.

## Links

* Phone numbers basics: [https://voximplant.com/docs/getting-started/basic-concepts/phone-numbers](https://voximplant.com/docs/getting-started/basic-concepts/phone-numbers)
* Outbound call API (`callPSTN`): [https://voximplant.com/docs/references/voxengine/voxengine/callpstn](https://voximplant.com/docs/references/voxengine/voxengine/callpstn)
* Start scenarios API: [https://voximplant.com/docs/references/httpapi/scenarios#startscenarios](https://voximplant.com/docs/references/httpapi/scenarios#startscenarios)

<Info title="Screenshots needed">
  - Outbound caller ID setup or verification.
  - Outbound rule run dialog with `destination` and `callerId`.
</Info>