Tutoriais do ActiveZap

Antes de atender em volume, organize a operação. O ActiveZap funciona melhor quando cada conversa tem responsável, departamento, etapa, tags, histórico e dados do cliente.

1. 1Abra Configurações > Geral e revise os dados da empresa.
2. 2Em Configurações > Equipe, convide os usuários e escolha as permissões adequadas.
3. 3Crie departamentos como Vendas, Suporte, Financeiro e Pós-venda.
4. 4Em Configurações > Tags, crie tags por origem, prioridade, interesse, campanha e status.
5. 5Configure as etapas do pipeline, por exemplo: Novo, Qualificação, Proposta, Negociação, Ganhou e Perdido.
6. 6Abra Canais e alcance > Conexões, conecte um canal e faça um teste de envio e recebimento.

Em Canais e alcance > Conexões, clique em Conectar WhatsApp. O ActiveZap oferece conexão por QR Code e API Oficial da Meta, conforme o plano e a configuração da conta.

Conectar por QR Code

1. 1Clique em Conectar WhatsApp e selecione a aba QR Code.
2. 2Informe um nome claro, como vendas-principal, e o número com DDI e DDD.
3. 3Revise as preferências. Ative Ignorar grupos se não quiser receber conversas de grupos no CRM.
4. 4Crie a conexão e, quando o QR Code aparecer, leia em WhatsApp > Aparelhos conectados.
5. 5Aguarde a conexão ficar ativa e teste uma mensagem nos dois sentidos.

Conectar pela API Oficial

1. 1Clique em Conectar WhatsApp, escolha API Oficial e dê um nome para a conexão.
2. 2Prefira Conectar com a Meta para usar o fluxo de coexistência. Marque a importação de histórico apenas se desejar trazê-lo.
3. 3Para conexão manual, abra Configuração avançada e copie a URL de callback exibida pelo ActiveZap para o webhook do aplicativo na Meta.
4. 4Informe o Phone Number ID, o WABA ID e o token permanente do usuário do sistema. Não use o número de telefone no campo Phone Number ID.
5. 5Conclua a conexão, verifique o diagnóstico e teste uma mensagem recebida e uma enviada.

Instagram Direct, comentários e Facebook Messenger entram na mesma caixa de entrada usada pelo WhatsApp. As conexões são oficiais e cada conta ou Página respeita os limites do plano.

1. 1Abra Canais e alcance > Conexões.
2. 2Escolha Instagram ou Facebook no bloco Conecte seus canais.
3. 3Entre na conta Meta que administra os ativos e aceite as permissões necessárias.
4. 4No Facebook, selecione somente as Páginas e contas profissionais que deseja ativar.
5. 5Confirme que as contas aparecem em Contas sociais conectadas.
6. 6Envie uma mensagem real pelo Direct ou Messenger e confira a conversa em Conversas.

A área Conversas reúne WhatsApp, Instagram e Messenger. Cada atendimento mantém mensagens, canal de origem, responsável, departamento, etapa, tags, valor, dados do contato, notas internas e mídias.

1. 1Abra Conversas e use as abas para filtrar todos os canais, não lidos, WhatsApp, Instagram ou Messenger.
2. 2Leia o histórico antes de responder.
3. 3Use notas internas para registrar contexto que o cliente não deve ver.
4. 4Atribua agente e departamento quando a conversa precisar de dono.
5. 5Atualize etapa do funil, valor e tags conforme a negociação evoluir.
6. 6Use a lateral da conversa para consultar imagens, vídeos, áudios, documentos, localização, produtos e agenda.

O follow-up envia uma mensagem futura para uma conversa específica. Por padrão, ele pode ser cancelado automaticamente quando o cliente responde antes do horário, evitando abordagens fora de contexto.

1. 1Abra uma conversa ou a visão 360° de um contato que já possua conversa vinculada.
2. 2Clique em Follow-up no cabeçalho do atendimento.
3. 3Escolha Em 1 hora, Amanhã, Em 3 dias ou informe uma data e hora personalizada.
4. 4Escreva a mensagem que será enviada.
5. 5Mantenha Cancelar se houver resposta ativado quando o lembrete só fizer sentido sem retorno do cliente.
6. 6Clique em Agendar follow-up e confira o agendamento na mesma janela.

Contatos são a base do relacionamento. Use filtros, tags, agentes, departamentos, instâncias, funil e campos personalizados para organizar sua operação.

