Input Parameters

What are Input Parameters?

Input Parameters are dynamic variables that allow you to personalize each call with customer-specific information. When initiating an outbound call or receiving an inbound call through your API, you can pass these variables to customize the agent’s behavior and knowledge.

Input Parameters are passed via API when initiating calls, making each conversation unique and personalized.

AI Copilot Suggestions

The AI Copilot can automatically analyze your agent’s purpose and suggest relevant input parameters to enhance your call personalization. These suggestions appear as purple banners throughout the Input Parameters interface.

How It Works

When you’re working on your agent configuration, the AI Copilot:

Analyzes your system prompt and agent purpose
Identifies opportunities for personalization
Suggests new parameters or modifications to existing ones
Provides intelligent recommendations for parameter types and descriptions

Suggestion Banners

AI suggestions appear in purple banners at the top of the Input Parameters section. Each banner contains:

Copilot icon - Indicates this is an AI-generated suggestion
Summary - Brief description of what changes are suggested
Parameter cards - Detailed breakdown of each suggested parameter
Accept/Reject buttons - Quick actions to apply or dismiss suggestions

Managing Suggestions

Accept Suggestions
Reject Suggestions

Click Accept All to apply all suggested parameters to your agent configuration. This will:

Add new suggested parameters
Modify existing parameters if improvements are suggested
Update parameter descriptions and types as recommended

Accepting suggestions will modify your current input parameters. Make sure to review the changes before publishing your agent.

Common Use Cases

Use Case	Example Parameters
Customer Identification	`customer_name`, `customer_id`
Appointment Booking	`appointment_date`, `appointment_time`, `service_type`
Order Status	`order_number`, `order_status`, `delivery_date`
Account Management	`account_balance`, `payment_due_date`
Lead Qualification	`lead_source`, `product_interest`

Configuring Input Parameters

Adding a Parameter

Open Input Params Section

Navigate to the Input Parameters section in the left panel.

Add New Parameter

Click “Add Parameter” to create a new variable.

Configure Properties

Set the name, type, and description.

Parameter Properties

Property	Description	Required
Name	Variable identifier (e.g., `customer_name`)	Yes
Type	Data type: string, number, boolean	Yes
Description	What this parameter represents	Yes
Default Value	Fallback if not provided	No

Data Types

String

Text values like names, addresses, or identifiers.

{
  "customer_name": "John Smith",
  "order_id": "ORD-12345"
}

Number

Numeric values like amounts, quantities, or IDs.

{
  "account_balance": 1250.50,
  "order_count": 3
}

Boolean

True/false values for flags and conditions.

{
  "is_premium_customer": true,
  "has_pending_payment": false
}

Using Parameters in Prompts

Once defined, you can reference input parameters in your system prompt and greetings using the {{parameter_name}} syntax.

Example: Personalized Greeting

System Prompt:

You are a customer service agent for Acme Corp.
You are speaking with {{customer_name}}.
Their account status is {{account_status}}.

Greeting (Outbound):

Hello {{customer_name}}, this is Sarah from Acme Corp. 
I'm calling about your order {{order_number}}.

Example: Conditional Behavior

{{#if is_premium_customer}}
Treat this customer as a VIP. Offer priority support and exclusive deals.
{{else}}
Provide standard support. Mention upgrade options if relevant.
{{/if}}

API Integration

When making API calls to initiate calls, include input parameters in your request:

curl -X POST https://api.meetzy.io/v1/calls \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_123",
    "phone_number": "+1234567890",
    "input_params": {
      "customer_name": "John Smith",
      "order_number": "ORD-12345",
      "is_premium_customer": true,
      "account_balance": 1250.50
    }
  }'

Testing Input Parameters

Use the Playground to test how your agent handles different parameter values:

Open Playground

Navigate to the Playground in the right panel.

Open Context Variables

Click the “Context Variables” panel.

Set Test Values

Enter values for each input parameter.

Start Conversation

Test how the agent uses these values.

Best Practices

Use descriptive names and clear descriptions so the AI understands the context of each parameter.

Use Clear Names - customer_name is better than cn
Provide Descriptions - Help the AI understand context
Set Default Values - Prevent errors when parameters aren’t provided
Validate Before Sending - Ensure parameters have valid values
Document for Team - Keep a reference of all parameters and their purposes
Review AI Suggestions - Let the Copilot help identify missing personalization opportunities

Common Parameter Patterns

Customer Information

{
  "customer_name": "string",
  "customer_phone": "string",
  "customer_email": "string",
  "customer_id": "string"
}

Appointment Details

{
  "appointment_date": "string",
  "appointment_time": "string",
  "service_type": "string",
  "location": "string"
}

Order Information

{
  "order_number": "string",
  "order_total": "number",
  "items_count": "number",
  "delivery_date": "string"
}

Getting Started

Agents

Advanced Editor

Voice Library

Calls

CRM

Account

What are Input Parameters?

AI Copilot Suggestions

How It Works

Suggestion Banners

Managing Suggestions

Common Use Cases

Configuring Input Parameters

Adding a Parameter

Parameter Properties

Data Types

Using Parameters in Prompts

Example: Personalized Greeting

Example: Conditional Behavior

API Integration

Testing Input Parameters

Best Practices

Common Parameter Patterns

Customer Information

Appointment Details

Order Information

Next Steps

Output Settings

Playground

​What are Input Parameters?

​AI Copilot Suggestions

​How It Works

​Suggestion Banners

​Managing Suggestions

​Common Use Cases

​Configuring Input Parameters

​Adding a Parameter

​Parameter Properties

​Data Types

​Using Parameters in Prompts

​Example: Personalized Greeting

​Example: Conditional Behavior

​API Integration

​Testing Input Parameters

​Best Practices

​Common Parameter Patterns

​Customer Information

​Appointment Details

​Order Information

​Next Steps

Output Settings

Playground

What are Input Parameters?

AI Copilot Suggestions

How It Works

Suggestion Banners

Managing Suggestions

Common Use Cases

Configuring Input Parameters

Adding a Parameter

Parameter Properties

Data Types

Using Parameters in Prompts

Example: Personalized Greeting

Example: Conditional Behavior

API Integration

Testing Input Parameters

Best Practices

Common Parameter Patterns

Customer Information

Appointment Details

Order Information

Next Steps