Learn how to use variables in Famulor to retrieve information during a call.
What is a Variable?
A variable is a data value that you can store and reuse during a call. Variables allow you to capture, for example, the caller’s name, phone number, or AI-generated values.
System Variables
Famulor provides various system variables that are automatically available:
Date and Time Variables
{{now}} – Current time from the assistant (date and time){created_at} – Date and time when the call started
Phone Number Variables
{client_phone_number} or {customer_phone} – Phone number of the caller{assistant_phone_number} – Phone number of the assistant
Assistant and Campaign Variables
{assistant_name} – Name of the assistant{campaign_name} – Name of the campaign (for outbound calls)
Call Variables
Call Variables are custom variables that you define before a call and pass to the assistant. They enable you to conduct personalized conversations and provide context-specific information.
Variable Configuration
Variable Definition
Create Call Variables to pass information to your assistant before the call starts.
Setup process:
- Define variable names and default values
- Pass values when creating calls/leads or importing clients
- Variables are immediately available in prompts and during the call
- Use them for personalization and context
Configuration:
- Variable Name: The identifier (e.g.,
customer_name)
- Default Value: Used if no value is passed (e.g., “John”)
Variable Usage
Usage in System Prompts
How to use Call Variables in your assistant:
- Reference variables using the syntax
{variable_name}
- Personalize conversations dynamically
- Provide context-specific information
Examples:
{customer_name} for personalization (“Hello ”){email} for calendar integrations{account_type} for tailored responses{company} for business context
Data Sources
There are various ways to populate Call Variables:
Manual Entry
- When creating individual calls
- Via campaign lead creation
Import Methods
- CSV Import: Import leads with variable columns
- API Integration: Direct integration with client data
- Direct CRM Synchronization: Connect to your CRM system
- GoHighLevel (GHL): Automatically fetch contact data and custom fields
- Google Sheets: Import leads with variables from spreadsheet columns
- 250+ popular tools and platforms: Use our no-code platform for integrations
- Webhooks: Custom integrations via webhooks for bespoke use cases
- Automatically populated from client profiles
- Connected to existing customer databases
- No-code automation workflows
Best Practices
- Use meaningful variable names: Use clear names like
customer_name instead of name1
- Define default values: Ensure important variables have default values
- Document your variables: Keep track of which variables are available and what they are used for
- Test your variables: Verify variables are correctly passed and used
Example Usage
System Prompt Example
You are a sales assistant for {company}.
Hello {customer_name}, thank you for your interest in our services.
Based on your account type ({account_type}), I can offer you the following options...
Call Creation with Variables
When creating a call, you can pass variables as follows:
{
"assistant_id": "123",
"phone_number": "+49123456789",
"variables": {
"customer_name": "Max Mustermann",
"company": "Muster GmbH",
"account_type": "Premium",
"email": "max@muster.de"
}
}
Call Variables are essential for personalizing AI conversations. They allow the AI to use specific customer information during the call, making interactions more relevant and effective.
