使用 WhatsApp API PHP SDK 优化您的 WhatsApp 机器人开发

2024-12-23

使用 WhatsApp API PHP SDK 优化您的 WhatsApp 机器人开发

使用 whatsapp api php sdk 优化您的 whatsapp 机器人开发

释放 WhatsApp API 的全部潜能：whapi.cloud PHP SDK 助力您的机器人开发

whapi.cloud 的 PHP SDK 是一个全面的工具包，旨在简化 WhatsApp 机器人开发，实现高效的消息传递流程自动化。无论您是发送消息、管理群组还是构建复杂的客户互动，此 SDK 都能帮助您轻松创建强大且可扩展的解决方案。

选择 whapi.cloud PHP SDK 的理由

无需号码迁移: 使用您现有的号码，无需迁移到新号码。
轻松集成: 通过二维码快速连接您的号码，方便测试。
便捷的 Webhook 设置: 只需几步即可配置 Webhook，实现实时消息传递。
功能全面: 支持发送和接收文本、媒体、文件、位置、投票等，涵盖个人和群组聊天。

快速入门

1. 获取 API 令牌

注册并登录 whapi.cloud 控制面板，授权您的号码并生成 API 令牌。此令牌是使用 SDK 的关键。

2. 下载 SDK

从官方 GitHub 仓库下载 PHP SDK：下载链接

3. 安装 SDK

使用 Composer 进行依赖管理，简化安装过程：

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

composer require whapi-cloud/whatsapp-api-sdk-php

登录后复制

集成设置

初始化客户端

使用您的 API 令牌初始化客户端，验证您的 API 请求：

use openapiclientpiMessagesAPI;
use openapiclientConfiguration;

// 初始化客户端
$config = openapiclientConfiguration::getDefaultConfiguration()
    ->setApiKey('token', "your_token")
    ->setAccessToken("your_token");

$apiInstance = new openapiclientpiMessagesAPI(
    new GuzzleHttpClient(),
    $config
);

登录后复制

消息传递 API：核心功能与示例

发送短信

轻松发送短信，并可设置可选参数，如打字模拟或短暂可见性：

$senderText = new openapiclientmodelSenderText();
$senderText->setTo('13016789891'); // 包含国家代码
$senderText->setBody('您的消息内容'); // 消息内容
$senderText->setEphemeral(3600); // 消息可见时间
$senderText->setTypingTime(5.0); // 打字模拟时长

$result = $apiInstance->sendMessageText($senderText);
print_r($result);

登录后复制

使用 Webhook 接收消息

Webhook 提供实时消息更新，确保您的机器人始终保持最新状态。

检索多条消息

使用以下示例检索多条消息：

$count = 100;
$offset = 0;
$result = $apiInstance->getMessages($count, $offset);
print_r($result);

登录后复制

检索单条消息

使用以下示例通过 ID 获取特定消息：

$messageId = "your_message_id";
$result = $apiInstance->getMessage($messageId);
print_r($result);

登录后复制

更多 Webhook 设置信息，请参考 Webhook 指南。

WhatsApp 群组 API：自动化群组管理

whapi.cloud 的群组 API 简化了 WhatsApp 群组的管理，实现任务自动化，节省时间和精力。

群组管理核心功能

创建、更新或删除群组: 以编程方式管理 WhatsApp 群组。
成员管理: 灵活地添加、删除或阻止成员。
自定义群组设置: 轻松调整群组名称、头像和权限。
生成邀请链接: 快速创建和共享群组邀请链接。

示例：创建群组

以下示例演示如何使用 API 创建新的 WhatsApp 群组：

$createGroupRequest = [
    "subject" => "群组名称",
    "participants" => [
        "13016789891",
        "13016789892"
    ]
];

$result = $apiInstance->createGroup($createGroupRequest);
print_r($result);

登录后复制

最佳实践与注意事项

电话号码使用

使用 whapi.cloud API 时，请遵循以下电话号码处理最佳实践：

始终包含国家/地区代码: 例如，“+13016789891”表示美国号码。
避免特殊字符和空格: 电话号码应为连续的数字字符串。

媒体文件要求

确保您的媒体文件符合以下标准：

可公开访问的 URL: 所有媒体文件必须托管在无需身份验证即可访问的 URL 上。
支持的格式: 支持 JPEG、PNG 等常见图像格式以及其他标准文件类型。

消息传递优化

为了提升用户体验，请考虑使用以下选项：

临时消息: 设置消息在特定时间后消失，增强隐私性。
打字模拟: 模拟打字指示器，提供更自然的用户互动。

选择 whapi.cloud 的理由

whapi.cloud 提供强大且易用的 WhatsApp API 网关，旨在简化开发人员的集成过程。其优势在于：

全面的群组管理: 轻松创建、管理和自动化 WhatsApp 群组、社区和频道。
丰富的交互式消息传递功能: 支持按钮、媒体共享、投票和表情反应等，增强互动性。
可靠的技术支持: 获得专业团队的快速且专业的帮助，确保您的开发顺利进行。

立即开始

使用 whapi.cloud PHP SDK 开始构建强大的 WhatsApp 自动化解决方案。