Pular para o conteúdo
Wbiztool

Guias do produto

Campanhas a partir de uma planilha

Faça upload de um arquivo Excel ou CSV em que cada linha é uma mensagem de WhatsApp, e o Wbiztool envia todas para você como uma campanha. É a forma mais rápida de enviar mensagens para uma lista de clientes ou grupos quando cada linha já tem o próprio texto.

Abra pelo menu Ferramentas → Enviar via Excel na barra lateral ou acesse /campaigns/.

Antes de começar#

  • Um número de WhatsApp mostrando Conectado nas configurações do WhatsApp.
  • Créditos suficientes para todas as linhas. A página mostra quantas mensagens restantes você tem.
  • Um arquivo .csv, .xls ou .xlsx no formato abaixo.

Formato do arquivo#

A primeira linha deve conter estes cabeçalhos de coluna, escritos exatamente como mostrado. Clique em Formato de Exemplo na página para ver um exemplo ou baixe o CSV de exemplo. Troque o número de telefone e o horário de agendamento de 2024 do exemplo antes de fazer o upload. Um horário no passado é enviado imediatamente.

Se o painel estiver em outro idioma, a janela Formato de Exemplo mostra esses nomes de coluna traduzidos. Mesmo assim, seu arquivo precisa usar os cabeçalhos em inglês listados aqui.

ColunaObrigatóriaO que colocar
ToSimO número de telefone com código do país, como 919876543210, ou o nome exato de um grupo de WhatsApp, como Family Group.
MessageSimO texto da mensagem. A formatação do WhatsApp, como *bold*, funciona.
Image/File Url (Optional)NãoUm link público para uma imagem ou arquivo. A Message da linha é enviada como legenda.
whatsapp_client_idNãoO ID do Cliente WhatsApp do número que vai enviar, obtido nas configurações do WhatsApp. Use 0 ou deixe vazio para enviar pelo seu primeiro número conectado.
Schedule Time (Optional)NãoQuando enviar a linha, em formato ISO com deslocamento de fuso horário, como 2026-12-25T14:30:00+05:30. Um horário sem deslocamento, como 2026-12-25T14:30:00, é interpretado no fuso horário do servidor; por isso, sempre adicione +05:30, Z (UTC) ou o seu próprio deslocamento. Deixe vazio para enviar o quanto antes.

Em arquivos Excel, Whatsapp Number ou Contact phone Number também funcionam no lugar de To. Em um arquivo CSV sem o cabeçalho To, a primeira coluna é lida como o número e a segunda como a mensagem, sejam quais forem os cabeçalhos; por isso, mantenha o número primeiro e a mensagem em segundo. Image/File Url e Schedule Time também funcionam sem "(Optional)".

Linhas de exemplo:

ToMessageImage/File Url (Optional)whatsapp_client_idSchedule Time (Optional)
919876543210Hi Aman, your order has shipped.1234
Family GroupHappy holidays everyone!12342026-12-25T16:00:00+05:30
919876543211This week's offershttps://example.com/offer.jpg1234

Números de telefone e grupos#

  • Escreva os números com o código do país e apenas dígitos. Um + no início, espaços e um 0 à esquerda são removidos.
  • Um valor de To que contenha letras, traços ou parênteses é tratado como nome do grupo; assim, 98765-43210 seria enviado para um grupo com esse nome e falharia. Remova traços e parênteses dos números.
  • Os nomes de grupo precisam corresponder exatamente ao grupo do WhatsApp, e o número de envio precisa ser membro. Use nomes de grupo que não sejam compartilhados por outras conversas.

Imagens e arquivos#

  • Links terminados em .jpg, .jpeg, .png, .gif, .bmp, .tiff ou .svg são enviados como imagens. Qualquer outro link é enviado como arquivo.
  • Os links precisam abrir o arquivo diretamente, sem login. Envie arquivos para a Biblioteca de mídia para obter um link.
  • O destinatário vê um nome de arquivo tirado do final do link. Use links que terminem na extensão correta, como .pdf; caso contrário, .pdf é adicionado ao nome.

Iniciar uma campanha#

  1. Dê um nome à campanha

    Em Iniciar Nova Campanha, digite um Nome da Campanha. Se já existir uma campanha com esse nome, um número é adicionado, como Diwali offer (1).

  2. Escolha seu arquivo

    Em Upload de Arquivo Excel/CSV, escolha seu arquivo .csv, .xls ou .xlsx.

  3. Inicie

    Clique em Iniciar Campanha. Quando o arquivo for lido, você verá "N mensagens salvas na nova campanha" e a campanha aparecerá em Todas as Campanhas.

