创建 WhatsApp 会话（二维码 / 配对码登录）

查看全部 WhatsApp 消息 API API →

开始登录你的 WhatsApp 账号并获取后续所有接口都要用到的 sessionId。共有两种登录方式，任选其一、发送对应的 JSON 请求体，然后轮询“获取会话状态”直到 status 为 CONNECTED。 二维码登录（推荐）。请求体：{"mode":"qr","deviceName":"My Bot"}。状态响应会返回可扫描的 qrImage（base64 data-URI）和可实时查看进度的 qrPageUrl。在手机上：WhatsApp → 设置 → 已链接的设备 → 链接设备，然后扫码。 配对码登录。请求体：{"mode":"pairing","phoneNumber":"8613800138000","deviceName":"My Bot"}。phoneNumber 为完整国际号码，仅数字，不含 + 号和空格。状态响应随后会返回一个 8 位 pairingCode。在手机上：WhatsApp → 设置 → 已链接的设备 → 链接设备 → 改用电话号码关联，然后输入该配对码。 连接成功后，sessionId 会变成由设备生成的稳定 ID，可在重启后复用。deviceName 用于设置在 WhatsApp“已链接设备”中显示的名称。

API 功能

二维码或配对码登录 扫码或在手机输入配对码即可绑定账号，无需冗长审批
实时登录状态 轮询会话即可获取二维码图片或配对码，并观察状态变为 CONNECTED
稳定可复用的 sessionId 连接成功后 ID 变为设备生成的确定性 ID，重启后仍可复用，并用于鉴权所有接口
自定义设备名 deviceName 控制 WhatsApp“已链接设备”中显示的名称，便于审计

在线 API 演示

POST /api/project/whatsapp-messaging/create-session

API Response (JSON)

{}
📢
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
联系我们

使用场景

查看订阅方案 →