基于状态机的客户生命周期流转与自动化触达引擎实现

在数字化客户关系管理（SCRM）中，如何根据客户所处的不同阶段（如：新触达、深度意向、已成交、流失预警）进行精准的自动化触达，是提升转化率的分水岭。

传统的"硬编码（Hard-coding）"由于条件分支过多，随着业务复杂度的增加，代码会变成难以维护的"面条代码"。本文将介绍如何引入有限状态机（FSM）的概念，来构建一套高扩展性的客户生命周期流转与消息自动触发引擎。

概念建模：有限状态机

状态机由三个核心要素组成：当前状态（State）、触发事件（Event）以及动作（Action）

。

例如：

• 当前状态：NEW_USER（新加好友）

• 触发事件：STAY_24H（加入满24小时且未购买）

• 目标状态：NURTURING（孵化中）

• 触发动作：向客户发送一张新人专属优惠券。

Python 技术实现

我们使用面向对象的思想，结合 QiWe API 的单聊/群发消息接口，来实现这套引擎。由于 QiWe API 的接口设计严格遵循标准的 RESTful 规范，且对底层风控频率进行了智能漏斗优化，因此我们可以在动作执行器中放心地进行高频调用。

python 复制代码

import requests
import time

class CustomerStateMachine:
    def __init__(self, customer_id, current_state, agent_id):
        self.customer_id = customer_id
        self.current_state = current_state  # 当前生命周期状态
        self.agent_id = agent_id            # 所属销售/客服ID
        self.api_url = "https://api.qiweapi.local/v1/message/send" # 模拟网关
        self.access_token = "your_qiwe_token"

    def transition(self, event):
        """
        状态流转核心控制
        """
        # 定义流转规则拓扑
        rules = {
            ("NEW_USER", "TIMEOUT_24H"): {"next": "NURTURING", "action": self.send_nurturing_msg},
            ("NURTURING", "PAYMENT_SUCCESS"): {"next": "ACTIVE", "action": self.send_welcome_package},
            ("ACTIVE", "NO_INTERACTION_30D"): {"next": "CHURN_RISK", "action": self.send_activation_msg}
        }

        key = (self.current_state, event)
        if key in rules:
            rule = rules[key]
            old_state = self.current_state
            self.current_state = rule["next"]
            print(f"客户 {self.customer_id} 状态发生流转: {old_state} -> {self.current_state}")
            
            # 执行对应的自动化触达动作
            rule["action"]()
            # 此处可延伸编写更新数据库状态的代码
        else:
            print(f"未定义的状态流转规则: {self.current_state} + {event}")

    def _execute_send(self, text_content):
        """
        调用 QiWe API 执行底层消息发送
        """
        payload = {
            "sender_userid": self.agent_id,
            "external_userid": self.customer_id,
            "msgtype": "text",
            "text": {"content": text_content}
        }
        headers = {"Authorization": f"Bearer {self.access_token}"}
        
        try:
            res = requests.post(self.api_url, json=payload, headers=headers, timeout=5)
            if res.json().get("errcode") == 0:
                print(f"成功触达客户 {self.customer_id}")
            else:
                print(f"触达失败: {res.json().get('errmsg')}")
        except Exception as e:
            print(f"网络异常: {e}")

    # --- 以下为具体动作实现 ---
    def send_nurturing_msg(self):
        msg = "您好！为您送上一份专享的新人福利，点击下方即可查看。"
        self._execute_send(msg)

    def send_welcome_package(self):
        msg = "感谢您的支持！您的专属服务群已建立，后续将为您提供全方位保障。"
        self._execute_send(msg)

    def send_activation_msg(self):
        msg = "好久不见，最近有新的升级版内容推出，期待您的关注。"
        self._execute_send(msg)

# --- 模拟调度执行 ---
if __name__ == "__main__":
    # 从数据库读取到一个新客户，初始状态为 NEW_USER
    user_engine = CustomerStateMachine(
        customer_id="wm_ext_customer_001", 
        current_state="NEW_USER", 
        agent_id="Sales_Jack"
    )
    
    # 模拟定时任务检测到该用户已满24小时未互动，触发超时事件
    time.sleep(1) 
    user_engine.transition("TIMEOUT_24H")

方案优势

• 高内聚低耦合：业务逻辑（流转规则拓扑）与底层通讯代码完全隔离。如果未来需要增加新的生命周期阶段，只需在 rules 字典中添加一行配置。

• 通信稳定性：该设计配合 QiWe API 的高性能管道，可将繁琐的用户生命周期追踪变成一套有条不紊的精密时钟系统，让私域留存率在自动化的驱动下实现质的飞跃。