用途
该技能用于面向以色列市场的 WhatsApp Business API 集成,覆盖希伯来语消息模板、客户沟通与 CRM 集成。技能首先要求判断用户是否真的需要 WhatsApp Business Platform(Cloud API):多数以色列小企业只需要免费 WhatsApp Business 应用(商品目录、快捷回复、标签、手动聊天),此时其余步骤属于多余开销。仅在需要自动化、规模化模板、CRM 同步或 webhook 时才应转向 Platform。
主要能力
- 验证 WhatsApp Business 设置:Meta Business Account、WABA、带以色列区号 +972 的注册号码(官方 Cloud API 或 BSP),以及具有 whatsapp_business_messaging 权限的 System User Access Token(模板操作还需 whatsapp_business_management)。
- 创建希伯来语消息模板,支持 UTILITY、AUTHENTICATION、MARKETING 分类,包含 BODY 与 BUTTONS 组件及示例变量。
- 发送模板消息,脚本 scripts/send_whatsapp.py 支持 --mode template|text|interactive|list 四种模式,含以色列号码校验与 --dry-run。
- 号码预热、质量评级维护,以及消息限额(250 / 2,000 / 10,000 / 100,000 / 无限)说明。
- 以色列合规指引:第 30א 条(חוק הספאם)、广告消息必含内容、在售客户列表使用条件、退订操作。
使用方式
- 判断是否需要 Platform。若号码已在 WhatsApp Business 应用上,Embedded Signup 可在继续使用应用的同时接入 Platform,并保持消息历史同步;需先确认 BSP 的注册流程支持该能力。Platform 访问需要 business portfolio、WABA 与 system user token。
- 验证设置,可调用示例代码 verify_whatsapp_setup(GET https://graph.facebook.com/v26.0/{phone_number_id})。
- 创建模板。希伯来语语言代码为 he(不是 he_IL);模板名须为小写 ASCII 加下划线;同一名称每种语言一个版本;RTL 正文不要以变量开头。示例模板 appointment_reminder_he 使用 UTILITY 分类,含两个快捷回复按钮“מאשר”“צריך לשנות”。
- 发送消息。to 字段格式为 972541234567(无前导 + 与前导 0)。
- 号码预热:第 1-7 天仅发送 UTILITY 模板给主动预期的已同意客户;第 7-14 天引入小批量营销(50-200 人,仅限 30 天内同意者);第 14-30 天逐步扩量,质量评分下降立即停止。
适用场景
- 电商订单确认、物流更新、支付回执、预约提醒(UTILITY)。
- OTP 与验证码(AUTHENTICATION,始终按条计费)。
- 促销、优惠、节日活动、再营销(MARKETING,通常最贵档)。
- Click-to-WhatsApp(CTWA)广告触发的 72 小时免费入口窗口,常见于以色列获客模式。
限制与合规
- 计费:自 2025 年 7 月 1 日起按模板消息计费;非模板服务消息自 2026 年 10 月 1 日起计费,每个业务号码每月 1,000 条免费服务消息。资料注明 2026 年 10 月 1 日前 24 小时客户服务窗口内的非模板消息与响应用户的 UTILITY 模板免费,之后变为计费。定价可能仅在季度首日调整(1 月 1 日、4 月 1 日、7 月 1 日、10 月 1 日)。具体以色列费率暂未提供,需查 Meta 定价页按国家代码 972 查询,不得硬编码。
- 限额:消息限额设在 business portfolio 层级,由该 portfolio 下所有号码共享;迁移活动到新号码不会重置限额。限额指在滚动 24 小时内可向唯一用户发送、且发生在客户服务窗口之外的消息数。
- 质量:质量评级过低会阻止限额提升、暂停相关模板,甚至限制该号码发送(error 131048)。
- 合规:以色列商业消息受《通信法》(Bezeq 与广播)第 30א 条约束;WhatsApp 未在法条中列名,覆盖范围为推定适用,应假定受监管并全面合规。广告消息需以显著清晰方式标明广告主名称、地址与联系方式,以及收件人拒绝继续接收广告的权利与操作方式。在售客户列表使用需同时满足:购买或洽谈中提供联系方式、已被告知将用于广告、有简单合理的拒绝机会且未拒绝、广告内容与所购或洽谈商品服务同类(第 4 项常被忽略)。
- 其他:Meta Business Verification 是以色列企业常见卡点;新 portfolio 默认限额 250,验证企业是提升至 2,000 的最快路径。活跃的 BSP 包括 360dialog、MessageBird/Bird、Twilio、Infobip、Vonage、Gupshup、AiSensy、Sinch;选择前需走 references/bsp-selection.md 的五个问题。更多细节见 references/platform-2026.md、references/template-rejections.md、references/interactive-list.md。