WhatsApp Business API MCP 工具

WhatsApp Business API MCP 工具按官方号码、business profile、联系人、分众、同意、team inbox、24 小时 session、template 审核、broadcast、互动按钮、自动回复、webhook、送达报告及 audit workflow 设计。

whatsapp.config.get

read

读取 WhatsApp Business API、Webhook、发送限额、24 小时时窗、template 及审批设定。

建议先读取

-

治理与审批

Read-only. No approval required.

安全说明

Do not expose Meta access tokens, webhook secrets, app secrets, or phone number private credentials.

whatsapp.phone_numbers.list

read

列出官方 WhatsApp 号码、显示名称、品质评分、发送层级及连线状态。

建议先读取

whatsapp.config.get

治理与审批

Read-only. No approval required.

安全说明

Hide verification details and provider identifiers unless admin role is present.

whatsapp.business_profile.get

read

读取商业档案、地址、网站、类别、简介、营业时间及官方认证状态。

建议先读取

whatsapp.phone_numbers.list

治理与审批

Read-only. No approval required.

安全说明

Do not expose account verification documents or Meta business manager secrets.

whatsapp.contacts.list

read

查询 WhatsApp 联络人、电话、标签、分众、同意、封锁及最近互动。

建议先读取

whatsapp.config.get

治理与审批

Read-only. No approval required.

安全说明

Mask phone and profile data according to customer-data permissions.

whatsapp.contact.get

read

读取单一联络人资料、对话、同意、订阅偏好、购买纪录及 CRM 连结。

建议先读取

whatsapp.contacts.list

治理与审批

Read-only. No approval required.

安全说明

Keep contact data tenant-scoped and channel-consent scoped.

whatsapp.segments.list

read

列出客户分组、条件、预估人数、排除名单及可用 template 类别。

建议先读取

whatsapp.contacts.list, whatsapp.consent_records.list

治理与审批

Read-only. No approval required.

安全说明

Segment counts must exclude opted-out, blocked, or invalid contacts.

whatsapp.consent_records.list

read

查询 WhatsApp 同意、退订、封锁、来源、时间及适用讯息类别。

建议先读取

whatsapp.contacts.list

治理与审批

Read-only. No approval required.

安全说明

Consent state is authoritative for broadcasts and must not be bypassed.

whatsapp.conversations.list

read

按状态、负责人、队列、最后讯息、未读、SLA 或 24 小时时窗查询对话。

建议先读取

whatsapp.contacts.list

治理与审批

Read-only. No approval required.

安全说明

Only return conversations available to the requester or assigned team.

whatsapp.conversation.get

read

读取对话讯息、附件、按钮回复、指派、CRM context、订单及处理纪录。

建议先读取

whatsapp.conversations.list

治理与审批

Read-only. No approval required.

安全说明

Mask private staff notes and attachment URLs unless authorized.

whatsapp.inbox_assignments.list

read

查询 team inbox 队列、负责人、分流规则、移交纪录及未处理对话。

建议先读取

whatsapp.conversations.list

治理与审批

Read-only. No approval required.

安全说明

Do not reveal conversations assigned to restricted queues.

whatsapp.templates.list

read

列出已核准、待审、被拒、停用及不同语言的 Meta 讯息范本。

建议先读取

whatsapp.config.get

治理与审批

Read-only. No approval required.

安全说明

Do not use unapproved templates for outbound business-initiated messages.

whatsapp.template.get

read

读取范本文字、变数、媒体、按钮、语言、类别、审核原因及品质状态。

建议先读取

whatsapp.templates.list

治理与审批

Read-only. No approval required.

安全说明

Show rejected reasons without exposing Meta internal tokens or reviewer data.

whatsapp.template_quality.get

read

读取 template 品质、封锁率、回报率、暂停风险及可发送限制。

建议先读取

whatsapp.template.get

治理与审批

Read-only. No approval required.

