Blocos de ação
Mova cards, aplique tags, preencha campos, crie tarefas, abra negociações e envie dados para outros sistemas pelo funil.
Nesta página
Os blocos de ação não falam com o contato: eles organizam o seu trabalho. Com eles o funil move o card no CRM, marca o contato com uma tag, cria uma tarefa para a equipe ou avisa outro sistema. Vários ficam no grupo Avançado, que depende do seu plano.
#Onde está cada ação
| Quero… | Bloco | Grupo |
|---|---|---|
| Pôr ou tirar tag, preencher campo, mudar status, atribuir atendente | Ação Avançada | Básico |
| Mover, criar ou excluir card no CRM | Ações CRM | Avançado |
| Criar uma tarefa para a equipe | Criar tarefa | Avançado |
| Avisar a equipe | Notificação interna | Avançado |
| Registrar o que o contato está negociando | Abrir negociação | Avançado |
| Mandar dados para outro sistema | Webhook | Avançado |
| Registrar um evento no Sparkle Tracker | Enviar evento ao Sparkle Tracker | Integrações |
| Pedir dados ou transferir no chat do site | Mensagem do Chatbot | Básico (funil de Chatbot) |
#Ação Avançada
Um bloco, uma ação. Em Ação interna, escolha o que fazer.
| Ação interna | Operações | Detalhes |
|---|---|---|
| Tags do contato | Adicionar tag ao contato, Remover tag do contato | Escolha a tag na lista ou crie uma nova ali mesmo. |
| Campo de contato | Salvar informação, Remover informação | Campos da ficha: Nome, Sobrenome, E-mail, Telefone, WhatsApp, Instagram (@handle) e Status do lead. |
| Campos personalizados | Salvar informação no campo personalizado, Somar ao campo personalizado (contador), Remover informação do campo personalizado | Para os campos que você criou. Dá para criar um campo novo no próprio bloco. |
| Tarefas | Criar tarefa, Remover tarefa | Remover apaga só tarefas criadas por funil para aquele contato. |
| Status do atendimento | Aberto, Pendente, Finalizado | Muda o status da conversa. |
| Atribuir atendente | — | Define o responsável pela conversa. Vazio remove a atribuição. |
| Descadastrar (excluir contato) | — | Apaga o contato e encerra o funil. |
Dicas de uso:
- O valor de um campo aceita texto fixo e variáveis, inclusive o valor atual do próprio campo. Exemplo: em Telefone, o valor
55{{phone}}acrescenta o código do país. - Em Telefone e WhatsApp o Leadz grava só os números. Um valor que resulta vazio não é gravado, para não apagar o dado que já existia.
- Somar ao campo personalizado (contador) soma ao valor atual. Use número negativo para subtrair. Exemplo: somar 1 a cada depósito recebido por webhook.
#Ações CRM
Mexe no quadro da tela CRM. Em Ação CRM, escolha uma das três.
#Mover coluna
Escolha o Pipeline (o quadro), a Coluna destino e a Ação:
| Ação | O que faz |
|---|---|
| Criar Card | Cria um card novo a cada execução, mesmo que o contato já tenha outro. |
| Mover e Criar Card | Move o card do contato. Se ele ainda não tem card no quadro, cria um. É o padrão. |
| Mover Card | Só move. Se o contato não tem card, o bloco não faz nada. |
| Excluir Card | Apaga o card do contato no quadro. O contato continua em Contatos, com o histórico. |
Ao criar, preencha Nome do card (em branco, o card recebe o nome do contato) e Responsável do card.
#Verificar coluna
Pergunta se o contato está numa coluna. O bloco sai por Sim ou por Não.
#Alerta
Registra um aviso, com Mensagem e Atribuir para, no histórico da execução. Para chamar a atenção da equipe, prefira Notificação interna.
#Criar tarefa
Cria uma tarefa para a equipe. Preencha Título da tarefa (aceita variáveis, ex.: «Ligar para {{full_name}}»), a descrição, a Prioridade (Baixa, Média ou Alta), o Prazo (horas) e Atribuir para (opcional).
Exemplo: quando o contato pede para falar com um vendedor, criar a tarefa «Ligar em até 2 horas» com prioridade Alta.
#Notificação interna
Avisa a equipe quando algo importante acontece. Preencha Mensagem da notificação e, se quiser, Atribuir para (opcional). Em Canal, escolha In-app (painel + atividades) ou Somente log de execução.
Para avisar um grupo do WhatsApp da equipe, use o bloco WhatsApp · não oficial com Enviar mensagem em grupo. Veja Blocos de mensagem.
#Abrir negociação
Registra na ficha do contato o que ele está negociando, com valor e situação. É o que a condição Produto (qual foi negociado) lê depois, e o que o CRM soma como valor em jogo.
| Campo | O que preencher |
|---|---|
| Produto | Um produto do seu catálogo, ou Avulso (escrever o nome). |
| Oferta | Uma oferta do produto, ou Sem oferta específica. |
| Nome da negociação | Para produto avulso. Aceita variáveis. |
| Tipo | Tipo da venda, ou Não informar. |
| Valor e Moeda | Número ou variável (ex.: {{vars.purchase_value}}). |
| Situação | Em que etapa a negociação está. |
#Webhook (envio)
Envia os dados do contato para um endereço externo. Este bloco só envia: ele não consulta nem espera um evento de volta. Para receber dados de outro sistema, use um webhook de entrada. Para buscar dados e usar a resposta, use o bloco HTTP Request.
- Em Método, escolha o método que o sistema de destino pede.
- Em URL de destino, cole o endereço público do sistema.
- Em Como montar o payload, escolha Parâmetros do Leadz ou JSON manual.
- Em Parâmetros enviados, escolha o dado do Leadz e o nome com que ele sai (ex.: ID do contato →
ID_USER). - Se o destino pede autenticação, escolha o tipo e informe o token.
Em Enviar os parâmetros como, escolha Automático, JSON no corpo, Formulário ou Query string. Marque Enviar também os campos vazios se o destino exige todos os campos. Cada bloco aceita até 50 parâmetros. Além dos dados do contato, um parâmetro pode vir de Variável do fluxo… ou de Texto fixo….
#Enviar evento ao Sparkle Tracker
Aparece no grupo Integrações quando o Sparkle Tracker está conectado. O bloco envia um evento para a sua conta do Tracker. O Tracker guarda o evento no histórico do contato e dispara a conversão para a Meta.
- Nome do evento no Tracker: escolha um evento existente ou escreva um novo (ex.: «Lead Qualificado»). Um nome novo cria o evento no Tracker no primeiro envio. Sem nome, o bloco não envia nada.
- Informações enviadas: à esquerda o campo do Tracker, à direita de onde o Leadz tira o valor.
O bloco tem duas saídas: Enviado e Erro.
#Mensagem do Chatbot
Só em funis do canal Chatbot. Em O que fazer, escolha:
| Opção | O que faz |
|---|---|
| Enviar mensagem com botões | Manda uma mensagem com botões. O botão aparece na última mensagem. Quem escreve em vez de tocar segue para o Agente IA, se houver, ou para a equipe. |
| Pedir dados | Mostra um formulário com os campos marcados: Nome, E-mail, WhatsApp ou telefone. Saídas: Preencheu e Não preencheu. |
| Transferir para o time | Passa a conversa para a equipe. Ela fica como pendente no Chat de conversas. A mensagem é opcional. |
Em Pedir dados, quem já deixou contato segue direto. Quem escreve em vez de preencher, ou não responde em 24 horas, sai por Não preencheu. Em Transferir para o time, a opção Fora do horário do time, pedir nome e e-mail antes de transferir garante um jeito de retornar.
#Nota da operação
Todo bloco tem, no fim do painel, o botão Adicionar nota da operação. É um comentário interno para a equipe, para explicar por que aquele bloco existe. A nota não aparece para o contato.
#Como as ações conversam com os gatilhos
Uma ação pode iniciar outro funil. Se um funil aplica a tag «aluno», os funis com o gatilho Tag adicionada ao lead para essa tag começam. O mesmo vale para campos personalizados alterados e para cards criados. O funil que fez a mudança não dispara a si mesmo.
#Problemas comuns
«Contato não encontrado — … não foi gravado»
A execução não tinha um contato ligado a ela. Acontece em gatilhos sem pessoa, como um disparo para grupos. Use essas ações em funis que começam por um contato.
A tag foi aplicada mas outro funil não começou
Confira se o outro funil está Publicado e se o gatilho pede exatamente a mesma tag. O gatilho só dispara quando a tag é nova: se o contato já tinha a tag, nada acontece.
O card não foi movido
Com Mover Card, o bloco não faz nada quando o contato ainda não tem card naquele quadro. Troque para Mover e Criar Card.
«URL externa aponta para rede privada ou reservada.»
O endereço do bloco Webhook precisa ser público, acessível pela internet. Endereços de rede interna e de teste local são recusados.
O bloco está com cadeado
«Os blocos avançados não fazem parte do plano deste workspace.» Veja o que o seu plano inclui em https://sparkleleadz.com/planos.
#Veja também
Que bom! Obrigado pelo retorno.
Poxa. Tente a solução de problemas ou fale com o suporte.
Mais em Funil
Ver os 10 artigos