Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://zapo.to/llms.txt

Use this file to discover all available pages before exploring further.

Uma lista de transmissão envia uma única mensagem para vários contatos de uma vez — cada destinatário a recebe como um chat 1:1 normal e não vê quem mais está na lista. As listas de transmissão ficam em client.broadcastList (WaBroadcastListCoordinator). Business-only
Apenas business. As listas de transmissão são baseadas no schema de app-state BusinessBroadcastList e só funcionam em contas WhatsApp Business. Em uma conta comum, o servidor rejeita as mutações subjacentes.

​
Definindo uma lista

setList cria ou atualiza a definição de uma lista — ela então aparece em Listas de transmissão no celular, sincronizada via app-state. Os participantes são identificados pelo LID (lidJid), opcionalmente acompanhado do JID de número de telefone (pnJid): 
await client.broadcastList.setList({
  id: 'list-1',
  listName: 'Friends',
  participants: [
    { lidJid: 'a@lid', pnJid: 'a@s.whatsapp.net' },
    { lidJid: 'b@lid' }
  ],
  labelIds: ['L1'] // opcional — anexa labels de business
})
Remova uma lista pelo seu id: 
await client.broadcastList.removeList('list-1')

​
Enviando para uma lista

send recebe a mesma union de conteúdo de client.message.send — texto, mídia, enquetes e assim por diante — mais o listJid da transmissão (o id da lista com o sufixo @broadcast) e os recipients explícitos para os quais fazer o fanout: 
const result = await client.broadcastList.send({
  listJid: 'list-1@broadcast',
  content: 'Weekend sale starts now! 🎉',
  recipients: ['a@lid', 'b@lid']
  // options: { ... }  // mesmo formato das options de client.message.send
})

console.log(result.id) // o id da mensagem publicada
Cada destinatário é criptografado individualmente (um fanout), então um único send equivale a N envios diretos por trás de uma requisição. Passe as opções de envio habituais através de options.
Listas de transmissão não são newsletters/canais: uma transmissão chega aos seus contatos existentes como mensagens privadas 1:1, enquanto um canal é um feed público baseado em seguidores.

Referência do client

As assinaturas completas dos métodos de client.broadcastList.

Identidades (PN vs LID)

Por que os participantes são indexados por LID.
Last modified on May 28, 2026