Get started

Vonage (bring your own number)

The Vonage connection uses a SIP trunk to route a number you already control to a ThunderPhone agent. Vonage remains the telephony provider for the number and trunk, while ThunderPhone controls the agent prompt, voice behavior, attached knowledge, and call handling. Once the imported number passes verification, it can be used for inbound and outbound calls.

What the Vonage connection does on ThunderPhone

ThunderPhone's current documentation lists direct Vonage onboarding as coming soon. Today, the supported route is Manual SIP configuration, which works with any SIP trunk. This distinction matters: the documented integration is trunk-level call connectivity, not a native synchronization of your Vonage account or its business data.

The manual connection records the SIP domain or URI, optional username and password, port, transport, and an optional allowed-source-IP list. ThunderPhone can generate provider-specific setup instructions for the configuration required on the trunk side. Test & Save Connection then checks the connection end to end before it is stored.

After the trunk is connected, import the number into ThunderPhone and verify it. Verification includes an inbound dial-in check and an outbound authorization probe. The number becomes active only after those checks pass. You can then assign separate inbound and outbound agents if the two directions need different prompts.

Typical call flows

After-hours call handling

A caller dials the same Vonage number the business already uses. The trunk sends the call to the assigned ThunderPhone inbound agent, which follows its deployed instructions to answer routine questions, collect caller details, or route urgent requests. This supports after-hours answering without asking callers to learn a temporary demo number.

Screening and routing

The agent can ask why the caller is contacting the business, capture the relevant context, and follow prompt-defined routing rules. If the call should reach a person, the agent can transfer it according to the configured behavior. An attended warm transfer requires an eligible production number that can place an outbound SIP leg, so confirm that capability during testing. See call screening and routing for the broader workflow.

Outbound reminders

A verified imported number can also be assigned to an outbound agent. ThunderPhone places the call through the connected trunk, the agent follows its outbound prompt, and voicemail behavior follows the agent's configuration. A separate webhook endpoint can receive call events for downstream processing; the SIP connection itself does not update an external application.

Setup outline

  1. In your Vonage environment, identify the SIP trunk and the number you intend to route. Confirm that the trunk is authorized for the inbound and outbound directions you need.
  2. In ThunderPhone, open Connections → VoIP, choose New connection, then select Manual SIP configuration.
  3. Enter the SIP domain or URI, optional authentication, port, and transport. Add allowed source IPs where your network policy uses an allowlist.
  4. Use Generate AI Setup Guide for provider-specific trunk-side instructions, then complete the corresponding routing in your Vonage setup.
  5. Select Test & Save Connection. If a check fails, correct the trunk assignment, source restrictions, or outbound authorization and test again.
  6. Import the number from Phone Numbers → Add number → Connect VoIP provider, run round-trip verification, and assign the appropriate agents.
  7. Test inbound pickup, outbound caller authorization, voicemail handling, and any transfers before launch.

Provider-specific onboarding status can change, so check the current ThunderPhone VoIP screen before setup. Telephony and number charges depend on your Vonage configuration.

Related reading