push(['requestId' => 'REQ20240806001']); * * // 带完整参数 * $result = $inbox->push([ * 'requestId' => 'REQ20240806001', * 'content' => '入库订单 SO001 已完成', * 'groupId' => 'GRP001', * 'groupName' => '仓储业务群', * 'userId' => 'U001', * 'userName' => '张三', * 'parentId' => 0, * 'sourceType' => 'api', * 'targetType' => 'im', * 'extData' => ['orderNo' => 'SO001'], * 'flags' => new \stdClass(), * ]); */ class Inbox extends Base { /** * {@inheritDoc} */ protected function moduleName() { return 'inbox'; } // ==================== API 方法 ==================== /** * inbox.push — 推送站内信 * * 外部系统将消息推入仓库站内信。 * 注意:warehouse_id 由验签后上下文注入,禁止外部传入。 * * @param array $params 推送参数(共 11 个字段) * - requestId string 必填 来源请求唯一 ID,与 appKey 组合为 ext_id(api:{appKey}:{requestId}),用于幂等去重 * - content string 可选 消息正文/摘要 * - groupId string 可选 外部群 ID,用于关联群及自动查询货主路由 * - groupName string 可选 群名称(展示用) * - userId string 可选 外部用户 ID * - userName string 可选 用户名称(展示用) * - parentId number 可选 关联消息 ID(回信时指向原消息,形成对话链) * - sourceType string 可选 来源类型:im / api / system,默认 api * - targetType string 可选 目标类型:im / api / webhook,默认 im * - extData object 可选 外部透传数据,任意 JSON,WMS 不解析,回信时原样返回 * - flags object 可选 处理标记(预留,当前未消费) * @return array ['code' => int, 'msg' => string, 'data' => ['ok' => bool, 'id' => int, 'ext_id' => string]] */ public function push(array $params) { $body = array_merge([ 'requestId' => '', 'content' => '', 'groupId' => '', 'groupName' => '', 'userId' => '', 'userName' => '', 'parentId' => 0, 'sourceType' => 'api', 'targetType' => 'im', 'extData' => new \stdClass(), 'flags' => new \stdClass(), ], $params); return $this->call('push', $body); } }