curl -X GET "https://app.famulor.de/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';
const response = await fetch(
`https://app.famulor.de/api/conversations/${conversationId}`
);
const data = await response.json();
console.log(data.history);
import requests
conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'
response = requests.get(
f'https://app.famulor.de/api/conversations/{conversation_id}'
)
data = response.json()
print(data['history'])
{
"status": true,
"history": [
{
"role": "assistant",
"content": "Hello! Welcome to our support. How can I help you today?"
},
{
"role": "user",
"content": "I'd like to schedule a demo"
},
{
"role": "assistant",
"content": "I'd be happy to help you schedule a demo! I have availability tomorrow at 2 PM or Thursday at 10 AM. Which works better for you?",
"function_calls": [
{
"name": "check_calendar_availability",
"arguments": {
"date_range": "next_7_days"
},
"result": {
"available_slots": ["2025-01-10 14:00", "2025-01-12 10:00"]
}
}
]
},
{
"role": "user",
"content": "Thursday at 10 AM works for me"
},
{
"role": "assistant",
"content": "I've scheduled your demo for Thursday, January 12th at 10 AM. You'll receive a calendar invitation shortly. Is there anything specific you'd like us to cover during the demo?",
"function_calls": [
{
"name": "book_appointment",
"arguments": {
"datetime": "2025-01-12T10:00:00",
"title": "Product Demo"
},
"result": {
"success": true,
"booking_id": "abc123"
}
}
]
}
],
"variables": {
"user_name": "Jane Smith",
"plan": "premium"
}
}
{
"status": true,
"history": [
{
"role": "assistant",
"content": "Hi! I'm following up on your recent inquiry. How can I help you today?"
},
{
"role": "user",
"content": "I wanted to know more about your enterprise plan"
}
],
"variables": {
"lead_id": "12345",
"source": "website"
},
"external_identifier": "crm-lead-12345"
}
{
"status": true,
"history": [
{
"role": "user",
"content": "Hi, I need help with my order"
},
{
"role": "assistant",
"content": "Hello! I'd be happy to help you with your order. Could you please provide your order number?"
}
],
"variables": null,
"whatsapp_sender": {
"name": "Acme Corp Support",
"phone": "+14155551234"
},
"customer": {
"name": "John Doe",
"phone": "+14155559876"
}
}
{
"status": false,
"error": "Conversation not found"
}
AI Chatbot
Get conversation
Retrieve full message history for an existing conversation
GET
/
conversations
/
{uuid}
curl -X GET "https://app.famulor.de/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';
const response = await fetch(
`https://app.famulor.de/api/conversations/${conversationId}`
);
const data = await response.json();
console.log(data.history);
import requests
conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'
response = requests.get(
f'https://app.famulor.de/api/conversations/{conversation_id}'
)
data = response.json()
print(data['history'])
{
"status": true,
"history": [
{
"role": "assistant",
"content": "Hello! Welcome to our support. How can I help you today?"
},
{
"role": "user",
"content": "I'd like to schedule a demo"
},
{
"role": "assistant",
"content": "I'd be happy to help you schedule a demo! I have availability tomorrow at 2 PM or Thursday at 10 AM. Which works better for you?",
"function_calls": [
{
"name": "check_calendar_availability",
"arguments": {
"date_range": "next_7_days"
},
"result": {
"available_slots": ["2025-01-10 14:00", "2025-01-12 10:00"]
}
}
]
},
{
"role": "user",
"content": "Thursday at 10 AM works for me"
},
{
"role": "assistant",
"content": "I've scheduled your demo for Thursday, January 12th at 10 AM. You'll receive a calendar invitation shortly. Is there anything specific you'd like us to cover during the demo?",
"function_calls": [
{
"name": "book_appointment",
"arguments": {
"datetime": "2025-01-12T10:00:00",
"title": "Product Demo"
},
"result": {
"success": true,
"booking_id": "abc123"
}
}
]
}
],
"variables": {
"user_name": "Jane Smith",
"plan": "premium"
}
}
{
"status": true,
"history": [
{
"role": "assistant",
"content": "Hi! I'm following up on your recent inquiry. How can I help you today?"
},
{
"role": "user",
"content": "I wanted to know more about your enterprise plan"
}
],
"variables": {
"lead_id": "12345",
"source": "website"
},
"external_identifier": "crm-lead-12345"
}
{
"status": true,
"history": [
{
"role": "user",
"content": "Hi, I need help with my order"
},
{
"role": "assistant",
"content": "Hello! I'd be happy to help you with your order. Could you please provide your order number?"
}
],
"variables": null,
"whatsapp_sender": {
"name": "Acme Corp Support",
"phone": "+14155551234"
},
"customer": {
"name": "John Doe",
"phone": "+14155559876"
}
}
{
"status": false,
"error": "Conversation not found"
}
Famulor 1.0 API (legacy). This page applies only to Famulor 1.0 (
app.famulor.de) and is retained for legacy compatibility. For the current platform, use the Famulor 2.0 API reference.Path Parameters
string
required
UUID of the conversation to retrieve
Error Responses
boolean
Will be
false when an error occursstring
Error message. Possible values:
Conversation not found- The provided UUID does not match any conversation
curl -X GET "https://app.famulor.de/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';
const response = await fetch(
`https://app.famulor.de/api/conversations/${conversationId}`
);
const data = await response.json();
console.log(data.history);
import requests
conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'
response = requests.get(
f'https://app.famulor.de/api/conversations/{conversation_id}'
)
data = response.json()
print(data['history'])
{
"status": true,
"history": [
{
"role": "assistant",
"content": "Hello! Welcome to our support. How can I help you today?"
},
{
"role": "user",
"content": "I'd like to schedule a demo"
},
{
"role": "assistant",
"content": "I'd be happy to help you schedule a demo! I have availability tomorrow at 2 PM or Thursday at 10 AM. Which works better for you?",
"function_calls": [
{
"name": "check_calendar_availability",
"arguments": {
"date_range": "next_7_days"
},
"result": {
"available_slots": ["2025-01-10 14:00", "2025-01-12 10:00"]
}
}
]
},
{
"role": "user",
"content": "Thursday at 10 AM works for me"
},
{
"role": "assistant",
"content": "I've scheduled your demo for Thursday, January 12th at 10 AM. You'll receive a calendar invitation shortly. Is there anything specific you'd like us to cover during the demo?",
"function_calls": [
{
"name": "book_appointment",
"arguments": {
"datetime": "2025-01-12T10:00:00",
"title": "Product Demo"
},
"result": {
"success": true,
"booking_id": "abc123"
}
}
]
}
],
"variables": {
"user_name": "Jane Smith",
"plan": "premium"
}
}
{
"status": true,
"history": [
{
"role": "assistant",
"content": "Hi! I'm following up on your recent inquiry. How can I help you today?"
},
{
"role": "user",
"content": "I wanted to know more about your enterprise plan"
}
],
"variables": {
"lead_id": "12345",
"source": "website"
},
"external_identifier": "crm-lead-12345"
}
{
"status": true,
"history": [
{
"role": "user",
"content": "Hi, I need help with my order"
},
{
"role": "assistant",
"content": "Hello! I'd be happy to help you with your order. Could you please provide your order number?"
}
],
"variables": null,
"whatsapp_sender": {
"name": "Acme Corp Support",
"phone": "+14155551234"
},
"customer": {
"name": "John Doe",
"phone": "+14155559876"
}
}
{
"status": false,
"error": "Conversation not found"
}
⌘I