Skip to main content

​
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

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 CaseExample Parameters
Customer Identificationcustomer_name, customer_id
Appointment Bookingappointment_date, appointment_time, service_type
Order Statusorder_number, order_status, delivery_date
Account Managementaccount_balance, payment_due_date
Lead Qualificationlead_source, product_interest

​
Configuring Input Parameters

​
Adding a Parameter

1

Open Input Params Section

Navigate to the Input Parameters section in the left panel.
2

Add New Parameter

Click “Add Parameter” to create a new variable.
3

Configure Properties

Set the name, type, and description.

​
Parameter Properties

PropertyDescriptionRequired
NameVariable identifier (e.g., customer_name)Yes
TypeData type: string, number, booleanYes
DescriptionWhat this parameter representsYes
Default ValueFallback if not providedNo

​
Data Types

Text values like names, addresses, or identifiers.
{
  "customer_name": "John Smith",
  "order_id": "ORD-12345"
}
Numeric values like amounts, quantities, or IDs.
{
  "account_balance": 1250.50,
  "order_count": 3
}
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:
1

Open Playground

Navigate to the Playground in the right panel.
2

Open Context Variables

Click the “Context Variables” panel.
3

Set Test Values

Enter values for each input parameter.
4

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.
  1. Use Clear Names - customer_name is better than cn
  2. Provide Descriptions - Help the AI understand context
  3. Set Default Values - Prevent errors when parameters aren’t provided
  4. Validate Before Sending - Ensure parameters have valid values
  5. Document for Team - Keep a reference of all parameters and their purposes
  6. 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"
}

​
Next Steps

Output Settings

Configure data extraction

Playground

Test with different parameters