POST
/
v1
/
api
/
conversations
/
message
/
generate
Generate Message
curl --request POST \
  --url https://api.trillet.ai/v1/api/conversations/message/generate \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-workspace-id: <x-workspace-id>' \
  --data '{
  "flowId": "<string>",
  "to": "<string>",
  "metadata": {
    "customerDetails": {
      "name": "<string>"
    }
  },
  "autopilot": true,
  "dynamic": {}
}'
{  
  "status": "success",  
  "conversation_id": "63e63b2a-8b6d-4ea4-ae84-abc123",  
  "message_id": "56f3459b-c23d-46a4-8a2d-bcd456",  
  "message": "Your appointment is confirmed for tomorrow at 3 PM."  
}

​
Headers

​
x-api-key
string
required
API key used for authenticating requests to the API.
​
x-workspace-id
string
required
Workspace identifier for the API.

​
Request Body

​
flowId
string
required
Unique identifier for the message flow sending the message. Ensure the Message Flow ID belongs to an active flow.
​
to
string
required
Recipient’s contact information. Use E.164 format for SMS (e.g., +1234567890) and a valid email address format for Email (e.g., user@example.com).
Ensure the contact format matches the messageChannel type: SMS for phone numbers and Email for email addresses. Using an incorrect format or type will result in an error.
​
metadata
object
​
autopilot
boolean
required
Enable automatically sending the generated message to the intended recipient. If your flow has a delay enabled, the message will be sent after that delay. Defaults to false.
​
dynamic
object
Dynamic inputs for AI-generated messages.

​
Response Fields

​
status
string
Indicates (success) if the request was successful.
​
conversation_id
string
Unique identifier for the newly created or fetched existing conversation.
​
message_id
string
Unique identifier for the newly created message within the conversation.
​
message
string
Content of the message sent. This will always be the corresponding message flow’s initiationMessage.
{  
  "status": "success",  
  "conversation_id": "63e63b2a-8b6d-4ea4-ae84-abc123",  
  "message_id": "56f3459b-c23d-46a4-8a2d-bcd456",  
  "message": "Your appointment is confirmed for tomorrow at 3 PM."  
}