安全说明

Quality data should guide throttling and must not be edited by reads.

whatsapp.broadcasts.list

read

查询广播草稿、受众、template、排程、批核、发送状态及失败原因。

建议先读取

whatsapp.segments.list, whatsapp.templates.list

治理与审批

Read-only. No approval required.

安全说明

Audience counts must exclude opt-outs and contacts without required consent.

whatsapp.flows.list

read

读取 FAQ、自动回复、关键字、客户旅程、按钮节点及 fallback 流程。

建议先读取

whatsapp.config.get

治理与审批

Read-only. No approval required.

安全说明

Draft automation should not answer customers until enabled through approval.

whatsapp.keyword_rules.list

read

列出关键字、意图、回复内容、分流队列、触发条件及优先次序。

建议先读取

whatsapp.flows.list

治理与审批

Read-only. No approval required.

安全说明

Avoid exposing internal routing logic to customer-facing users.

whatsapp.webhook_logs.list

read

查询 inbound、status update、template review、delivery receipt webhook 纪录及错误。

建议先读取

whatsapp.config.get

治理与审批

Read-only. No approval required.

安全说明

Mask webhook payload PII and secrets; retain replay boundaries.

whatsapp.opt_outs.list

read

查询退订、封锁、STOP 字眼、投诉及不可发送名单。

建议先读取

whatsapp.consent_records.list

治理与审批

Read-only. No approval required.

安全说明

Suppression list must be enforced before any broadcast or campaign send.

whatsapp.media_assets.list

read

列出可用图片、文件、影片、template header media、尺寸及审核状态。

建议先读取

whatsapp.templates.list

治理与审批

Read-only. No approval required.

安全说明

Only return signed asset references and check Meta media policy.

whatsapp.message_delivery.list

read

查询讯息 sent、delivered、read、failed、reply、click 及错误代码。

建议先读取

whatsapp.broadcasts.list or whatsapp.conversation.get

治理与审批

Read-only. No approval required.

安全说明

Do not expose other customers' message state outside authorized reports.

whatsapp.conversation_summary.get

read

读取回复时间、SLA、未处理对话、分流量、解决率及员工工作量。

建议先读取

whatsapp.conversations.list, whatsapp.inbox_assignments.list

治理与审批

Read-only. No approval required.

安全说明

Aggregate staff metrics unless manager permission allows individual detail.

whatsapp.campaign_report.get

read

读取广播送达、读取、回复、按钮点击、转换、退订及成本摘要。

建议先读取

whatsapp.broadcasts.list, whatsapp.message_delivery.list

治理与审批

Read-only. No approval required.

安全说明

Respect attribution boundaries and avoid exposing individual behavior unnecessarily.

whatsapp.policy_rules.get

read

读取 Meta template 类别、同意、退订、24 小时时窗、频率及批核规则。

建议先读取

whatsapp.config.get

治理与审批

Read-only. No approval required.

安全说明

Policy rules must be treated as guardrails for every send and automation write.

whatsapp.audit_logs.list

read

读取联络人、同意、template、广播、对话、分流、自动化及 webhook audit log。

建议先读取

whatsapp.contact.get or whatsapp.broadcasts.list

治理与审批

Read-only. No approval required.

安全说明

Audit logs must be immutable and restricted to admin/compliance roles.

whatsapp.template_submit.preview

preview

预览 template 类别、文案、变数、按钮、媒体、语言及 Meta 审核风险。

建议先读取

whatsapp.template.get, whatsapp.policy_rules.get, whatsapp.media_assets.list

治理与审批

Approval required before submitting or resubmitting a Meta template.

安全说明

Detect prohibited claims, wrong category, missing variables, and policy mismatch.

whatsapp.broadcast.preview

preview

预览广播受众、同意、template、变数、排程、成本、频率及退订风险。

建议先读取

whatsapp.segments.list, whatsapp.consent_records.list, whatsapp.template.get, whatsapp.policy_rules.get

