Quickstart
Make your first AI voice call in under 5 minutes.
Prerequisites
- A BringRings account (Sign up free)
- An API key (Get your API key)
- At least one configured AI agent
1Install the SDK
Install the BringRings SDK using npm, yarn, or pnpm:
Terminal
npm install @bringrings/sdk2Initialize the Client
Import the SDK and initialize it with your API key:
app.js
import BringRings from '@bringrings/sdk';const client = new BringRings({ apiKey: 'pk_live_xxxxxxxxxxxxxxxx'});Security Tip: Never expose your API key in client-side code. Use environment variables and keep your key on the server.
3Make Your First Call
Use the calls.initiate() method to start an AI voice call:
app.js
// Initiate an AI voice callconst call = await client.calls.initiate({ to: '+1234567890', agentId: 'your-agent-id', metadata: { customerId: 'cust_123' }});console.log('Call ID:', call.id);console.log('Status:', call.status);