告别繁琐：客户反馈集成难题与 Delighted 的救赎
作为一名开发者，我深知在业务应用中集成第三方服务常常伴随着挑战。特别是涉及到客户反馈这种需要持续、高效收集数据的场景，如果采用传统的手动方式，例如通过邮件批量发送调查问卷、人工统计响应，那简直是噩梦。不仅效率低下，还极易出错，更别提数据的及时性和准确性了。
我们之前也面临着这样的困境：如何在我们已有的 php 应用中，优雅地实现客户满意度调查（NPS）、客户努力度（CES）或客户满意度（CSAT）等反馈机制？最初，我们考虑过自己搭建一套调查系统，但很快就发现这不仅耗费巨大的人力物力，还需要处理邮件发送、响应收集、数据分析、用户管理等一系列复杂问题。更不用说，如果需要与专业的客户体验平台对接，还得从零开始编写 API 客户端，处理认证、http 请求、错误重试、数据解析……想想都头大。
就在我们焦头烂额之际，我们发现了 Delighted——一个专注于客户体验管理的优秀平台。它提供了强大的调查功能和数据分析工具，但关键在于，如何将它无缝集成到我们的 PHP 应用中呢？幸运的是，Delighted 提供了一个官方的 PHP API 客户端 delighted/delighted，而 composer 则成了我们解决这一难题的得力助手。
Composer：让 Delighted 客户端触手可及
使用 Composer 来管理 delighted/delighted 客户端简直是轻而易举。你只需要在项目的 composer.json 文件中添加一行依赖，然后运行简单的命令，就能将 Delighted 客户端及其所有依赖（包括强大的 Guzzle HTTP 客户端）自动安装到你的项目中。
立即学习“PHP免费学习笔记（深入）”；
安装步骤：
-
在
composer.json中添加依赖：<pre class="brush:php;toolbar:false;">{ "require": { "delighted/delighted": "4.*" } }这里我们指定了
4.*版本，以确保兼容性和获取最新功能。 -
运行 Composer 安装命令：
<code class="bash">composer install</code>
Composer 会自动下载
delighted/delighted包及其所有依赖，包括 Guzzle HTTP 客户端。这意味着你无需手动配置任何 HTTP 请求细节，Delighted 客户端已经为你封装好了一切。
配置与使用：Delighted 客户端的魔法
安装完成后，接下来就是配置和使用了。
1. 配置 API 密钥
在使用 Delighted 客户端的任何功能之前，你需要用你的 Delighted API 密钥进行配置。这个密钥可以在你的 Delighted 账户设置中找到，务必像对待密码一样妥善保管它。
<pre class="brush:php;toolbar:false;"><?php require 'vendor/autoload.php'; // 引入 Composer 自动加载文件 use DelightedClient; // 替换为你的实际 API 密钥 Client::setApiKey('YOUR_API_KEY'); // 你的应用程序逻辑开始 // ...
2. 添加/更新用户并调度调查
Delighted 客户端最核心的功能之一就是添加或更新用户，并根据需求调度调查。你可以立即发送调查，设置延迟，甚至只是添加用户而不立即发送。
<pre class="brush:php;toolbar:false;"><?php use DelightedPerson; // 1. 添加一个新用户，并立即发送调查 $person1 = Person::create(['email' => 'ellie@example.com']); echo "用户 {$person1->email} 已添加，并已调度调查。n"; // 2. 添加一个新用户，并设置 1 分钟（60 秒）后发送调查 $person2 = Person::create(['email' => 'richard@example.com', 'delay' => 60]); echo "用户 {$person2->email} 已添加，调查将在 60 秒后发送。n"; // 3. 添加一个新用户，但不发送调查（可能稍后手动发送） $person3 = Person::create(['email' => 'gvargas@example.com', 'send' => false]); echo "用户 {$person3->email} 已添加，但未调度调查。n"; // 4. 添加一个带有自定义属性的用户，并设置延迟 $props = ['customer_id' => 123, 'country' => 'USA', 'question_product_name' => 'The London Trench']; $person4 = Person::create([ 'email' => 'alexis@example.com', 'name' => 'Alexis Burke', 'properties' => $props, 'delay' => 30 ]); echo "用户 {$person4->email} (产品: {$person4->properties->question_product_name}) 已添加，调查将在 30 秒后发送。n"; // 5. 更新一个现有用户（通过 email 识别），添加名字，但不发送调查 $updated_person1 = Person::create([ 'email' => 'ellie@example.com', 'name' => 'Ellie Newman', 'send' => false ]); echo "用户 {$updated_person1->email} 的名字已更新为 {$updated_person1->name}。n";
3. 列出用户和调查响应（并处理限流）
在与第三方 API 交互时，限流（Rate Limits）是一个常见的问题。Delighted 客户端非常贴心地提供了自动分页迭代器和限流异常处理机制，让你的代码更加健壮。
<pre class="brush:php;toolbar:false;"><?php use DelightedPerson; use DelightedRateLimitedException; use DelightedSurveyResponse; // 列出所有用户，并自动处理分页和限流 echo "列出所有用户：n"; $people = Person::list(); foreach ($people->autoPagingIterator(['auto_handle_rate_limits' => true]) as $person) { echo " - ID: {$person->id}, Email: {$person->email}n"; // 可以在这里对每个用户进行操作 } // 列出所有调查响应，并处理限流 echo "n列出所有调查响应：n"; $responses = SurveyResponse::all(); while (true) { try { foreach ($responses->autoPagingIterator() as $response) { echo " - 响应 ID: {$response->id}, 分数: {$response->score}, 评论: '{$response->comment}'n"; } break; // 成功获取所有响应，跳出循环 } catch (RateLimitedException $e) { // 遇到限流，等待指定时间后重试 $retryAfterSeconds = $e->getRetryAfter(); echo "遇到 Delighted API 限流，等待 {$retryAfterSeconds} 秒后重试...n"; sleep($retryAfterSeconds); // 重新尝试获取，或者根据业务逻辑进行其他处理 continue; } catch (Exception $e) { // 处理其他可能的异常 echo "获取调查响应时发生错误: " . $e->getMessage() . "n"; break; } }
4. 添加调查响应
你也可以通过 API 添加调查响应，这对于从其他渠道获取的反馈数据非常有用。
<pre class="brush:php;toolbar:false;"><?php use DelightedSurveyResponse; // 假设 $person1->id 是之前创建的用户 ID // 添加一个仅有分数的调查响应 $survey_response1 = SurveyResponse::create(['person' => $person1->id, 'score' => 10]); echo "已为用户 {$person1->id} 添加分数 {$survey_response1->score} 的调查响应。n"; // 添加一个带有分数和评论的调查响应 $survey_response2 = SurveyResponse::create([ 'person' => $person1->id, 'score' => 5, 'comment' => 'Really nice experience.' ]); echo "已为用户 {$person1->id} 添加分数 {$survey_response2->score} 和评论 '{$survey_response2->comment}' 的调查响应。n";
5. 删除用户数据
在某些情况下，你可能需要删除用户的相关数据，例如 GDPR 合规性要求。
<pre class="brush:php;toolbar:false;"><?php use DelightedPerson; use DelightedSurveyRequest; // 根据用户 ID 删除用户及其所有数据 Person::delete(['id' => 42]); echo "用户 ID 42 及其所有数据已删除。n"; // 根据 email 地址删除用户及其所有数据 Person::delete(['email' => 'test@example.com']); echo "用户 test@example.com 及其所有数据已删除。n"; // 删除某个用户所有待处理（已调度但未发送）的调查请求 SurveyRequest::deletePending(['person_email' => 'ellie@example.com']); echo "用户 ellie@example.com 的所有待处理调查请求已删除。n";
总结与优势：为何选择 Delighted 客户端？
通过 delighted/delighted 和 Composer，我们彻底改变了客户反馈的集成方式。
- 官方支持，高度可靠： 作为 Delighted 官方提供的客户端，它确保了与最新 API 的兼容性，并且由官方维护，大大降低了集成风险。
- Composer 简化依赖管理： 告别手动下载、配置和版本冲突的烦恼，Composer 自动处理所有依赖，让你的项目结构清晰，易于维护。
- 封装底层 HTTP 请求： 你无需关心复杂的 HTTP 请求细节、认证机制或数据序列化。客户端已经将这些都封装好了，让你能够专注于业务逻辑。
- 内置错误处理机制： 尤其是在处理限流时，客户端提供了
RateLimitedException和getRetryAfter()方法，让你可以优雅地实现重试逻辑，确保数据传输的稳定性。 - 提升开发效率： 快速集成，减少了大量的重复造轮子工作，让开发者能够将宝贵的精力投入到更有价值的业务功能开发上。
实际应用中，我们通过自动化 Delighted 调查的发送和响应收集，不仅节省了大量人力，还确保了反馈数据的及时性和准确性。这些宝贵的客户洞察直接指导了我们的产品改进和客户服务优化，真正实现了数据驱动的决策。如果你也在为客户反馈的集成而烦恼，强烈推荐你尝试 delighted/delighted 客户端与 Composer 的组合，它将为你带来意想不到的便利和效率提升！