canais do whatsapp
Canais do WhatsApp (newsletter) por API para o seu cliente publicar sem abrir o celular
Com os canais do WhatsApp (newsletter) por API, o seu SaaS cria o canal do cliente, lista os canais da conta com papel e número de seguidores e publica atualizações usando as mesmas rotas de envio de mensagem e mídia.
SaaS testa 14 dias com o time técnico ajudando na integração.
- conexões na D-API
- 1.875
- de uptime garantido em contrato
- 99,9%
- datacenters no Brasil
- 4
- por ligação de WhatsApp na API não-oficial
- R$ 0
Criar o canal pela API
Nome, descrição e foto, por URL ou base64, numa chamada. O canal nasce na conta conectada e já pode receber publicações.
Publicar com as rotas de envio
Texto, imagem e outras mídias vão para o canal pelas rotas /messages/send/*, com o JID do canal no campo to.
Imagem que chega aos seguidores
Imagens em PNG, WEBP ou GIF enviadas a canais são convertidas para JPEG, o formato que o WhatsApp entrega a quem segue o canal.
Os canais do WhatsApp (newsletter) por API dão ao seu cliente um jeito de falar com muita gente ao mesmo tempo, sem grupo lotado e sem lista de transmissão. É a academia que publica a grade de aulas da semana, a escola que avisa sobre o calendário de provas, a loja que mostra a coleção nova. Quem quer receber segue o canal; quem administra publica. E com a D-API, quem publica pode ser o seu sistema, no horário certo, a partir do conteúdo que o cliente já cadastrou no seu produto.
Os canais fazem parte da API não oficial. A API cobre o que um SaaS precisa para operar o canal do cliente: criar, listar e publicar.
Para que um canal serve num SaaS
O canal é transmissão de mão única. Só administradores publicam, e os seguidores leem e reagem, sem conversa paralela. Isso muda o tipo de conteúdo que faz sentido.
Software de academia. A grade da semana, o aviso de feriado, o desafio do mês. Conteúdo para todos os alunos, que num grupo viraria uma enxurrada de respostas.
Edtech e escolas. Calendário, avisos gerais e materiais complementares. Os grupos de turma ficam para a conversa com o professor, e o canal para os comunicados da instituição. A página da API de grupos cobre o lado das turmas.
E-commerce e varejo. Lançamentos e promoções para quem escolheu acompanhar a marca, sem disparo individual para cada contato.
Plataformas de conteúdo e creators. Novos episódios, artigos e lives publicados automaticamente quando o conteúdo entra no ar.
Criar o canal pela API
POST /api/v1/newsletters/create cria um canal na conta conectada à sessão. Só name é obrigatório; description e picture completam o perfil, e a foto aceita URL ou base64.
curl -X POST https://api.d-api.cloud/api/v1/newsletters/create \
-H "Authorization: SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sessionId": "academia-forca-unidade-centro",
"name": "Academia Força - Unidade Centro",
"description": "Grade de aulas, avisos e desafios da unidade.",
"picture": "https://cdn.seu-saas.com/marcas/academia-forca.jpg"
}'
A resposta traz o canal criado em newsletter. Guarde o identificador do canal junto do tenant no seu banco: é para ele que as publicações vão.
Uma forma de oferecer o recurso no seu produto é um botão “criar canal da minha empresa” na área de comunicação, que preenche nome, descrição e foto com os dados que o cliente já cadastrou. Ele não precisa saber que existe uma API por trás.
Listar os canais da conta
GET /api/v1/newsletters/list devolve os canais em que a conta está inscrita, incluindo os que ela administra. Cada item traz id, name, description, subscriberCount, picture, preview, inviteLink, state e role.
curl "https://api.d-api.cloud/api/v1/newsletters/list?sessionId=academia-forca-unidade-centro" \
-H "Authorization: SUA_API_KEY"
Dois campos são especialmente úteis. O role diz se a conta é OWNER, ADMIN ou SUBSCRIBER de cada canal, o que permite mostrar no seu painel só os canais em que o cliente pode publicar. E o inviteLink é o link para divulgar o canal: no rodapé do e-mail, na tela de confirmação de matrícula, no QR code impresso na recepção.
O subscriberCount mostra quantas pessoas seguem o canal. Num painel de comunicação, é um número que o seu cliente vai querer acompanhar semana a semana, e você pode registrá-lo periodicamente a partir dessa listagem.
Publicar no canal com as rotas de envio
A publicação usa as mesmas rotas de enviar mensagem pela API e de enviar mídia. O campo to aceita um JID completo, e o JID de canal termina em @newsletter.
{
"sessionId": "academia-forca-unidade-centro",
"to": "120363000000000000@newsletter",
"image": "https://cdn.seu-saas.com/grades/semana-47.png",
"caption": "Grade de aulas da semana. Spinning extra na quinta às 19h."
}
Dois cuidados técnicos já vêm resolvidos pela D-API. Canais não aceitam a mídia criptografada de ponta a ponta usada nas conversas, então o envio para @newsletter sobe o arquivo no formato próprio de canal. Sem isso, a mídia aparece para quem publicou e fica impossível de baixar para os seguidores. E o servidor do canal só gera a versão entregue aos seguidores a partir de JPEG: uma imagem em PNG, WEBP ou GIF chegaria ao dono, e o seguidor não receberia mídia nenhuma. Por isso, imagens enviadas a canais são convertidas para JPEG antes do envio.
Para agendar publicações, como a grade que sai toda segunda às 6h, o seu sistema chama a rota de envio no horário. Com async: true, a chamada responde na hora e o resultado chega no webhook command.result.
Canais num SaaS com muitos clientes
Cada canal pertence ao número de um cliente, então a regra é a mesma de qualquer recurso da plataforma: uma sessão por número, com o sessionId carregando o identificador do tenant. Guarde o JID do canal junto do cliente e confira o role na listagem antes de publicar, porque uma conta pode seguir dezenas de canais e administrar só um. Num software de academias com várias unidades, cada unidade conectada tem o próprio canal, e o painel da rede mostra todos lado a lado, com os seguidores de cada um.
O que esperar da API de canais
Vale alinhar com o seu cliente o que o recurso cobre. A API cria canais, lista os canais da conta com papel, seguidores e link de convite, e publica conteúdo pelas rotas de envio.
Ela não entrega o conteúdo de canais que a conta segue: mensagens e eventos vindos de @newsletter são descartados pela conexão e não chegam ao webhook. Se o seu produto precisa de interação com o público, como respostas e perguntas, o caminho é a conversa individual ou o grupo.
Com esse desenho, o canal vira a peça de comunicação em massa do seu produto, e as conversas individuais seguem para o atendimento. A visão completa do que a plataforma oferece está na página da API de WhatsApp, e a referência dos endpoints na documentação da D-API.
Time D-API. Atualizado em .
Perguntas frequentes
O canal pertence a qual conta?
À conta de WhatsApp conectada na sessão informada em sessionId. Para criar canais de vários clientes, use a sessão de cada um, e o canal fica no número daquele cliente.
Canal e grupo têm o mesmo uso?
Não. O grupo é conversa entre participantes, com entrada, saída e moderação. O canal é transmissão de mão única: só quem administra publica, e quem segue só acompanha.
Consigo criar canais de forma assíncrona?
Sim. As rotas de canais aceitam async true, respondem com um commandId e entregam o resultado no webhook command.result.
Qual o tempo máximo de espera nas rotas de canais?
As duas rotas aceitam o parâmetro timeout, em milissegundos. O padrão é 30 segundos na listagem e 60 segundos na criação, com teto de 300 segundos.