Welcome to Voicebip

Voicebip is a developer-first platform that gives AI agents real phone numbers, WhatsApp identities, and SMS capability — all through a single API. Built on NCC-licensed Nigerian carrier infrastructure by Temlio Communications Limited.

Quick Start

Get your first AI agent live in under a minute using templates.

Step 1: Pick a Template and Create an Agent

Browse pre-built templates and create a production-ready agent in one call:

$
# List available templates
$
curl "https://api.voicebip.com/v1/templates" \
>
  -H "Authorization: Bearer pk_live_your_key"
$
$
# Create an agent from a template
$
curl -X POST "https://api.voicebip.com/v1/agents" \
>
  -H "Authorization: Bearer pk_live_your_key" \
>
  -H "Content-Type: application/json" \
>
  -d '{"display_name": "Customer Support Agent", "template_id": "tpl_customer_support"}'

Or create from scratch without a template:

$
curl -X POST "https://api.voicebip.com/v1/agents" \
>
  -H "Authorization: Bearer pk_live_your_key" \
>
  -H "Content-Type: application/json" \
>
  -d '{"display_name": "Customer Support Agent", "language": "en"}'

Step 2: Provision a Nigerian Phone Number

$
curl -X POST "https://api.voicebip.com/v1/numbers/auto" \
>
  -H "Authorization: Bearer pk_live_your_key" \
>
  -H "Content-Type: application/json" \
>
  -d '{"agent_id": "agt_xxx", "type": "geo_did", "country_code": "NG", "channels": ["voice", "sms"]}'

Step 3: Test from Your Browser

Make a test call directly from the dashboard — no phone needed. Or enable the shareable link and call from any browser:

$
curl -X PATCH "https://api.voicebip.com/v1/agents/{agent_id}/shareable" \
>
  -H "Authorization: Bearer pk_live_your_key" \
>
  -H "Content-Type: application/json" \
>
  -d '{"shareable": true}'

Step 4: Configure a Webhook

Set your webhook_url when creating or updating the agent to receive real-time events.

Step 5: Start Receiving Calls

Your agent’s Nigerian phone number is now live. Inbound calls trigger call.initiated and call.transcription webhook events. Track performance with the analytics dashboard.

Core Concepts

• Agents — AI personas that own phone numbers and handle calls/messages
• Phone Numbers — Nigerian DIDs, mobile virtual numbers, and international DIDs
• Voice Calls — Inbound and outbound with real-time transcription
• SMS — Direct SMPP to all four Nigerian MNOs
• Webhooks — Real-time events with HMAC-SHA256 signatures
• Usage & Billing — Naira (Paystack) and USD (Stripe) pay-as-you-go

Base URL

https://api.voicebip.com/v1

Authentication

Authorization: Bearer pk_live_your_api_key

See Authentication for full details on API keys, sandbox mode, and rate limits.