Transmissões

Uma transmissão manda o mesmo template aprovado para uma lista de contatos, de uma vez só: uma promoção, um aviso de feriado, um convite. Você escolhe o template, o número que envia e quem recebe. O BotoZap dispara em segundo plano e mostra, contato a contato, o que foi enviado, entregue, lido e respondido.

Tudo fica em Campanhas › Transmissões.

Antes de começar

• Plano pago. Transmissões fazem parte dos planos Starter e Pro, e do período de teste. No Free, o botão vira Fazer upgrade. Contas Free anteriores à mudança de planos veem um aviso com a data até quando ainda podem transmitir.
• Template aprovado. A transmissão só usa templates com status Aprovado. Templates de Autenticação não aparecem: o código de verificação vem do sistema de quem integra, e eles só são enviados pela API. Veja Templates.
• Número conectado no cliente escolhido no seletor do topo do painel.
• Contatos com permissão. Para templates de Marketing, quem recusou receber marketing fica de fora sozinho. Veja Campanhas.

Passo a passo: nova transmissão

Em Campanhas › Transmissões, clique em Nova transmissão. A tela abre sem o menu lateral, com as seções numa lista para preencher em ordem. Cada seção ganha um ✓ quando está pronta, e o botão Revisar e enviar, no topo, acende quando tudo está ✓. Para desistir, clique em Sair.

Ao lado ficam a Prévia da mensagem, que mostra a mensagem como ela chega no WhatsApp, e o Resumo do disparo, com quantos vão receber e o limite do número.

1. Mensagem

1. Em Template aprovado, escolha o template.
2. Em Número de origem, escolha o número que envia. Só aparecem os números da mesma conta do WhatsApp do template. Um número que não pode transmitir aparece com (indisponível para transmissão), e o motivo aparece logo abaixo.
3. Se quiser, dê um Nome da transmissão (opcional), como "Promoção de junho". Sem nome, a lista mostra o nome do template.
4. Clique em Continuar.

2. Quem recebe

Escolha uma das quatro abas.

Colar números. Um número por linha, com DDI e DDD, como +5511999999999. Linhas repetidas contam uma vez só. Abaixo da caixa, a tela mostra quantos destinatários você colou e o limite do número.

Planilha (CSV). Para partir de uma lista que você já tem e, se o template tiver variáveis, mandar um valor diferente para cada contato (o nome, o número do pedido). Clique em Carregar arquivo .csv ou cole o conteúdo. O arquivo pode ter até 512 KB. Com um template sem variáveis, só a coluna do telefone importa: as outras colunas são ignoradas.

• Sem linha de cabeçalho, as colunas seguem a ordem que a tela mostra: primeiro o destinatário, depois uma coluna por variável do template.
• Com linha de cabeçalho, o BotoZap abre o mapeamento: para cada coluna da planilha, escolha Destinatário, a variável que ela preenche ou Ignorar. Não precisa reordenar a planilha.

Abaixo do texto aparecem quantos destinatários são válidos, os repetidos descartados, as linhas com problema (com o motivo) e uma prévia das primeiras linhas. Corrija as linhas com problema antes de continuar.

Contatos. Dispara para os contatos já cadastrados do número de origem, sem planilha.

1. Em Filtrar por campo (opcional), deixe Todos os contatos do número ou escolha um campo personalizado. Com um campo, escolha Preenchido (quem tem o campo) ou Igual a e digite o Valor exato do campo.
2. Para cada variável do template, escolha de onde vem o valor: Nome do contato (o nome do WhatsApp), um campo personalizado ou Valor fixo, igual para todos.
3. Confira quantos contatos vão receber. Quem não tem o nome ou o campo usado numa variável fica de fora, e a tela lista quem ficou e por quê.

Esta aba não filtra por etapa do funil. Para partir de uma etapa, use o atalho da visão Funil descrito acima. A aba pega até 2.000 contatos: acima disso, use um filtro.

Com um template sem variáveis, a aba manda o mesmo texto para os contatos do número (ou só para os do filtro), sem nada para preencher.

Reengajar transmissão. Para voltar a falar com quem recebeu uma transmissão anterior.

1. Em Transmissão, escolha uma das transmissões recentes deste cliente.
2. Em Quem reengajar, escolha Quem não respondeu, Quem respondeu ou Todos que receberam.

A lista parte só de quem recebeu de fato. Conta como resposta a mensagem que cita a transmissão (ou toca num botão dela) ou que chega até 7 dias depois do envio.

3. Mídia do cabeçalho, localização ou cards

Só aparece quando a lista vem de Planilha (CSV) ou Contatos e o template pede algo que vale para todos. O título da seção muda conforme o template:

• Mídia do cabeçalho: imagem, vídeo ou documento no cabeçalho. Envie o arquivo ou cole o endereço público dele.
• Localização do cabeçalho: preencha Latitude e Longitude e, se quiser, Nome do local (opcional) e Endereço (opcional). Para achar as coordenadas, abra o local no Google Maps, clique com o botão direito no ponto e copie os dois números.
• Cards do carrossel: em cada card, envie a imagem (ou o vídeo) e preencha as variáveis do card e o fim dos links dinâmicos, quando houver.