治理与审批

Human approval required before any bulk or campaign send.

安全说明

Exclude opt-outs, blocked numbers, invalid contacts, and unapproved templates.

whatsapp.session_message.preview

preview

预览 24 小时客服时窗内可发送内容、附件、按钮、收件人及 context。

建议先读取

whatsapp.conversation.get, whatsapp.policy_rules.get

治理与审批

Approval required for sensitive, payment, or policy-changing replies.

安全说明

Block free-form business-initiated sends outside the 24-hour session window.

whatsapp.automation_change.preview

preview

预览自动回复、关键字、分流、fallback、按钮及受影响对话流程。

建议先读取

whatsapp.flows.list, whatsapp.keyword_rules.list, whatsapp.policy_rules.get

治理与审批

Approval required before automation becomes live.

安全说明

Prevent loops, wrong queue routing, misleading replies, and unapproved template sends.

whatsapp.contact_import.preview

preview

预览汇入联络人去重、电话格式、同意来源、分众、退订排除及错误。

建议先读取

whatsapp.contacts.list, whatsapp.consent_records.list, whatsapp.opt_outs.list

治理与审批

Approval required before bulk contact import or consent update.

安全说明

Do not import contacts without traceable consent source.

whatsapp.order_payment_message.preview

preview

预览对话内开单、付款连结、产品资料、客户资料及发送讯息。

建议先读取

whatsapp.conversation.get, whatsapp.contact.get, whatsapp.session_message.preview

治理与审批

Approval required before creating order or sending payment link.

安全说明

Confirm customer identity and avoid exposing payment links to wrong conversations.

whatsapp.handover.preview

preview

预览对话指派、移交、队列、SLA、内部备注及通知影响。

建议先读取

whatsapp.conversation.get, whatsapp.inbox_assignments.list

治理与审批

Approval required for restricted queues or bulk reassignment.

安全说明

Do not expose private notes to customers and preserve handover history.

whatsapp.contact.upsert

write

建立或更新联络人、姓名、电话、CRM 连结、标签、语言及偏好。

建议先读取

whatsapp.contact.get or whatsapp.contacts.list

治理与审批

Approval required for sensitive identity or phone changes.

安全说明

Deduplicate by normalized phone and preserve consent history.

whatsapp.contact.import

write

批量汇入联络人、分众、标签及同意来源。

建议先读取

whatsapp.contact_import.preview

治理与审批

Approval required before bulk import.

安全说明

Reject rows without valid phone or traceable consent.

whatsapp.segment.upsert

write

建立或更新客户分众条件、排除规则、同步规则及用途。

建议先读取

whatsapp.segments.list, whatsapp.broadcast.preview

治理与审批

Approval required when segment affects active or scheduled broadcasts.

安全说明

Keep opt-outs excluded and prevent accidental all-customer targeting.

whatsapp.consent.update

write

更新同意、退订、封锁、来源、类别及时间戳。

建议先读取

whatsapp.consent_records.list, whatsapp.opt_outs.list

治理与审批

Approval required for bulk consent changes or opt-out reversal.

安全说明

Never override opt-out without verified customer action and audit record.

whatsapp.conversation.assign

write

指派、转交或重新分配对话到队列、团队或负责人。

建议先读取

whatsapp.handover.preview

治理与审批

Approval required for restricted queue transfers or bulk changes.

安全说明

Preserve handover history and do not notify customers with internal notes.

whatsapp.session_message.send

write

在 24 小时客服时窗内发送文字、附件、按钮或客服回复。

建议先读取

whatsapp.session_message.preview

治理与审批

Approval required for sensitive or payment-related replies.

安全说明

Block session messages outside active customer-care window unless template is used.

whatsapp.template_draft.upsert

write

建立或更新 template 草稿、变数、媒体、按钮、多语版本及类别。

建议先读取

