Skip to main content
Your app signs in to Vobiz as a SIP endpoint: a username and password that registers with the Vobiz registrar. This page creates one in the Vobiz Console and shows where each value goes in the SDK.
Signing in with an access token needs no endpoint. Create one only if you sign in with a username and password.

Before you start

  • A Vobiz account. Sign up at console.vobiz.ai.
  • An application whose Answer URL handles the calls your app places. You can attach it while you create the endpoint, or later.

Create the endpoint

1

Open the Console and go to Voice

Sign in to the Vobiz Console. You land on the Dashboard. In the left menu, under Communication, click Voice.
Vobiz Console dashboard with quick actions, business metrics, and wallet balance, and the Voice item highlighted in the left menu under Communication

The Vobiz Console dashboard. Open Voice in the left menu.

2

Open Endpoints

Voice expands. Click Endpoints.
Expanded Voice menu listing Overview, Applications, Endpoints, Call Logs, Recordings, Push Notifications, Campaigns, Campaign Agents, and Campaign Call Logs, with Endpoints highlighted

Voice > Endpoints in the left menu.

3

Click Create endpoint

The Endpoints page lists your SIP endpoints, the application each one uses, whether it is registered, and its SIP username. Click Create endpoint at the top right.
Endpoints page with a search box, All endpoints, Registered, and Not linked tabs, a table with Endpoint, Application, Status, and SIP username columns, and the Create endpoint button highlighted at the top right

The Endpoints page. Create endpoint is at the top right.

4

Fill in the endpoint details

The Create SIP Endpoint panel opens.
Create SIP Endpoint panel with numbered fields: 1 Alias, 2 Username, 3 Password, and 4 Application (optional) set to None, and the Create Endpoint button highlighted

Create SIP Endpoint. The numbers match the table below.

5

Create the endpoint

Click Create Endpoint. The endpoint appears in the list. Copy its full username from the SIP USERNAME column: that, not the username you typed, is what the SDK signs in with.

Where the values go in the SDK

Once the app signs in, the endpoint shows Registered in the Status column.

Route calls to and from the endpoint

Outbound. When the app calls a number, Vobiz requests the Answer URL of the endpoint’s application with the dialled number in To. Return VobizXML that dials it, with a caller ID your account owns:
Inbound. Ring the app from the application linked to your Vobiz number:
Each SIP username has one active registration: if the same username signs in on a second device, the newest sign-in replaces the older one, and only that device rings. Create one endpoint per user or device.

Production: one endpoint per user

Creating endpoints by hand suits testing. In production, your backend creates an endpoint for each user with the Create endpoint API, keeps its password, and hands it to the app after authenticating the user. The SDK fetches it through a credentials provider. Alternatively, use access tokens, which need no endpoint at all.

Next steps