> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.voicebip.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.voicebip.com/_mcp/server.

# Agent Templates

> Create production-ready agents in seconds using pre-built templates for common Nigerian business use cases.

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

| Template               | Category   | Description                                                                                            |
| ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------ |
| Loan Recovery Agent    | Finance    | Empathetic collection agent for Nigerian fintechs. Discusses outstanding balances and payment options. |
| Customer Support Agent | Support    | General-purpose support agent with Nigerian cultural context.                                          |
| Appointment Booking    | Healthcare | Schedules and manages appointments with confirmation follow-ups.                                       |
| Payment Reminder       | Finance    | Sends polite payment reminders with Paystack/bank transfer instructions.                               |

## List Templates

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

Response:

```json
{
  "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.

```bash
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

```bash
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