whatsapp.template_submit.preview

治理与审批

Approval required before customer-facing use or Meta submission.

安全说明

Validate variables and category before storing submit-ready draft.

whatsapp.template.submit

write

提交 template 到 Meta 审核或重新提交修正版。

建议先读取

whatsapp.template_submit.preview

治理与审批

Explicit approval required before submission.

安全说明

Use preview as contract and store Meta review response in audit.

whatsapp.broadcast.create

write

建立广播草稿、受众、template、变数、排除名单及目标。

建议先读取

whatsapp.broadcast.preview

治理与审批

Approval required before scheduling or sending.

安全说明

Do not create executable broadcast without approved template and consent-filtered audience.

whatsapp.broadcast.schedule

write

安排已批核广播的发送时间、节流、批次及 fallback。

建议先读取

whatsapp.broadcast.preview, whatsapp.broadcasts.list

治理与审批

Human approval required before execution.

安全说明

Recheck template approval, quality rating, consent, and opt-out state before send.

whatsapp.flow.upsert

write

建立或更新 FAQ、自动回复、按钮流程、分流及 fallback。

建议先读取

whatsapp.automation_change.preview

治理与审批

Approval required before flow is active.

安全说明

Prevent loops, stale pricing, and policy-violating replies.

whatsapp.keyword_rule.upsert

write

建立或更新关键字、意图、回复、分流队列及优先次序。

建议先读取

whatsapp.automation_change.preview

治理与审批

Approval required before live routing or replies change.

安全说明

Avoid matching overly broad keywords that misroute customers.

whatsapp.auto_reply.enable

write

启用、停用或调整自动回复流程的生效范围及时间。

建议先读取

whatsapp.automation_change.preview

治理与审批

Approval required before activation or deactivation.

安全说明

Check fallback and human handover path before enabling.

whatsapp.conversation.close

write

关闭已处理对话,记录结果、标签、SLA 及 follow-up。

建议先读取

whatsapp.conversation.get

治理与审批

Approval required for complaint, payment, or escalation closures.

安全说明

Do not close unresolved or active escalation conversations without owner confirmation.

whatsapp.order.create_from_chat

write

由对话建立订单、客户、产品、数量、价格及备注。

建议先读取

whatsapp.order_payment_message.preview

治理与审批

Approval required before creating order from conversation.

安全说明

Confirm customer identity, product, price, and stock/source system before write.

whatsapp.payment_link.send

write

向对话发送已批核订单或发票付款连结。

建议先读取

whatsapp.order_payment_message.preview

治理与审批

Approval required before sending payment link.

安全说明

Use short-lived links and verify recipient conversation before send.

whatsapp.media_asset.upload

write

上载 template 或对话可用的图片、文件、影片及 metadata。

建议先读取

whatsapp.media_assets.list, whatsapp.template_submit.preview

治理与审批

Approval required before media is used in approved templates or broadcasts.

安全说明

Scan files and validate Meta media size/type policy.

whatsapp.tag.apply

write

为联络人或对话套用标签、分众讯号或 follow-up 状态。

建议先读取

whatsapp.contact.get, whatsapp.conversation.get

治理与审批

Approval required for bulk tags that affect campaigns or routing.

安全说明

Avoid tags that imply consent unless consent update is explicitly recorded.

whatsapp.webhook.retry

write

重试失败 webhook 处理,例如 inbound 讯息、送达状态或 template review。

建议先读取

whatsapp.webhook_logs.list

治理与审批

Approval required for bulk replay or state-changing webhook retry.

安全说明

Use idempotency keys and never replay already-applied customer actions.

whatsapp.action_request.status

status

查询 WhatsApp 写入、preview 或批核请求状态,不会重新执行动作。

建议先读取

whatsapp.audit_logs.list

治理与审批

Read-only status lookup. No approval required.

安全说明

Return status and audit references only; never replay sends, broadcasts, or webhook writes.