把 WhatsApp 变成 API：7WaPilot Skills 开发接入完整教程（含示例代码）

很多团队已经有了自己的 CRM、ERP 或内部管理系统，但 WhatsApp 数据被困在手机或第三方工具里，无法与现有系统打通。7WaPilot 的 OpenAPI Skills 提供了一套完整的 RESTful 接口，让你可以把 WhatsApp 变成可调用的 API。本文面向开发者，从零开始讲解接入流程。

前置条件

一个 7WaPilot 账号（注册免费）
至少一个已绑定的 WhatsApp 设备
基础的 HTTP/REST API 调用知识

第一步：获取 API Secret

安全提示：API Secret 是账号级别的凭证，可以访问你名下所有设备和数据。不要在客户端代码中暴露 Secret，建议通过后端代理调用。

第二步：基础调用示例

Base URL 和鉴权

Base URL: https://api.7wapilot.com/7wa
Header: X-Api-Secret: sk_your_secret_here

Python 示例

import requests

BASE_URL = "https://api.7wapilot.com/7wa"
API_SECRET = "sk_your_secret_here"

headers = {"X-Api-Secret": API_SECRET}

# 获取 Channel 信息
r = requests.get(f"{BASE_URL}/v1/open/channel", headers=headers)
print(r.json())

# 获取会话列表
r = requests.get(
    f"{BASE_URL}/v1/open/chats?pageFrom=1&pageSize=20",
    headers=headers
)
print(r.json())

# 发送消息
r = requests.post(
    f"{BASE_URL}/v1/open/messages/send",
    headers=headers,
    json={
        "channelId": "your_channel_id",
        "chatId": "86138xxxxxxx@s.whatsapp.net",
        "body": "你好，这是我们最新季度的产品报价表"
    }
)
print(r.json())

JavaScript / Node.js 示例

const BASE_URL = 'https://api.7wapilot.com/7wa';
const API_SECRET = 'sk_your_secret_here';

const headers = {
  'X-Api-Secret': API_SECRET,
  'Content-Type': 'application/json',
};

// 搜索客户画像
async function searchProfiles() {
  const res = await fetch(
    `${BASE_URL}/v1/open/customer-profiles/search?pageFrom=1&pageSize=15`,
    { headers }
  );
  return await res.json();
}

// 添加客户备注
async function addNote(profileId, note) {
  const res = await fetch(
    `${BASE_URL}/v1/open/customer-profiles/manual-note`,
    {
      method: 'POST',
      headers,
      body: JSON.stringify({ customerProfileId: profileId, note }),
    }
  );
  return await res.json();
}

核心接口速查

基础数据接口

接口	方法	说明
/v1/open/channel	GET	获取 Channel 信息
/v1/open/chats	GET	会话列表（支持 type/like 筛选）
/v1/open/messages	GET	聊天记录（支持 keyword/type 筛选）
/v1/open/messages/send	POST	发送消息

智能体管理接口

接口	方法	说明
/v1/open/ai-agents/search	GET	搜索聊天智能体
/v1/open/ai-agents/status	POST	更新智能体状态（active/paused）
/v1/open/customer-profiles/search	GET	搜索客户画像
/v1/open/customer-profiles/manual-note	POST	添加客户备注

频率限制

所有 Skills 接口统一限制为 每秒最多 1 次请求。超出频率会返回 429 Too Many Requests。建议客户端实现简单的重试退避机制。

Chat ID 格式

# 个人聊天
{phone}@s.whatsapp.net
例：8613800138000@s.whatsapp.net

# 群聊
{group_id}@g.us
例：120363028789123456@g.us

接入 Claude Code / Cursor

如果你想让 AI 开发工具直接调用这些接口，不需要手写代码。7WaPilot 提供了结构化的 Skills 文本，可以直接粘贴到 CLAUDE.md 或 .cursorrules 中：

进入 7WaPilot 的 AI Agent Skills 页面
点击「复制 Skills」按钮
粘贴到你的 AI 工具配置文件中
直接对话操作，AI 会自动选择合适的接口

详细步骤可以参考我们的 Claude Code 接入指南和 Cursor 接入指南。

常见问题

WhatsApp API 怎么用？

先在 7WaPilot 平台生成 API Secret，然后在请求 Header 中携带 X-Api-Secret 调用接口。支持查询 Channel、会话、消息、客户画像等操作。

WhatsApp Business API 申请流程复杂吗？

通过 7WaPilot 无需申请 Business API，直接扫码连接个人 WhatsApp 即可使用 API 功能，5 分钟完成接入。

WhatsApp Web API 接入教程适合初学者吗？

适合。本文提供完整的 Python 和 JavaScript 示例代码，从生成 Secret 到调用接口，零基础也能跟着步骤完成接入。

开始把 WhatsApp 接入你的系统

生成 API Secret →