Skip to main content
GET
https://app.famulor.de/api/
/
conversations
/
{uuid}
{
  "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"
          }
        }
      ]
    }
  ]
}
Hole den vollständigen Nachrichtenverlauf einer bestehenden Famulor-Conversation. Nutze dies, um einen Chat fortzusetzen, alte Nachrichten anzuzeigen oder Interaktionen zu analysieren.

​
Path Parameters

​
uuid
string
required
UUID der abzurufenden Conversation

​
Request Example

cURL
curl -X GET "https://app.famulor.de/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
const response = await fetch(
  "https://app.famulor.de/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7",
  {
    headers: { Authorization: "Bearer YOUR_API_KEY" },
  }
);

const data = await response.json();
Python
import requests

conversation_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7"
response = requests.get(
    f"https://app.famulor.de/api/conversations/{conversation_id}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=10,
)

print(response.json())

​
Response Fields

​
status
boolean
required
Zeigt an, ob die Anfrage erfolgreich war
​
history
array
required
Chronologische Liste der Nachrichten (älteste zuerst)

​
Response Examples

{
  "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"
          }
        }
      ]
    }
  ]
}

​
Use Cases

  • Conversations fortsetzen: Verlauf wiederherstellen, wenn Nutzer zurückkehren
  • Analytics: Dialoge für QA oder Training überprüfen
  • Integration: Transkripte in CRM- oder Support-Tools synchronisieren

​
Notes

  • Der Verlauf ist aufsteigend sortiert (älteste zuerst).
  • Function Calls erscheinen nur, wenn der Assistent während einer Nachricht Tools genutzt hat.
  • Kombiniere mit Create Conversation und Send Message für den kompletten Flow.