Linhas sem número são ignoradas, e todas as linhas são ignoradas se o arquivo não tiver a coluna Message (exceto em um CSV sem o cabeçalho To, como descrito acima). Se você não tiver nenhum número conectado e o arquivo não indicar um em whatsapp_client_id, todas as linhas são ignoradas. Se nenhuma linha puder ser usada, a campanha não é criada e não aparece em Todas as Campanhas.

Ritmo de envio#

As linhas sem Schedule Time (horário de agendamento) são espaçadas automaticamente: a primeira fica programada para cerca de 5 segundos após o upload, e cada uma das seguintes para um intervalo aleatório de 5 a 30 segundos após a anterior. As linhas com Schedule Time ficam programadas para esse horário.

As mensagens são enviadas em ordem pelo número de WhatsApp que as envia, apenas enquanto esse número estiver conectado. Um número ocupado ou desconectado atrasa as mensagens dele. Siga as Melhores Práticas mostradas nas configurações do WhatsApp, como 150–200 mensagens por número por dia.

Acompanhar uma campanha#

A tabela Todas as Campanhas lista suas campanhas, das mais novas para as mais antigas, 20 por página:

ColunaSignificado
Data da CampanhaO nome da campanha.
Total de MensagensMensagens criadas a partir do arquivo.
PendenteNa fila e ainda não enviadas, incluindo linhas agendadas.
EntregueEnviadas pelo seu número de WhatsApp.
CanceladoCom falha, canceladas ou expiradas.

Campanhas criadas em Mensagens de modelo também aparecem aqui, com o nome Template Messages - seguido da data e da hora.

Abra Ações em uma campanha para:

  • Baixar Relatório: um arquivo Excel com Whatsapp Number (número do WhatsApp), Customer Number (número do cliente), Msg (mensagem), Created Time (hora de criação), Sent Time (hora de envio) e Status de cada mensagem (Created, Sent, Failed, Cancelled ou Expired, ou seja, criada, enviada, com falha, cancelada ou expirada). Os horários estão em UTC.
  • Ver Mensagens: abre Relatórios filtrado para esta campanha, com o motivo de cada falha.
  • Cancelar Mensagens Pendentes: aparece quando a campanha ainda tem mensagens pendentes.
  • Arquivar ou Restaurar.

As mensagens finalizadas são removidas depois de cerca de 90 dias; por isso, baixe os relatórios que você quiser guardar.

Cancelar mensagens pendentes#

  1. Abra as ações da campanha

    Em Todas as Campanhas, abra Ações na campanha e clique em Cancelar Mensagens Pendentes.

  2. Confirme

    Clique em Sim, cancelar mensagens!. Você verá "N pending messages cancelled successfully" (N mensagens pendentes canceladas com sucesso).

Mensagens canceladas não consomem créditos. Mensagens que já foram enviadas não são afetadas, e o cancelamento não pode ser desfeito.

Arquivar e restaurar#

Arquivar esconde uma campanha concluída da lista principal. Clique em Arquivar no menu Ações dela e confirme com Sim, arquivar!. Para ver as campanhas arquivadas, ative Mostrar Campanhas Arquivadas e clique em Restaurar para trazer uma de volta.

Solução de problemas#

Mensagem ou problemaO que fazer
"Por favor, digite um nome para a campanha."Preencha Nome da Campanha.
"Por favor, faça upload de um arquivo antes de salvar a campanha."Escolha um arquivo primeiro.
"Invalid file format" (formato de arquivo inválido)Salve o arquivo como .csv, .xls ou .xlsx.
"Low credits" (créditos baixos)Você não tem mais créditos. Faça upgrade em Cobrança e Planos.
"Not enough credits: this file would create…"Divida o arquivo ou faça upgrade e envie de novo.
"0 mensagens salvas na nova campanha"Confira se os cabeçalhos são exatamente To e Message (em um CSV, mantenha o número na primeira coluna e a mensagem na segunda) e se há um número conectado.
"Ocorreu um erro ao fazer upload da campanha"Não foi possível ler o arquivo. Salve-o novamente como .xlsx ou .csv UTF-8 e tente de novo.
As mensagens continuam em PendenteO número de envio precisa estar Conectado. Confira se o whatsapp_client_id do seu arquivo pertence a um número conectado. O ID de um número que você excluiu ou desconectou continua sendo aceito, e as mensagens dele ficam pendentes; só um ID desconhecido ou 0 usa o seu primeiro número conectado.
Linhas agendadas enviadas no horário erradoInclua o deslocamento de fuso horário, como +05:30, e formate a coluna como texto no Excel. Um horário que não puder ser lido é enviado imediatamente.
As mensagens para um número falhamVeja o erro em Ver Mensagens. Os números precisam do código do país, sem traços nem parênteses.

Relacionados#