Skip to main content

​
Overview

CallHQ makes it easy to build voice agents that can make and receive phone calls. In under 5 minutes, you’ll create a voice assistant and start interacting over the phone. In this quickstart, you’ll learn to:
  • Create an assistant using the CallHQ Dashboard or programmatically
  • Set up a phone number
  • Make your first inbound and outbound calls

​
Prerequisites

​
Create your first voice assistant

  • Dashboard
  • cURL
1

Open the CallHQ Dashboard

Go to web.callhq.ai and log in to your account.
2

Create a new assistant

In the dashboard, navigate to the Assistants section and click “Create Assistant”.
3

Configure your assistant

Set the first message and system prompt for your assistant.First message:
Thank you for calling Health Care Solutions. This is Emily, your scheduling assistant. How may I help you today?
System prompt:
# Appointment Scheduling Agent Prompt

## Identity & Purpose

You are Emily, an appointment scheduling voice assistant for Health Care Solutions,
a multi-specialty health clinic. Your primary purpose is to efficiently schedule, confirm, 
reschedule, or cancel appointments while providing clear information about services and ensuring a smooth booking experience.

## Voice & Persona

### Personality
- Sound friendly, organized, and efficient
- Project a helpful and patient demeanor, especially with elderly or confused callers
- Maintain a warm but professional tone throughout the conversation
- Convey confidence and competence in managing the scheduling system

​
Set up a phone number

  • Dashboard
1

Purchase or link a phone number

In the Phone Numbers section, either purchase a CallHQ number or link your own via supported providers.
2

Assign an assistant to the number

Select your assistant in the inbound call configuration. When someone calls this number, your assistant will automatically respond.

​
Make your first calls

1

Test inbound calling

Call the number you’ve configured. Your assistant will pick up and begin the conversation using the defined first message.
2

Initiate an outbound call via API

curl -X 'POST' \
'https://api.callhq.ai/api/calls/outbound' \
-H 'accept: */*' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"assistantId": "fe5be098-d76b-7653-b354-bb8246d1d53d",
"phoneNumberId": "59090934-7b8b-45d6-9565-88a9cf53b6fb",
"customer": {
"number": "+919876543210"
}
}'

​
Next steps

Now that you’ve launched your first voice assistant:
  • Customize system prompts for your use case
  • Enable API tools to trigger logic and workflows
  • Use the dashboard to monitor performance and transcripts
  • Scale voice automation with secure, programmable APIs
Ready to add voice into your web app? See the Web integration guide to embed your assistant on any website.