API 文档, VoiceOfCustomerInsightPack

异步 API：客户之声洞察包

将一份客户反馈 CSV 或 JSON 数组导出转换为有证据支持的主题、优先级产品待办和可下载的研究文件。

端点: POST https://mxprocess.com/api/files/start-process
身份验证: Bearer JWT
费用: 120 令牌，在操作成功后按平台生命周期扣除。

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Accept: application/json' \
--form 'file=@"/absolute/path/customer-feedback.csv"' \
--form 'actionName=VoiceOfCustomerInsightPack' \
--form 'parameters=[["language",["English"]],["productContext",["B2B SaaS"]],["analysisGoal",["prioritize retention improvements"]]]' \
--form 'async=true'

上传一个不超过 25 MB、最多 1,000 条记录的 CSV 或 JSON 数组导出。保存返回的 id，并轮询 /api/actions/get-action-infos/{id}。完成后会列出标准化反馈 CSV、Markdown 报告、主题 CSV、机会待办 CSV 和 JSON；请通过 /api/actions/download-action-result/{id}/FILENAME 下载每个文件，包括 JSON。

功能错误示例

{"error":"ERROR_VOC004 Voice of Customer Insight Pack accepts CSV or JSON exports up to 25 MB."}

如需直接执行，请使用同步 API.

联系我们