Documentation

ChatPilot

State Machine

Conversation states and transition signals used by ChatPilot.

![Conversation state machine](/img/conversation-state-machine.svg)

States include greeting, qualifying, bot_active, human_requested, handed_off, follow_up, and closed.

Transitions are triggered by inbound messages, classifier scores, campaign replies, business-hours rules, payment events, or explicit staff actions. The active state is stored in conversations.current_state.