← Blog
Features

Ações iniciais: WhatsApp e webhook antes da ligação sair

Configure ações iniciais no pipeline para avisar o lead no WhatsApp ou chamar um webhook cerca de 30 segundos antes do agente discar. Gatilho na primeira tentativa, disparo manual e histórico no card.

Antes do agente falar com o lead, muitas operações já querem avisar o contato ou avisar o CRM. Um WhatsApp de lembrete, um POST para marcar "ligação em andamento" ou um payload com contexto para outro sistema. No Pipevoz, isso vive em Ações iniciais no pipeline: disparam cerca de 30 segundos antes de cada tentativa de discagem, com opção de rodar só na primeira tentativa. Este guia explica o que configurar, quando dispara e como acompanhar.

O que são ações iniciais

Ações iniciais são automações configuradas por pipeline que rodam antes da ligação sair. Elas usam o mesmo motor das ações finais (webhook e WhatsApp), mas com gatilho before_call em vez de after_call.

Quando o discador vai originar uma chamada, o Pipevoz agenda um intervalo de cerca de 30 segundos, dispara as ações iniciais ativas e só então conecta o agente de voz. Esse intervalo dá tempo do WhatsApp chegar no celular do lead ou do seu endpoint processar o payload antes do telefone tocar.

  • Configuração no pipeline, aba Ações iniciais (ícone de sino no topo do board).
  • Tipos hoje: webhook (POST) e WhatsApp.
  • Disparo automático antes de cada tentativa, respeitando a janela de discagem.
  • Disparo manual pelo menu do card: Disparar ação inicial.

Quando disparam na prática

O fluxo começa quando o lead entra na fila de execução e o discador seleciona a próxima tentativa. Se existir ao menos uma ação inicial ativa no pipeline, a plataforma enfileira as execuções e atrasa a origem da chamada em ~30 segundos.

Na rediscagem, as ações podem rodar de novo ou só na primeira tentativa, conforme você marcar "Somente na primeira tentativa" em cada ação. Isso evita spammar o lead com o mesmo aviso em toda retentativa.

  • Primeira tentativa do lead: ações iniciais rodam (se ativas).
  • Retentativas: dependem do flag por ação.
  • Lead fora da janela de horário: nada dispara até o horário permitido.
  • Disparo manual: ignora a fila e executa a ação escolhida na hora.

WhatsApp antes da ligação

Use para avisar o lead que vai receber uma ligação, confirmar horário ou enviar contexto curto antes do agente falar. Conecte um canal de WhatsApp, crie a ação na aba WhatsApp das ações iniciais e escreva a mensagem com variáveis do lead.

Placeholders típicos: "Olá {{lead.contact.first_name}}, em instantes nosso time liga para falar sobre {{lead.company}}." O envio usa os canais de WhatsApp contratados em Faturamento, por R$79/mês por canal.

  • Número conectado por QR (integração não oficial).
  • Variáveis do lead e do pipeline no texto.
  • Execução registrada no histórico do card.
  • Falha de envio fica visível para retry manual.

Webhook antes da ligação

Use quando o destino é sistema, não o lead. Exemplos: marcar no CRM que a discagem vai começar, buscar score atualizado, registrar timestamp de tentativa ou acionar um fluxo no n8n antes do telefone tocar.

Configure URL HTTPS, headers opcionais e secret para assinatura. O payload inclui dados do lead, pipeline, tentativa e metadados da chamada que está prestes a iniciar.

  • POST JSON para endpoint que você controla.
  • Retry automático em falha temporária do seu servidor.
  • Histórico de request e response no drawer de execuções.
  • Combine com ação final webhook para fechar o ciclo pós-ligação.

Como configurar no pipeline

Abra o pipeline outbound, clique em Ações iniciais na barra superior e escolha a aba Webhooks ou WhatsApp. Dê nome claro à ação (ex.: "Aviso WhatsApp pré-call"), preencha URL ou mensagem e salve.

Para WhatsApp, selecione qual canal conectado envia. Para webhook, teste com um endpoint de staging antes de ativar em campanha grande. Use o disparo manual em um card de teste para validar payload e texto sem esperar a fila.

Fluxo completo: inicial, ligação, final

O desenho mais comum em outbound maduro: ação inicial avisa o lead ou o CRM, o agente de voz roda a conversa, a ação final devolve resultado (WhatsApp de follow-up, webhook para HubSpot, etc.). Cada etapa é independente e configurável por pipeline.

Para aprofundar o pós-ligação, leia Ações finais: webhook e WhatsApp depois da ligação. Para WhatsApp em detalhe, veja Disparo de WhatsApp após a chamada. Para API + funil, Integração no fluxo comercial.

Próximo passo

Quer testar agentes de voz na sua operação?

Crie sua conta e rode chamadas de teste pelo navegador antes de escalar a discagem.

Começar agora →