Skip to main content

Creating Conversations

HuskyVoice AI allows you to initiate voice conversations programmatically. You can trigger calls using either our REST API for custom applications or Inbound Webhooks for no-code tools.

Before You Begin​

Make sure you have completed these three steps before initiating a call. If any of these are missing, your call will not go through.

Step 1 — Create an Outbound Agent​

An Agent is your AI voice assistant — it handles the conversation on your behalf. You need at least one Outbound Agent set up in your HuskyVoice dashboard before making any calls.

Go to Dashboard → Agents → Create Agent and select Outbound as the type.

Step 2 — Assign a Phone Number to the Agent​

Your agent needs a phone number to call from. Without an assigned number, calls cannot be placed.

Go to Dashboard → Agents → Select your Agent → Phone Numbers → Assign Number.

Step 3 — Generate an API Key​

An API Key is a unique password that lets your application talk to HuskyVoice securely. You need this to authenticate your requests.

Go to Dashboard → Integrations → API Keys → Generate New Key. Copy and store it safely — it will not be shown again.

Not a developer?

If you are using a no-code tool like Zapier or HubSpot, you only need Steps 1 and 2. Use the Inbound Webhook tab below instead of the REST API.

1. Using the REST API​

Best for developers building custom applications. Authenticate using your API Key.

curl -s -X POST https://api.huskyvoice.ai/v1/calls \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_123",
    "contact_number": "+1234567890",
    "additional_info": {
      "customer_name": "Charlie",
      "purpose": "Appointment Confirmation"
    }
  }'

Sample Response:

{
  "success": true,
  "call_id": "call_abc123",
  "status": "queued",
  "message": "Call has been queued successfully."
}

What Happens Next?​

Once your call is initiated, HuskyVoice queues it and connects the agent to the contact. You can track the live status and outcome of the call via Call Status.

tip

Save the call_id from the response — you'll need it to fetch status updates or cancel the call later.

Technical Details​

FieldRequiredDescription
contact_numberYesThe target phone number with country code (e.g., +91XXXXXXXXXX).
agent_idYesThe unique ID of the AI agent to use for this call.
additional_infoNoA JSON object containing variables your agent can reference during the call.

Using additional_info in Your Agent Prompt​

The fields you pass in additional_info can be used directly inside your agent's prompt using double curly braces {{ }}. This lets your agent personalise the conversation for each contact.

Example — passing additional info in the API call:

{
  "agent_id": "agent_123",
  "contact_number": "+1234567890",
  "additional_info": {
    "customer_name": "Charlie",
    "appointment_date": "12th May 2026",
    "purpose": "Appointment Confirmation"
  }
}

Example — referencing them inside your agent prompt:

Hi {{customer_name}}, this is a reminder that your appointment is scheduled for {{appointment_date}}.
The purpose of your visit is {{purpose}}. Please confirm if you will be attending.

What the agent will say:

"Hi Charlie, this is a reminder that your appointment is scheduled for 12th May 2026. The purpose of your visit is Appointment Confirmation. Please confirm if you will be attending."

tip

You can pass up to 25 key-value pairs in additional_info. Use clear, descriptive key names so your agent prompt stays readable.