Agent Templates

Templates are pre-built agent configurations for common use cases. Instead of writing a system prompt from scratch, pick a template and get a working agent in 30 seconds.

Available Templates

List Templates

curl "https://api.voicebip.com/v1/templates" \
  -H "Authorization: Bearer pk_live_your_key"

Response:

{
  "templates": [
    {
      "template_id": "tpl_loan_recovery",
      "name": "Loan Recovery Agent",
      "description": "Empathetic loan recovery agent for Nigerian fintechs",
      "category": "finance",
      "language": "en",
      "ai_provider": "openai",
      "system_prompt": "You are a friendly loan recovery agent...",
      "greeting_text": "Hello, this is your loan recovery assistant. How can I help you today?"
    }
  ]
}

Create an Agent from a Template

Pass the template_id when creating an agent. The template pre-fills system_prompt, language, ai_provider, and greeting_text. You can override any field.

curl -X POST "https://api.voicebip.com/v1/agents" \
  -H "Authorization: Bearer pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "Acme Loan Recovery",
    "template_id": "tpl_loan_recovery"
  }'

Override Template Defaults

curl -X POST "https://api.voicebip.com/v1/agents" \
  -H "Authorization: Bearer pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "Acme Loan Recovery",
    "template_id": "tpl_loan_recovery",
    "language": "pcm",
    "greeting_text": "Good day! Na Acme Finance dey call. How we fit help you?"
  }'

Fields you provide explicitly always take precedence over template defaults.

Onboarding Wizard

The dashboard includes a 4-step onboarding wizard that uses templates:

1. Pick a template - Choose from the available templates
2. Provision a number - Get a Nigerian phone number
3. Test call from browser - Make a WebRTC test call directly from the dashboard
4. Share your agent - Enable the shareable link and distribute it