--- title: "Canal do WhatsApp pela API: criar, gerenciar e acompanhar (newsletter)" description: "Como criar e gerenciar um Canal do WhatsApp pela API não oficial: nome, descrição, foto, seguidores, mensagens, reações e transferência de dono." url: "https://wame.api.br/blog/canal-whatsapp-newsletter-api" language: "pt-BR" og:type: "article" published_time: "2026-09-28" modified_time: "2026-09-28" author: "Raphael Serafim" keywords: "api whatsapp não oficial, api não oficial whatsapp, canal do whatsapp api, whatsapp channels api, newsletter whatsapp api, criar canal whatsapp automatico, seguidores canal whatsapp" reading_time: "8 min de leitura" --- # Canal do WhatsApp pela API: criar, gerenciar e acompanhar (newsletter) > Como criar e gerenciar um Canal do WhatsApp pela API não oficial: nome, descrição, foto, seguidores, mensagens, reações e transferência de dono. **Sim, dá para criar e gerenciar um Canal do WhatsApp pela API: na API não oficial da WAME, `POST /{key}/newsletter` cria o canal, e endpoints próprios cuidam de nome, descrição, foto, contagem de seguidores, leitura das mensagens publicadas, reações e até transferência de dono.** Para quem administra canais de vários clientes, ou quer métricas do canal dentro do próprio sistema, isso tira do celular um trabalho que hoje é todo manual. Canais (tecnicamente, *newsletters*) são o formato de transmissão de um-para-muitos do WhatsApp: você publica, os seguidores acompanham na aba **Atualizações**. E têm uma característica que importa muito para quem leva a sério a saúde do número: **ninguém recebe publicação de canal sem ter escolhido seguir**. ## Canal x lista de transmissão x grupo Antes do código, vale entender onde o canal se encaixa: | | Canal | Lista de transmissão | Grupo | | --- | --- | --- | --- | | Quem decide receber | O seguidor | Você | Você ou o convite | | Onde aparece | Aba Atualizações | Chat privado | Chat do grupo | | Membros se veem | Não | Não | Sim | | Conversa de volta | Reações | Resposta no privado | Todos falam | | Escala | Alta | Limitada | Limitada (teto de membros) | A lista de transmissão é o formato que mais gera problema: é você quem escolhe quem recebe, e cada mensagem cai no chat privado da pessoa. Se ela não esperava, denuncia. O canal inverte a lógica — **o seguidor opta por acompanhar**. É comunicação um-para-muitos com opt-in embutido, e por isso é a alternativa natural para quem quer falar com muita gente sem flertar com spam. ## Por que gerenciar pela API O app do WhatsApp já permite criar um canal. A API entra quando: - **Você administra canais de vários clientes** (agência, software house) e quer criar, configurar e acompanhar todos a partir de um painel. - **Quer métricas no seu sistema**: seguidores por dia, reações por publicação, sem abrir o celular. - **Precisa padronizar**: nome, descrição e foto seguindo a identidade do cliente, aplicados por script. - **Quer integrar com outros sistemas**: o canal entra no mesmo fluxo em que o seu produto já cuida de WhatsApp, grupos e status. Tudo isso usa a [API não oficial](/blog/api-nao-oficial-whatsapp), que conecta o número como um aparelho e por isso enxerga recursos como canais, status e grupos. A camada não oficial não é afiliada nem endossada pelo WhatsApp ou pela Meta; o uso é de responsabilidade de quem opera o número. ## Criar o canal ```bash curl -X POST "https://server.wame.api.br/SUA_KEY/newsletter" \ -H "Content-Type: application/json" \ -d '{ "name": "Ofertas da Padaria Central", "description": "Pão quentinho, promoções do dia e novidades. Seguiu, ficou sabendo." }' ``` A resposta traz o identificador do canal, que você guarda para as próximas chamadas (o formato completo está na [documentação](/docs)). ## Consultar os dados do canal Os metadados podem ser buscados pelo JID do canal ou pelo código de convite: ```bash # Pelo JID do canal curl "https://server.wame.api.br/SUA_KEY/newsletter/metadata?type=jid&id=ID_DO_CANAL" # Pelo código do link de convite curl "https://server.wame.api.br/SUA_KEY/newsletter/metadata?type=invite&id=CODIGO_DO_CONVITE" ``` A busca por convite é útil também para canais que não são seus: dá para identificar um canal a partir do link que alguém compartilhou. ## Configurar nome, descrição e foto Cada atributo tem seu endpoint, o que facilita atualizar só o que mudou: ```bash # Nome curl -X PUT "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/name" \ -H "Content-Type: application/json" \ -d '{ "name": "Padaria Central — Ofertas" }' # Descrição curl -X PUT "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/description" \ -H "Content-Type: application/json" \ -d '{ "description": "Promoções do dia às 7h. Encomendas: fale no nosso WhatsApp." }' # Foto a partir de uma URL curl -X PUT "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/picture" \ -H "Content-Type: application/json" \ -d '{ "url": "https://seu-site.com/logo-canal.png" }' # Remover a foto curl -X DELETE "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/picture" ``` Um uso prático: descrição sazonal. Na Black Friday, o script troca a descrição e a foto do canal de todos os clientes da agência; na segunda-feira, volta ao normal. ## Acompanhar seguidores ```bash # Quantidade de seguidores curl "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/subscribers" # Quantidade de administradores curl "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/admins" ``` O WhatsApp mostra o número atual, mas não o histórico. Um job diário que grava a contagem resolve: ```js const BASE = 'https://server.wame.api.br/SUA_KEY'; async function registrarSeguidores(canalId) { const r = await fetch(`${BASE}/newsletter/${encodeURIComponent(canalId)}/subscribers`); const dados = await r.json(); // campo da contagem descrito em /docs await salvarMetrica(canalId, new Date(), dados); // seu banco } ``` Com isso você responde perguntas que o app não responde: quantos seguidores a campanha da semana trouxe, se o canal está crescendo ou estagnado, qual cliente da agência tem o canal mais ativo. ## Ler as publicações e reagir As mensagens do canal podem ser lidas com paginação: ```bash # As 50 mais recentes curl "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/messages?count=50" # Só as publicadas depois de um timestamp curl "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/messages?count=50&since=1759000000" # Só as que vieram depois de um id de servidor específico curl "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/messages?count=50&after=1234" ``` Isso serve para arquivar o conteúdo publicado, montar um relatório mensal ou espelhar as publicações no site. Para reagir a uma publicação (ou remover a reação, enviando sem `reaction`): ```bash curl -X POST "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/react" \ -H "Content-Type: application/json" \ -d '{ "serverId": "ID_DA_PUBLICACAO", "reaction": "🔥" }' ``` ## E publicar no canal? Os endpoints de newsletter listados na documentação cobrem criação, configuração, seguidores, leitura, reação, silenciar e administração. Se você pretende **automatizar a publicação** (por exemplo, postar a oferta do dia às 7h), confira na [documentação](/docs) como o envio para o identificador do canal funciona na versão atual da API antes de construir o fluxo. Enquanto isso, o conteúdo pode continuar sendo publicado pelo app, e a API cuida de todo o resto. Se o objetivo é aparecer para os contatos de forma visual e efêmera, o status também tem API — veja [como postar status no WhatsApp pela API](/blog/postar-status-whatsapp-api). ## Seguir, silenciar e administrar A instância também pode acompanhar canais de terceiros — útil para monitorar concorrentes ou fontes de notícia do setor: ```bash curl -X POST "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/follow" curl -X POST "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/mute" curl -X POST "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/unfollow" ``` E há as operações administrativas, que merecem cuidado: ```bash # Remover um administrador curl -X PUT "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/demote" \ -H "Content-Type: application/json" \ -d '{ "userJid": "5511999999999@s.whatsapp.net" }' # Transferir a propriedade — IRREVERSÍVEL curl -X PUT "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL/owner" \ -H "Content-Type: application/json" \ -d '{ "newOwnerJid": "5511999999999@s.whatsapp.net" }' # Apagar o canal e todas as publicações — IRREVERSÍVEL curl -X DELETE "https://server.wame.api.br/SUA_KEY/newsletter/ID_DO_CANAL" ``` A transferência de dono é o caminho para a agência que cria o canal no próprio número e depois entrega ao cliente. Coloque uma confirmação dupla no seu painel antes de chamar esses dois últimos endpoints. ## Canal como estratégia anti-spam Vale insistir neste ponto porque ele muda o jogo para quem precisa falar com muita gente. A WAME não apoia spam — nem disparo para quem não pediu, nem lista comprada. E o canal é a resposta estrutural a isso: em vez de mandar a mesma mensagem para milhares de chats privados, você publica uma vez para quem **escolheu** seguir. Um fluxo saudável combina os formatos: 1. O cliente conversa com você no privado (atendimento, pedido). 2. Ao final, recebe o convite para seguir o canal de novidades. 3. As novidades vão pelo canal; o privado fica para o que é individual. Com isso, o volume de mensagens privadas cai, cada conversa privada é esperada e o número fica mais saudável — o que, somado à camada de proteção da WAME por trás de cada instância, mantém a taxa de bloqueio muito baixa para quem usa do jeito certo. ## Conclusão O Canal do WhatsApp é o formato de transmissão com opt-in embutido: só vê quem escolheu seguir. Com a API não oficial da WAME você cria o canal com `POST /{key}/newsletter`, configura nome, descrição e foto, registra seguidores ao longo do tempo, lê e reage às publicações e administra donos e admins — tudo pelo seu sistema, para um ou para centenas de clientes. Para quem quer falar com muita gente sem transformar o WhatsApp em spam, o canal é o caminho mais limpo. Os detalhes de cada endpoint estão na [documentação](/docs). ## Perguntas frequentes ### Dá para criar um Canal do WhatsApp pela API? Sim. Na API não oficial da WAME, POST /{key}/newsletter com name e description cria o canal. Depois você gerencia nome, descrição e foto, consulta seguidores, lê as mensagens publicadas e reage a elas por endpoints próprios de newsletter. ### Qual a diferença entre Canal do WhatsApp e lista de transmissão? Na lista de transmissão você escolhe quem recebe, e a mensagem cai no chat privado da pessoa. No Canal, a pessoa escolhe seguir e vê as publicações na aba Atualizações. Como o seguidor optou por acompanhar, o canal é o formato naturalmente alinhado a comunicação sem spam. ### Consigo ver quantos seguidores meu canal tem pela API? Sim. GET /{key}/newsletter/{id}/subscribers retorna a contagem de seguidores e GET /{key}/newsletter/{id}/admins a de administradores. Dá para registrar esse número todo dia e acompanhar o crescimento do canal no seu próprio painel. ### A API oficial do WhatsApp gerencia canais? Os Canais do WhatsApp são gerenciados pela camada não oficial, que conecta o número como um aparelho. A camada não oficial não é afiliada ao WhatsApp nem à Meta, e o uso é de responsabilidade de quem opera o número. ### Transferir a propriedade do canal pode ser desfeito? Não. PUT /{key}/newsletter/{id}/owner com newOwnerJid transfere a propriedade de forma irreversível. Use apenas quando tiver certeza, por exemplo ao entregar o canal para o número definitivo do cliente.