RapidSMS 消息对象详解IncomingMessage 与 OutgoingMessage 的 10 个关键用法【免费下载链接】rapidsmsBuild SMS applications with Python项目地址: https://gitcode.com/gh_mirrors/ra/rapidsmsRapidSMS 消息对象是构建 Python 短信应用的核心基石其中IncomingMessage接收消息与OutgoingMessage发送消息贯穿了短信收发的全过程。无论你是刚接触 RapidSMS 的新手还是正在开发短信应用的中级开发者掌握这两个消息对象的用法都能让你的开发效率大幅提升。本文将从源码层面拆解这两个消息对象为你梳理10 个最实用、最常用的关键用法。RapidSMS 整体架构消息对象在 Router、App 与 Backend 之间流转一、先认识两个消息对象它们从哪来在 RapidSMS 中所有短信内容都被抽象为消息对象它们都继承自MessageBasebase.py。简单来说IncomingMessageincoming.py用户发来的短信由后端Backend接收后创建。OutgoingMessageoutgoing.py你要发给用户的短信通常由应用创建并通过路由器发送。RapidSMS 的消息对象自带text文本内容、connections连接、id唯一标识等基础属性下面我们逐一解锁它们的实战用法。二、10 个关键用法从入门到进阶用法 1用receive()快速创建 IncomingMessage 接收短信接收短信最标准的入口是receive()函数api.py它会把文本和连接对象包装成 IncomingMessage 并交给路由器处理from rapidsms.router import receive receive(echo hello, connection)这是大多数短信后端如 Kannel、Vumi接入短信时都会调用的方法也是测试短信接收流程的最快方式。用法 2用respond()一键回复用户当你的应用处理完一条 IncomingMessage 后最自然的动作就是回复用户。respond()方法会自动把回复发送给原始消息的发送者并自动记录in_response_to关联msg.respond(感谢你的来信我们会尽快处理)这里有个小细节respond()返回的是一个包含text、connections、in_response_to的字典响应会被暂存在msg.responses列表中等处理阶段结束后统一发送无需你手动调用发送接口。用法 3用error()优雅地发送错误提示在短信交互中输入错误很常见。RapidSMS 专门提供了ErrorMessageerror.py来表示错误消息通过IncomingMessage.error()即可发送msg.error(指令格式错误请回复 HELP 查看帮助)这样业务上回复失败和回复成功就能清晰区分方便后续统计与日志分析。用法 4用send()主动推送 OutgoingMessage 短信除了被动回复短信应用经常需要主动给用户发消息比如天气提醒、验证码。你可以直接使用send()函数api.pyfrom rapidsms.router import send send(您订阅的天气预报已更新, connections)也可以先创建 OutgoingMessage 对象再调用它的send()方法outgoing.py效果完全等价from rapidsms.messages import OutgoingMessage msg OutgoingMessage(text今日天气晴适合出行, connectionsconnections) msg.send()用法 5用connections管理发给谁消息对象中的connections是一个Connection对象列表。Connectionmodels.py把后端 身份标识如手机号绑定在一起一条消息可以同时发给多个连接connections lookup_connections(backendkannel, identities[13800000001, 13800000002]) send(群发测试, connections)借助lookup_connections工具函数即使连接不存在也会自动创建非常适合批量群发场景。用法 6用fields携带任意元数据消息对象自带一个fields字典用于在消息流转过程中挂载额外信息比如短信的外部 ID、业务参数等msg IncomingMessage(connection, test, fields{external_id: ABC123})有意思的是当这条消息被回复时fields里的external_id还会通过extra_backend_context()outgoing.py自动透传给后端方便你对接运营商的回执系统。用法 7用id追踪每条消息的唯一身份每条消息在创建时都会通过generate_id()生成一个 UUID 形式的唯一 IDbase.py用于日志追踪、数据库记录和消息关联。你可以在自己的日志或报表中打印msg.id快速定位任意一条短信的完整生命周期。用法 8用in_response_to建立消息对话链短信应用经常需要处理多轮对话。in_response_to属性让回复消息始终指向原始消息形成一条完整的对话链。配合 OutgoingMessage 的extra_backend_context()回复时还会带上原始消息的 ID方便后端进行会话管理。用法 9用raw_text保留短信原始内容消息对象同时保存text当前文本和raw_text原始文本两个属性。如果你的应用会修改或转发消息内容raw_text能帮你随时找回最初的内容这对审计和数据校验非常有用。用法 10用processed与handled控制处理流程IncomingMessage 有两个与路由器协作的标志位base.pyprocessed消息是否已被所有应用处理完毕handled消息是否已被某个应用接管可短路默认处理逻辑。在复杂的业务应用中利用这两个标志可以实现消息被处理后就停止后续流程的短路机制避免重复响应。三、一个完整的实战示例回声机器人光说不练假把式我们结合 RapidSMS 自带的 echo 应用echo.py和 ping 处理器ping.py看消息对象如何协同工作class PingHandler(BaseHandler): classmethod def dispatch(cls, router, msg): if msg.text ping: return msg.respond(pong)当用户发送ping时路由器创建 IncomingMessage 并传入处理器处理器调用respond(pong)生成回复路由器收集所有响应后创建 OutgoingMessage 发回用户。整个流程中消息对象的创建、回复、关联、发送一气呵成。在 RapidSMS 中为消息处理添加任务直观管理短信应用逻辑四、新手最容易踩的 3 个坑不要把date用错对象IncomingMessage 上访问date会直接抛异常因为接收时间对入站消息没有意义时间戳由路由器统一管理。respond()不再支持template参数老版本可以用模板渲染新版本请直接传text否则会报TypeError。优先使用connections而非connection单数形式的connection属性已标记为弃用deprecated虽然暂时可用但会产生警告建议尽早迁移。五、写在最后消息对象是 RapidSMS 的灵魂通过这 10 个关键用法可以看到RapidSMS 消息对象的设计非常克制而优雅入站消息专注接收与应答出站消息专注发送与追踪共同支撑起完整的短信应用闭环。建议你动手写一个简单的 echo 应用亲自体验 IncomingMessage 与 OutgoingMessage 的协作流程——毕竟实践才是掌握短信开发最快的方式。如果你正在规划自己的第一个 RapidSMS 短信项目不妨先收藏本文开发时对照查阅相信它能帮你少走不少弯路。【免费下载链接】rapidsmsBuild SMS applications with Python项目地址: https://gitcode.com/gh_mirrors/ra/rapidsms创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考