Starts a new LLM-driven conversation with a lead. The system sends the initial outreach message via the specified channel. Requires leads:start_conversation permission.
API key for programmatic access (format nl_live_* or nl_test_*)
Conversation started successfully.
MongoDB ObjectId of the conversation.
"665f1a2b3c4d5e6f7a8b9c0d"
The ID of the associated lead.
MongoDB ObjectId of the account (tenant).
MongoDB ObjectId of the agent configuration used.
The messaging channel used for this conversation.
whatsapp, telegram, email The lead's phone number.
Current status of the conversation.
active, completed, handed_off, dropped Index of the current conversation stage.
Ordered list of messages in the conversation.
Total number of messages in the conversation.
When the conversation was created.
When the conversation was last updated.
MongoDB ObjectId of the campaign, if conversation was started by a campaign.
The lead's email address.
Name of the current conversation stage.
LLM-generated summary of the conversation.