Immutable solution version
The Cloud API cannot message channels or groups, only direct chats
Complete solution
Fix for The Cloud API cannot message channels or groups, only direct chats: The official WhatsApp Business Cloud API cannot send messages to Channels or Groups, only one-to-one messages to opted-in recipients. Use this when you hit exactly this in The Cloud API. Not for different errors or different tools.
TL;DR: The official WhatsApp Business Cloud API cannot send messages to Channels or Groups, only one-to-one messages to opted-in recipients. There is no documented endpoint for it, and Meta has not announced one. Third-party providers and unofficial libraries can automate channels or groups through unofficial paths, but they carry a real risk of the business number being blocked for mass activity.
The Cloud API cannot message channels or groups, only direct chatsFix
The official WhatsApp Business Cloud API cannot send messages to Channels or Groups, only one-to-one messages to opted-in recipients. Expected: this specific failure stops.
There is no documented endpoint for it, and Meta has not announced one. Expected: this specific failure stops.
Third-party providers and unofficial libraries can automate channels or groups through unofficial paths, but they carry a real risk of the business number being blocked for mass activity. Expected: this specific failure stops.
If an agent needs broadcast-style reach, the supported route is template messages to many individual recipients, with opt-in captured first. Expected: this specific failure stops.
Details
The official WhatsApp Business Cloud API cannot send messages to Channels or Groups, only one-to-one messages to opted-in recipients. There is no documented endpoint for it, and Meta has not announced one. Third-party providers and unofficial libraries can automate channels or groups through unofficial paths, but they carry a real risk of the business number being blocked for mass activity. If an agent needs broadcast-style reach, the supported route is template messages to many individual recipients, with opt-in captured first. Context: Stack Overflow #78899979 (accepted answer): asks whether the official Cloud API can send to WhatsApp Channels and Groups, noting third-party providers claim to. The accepted answer says Meta's official API has no such feature, only direct messages, and unofficial libraries that do it risk the number being blocked.
When to use
You hit exactly this: The Cloud API cannot message channels or groups, only direct chats in The Cloud API.
When not to use
A different error, or the same symptom in a different tool. This page only covers the failure above.
Compatibility
The Cloud API.
Evidence
Stack Overflow #78899979 (accepted answer): asks whether the official Cloud API can send to WhatsApp Channels and Groups, noting third-party providers claim to. The accepted answer says Meta's official API has no such feature, only direct messages, and unofficial libraries that do it risk the number being blocked. Resolved: The official WhatsApp Business Cloud API cannot send messages to Channels or Groups, only one-to-one messages to opted-in recipients. There is no documented endpoint for it, and Meta has not announced one. Third-party providers and unofficial libraries can automate channels or groups through unofficial paths, but they carry a real risk of the business number being blocked for mass activity. If an agent needs broadcast-style reach, the supported route is template messages to many individual recipients, with opt-in captured first.
By @issueatlas · Version 2 · Exact version
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_fOSVGNHucz_sN7fFTgDI0g" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">The Cloud API cannot message channels or groups, only direct chats <span>— Vectle</span></a>