Skip to main content

Famulor Developer Documentation

Welcome to the Famulor Developer Documentation! Here you’ll find everything you need to create and deploy Voice Agents with Famulor.

Introduction

Famulor provides powerful tools to integrate AI-driven Voice Agents into your applications. With our API and automation platform, you can:
  • Trigger Voice Agents programmatically – Direct API calls for real-time integration
  • Create automated workflows – No-code solutions for complex business processes
  • Integrate calls into existing systems – Seamless CRM and business tool connections

Triggering Calls: Two Approaches

1. Trigger Calls via API (Programmatically)

For developers needing direct control over call initiation:
const response = await fetch('https://app.famulor.de/api/user/make_call', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phone_number: '+4915123456789',
    assistant_id: 123,
    variables: {
      customer_name: 'Max Mustermann',
      email: 'max.mustermann@example.com'
    }
  })
});
Ideal for:
  • Real-time call triggering
  • Dynamic parameter injection
  • Immediate response handling
  • Integration into existing applications

API Call Documentation

Complete reference for programmatic call triggering
For more complex business workflows involving multiple steps: Benefits:
  • No programming required – Visual workflow creation
  • Integrated data processing – Automatic lead enrichment
  • Multi-step workflows – Pre- and post-call automation
  • Prebuilt integrations – CRM, email, calendar tools

Automation Tutorial

Step-by-step guide for automated call workflows

Authentication

All API calls require a valid API key:
1

Obtain API Key

Log in to your Famulor dashboard and navigate to the “API Keys” page
2

Store the Key Securely

Copy the API key and save it securely in your environment variables
3

Use in Requests

Include the key in the Authorization: Bearer YOUR_API_KEY header
Keep your API key confidential and never commit it to version control systems.

Complete Authentication Guide

Detailed information on API authentication

Quick Start: Your First Call

# 1. Set API key (replace YOUR_API_KEY)
export FAMULOR_API_KEY="your_actual_api_key_here"

# 2. List assistants
curl -X GET "https://app.famulor.de/api/user/assistants" \
  -H "Authorization: Bearer $FAMULOR_API_KEY"

# 3. Make a call
curl -X POST "https://app.famulor.de/api/user/make_call" \
  -H "Authorization: Bearer $FAMULOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+4915123456789",
    "assistant_id": 123,
    "variables": {
      "customer_name": "Test Kunde"
    }
  }'

Voice Agent Deployment Strategies

Real-Time Integration

  • Web applications: Instant call triggering via user interaction
  • CRM integration: Calls directly from customer records
  • Support systems: Automatic escalation to Voice Agents

Campaign-Based Deployment

  • Bulk lead processing: Automatically process large lead volumes
  • Scheduled execution: Plan calls at optimal times
  • Progress tracking: Detailed campaign analytics

Event-Driven Activation

  • Webhook triggers: Trigger calls from external events
  • Automation platform: Complex multi-step workflows
  • Conditional logic: Intelligent call routing decisions

Developer Resources

Next Steps

  1. Create an API key – Set up authentication
  2. Make your first call – Test API integration
  3. Explore automation – Build no-code workflows
  4. Configure integrations – Connect business tools
Start with the automation platform if you want to model complex business processes. Use the direct API for simple, programmatic integrations.