1. 1Acesse Contatos.
2. 2Clique em Importar para enviar um CSV ou cadastre manualmente.
3. 3Revise telefone, nome, tags, etapa e responsável.
4. 4Crie campos personalizados para CPF, CNPJ, endereço, cidade, país, valor ou dados próprios.
5. 5Use filtros para selecionar públicos antes de campanhas.

O Pipeline de vendas fica no menu principal, separado de Conversas. Cada conversa em aberto é um negócio: o quadro mostra o valor total, os negócios abertos, a conversão, o ciclo de vendas e o resultado por canal. Cada pipeline possui suas próprias etapas, e cada coluna mostra a quantidade e a soma dos valores.

1. 1Acesse Configurações > Pipelines para criar um fluxo, dentro do limite do seu plano.
2. 2No Pipeline de vendas, troque de pipeline pelas abas acima das colunas.
3. 3Use "Novo negócio" em uma coluna para colocar uma conversa existente na etapa ou cadastrar um novo contato de WhatsApp.
4. 4Clique no card para abrir a conversa. Conversão e ciclo de vendas começam a ser medidos a partir da ativação do histórico.
5. 5Defina nome, categoria e, se desejar, departamento e atendente padrão.
6. 6O atendente escolhido precisa fazer parte do departamento selecionado.
7. 7Ao colocar um contato em outro pipeline, os responsáveis padrão são aplicados. Contatos que já estavam nele não são reatribuídos ao editar a configuração.
8. 8Em Configurações > Pipelines, escolha um pipeline para criar, editar, reordenar ou excluir suas etapas. Também é possível ajustar as etapas pelo quadro.
9. 9Etapas com contatos ou usadas em automações não podem ser excluídas. Mova os contatos ou atualize o fluxo antes.
10. 10Crie etapas simples: Novo, Qualificando, Proposta, Negociação, Ganhou e Perdido.
11. 11Mova o card conforme o avanço da conversa.
12. 12Preencha o valor do lead quando existir oportunidade comercial.
13. 13Arquive pipelines vazios que não sejam mais necessários. Pipelines arquivados não contam no limite do plano.

Em Automação, o construtor visual cria fluxos por mensagem, primeira mensagem, fallback, webhook, agendamento e comentários sociais. As ofertas de afiliados possuem uma área guiada separada.

1. 1Crie uma automação e selecione a instância.
2. 2Configure o gatilho no nó Início.
3. 3Adicione uma mensagem de boas-vindas.
4. 4Colete nome, interesse ou necessidade do cliente.
5. 5Use Criar contato ou Salvar contato para registrar os dados no CRM.
6. 6Aplique tag e mova para uma etapa do funil.
7. 7Finalize informando que um atendente continuará, se necessário.
8. 8Salve, ative e teste todos os caminhos antes de divulgar.

A Biblioteca reúne modelos publicados pela equipe ActiveZap. Ao instalar, o fluxo entra como rascunho para que você revise mensagens, conexão e regras antes de ativar.

1. 1Abra Automação > Biblioteca.
2. 2Confira categoria, nicho, dificuldade e recursos exigidos pelo modelo.
3. 3Clique em Instalar modelo. Se o plano não possuir um recurso necessário, o botão indicará o bloqueio.
4. 4Abra a automação criada e substitua textos, conexões, destinatários e regras pelos dados da sua operação.
5. 5Teste todos os caminhos e só então ative o fluxo.

Uma automação social pode iniciar por comentário em uma publicação e enviar uma resposta privada. No Instagram, esse recurso precisa estar liberado no plano.

1. 1Conecte a conta do Instagram ou a Página do Facebook em Canais e alcance > Conexões.
2. 2Crie uma automação para a conexão social correta.
3. 3No nó Início, escolha Comentário no Instagram ou Comentário no Facebook.
4. 4Defina se o gatilho vale para todas as publicações ou selecione posts específicos.
5. 5Escolha qualquer comentário, correspondência exata ou texto contendo palavras-chave.
6. 6Adicione Resposta privada social e escreva a mensagem inicial enviada ao autor do comentário.
7. 7Complete o fluxo apenas com componentes compatíveis, salve, ative e teste em uma publicação real.

O webhook inicia uma automação quando outro sistema envia dados ao ActiveZap, como formulário de landing page, checkout, CRM externo ou sistema próprio.

{
  "event": "landing_popup_lead_created",
  "lead": {
    "name": "Maria Silva",
    "email": "maria@email.com",
    "whatsapp": "+55 11 99999-9999",
    "utm_source": "google",
    "utm_campaign": "campanha-activezap"
  }
}

