如何在PHP应用中高效集成Crisp聊天API？使用Composer和CrispPHPWrapper可以轻松实现！-composer-PHP中文网

如何在PHP应用中高效集成Crisp聊天API？使用Composer和CrispPHPWrapper可以轻松实现！

心靈之曲

发布： 2025-10-26 13:25:00

原创

894人浏览过

如何在php应用中高效集成crisp聊天api？使用composer和crispphpwrapper可以轻松实现！

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

告别繁琐：Crisp API集成中的那些痛点

想象一下这样的场景：你正在构建一个PHP驱动的电商平台，希望在用户遇到问题时，能够通过Crisp聊天系统快速响应。你需要实现以下功能：

自动创建对话：当用户在特定页面提交表单时，自动在Crisp中为他们创建一个新的对话。
发送系统消息：根据用户行为，向对话中发送自动化通知，例如订单状态更新。
获取对话历史：将Crisp中的对话记录同步到你的CRM系统。
更新用户信息：当用户在你的平台更新个人资料时，Crisp中的客户信息也随之更新。

面对这些需求，如果选择直接与Crisp的RESTful API交互，你将不得不面对一系列挑战：

手动HTTP请求：你需要使用cURL或Guzzle等HTTP客户端，手动构建每个API请求，包括设置请求头、请求体、HTTP方法等。
认证管理：API认证通常需要一个identifier和key。你需要安全地存储这些凭证，并在每次请求时正确地附带它们。
数据解析：API响应通常是JSON格式，你需要手动解析这些JSON数据，并将其转换为PHP对象或数组。
错误处理：API调用可能失败，你需要编写大量的代码来捕获和处理各种HTTP状态码和API错误信息。
代码冗余与维护：随着API集成点的增多，会产生大量重复的HTTP请求和数据处理逻辑，使得代码难以维护和扩展。

这些问题不仅降低了开发效率，也增加了项目后期的维护成本。有没有一种更“PHPic”的方式来解决这个问题呢？

救星登场：Composer 与 Crisp PHP Wrapper

答案是肯定的！得益于Composer这一PHP包管理器的强大功能，以及Crisp官方提供的crispchat/php-crisp-api PHP封装库，我们可以彻底告别上述烦恼。

立即学习“PHP免费学习笔记（深入）”；

Composer：PHP项目的依赖管理利器

Composer是PHP生态系统中不可或缺的工具，它让依赖管理变得前所未有的简单。通过一个composer.json文件，你可以声明项目所需的所有第三方库，Composer会负责下载、安装并自动加载它们。这意味着你不再需要手动下载库文件，也不用担心类名冲突。

crispchat/php-crisp-api：Crisp API的PHP化身

crispchat/php-crisp-api是Crisp官方为PHP开发者提供的API封装库。它将复杂的RESTful API调用抽象成简单易懂的PHP方法和对象。这个库的出现，极大地简化了Crisp API的集成过程，让你能够专注于业务逻辑，而不是底层的API通信细节。

如何使用Composer集成Crisp API？

整个过程简单直观，只需几步：

第一步：安装 crispchat/php-crisp-api

在你的PHP项目根目录下，打开终端，运行Composer命令：

<code class="bash">composer require crispchat/php-crisp-api</code>

登录后复制

Composer会自动下载并安装该库及其所有依赖项。

第二步：引入自动加载文件

在你的PHP脚本中，确保引入Composer生成的自动加载文件：

DeepBrain

AI视频生成工具，ChatGPT +生成式视频AI =你可以制作伟大的视频!

108

查看详情

<code class="php">require __DIR__ . '/vendor/autoload.php';</code>

登录后复制

这是使用任何Composer安装的库的通用做法。

第三步：获取Crisp API认证凭证

你需要从Crisp后台获取你的API认证令牌密钥对（identifier 和 key）。通常，这在Crisp的“插件”或“API设置”部分可以找到。请务必妥善保管这些凭证，不要将其暴露在公共仓库中！

第四步：初始化客户端并进行认证

使用你获取到的凭证初始化CrispClient对象，并进行认证。通常，你将使用plugin层级的认证。

<pre class="brush:php;toolbar:false;">use Crisp\CrispClient;

$CrispClient = new CrispClient;

// 设置认证层级为 'plugin'
$CrispClient->setTier("plugin");

// 使用你的 identifier 和 key 进行认证
// 示例：$CrispClient->authenticate("YOUR_IDENTIFIER", "YOUR_KEY");
$CrispClient->authenticate("YOUR_IDENTIFIER", "YOUR_KEY");

// 现在，$CrispClient 已经认证成功，可以开始调用API了！

登录后复制

第五步：调用Crisp API方法

现在，你可以通过$CrispClient对象轻松调用Crisp的各种API方法，例如：

1. 获取网站对话列表

<pre class="brush:php;toolbar:false;">// 假设你的 websiteId 是 "8c842203-7ed8-4e29-a608-7cf78a7d2fcc"
// 获取第一页的对话列表
$websiteId = "YOUR_WEBSITE_ID"; // 替换为你的网站ID
$conversations = $CrispClient->websiteConversations->getList($websiteId, 1);

echo "网站ID {$websiteId} 的对话列表:\n";
print_r($conversations);

登录后复制

2. 在对话中发送消息

<pre class="brush:php;toolbar:false;">$sessionId = "YOUR_SESSION_ID"; // 替换为目标对话的Session ID

$message = [
  "type" => "text",
  "from" => "operator", // 消息发送者，可以是 'operator' 或 'user'
  "origin" => "chat",
  "content" => "你好！我是您的自动化助手，有什么可以帮助您的吗？"
];

$CrispClient->websiteConversations->sendMessage($websiteId, $sessionId, $message);
echo "消息已发送到会话 {$sessionId}。\n";

登录后复制

3. 更新用户（People）资料

<pre class="brush:php;toolbar:false;">$peopleId = "YOUR_PEOPLE_ID_OR_EMAIL"; // 替换为用户ID或邮箱

$params = [
  "email" => "john.doe@example.com",
  "person" => [
    "nickname" => "John Doe (Updated)",
    "data" => [
        "source" => "my_php_app",
        "last_activity" => time()
    ]
  ],
  "segments" => [
    "vip_customer",
    "active_user"
  ]
];

$CrispClient->websitePeople->updatePeopleProfile($websiteId, $peopleId, $params);
echo "用户 {$peopleId} 的资料已更新。\n";

登录后复制