--- title: "Canal do WhatsApp pela API: criar e gerenciar" 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://api-wa.me/blog/canal-whatsapp-newsletter-api" language: "pt-BR" og:type: "article" og:site_name: "WAME API" --- [Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Canal do WhatsApp pela API: criar, gerenciar e acompanhar (newsletter) Raphael Serafim· Publicado em 28 de setembro de 2026· 8 min de leitura Compartilhar # 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. Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/canal-whatsapp-newsletter-api.md) **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](https://api-wa.me/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 Copiar ``` curl -X POST "https://us.api-wa.me/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](https://api-wa.me/docs)). ## Consultar os dados do canal Os metadados podem ser buscados pelo JID do canal ou pelo código de convite: bash Copiar ``` # Pelo JID do canal curl "https://us.api-wa.me/SUA_KEY/newsletter/metadata?type=jid&id=ID_DO_CANAL" # Pelo código do link de convite curl "https://us.api-wa.me/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 Copiar ``` # Nome curl -X PUT "https://us.api-wa.me/SUA_KEY/newsletter/ID_DO_CANAL/name" \ -H "Content-Type: application/json" \ -d '{ "name": "Padaria Central — Ofertas" }' # Descrição curl -X PUT "https://us.api-wa.me/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://us.api-wa.me/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://us.api-wa.me/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 Copiar ``` # Quantidade de seguidores curl "https://us.api-wa.me/SUA_KEY/newsletter/ID_DO_CANAL/subscribers" # Quantidade de administradores curl "https://us.api-wa.me/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: javascript Copiar ``` const BASE = 'https://us.api-wa.me/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 Copiar ``` # As 50 mais recentes curl "https://us.api-wa.me/SUA_KEY/newsletter/ID_DO_CANAL/messages?count=50" # Só as publicadas depois de um timestamp curl "https://us.api-wa.me/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://us.api-wa.me/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 Copiar ``` curl -X POST "https://us.api-wa.me/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](https://api-wa.me/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](https://api-wa.me/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 Copiar ``` curl -X POST "https://us.api-wa.me/SUA_KEY/newsletter/ID_DO_CANAL/follow" curl -X POST "https://us.api-wa.me/SUA_KEY/newsletter/ID_DO_CANAL/mute" curl -X POST "https://us.api-wa.me/SUA_KEY/newsletter/ID_DO_CANAL/unfollow" ``` E há as operações administrativas, que merecem cuidado: bash Copiar ``` # Remover um administrador curl -X PUT "https://us.api-wa.me/SUA_KEY/newsletter/ID_DO_CANAL/demote" \ -H "Content-Type: application/json" \ -d '{ "userJid": "[email protected]" }' # Transferir a propriedade — IRREVERSÍVEL curl -X PUT "https://us.api-wa.me/SUA_KEY/newsletter/ID_DO_CANAL/owner" \ -H "Content-Type: application/json" \ -d '{ "newOwnerJid": "[email protected]" }' # Apagar o canal e todas as publicações — IRREVERSÍVEL curl -X DELETE "https://us.api-wa.me/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](https://api-wa.me/docs). ### Pronto para automatizar seu WhatsApp? Crie sua conta gratuita e comece a enviar mensagens pela API em minutos. [Começar grátis](https://portal.api-wa.me/sign-up) ## 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. ## Continue lendo [### Agente de voz no WhatsApp: latência, interrupção (barge-in) e silêncio Como deixar um agente de voz no WhatsApp natural: latência, streaming, detecção de fala, interrupção (barge-in), silêncio e eco, com exemplos em Node.js.](https://api-wa.me/blog/agente-voz-whatsapp-latencia-interrupcao)[### Anti-detecção na API não oficial do WhatsApp: como a WAME protege seu número Como funciona a camada de anti-detecção da API não oficial da WAME: identidade de dispositivo, tempo humano, ritmo de envio, reconexão e monitor de saúde.](https://api-wa.me/blog/anti-deteccao-api-whatsapp-nao-oficial)[### API do WhatsApp em C# (.NET): enviar mensagens e receber webhook Tutorial de API do WhatsApp em C# e .NET: HttpClient tipado, envio de texto, imagem e lista, webhook em ASP.NET Core com fila em background e tratamento de 429.](https://api-wa.me/blog/api-whatsapp-csharp-dotnet) [Voltar ao blog](https://api-wa.me/blog) ## Structured data ```json { "@context": "https://schema.org", "@type": "WebSite", "name": "WAME API", "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram, Messenger e Telegram", "url": "https://api-wa.me", "inLanguage": "pt-BR", "publisher": { "@id": "https://api-wa.me/#organization", "@type": "Organization", "name": "WAME API", "url": "https://api-wa.me" } } { "@context": "https://schema.org", "@type": "Organization", "@id": "https://api-wa.me/#organization", "name": "WAME API", "alternateName": [ "WAME", "Wame API", "wame.api.br", "api-wa.me" ], "url": "https://api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/web-app-manifest-512x512.png", "width": 512, "height": 512 }, "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.", "identifier": { "@type": "PropertyValue", "propertyID": "INPI-BR", "name": "Pedido de registro de marca (INPI, classe NCL 42)", "value": "944724159" }, "foundingDate": "2017", "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram, Messenger e Telegram numa instância só. Desde 2017.", "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code e o Telegram, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.", "knowsAbout": [ "WhatsApp Cloud API oficial (Meta)", "API oficial de Instagram (Direct)", "API oficial de Messenger", "API multicanal Meta", "Meta Business Partner", "WhatsApp API", "API não oficial de WhatsApp", "automação de WhatsApp", "números virtuais", "webhooks" ], "sameAs": [ "https://github.com/wame-api", "https://www.linkedin.com/company/wameapi", "https://www.instagram.com/wame.api/", "https://www.youtube.com/@wameapi" ], "contactPoint": { "@type": "ContactPoint", "contactType": "customer support", "url": "https://api-wa.me/contact", "availableLanguage": [ "Portuguese" ] } } { "@context": "https://schema.org", "@type": "BlogPosting", "headline": "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.", "image": "https://api-wa.me/blog/canal-whatsapp-newsletter-api/opengraph-image", "datePublished": "2026-09-28", "dateModified": "2026-09-28", "author": { "@type": "Person", "name": "Raphael Serafim", "url": "https://github.com/raphaelvserafim", "sameAs": [ "https://github.com/raphaelvserafim" ] }, "publisher": { "@type": "Organization", "name": "api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/screenshot.png" } }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://api-wa.me/blog/canal-whatsapp-newsletter-api" }, "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", "inLanguage": "pt-BR" } { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://api-wa.me" }, { "@type": "ListItem", "position": 2, "name": "Blog da API do WhatsApp", "item": "https://api-wa.me/blog" }, { "@type": "ListItem", "position": 3, "name": "Canal do WhatsApp pela API: criar, gerenciar e acompanhar (newsletter)", "item": "https://api-wa.me/blog/canal-whatsapp-newsletter-api" } ] } { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Dá para criar um Canal do WhatsApp pela API?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Qual a diferença entre Canal do WhatsApp e lista de transmissão?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Consigo ver quantos seguidores meu canal tem pela API?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "A API oficial do WhatsApp gerencia canais?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Transferir a propriedade do canal pode ser desfeito?", "acceptedAnswer": { "@type": "Answer", "text": "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." } } ] } ```