Documentação completa 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. 1Acesse sua conta e confirme se o idioma está em Português.
2. 2Revise nome, e-mail e telefone em Configurações Gerais.
3. 3Cadastre usuários e defina permissões: owner, admin ou agent.
4. 4Crie departamentos como Vendas, Suporte, Financeiro e Pós-venda.
5. 5Crie tags para origem, prioridade, interesse, campanha e status.
6. 6Crie etapas do funil como Novo, Qualificando, Proposta, Negociação, Ganhou e Perdido.
7. 7Conecte o WhatsApp e envie uma mensagem de teste.

A página Conexões é onde você conecta e acompanha seus números. Você pode trabalhar com QR Code e, quando disponível no plano/configuração, API Oficial da Meta.

1. 1Acesse Conexões no menu principal.
2. 2Clique para adicionar uma nova conexão.
3. 3Informe um nome claro para a instância, como vendas-principal ou suporte-loja.
4. 4Escolha QR Code ou API Oficial, conforme disponibilidade.
5. 5No QR Code, escaneie com o celular do WhatsApp empresarial.
6. 6Aguarde o status conectado/open.
7. 7Envie e receba uma mensagem de teste.

A conversa com o cliente reúne mensagens, notas internas, tags, agente, departamento, etapa do funil, valor, campos personalizados e ativos de mídia.

1. 1Abra Dashboard ou Conversas e selecione o cliente.
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 os ativos de mídia para consultar imagens, vídeos, áudios, documentos e localização.

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 transforma conversas em oportunidades visuais. Cada coluna representa uma etapa do funil e pode mostrar soma dos valores dos leads daquela etapa.

1. 1Crie etapas simples: Novo, Qualificando, Proposta, Negociação, Ganhou e Perdido.
2. 2Mova o card conforme o avanço da conversa.
3. 3Preencha o valor do lead quando existir oportunidade comercial.
4. 4Use tags para marcar origem, produto, prioridade ou campanha.
5. 5Revise leads sem última atividade para evitar oportunidades esquecidas.

O construtor visual permite criar fluxos por mensagem, palavra-chave, webhook e Shopee. Um bom fluxo deve ter objetivo claro: responder, qualificar, direcionar, recuperar ou registrar dados.

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 para salvar 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.

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.

O fluxo Shopee busca produtos na API de afiliados, filtra ofertas, formata mensagens com variáveis e envia para grupos de WhatsApp.

• Plano com recurso Shopee habilitado.
• Credenciais App ID e Secret da API de Afiliados Shopee.
• WhatsApp conectado via QR Code e presente nos grupos.
• Grupos já criados no WhatsApp.
• Limite de grupos respeitando o plano contratado.

1. 1Crie uma automação e escolha o gatilho Shopee.
2. 2No Shopee Trigger, preencha App ID, Secret e intervalo em minutos.
3. 3Escolha Melhores Ofertas ou Busca por palavra-chave.
4. 4Teste para visualizar produtos retornados.
5. 5Adicione Filtro Shopee para preço, comissão, desconto, vendas e limite de produtos.
6. 6Adicione Loop de Produtos para iterar sobre cada oferta aprovada.
7. 7Adicione Formatar Produto e monte a mensagem com variáveis.
8. 8Escolha se deseja enviar com imagem quando imageUrl existir.
9. 9Adicione Enviar para Grupo, selecione instância, grupos e delay.
10. 10Teste o envio, salve e ative.

Produto: *{{product.name}}*
Preço: R$ {{product.priceMin}}
Comissão: {{product.commissionRate}}%
Vendas: {{product.sales}}
Loja: {{product.shopName}}
Link: {{product.affiliateLink}}

Campanhas servem para enviar mensagens para listas segmentadas. Use contatos já salvos ou importação, sempre respeitando consentimento e boas práticas.

1. 1Acesse Campanhas e crie uma nova campanha.
2. 2Escolha a instância ou canal de envio.
3. 3Selecione contatos salvos ou importe uma lista.
4. 4Filtre por tags, etapa, agente, departamento ou outros critérios disponíveis.
5. 5Revise mensagem, mídia ou template.
6. 6Envie um teste para seu próprio número.
7. 7Acompanhe envios e respostas na caixa de entrada.

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.

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.