Skip to main content
POST
Create conversation
Create a new conversation with your Famulor AI assistant. Use this endpoint to start a widget or test conversation and receive the initial history.

Request Body

string
required
UUID of the assistant that should handle the conversation
string
default:"widget"
Conversation type. Options: widget (paid) or test (free for development)
object
Custom variables injected into the assistant context (accessible via {{variable_name}})

Request Examples

Response Fields

boolean
required
Indicates whether the request succeeded
string
required
UUID of the created conversation; use it for subsequent messages
array
Initial conversation history. Empty if the assistant has no initial message.

Response Examples

Notes

  • type: "widget" conversations are billed; type: "test" is free for development.
  • Provide meaningful variables to personalize the assistant’s first reply.
  • Continue the chat with Send Message and fetch history with Get Conversation.