Além do WhatsApp automático antes ou depois da ligação, o Pipevoz agora tem Campanhas: você sobe uma planilha de contatos, escolhe um template com variáveis, define o horário de envio e a plataforma dispara mensagem por mensagem no canal de WhatsApp conectado, com fila, pausa e acompanhamento de progresso. Este guia cobre o fluxo completo da feature, do QR code ao encerramento da campanha.
Onde fica e o que compõe a campanha
No menu WhatsApp da sidebar você encontra Canais (pareamento do número), Templates (textos reutilizáveis) e Campanhas (disparo em lote). Uma campanha amarra três peças: o canal que envia, o template que personaliza o texto e a planilha com os destinatários.
Cada campanha fica no workspace atual. Você pode ter várias campanhas ao longo do tempo, mas o envio respeita um canal por vez: mensagens do mesmo número saem em fila, com intervalo entre um contato e outro, para reduzir risco de bloqueio no WhatsApp.
- Canais: contratados em Faturamento e conectados via QR.
- Templates: textos com variáveis do lead, criados em WhatsApp > Templates.
- Campanhas: importação, execução e métricas em WhatsApp > Campanhas.
Pré-requisitos: canal e template
Antes de criar a campanha, conecte um canal em WhatsApp > Canais e crie pelo menos um template ativo em WhatsApp > Templates. O template usa o mesmo motor de variáveis das ações finais: nome, empresa, campos customizados da planilha e metadados da campanha.
Exemplo de texto: "Olá {{lead.contact.first_name}}, aqui é a equipe da {{lead.company.name}}. Passando para confirmar seu interesse." Se o primeiro nome estiver vazio na linha, a variável some da mensagem enviada.
- Canal precisa estar com status conectado no momento do disparo.
- Template vazio ou canal offline pausam a campanha com motivo visível na lista.
- Templates ficam versionados por nome dentro do workspace.
Planilha: colunas e formatos aceitos
Na criação da campanha, envie um arquivo .xlsx, .xls ou .csv. A primeira linha deve ser cabeçalho. A coluna obrigatória é contact_phone (ou alias telefone, phone, whatsapp, celular). Números no formato nacional brasileiro funcionam: 11999999999 vira 5511999999999 na hora do envio.
Colunas padrão opcionais: contact_name, contact_first_name, contact_email, company_name, company_document, company_email, title. Qualquer outra coluna vira campo customizado disponível no template como lead.custom_fields.nome_da_coluna.
- Linhas sem telefone válido entram como inválidas, não bloqueiam o restante.
- Importação roda em background; status Importando vira Pronta quando termina.
- Arquivo fica armazenado na campanha para auditoria interna.
Horário de disparo e fila de envio
Você define a janela de horário igual às campanhas de voz: dias da semana e intervalos em que a fila pode enviar. Fora do horário, a campanha continua em execução, mas só retoma disparos quando a janela abrir de novo.
Entre cada mensagem enviada com sucesso, o sistema aguarda um intervalo aleatório de 4 a 12 segundos antes do próximo contato. Isso simula ritmo humano e evita estourar o canal com centenas de requisições simultâneas.
- Um lock por canal garante que duas campanhas no mesmo número não disparem juntas.
- Worker dedicado (fila whatsapp_campaigns) processa importação e envios.
- Tick periódico retoma campanhas em execução que ficaram sem próximo agendamento.
Controles: iniciar, pausar, retomar, encerrar
Campanha Pronta: clique em Iniciar para começar a fila. Em execução: Pause interrompe novos envios sem apagar progresso; Retomar continua de onde parou. Encerrar marca a campanha como finalizada manualmente. Excluir remove da lista (campanhas ativas são encerradas antes).
A lista atualiza a cada poucos segundos com barra de progresso: enviados, falhas, inválidos e total. Se o saldo de créditos cair abaixo do mínimo ou o canal cair, a campanha pausa sozinha com status Saldo insuficiente ou motivo equivalente.
- Importando: aguarde antes de iniciar.
- Concluída: todos os pendentes foram processados.
- Falhou: erro na importação ou nenhum telefone válido na planilha.
Cobrança e histórico
O envio usa os canais de WhatsApp contratados no workspace, por R$79/mês por canal. Falha de envio (número inválido, HTTP de erro, canal offline) fica registrada no histórico para análise e retry.
Para campanhas grandes, mantenha a assinatura de canais ativa antes de iniciar. Se a conta ficar bloqueada por saldo insuficiente, a operação pausa até a regularização.
Campanha vs ações automáticas no pipeline
Use Campanhas quando você já tem uma lista pronta (evento, base fria, reativação) e quer um disparo único ou recorrente manual. Use ações iniciais ou finais de WhatsApp quando a mensagem depende do fluxo de ligação (aviso antes de discar, follow-up pós tabulação).
Os três compartilham canais contratados e templates. A diferença é o gatilho: planilha + fila vs tentativa de discagem vs fim de ligação.
Para disparo pós-chamada, leia Disparo de WhatsApp após a chamada. Para visão comercial de campanha em massa, veja Campanha de WhatsApp em massa.