如何高效集成客户反馈？使用Composer与DelightedPHPAPI客户端轻松实现

碧海醫心

发布时间：2025-10-25 12:40:27

689人浏览过

来源于php中文网

原创

如何高效集成客户反馈？使用composer与delightedphpapi客户端轻松实现

可以通过一下地址学习composer：学习地址

告别繁琐：客户反馈集成难题与 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 安装命令：
```
composer install
```
Composer 会自动下载 delighted/delighted 包及其所有依赖，包括 Guzzle HTTP 客户端。这意味着你无需手动配置任何 HTTP 请求细节，Delighted 客户端已经为你封装好了一切。

iWebMall多用户商城系统
iWebMall 是一款高性能高扩展能力的开源 LAMP 电子商务软件，定位为大中型电子商务平台软件，服务于有建立电子商务需求的商业客户。这些商业客户不必学习任何计算机编程代码知识，只需要使用 iWebMall 软件他们就可以轻松建立一个功能强大的网上商城，实现用户注册、产品展示、在线定购、在线支付等电子商务功能；iWebMall 集成了产品发布与查询、会员注册登录、购物车、在线订单、在线支付、在

下载

配置与使用：Delighted 客户端的魔法

安装完成后，接下来就是配置和使用了。

1. 配置 API 密钥

在使用 Delighted 客户端的任何功能之前，你需要用你的 Delighted API 密钥进行配置。这个密钥可以在你的 Delighted 账户设置中找到，务必像对待密码一样妥善保管它。

2. 添加/更新用户并调度调查
Delighted 客户端最核心的功能之一就是添加或更新用户，并根据需求调度调查。你可以立即发送调查，设置延迟，甚至只是添加用户而不立即发送。
 '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 客户端非常贴心地提供了自动分页迭代器和限流异常处理机制，让你的代码更加健壮。
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 添加调查响应，这对于从其他渠道获取的反馈数据非常有用。
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 合规性要求。
 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 的组合，它将为你带来意想不到的便利和效率提升！