告别繁琐：客户反馈集成难题与 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中添加依赖：{ "require": { "delighted/delighted": "4.*" } }这里我们指定了
4.*版本，以确保兼容性和获取最新功能。 -
运行 Composer 安装命令：
Workflow Decomposer下载工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
composer install
Composer 会自动下载
delighted/delighted包及其所有依赖，包括 Guzzle HTTP 客户端。这意味着你无需手动配置任何 HTTP 请求细节，Delighted 客户端已经为你封装好了一切。
配置与使用：Delighted 客户端的魔法
安装完成后，接下来就是配置和使用了。
1. 配置 API 密钥
在使用 Delighted 客户端的任何功能之前，你需要用你的 Delighted API 密钥进行配置。这个密钥可以在你的 Delighted 账户设置中找到，务必像对待密码一样妥善保管它。
<?php
require 'vendor/autoload.php'; // 引入 Composer 自动加载文件
use Delighted\Client;
// 替换为你的实际 API 密钥
Client::setApiKey('YOUR_API_KEY');
// 你的应用程序逻辑开始
// ...2. 添加/更新用户并调度调查
Delighted 客户端最核心的功能之一就是添加或更新用户，并根据需求调度调查。你可以立即发送调查，设置延迟，甚至只是添加用户而不立即发送。
<?php
use Delighted\Person;
// 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 客户端非常贴心地提供了自动分页迭代器和限流异常处理机制，让你的代码更加健壮。
<?php
use Delighted\Person;
use Delighted\RateLimitedException;
use Delighted\SurveyResponse;
// 列出所有用户，并自动处理分页和限流
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 添加调查响应，这对于从其他渠道获取的反馈数据非常有用。
<?php
use Delighted\SurveyResponse;
// 假设 $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 合规性要求。
<?php use Delighted\Person; use Delighted\SurveyRequest; // 根据用户 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 的组合，它将为你带来意想不到的便利和效率提升！
