Lista de transmissão
Uma lista de transmissão permite enviar mensagens para múltiplos contatos de uma só vez, de forma individual — cada destinatário recebe a mensagem como se fosse uma conversa direta, e eventuais respostas chegam de forma privada, sem que os outros membros da lista tenham acesso.
Cada lista possui um identificador com o sufixo @broadcast, como por exemplo: 1624901640@broadcast.
Você pode consultar suas listas através do endpoint de listagem de broadcasts.
Limitação para números WhatsApp Business: O WhatsApp Business não permite criar listas de transmissão, enviar mensagens para elas, nem ser adicionado a listas criadas por outros usuários. No entanto, ao utilizar a Z-API, os endpoints de broadcast funcionam normalmente mesmo em números Business. Recomendamos verificar o comportamento esperado no seu caso de uso antes de utilizar essa funcionalidade com contas Business.
Envio de mensagens para lista de transmissão
Para enviar mensagens a uma lista de transmissão, utilize normalmente os endpoints de envio disponíveis na API (como texto, mídia, documentos, áudios, entre outros), informando o ID da lista de transmissão no campo phone.
Por exemplo, ao utilizar o endpoint de send-text, basta passar o ID da lista no campo phone. O mesmo conceito se aplica aos demais endpoints de envio de mensagens.
{
"phone": "1779476888985@broadcast",
"message": "Olá, essa é uma mensagem de broadcast!"
}
O broadcastId pode ser obtido através do endpoint de listagem de broadcasts disponível na Z-API.
Limite mensal de envios pelo WhatsApp: O WhatsApp impõe um limite de 35 transmissões (mensagens) por mês por número. Ao atingir esse limite, novos envios pelo aplicativo ficam bloqueados até o próximo ciclo. Via Z-API, as mensagens continuam sendo enviadas normalmente mesmo após o limite ser atingido — porém, recomendamos fortemente respeitar esse limite para evitar possíveis restrições impostas pelo WhatsApp.
Gerenciamento de listas de transmissão
A Z-API disponibiliza endpoints dedicados para criar, editar, deletar e listar suas listas de transmissão diretamente pela API. Consulte as páginas a seguir para mais detalhes.