Guides

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

TemplateCategoryDescription
Loan Recovery AgentFinanceEmpathetic collection agent for Nigerian fintechs. Discusses outstanding balances and payment options.
Customer Support AgentSupportGeneral-purpose support agent with Nigerian cultural context.
Appointment BookingHealthcareSchedules and manages appointments with confirmation follow-ups.
Payment ReminderFinanceSends polite payment reminders with Paystack/bank transfer instructions.

List Templates

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

Response:

1{
2  "templates": [
3    {
4      "template_id": "tpl_loan_recovery",
5      "name": "Loan Recovery Agent",
6      "description": "Empathetic loan recovery agent for Nigerian fintechs",
7      "category": "finance",
8      "language": "en",
9      "ai_provider": "openai",
10      "system_prompt": "You are a friendly loan recovery agent...",
11      "greeting_text": "Hello, this is your loan recovery assistant. How can I help you today?"
12    }
13  ]
14}

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