Skip to main content
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:
  1. Define variable names and default values
  2. Pass values when creating calls/leads or importing clients
  3. Variables are immediately available in prompts and during the call
  4. 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

​
Automation Platform Integrations

  • 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

​
Platform Integration

  • Automatically populated from client profiles
  • Connected to existing customer databases
  • No-code automation workflows

​
Best Practices

  1. Use meaningful variable names: Use clear names like customer_name instead of name1
  2. Define default values: Ensure important variables have default values
  3. Document your variables: Keep track of which variables are available and what they are used for
  4. 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"
  }
}

System Prompts

Learn how to use variables in your system prompts

Tools & Functions

Enhance your assistant’s capabilities with tools

Automation Platform

Use the no-code platform for advanced integrations

API Reference

Learn more about API integration
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.
Related pages: What Is AI Assistant and Prompt And Tools, and Assistant Best Practices.