Community编程与开发github.com

guisa17/whatsapp-cloud-api-skill

Meta 的 WhatsApp Cloud API 的 Claude 技能 — 静默失败的配置错误、错误代码解码以及独立的诊断脚本。已针对 Graph API v26.0 验证。

whatsapp-cloud-api-skill 是什么?

该技能“guisa17/whatsapp-cloud-api-skill”是为 Claude 设计的专门技能,专注于 Meta 的 WhatsApp Cloud API。它解决了开发者在集成该 API 时遇到的常见痛点,尤其是那些导致静默失败的配置错误(例如权限不足、令牌过期或 Webhook 验证问题),这些错误往往难以排查。技能包含对 Graph API v26.0 的错误代码进行解码的详细映射,帮助快速定位问题。此外,它还提供了一个独立的诊断脚本,用于验证 API 端点、令牌和媒体上传等核心功能,从而在不依赖 Claude 的情况下也能进行故障排查。该技能在 Claude Code、Cursor 和 Cline 等 AI Agent 平台中均可使用,通过上下文增强的方式指导用户配置、调试和诊断 WhatsApp Cloud API,显著提升开发和维护效率。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add guisa17/whatsapp-cloud-api-skill

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

whatsapp-cloud-api-skill 是做什么的?

Claude 技能,用于 Meta 的 WhatsApp Cloud API — 静默失败的配置错误、错误代码解码以及独立的诊断脚本。已针对 Graph API v26.0 验证。

概述

本技能帮助开发者快速识别和解决 WhatsApp Cloud API 集成中的常见问题,特别是那些不易察觉的错误。

功能

  • 静默失败的配置错误:识别并解释那些不会抛出明显错误,但导致功能异常的配置问题。
  • 错误代码解码:提供 Graph API v26.0 错误代码的详细解码,包括错误原因和解决方法。
  • 独立诊断脚本:提供可独立运行的脚本,用于测试 API 端点、验证令牌、检查媒体上传等。

使用方法

在支持 Claude 技能的环境中(如 Claude Code、Cursor、Cline 等),您可以询问以下问题:

  • “WhatsApp Cloud API 中常见的静默失败配置有哪些?”
  • “错误代码 100 和 102 分别代表什么?”
  • “如何通过诊断脚本验证我的令牌是否有效?”

支持的平台

  • Claude Code
  • Cursor
  • Cline
  • 其他兼容 Claude API 的 AI 编程助手

版本兼容性

  • 已验证的 Graph API 版本:v26.0
  • 基于 Meta 官方文档进行验证。

示例

# 运行诊断脚本示例
./diagnose.sh --token YOUR_TOKEN --phone-id YOUR_PHONE_ID

注意事项

本技能不包含敏感信息或密钥。请自行保管好您的 API 令牌和电话号码 ID。

许可证

开源,具体许可证请参考仓库根目录。

相关技能