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,.xlsou.xlsxno 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.
| Coluna | Obrigatória | O que colocar |
|---|---|---|
To | Sim | O número de telefone com código do país, como 919876543210, ou o nome exato de um grupo de WhatsApp, como Family Group. |
Message | Sim | O texto da mensagem. A formatação do WhatsApp, como *bold*, funciona. |
Image/File Url (Optional) | Não | Um link público para uma imagem ou arquivo. A Message da linha é enviada como legenda. |
whatsapp_client_id | Não | O 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ão | Quando 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:
| To | Message | Image/File Url (Optional) | whatsapp_client_id | Schedule Time (Optional) |
|---|---|---|---|---|
| 919876543210 | Hi Aman, your order has shipped. | 1234 | ||
| Family Group | Happy holidays everyone! | 1234 | 2026-12-25T16:00:00+05:30 | |
| 919876543211 | This week's offers | https://example.com/offer.jpg | 1234 |
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
Toque contenha letras, traços ou parênteses é tratado como nome do grupo; assim,98765-43210seria 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,.tiffou.svgsã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#
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).Escolha seu arquivo
Em Upload de Arquivo Excel/CSV, escolha seu arquivo
.csv,.xlsou.xlsx.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:
| Coluna | Significado |
|---|---|
| Data da Campanha | O nome da campanha. |
| Total de Mensagens | Mensagens criadas a partir do arquivo. |
| Pendente | Na fila e ainda não enviadas, incluindo linhas agendadas. |
| Entregue | Enviadas pelo seu número de WhatsApp. |
| Cancelado | Com 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#
Abra as ações da campanha
Em Todas as Campanhas, abra Ações na campanha e clique em Cancelar Mensagens Pendentes.
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 problema | O 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 Pendente | O 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 errado | Inclua 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 falham | Veja o erro em Ver Mensagens. Os números precisam do código do país, sem traços nem parênteses. |
Relacionados#
- Mensagens de modelo
- Biblioteca de mídia
- Relatórios e histórico de mensagens
- Conecte seu número de WhatsApp
- Integração com Google Sheets para linhas que continuam chegando
- API: Enviar para vários números e Agendar mensagem