O mesmo conteúdo vai para todos os destinatários; as variáveis de texto do corpo vêm de cada linha.

4. Variáveis

Só aparece nas abas Colar números e Reengajar transmissão. Se o template não tem variáveis, a tela diz Este template não tem variáveis: é só enviar.

• Mesmo valor para todos: preencha cada variável uma vez. Os valores aparecem na prévia.
• Valor por destinatário: abre uma tabela com uma linha por contato para preencher. Funciona até 200 contatos; acima disso, use a aba Planilha (CSV).

Se o template tem mídia ou localização no cabeçalho, ou é um carrossel, os campos aparecem aqui também (os mesmos da seção 3).

5. Envio

Por padrão, o envio começa assim que você confirma, tudo de uma vez.

Se o seu plano permite, aparece Enviar em ondas. Veja Envio em ondas abaixo.

6. Revise e confirme

1. Clique em Revisar e enviar.
2. A janela Confirmar transmissão repete o template, a quantidade de destinatários e o número de origem.
3. Clique em Enviar para N destinatário(s) (ou Iniciar envio em ondas (N)). Voltar fecha sem enviar.

A tela volta para a lista, com o aviso de que a transmissão começou.

Limites de cada transmissão

O Resumo do disparo mostra o limite do número escolhido. Ele é o menor entre dois tetos:

• O do seu plano: até 1.000 destinatários por transmissão no Starter e no período de teste, e até 2.000 no Pro. Contas Free anteriores à mudança de planos têm até 250.
• A capacidade do número na Meta: a Meta limita quantas pessoas diferentes um número pode procurar primeiro em 24 horas. Número novo começa em 250, e a Meta pode subir esse limite para 1.000, 2.000 e além. Quando é esse o teto, a tela diz (capacidade atual deste número na Meta).

Além disso, cada template enviado conta na franquia mensal de templates do plano. Ela é contada à parte e aparece em Configurações › Plano.

Lista acima do limite não pode ser enviada. A tela diz quantos remover. Divida em transmissões menores ou use o envio em ondas.

Envio em ondas

Nos planos pagos e no período de teste, Enviar em ondas divide a transmissão em ondas diárias do tamanho que o número aguenta com segurança: metade da capacidade dele na Meta, com pelo menos 24 horas entre uma onda e a próxima. A tela mostra o tamanho da onda e quantos dias a transmissão leva.

Por que isso existe: ao passar a lista pelas ondas, você alcança mais contatos do que a capacidade diária do número permite, sem estourar o limite da Meta. O teto passa a ser só o do plano. Quando a lista passa da capacidade do número, a própria tela oferece o botão Enviar em ondas.

Enquanto espera a próxima onda, a transmissão fica Aquecendo, e a lista mostra Próxima onda: com a data. No detalhe, o quadro Envio em ondas mostra a Onda atual, o Tamanho da onda e quando sai a próxima.

Se outra transmissão em ondas do mesmo portfólio de empresa na Meta já está em andamento, a nova espera a vez com o selo Aguardando a vez e começa sozinha quando a janela liberar.

O envio em ondas tem um número máximo de ondas. Se ele acabar antes de alcançar a lista toda, a transmissão termina como Falhou com o selo Ondas esgotadas, e o detalhe explica que quem ficou pendente não recebeu. Crie uma nova transmissão só com esses contatos.

Acompanhar

A transmissão continua em segundo plano mesmo com a página fechada. Clique em Atualizar para ver o progresso.

Na lista, a coluna Processamento mostra enviados, falhas, pendentes e o total. Os status:

• Enviando: em andamento.
• Aquecendo: envio em ondas, esperando a próxima onda.
• Concluída: o processamento terminou. Isso não quer dizer que todas as mensagens foram entregues.
• Interrompida: alguém parou a transmissão.
• Falhou: a transmissão terminou sem enviar para todos. Um selo ao lado diz o motivo: Ondas esgotadas (acabaram as ondas do envio em ondas) ou Número indisponível (o número de origem foi desconectado antes do fim). O detalhe explica o que fazer.
• Agendada e Rascunho: aparecem em transmissões criadas por um sistema integrado. Pelo painel, o envio sai na hora.

Clique no nome da transmissão (ou em Detalhes, quando aparece) para abrir o detalhe. No topo ficam os números, com barras de proporção:

• Enviadas: aceitas pela Meta.
• Entregues: chegaram ao aparelho.
• Lidas: parte das entregues.
• Respostas: só as respostas atribuídas a esta transmissão, não qualquer mensagem recebida.
• Falhas no envio: a Meta recusou antes de aceitar.
• Não entregues: a Meta aceitou, mas a mensagem não chegou.
• Pendentes: ainda na fila.

Não some falhas no envio com não entregues, nem lidas com entregues: são grupos diferentes.

A tabela Entregas mostra, por destinatário, a Situação e os horários em Enviada, Entregue, Lida e Respondeu. Quando o destinatário é um contato do número, aparecem Ver no Funil e, se já existe conversa, Abrir Conversa. A tabela mostra os primeiros 200 destinatários.