1. 1Crie uma automação com gatilho Webhook.
2. 2Copie a URL gerada pelo ActiveZap.
3. 3Configure o sistema externo para enviar POST para essa URL.
4. 4Dispare um teste para visualizar os campos recebidos.
5. 5Clique nos campos do preview para copiar a variável correta.
6. 6No Criar contato, use caminhos como lead.name e lead.whatsapp.
7. 7Mapeie tag, etapa, agente, departamento e campos personalizados.
8. 8Salve, ative e teste do formulário até a conversa no WhatsApp.

As automações para afiliados agora possuem uma configuração guiada própria. Não é necessário montar nodes de busca, filtro, loop e envio no construtor visual.

1. 1Abra Automação > Automação para Afiliados.
2. 2Clique para criar uma nova automação e escolha Shopee ou Amazon.
3. 3Selecione a conexão do marketplace e a conexão WhatsApp que fará os envios.
4. 4Configure busca, filtros de oferta, quantidade de produtos e frequência.
5. 5Escolha os grupos de destino e ajuste a mensagem gerada.
6. 6Faça um teste, revise a oferta recebida no grupo e ative a automação.
7. 7Acompanhe as execuções e corrija qualquer aviso exibido no painel.

Campanhas usam uma conexão da API Oficial e um template aprovado pela Meta. Para conexões por QR Code, existe a ferramenta separada Disparo em massa via QR Code, disponível conforme o plano.

1. 1Acesse Campanhas e crie uma nova campanha.
2. 2Informe o nome, selecione uma conexão oficial e escolha a data de envio.
3. 3Use contatos já salvos ou importe um CSV com a coluna de telefone.
4. 4Para contatos do CRM, filtre por busca, tags, etapa, departamento e agente.
5. 5Selecione um template aprovado compatível com a conexão.
6. 6Revise a prévia e o mapeamento das variáveis antes de criar.
7. 7Acompanhe status, entregas e erros na página da campanha; as respostas entram em Conversas.

Templates são mensagens aprovadas pela Meta para iniciar ou retomar conversas fora da janela de atendimento. Eles são essenciais para quem usa API Oficial.

1. 1Acesse Templates.
2. 2Escolha a instância oficial vinculada à Meta.
3. 3Crie nome, categoria, idioma e conteúdo.
4. 4Use variáveis numeradas quando precisar personalizar dados.
5. 5Envie para aprovação.
6. 6Depois de aprovado, use em campanhas, conversas ou automações.

A Agenda centraliza os próximos compromissos vinculados aos contatos. As reuniões são criadas a partir da conversa ou da visão 360° e podem ser sincronizadas com o Google Calendar do usuário.

1. 1Abra Configurações > Google Calendar e conecte a conta Google que receberá os eventos.
2. 2Abra uma conversa ou um contato e localize o painel Agenda.
3. 3Clique em Agendar reunião e informe título, data, duração, lembrete e descrição.
4. 4Ative Criar link do Google Meet quando a reunião for online.
5. 5Salve e confira o compromisso na página Agenda e no perfil do contato.
6. 6Use Agenda para abrir a conversa, entrar no Meet ou cancelar um compromisso futuro.

O Agente de IA pode responder clientes, consultar a base de conhecimento, preencher dados do contato e mover o funil conforme regras. O uso pode consumir créditos conforme modelo, tokens e processamento.

1. 1Acesse Configurações de IA.
2. 2Escreva uma instrução clara sobre o papel do agente.
3. 3Adicione textos e arquivos na base de conhecimento.
4. 4Defina o que a IA pode responder e quando deve chamar humano.
5. 5Teste perguntas difíceis antes de ativar para clientes reais.
6. 6Monitore consumo de créditos e qualidade das respostas.

A área Desenvolvedores permite criar chaves de API e enviar mensagens por integração. Use para conectar CRMs, checkouts, formulários, ferramentas internas e automações externas.

curl -X POST "https://seudominio.com.br/api/v1/send" \
  -H "Authorization: Bearer sk_live_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "instanceName": "minha-instancia",
    "number": "5511999999999",
    "type": "text",
    "message": "Olá, tudo bem?"
  }'

• Envie a chave no header Authorization como Bearer.
• Nunca exponha chaves de API no frontend.
• Use instanceName exatamente como aparece na conexão.
• Use número com DDI e DDD, por exemplo 5511999999999.
• Revogue chaves em caso de suspeita de vazamento.