Falhas e reprocessamento

A seção Falhas no envio lista cada falha com o Motivo do erro e se ela pode ser reenviada, na coluna Reenvio.

O motivo aparece em português, como O contato não pôde receber: o número pode não ter WhatsApp ou estar desatualizado ou O template foi pausado pela Meta por baixa qualidade. Passe o mouse sobre o motivo para ver o texto original da Meta, útil se precisar abrir um chamado.

Quem recusou marketing depois de entrar na lista aparece com O contato recusou mensagens de marketing depois de entrar na lista. A mensagem não saiu. Esses contatos não são reenviados: um novo envio seria recusado de novo.

Na tabela Entregas, quem não recebeu depois de a Meta aceitar a mensagem mostra o motivo do mesmo jeito, em português.

Só dá para reenviar quando a mensagem comprovadamente não saiu. Quando o BotoZap não tem essa prova, a coluna explica que o reenvio está indisponível, para não mandar a mesma mensagem duas vezes.

Para reenviar (só em transmissões Enviando ou Concluída):

1. Marque as falhas que quer reenviar, até 20 por vez.
2. Clique em Reprocessar selecionados.
3. Confirme em Confirmar reprocessamento.

É um envio novo: conta na franquia mensal como qualquer outro. Uma transmissão Interrompida não é reprocessada; crie uma nova.

Parar uma transmissão

1. Na lista ou no detalhe, clique em Parar.
2. Confirme em Parar transmissão.

Os envios param na hora. Mensagens já enviadas não são canceladas, os pendentes ficam sem envio e não dá para retomar. No máximo um envio que já estava saindo pode terminar.

Selos de bloqueio

Às vezes a transmissão não avança por um motivo externo. Um selo aparece ao lado do status, e o detalhe explica o que fazer.

• Sem token ou Token inválido: a conexão do número com a Meta caiu. Reconecte o número em Configurações › Canais com Reconectar. O envio retoma sozinho de onde parou.
• Franquia esgotada: a franquia mensal de templates do seu plano acabou, ou há um pagamento pendente. O envio fica pausado e retoma sozinho de onde parou quando a franquia renovar no mês seguinte ou o pagamento for regularizado. Para continuar antes disso, mude de plano ou quite a pendência em Configurações › Plano.
• Restrição na Meta: o número está com restrição na Meta. Reconectar não resolve. Confira o número no WhatsApp Manager; quando normalizar, a transmissão segue sozinha.
• Conta restrita: a conta do WhatsApp do cliente está banida ou restrita na Meta, e nenhum número dela transmite. Resolva no WhatsApp Manager.
• Desconectado: o número desconectou. Reconecte em Configurações › Canais.
• Aguardando a vez: espera normal do envio em ondas. Nenhuma ação é necessária.
• Recurso pago ou Acima do limite: a transmissão agendada foi preparada quando o plano permitia e agora não permite mais. Mude de plano em Configurações › Plano ou pare a transmissão.
• Lista incompleta: a transmissão agendada pelo sistema integrado chegou com menos destinatários do que o combinado. Ela não sai assim: peça a quem cuida da integração para completar a lista e agendar de novo, ou pare a transmissão.

Possivelmente travada aparece quando uma transmissão em envio fica mais de 5 minutos sem progresso. Normalmente o envio volta sozinho em poucos minutos e retoma de onde parou; você não precisa fazer nada. Se continuar assim por muito tempo, fale com o suporte do BotoZap ou pare a transmissão.

Problemas comuns

O botão Nova transmissão está apagado. Falta um template aprovado ou um número conectado para este cliente. Um aviso acima da lista diz qual dos dois falta (ou, sem transmissões ainda, a tela mostra Nenhum template aprovado disponível. ou Nenhum número disponível.). Se os únicos templates aprovados são de Autenticação, o aviso explica que eles só saem pela API: crie um template de Marketing ou Utilidade.

Revisar e enviar não acende. Alguma seção ainda não tem ✓. Abra a que falta: o motivo aparece nela ou no topo.

As abas Planilha (CSV) e Contatos estão apagadas. Escolha primeiro o template, em Mensagem. Elas acendem para qualquer template aprovado, com ou sem variáveis.

A contagem fica vermelha, "acima do limite". A lista passou do limite do número. Remova contatos, divida a lista ou use Enviar em ondas.

O resumo diz que alguns contatos "recusaram marketing e ficaram de fora". São contatos que recusaram marketing neste número. Eles não recebem templates de Marketing; quem nunca respondeu sobre isso recebe normalmente. Na aba Contatos, a lista de quem ficou de fora mostra cada um com recusou marketing.

Aparece "Todos os N destinatários recusaram mensagens de marketing". Todos da lista recusaram marketing neste número. Um template de Marketing não sai para eles.

Aparece "Envio em ondas não está disponível para este número ou plano". O envio em ondas é dos planos pagos e do período de teste, e não funciona num número bloqueado para transmissão.