Documentação — Mais Conversa

O que é o sistema?

O Mais Conversa é uma plataforma completa de atendimento e automação via WhatsApp. Com ele você pode conectar múltiplos números, gerenciar todas as conversas num inbox centralizado, organizar clientes num CRM, criar fluxos de automação visuais, disparar campanhas em massa, usar inteligência artificial para atendimento automático, enviar e receber e-mails e muito mais.

Navegando pelo sistema

O menu lateral esquerdo dá acesso a todas as áreas:

Fluxo recomendado para começar

1. 1Acesse Configurações → Conexões e conecte seu número de WhatsApp (via QR Code ou API Oficial Meta).
2. 2Acesse Configurações → Minha Conta e ajuste seu nome e setor de atuação.
3. 3Opcionalmente clique em 👥 Importar Contatos no card da instância para trazer os contatos do seu WhatsApp para o CRM.
4. 4Configure as Tags e o Funil de Vendas em Contatos para organizar seus leads.
5. 5Crie seu primeiro Fluxo de Automação para responder automaticamente palavras-chave.
6. 6Se desejar atendimento por IA, configure o Agente de IA com o prompt da sua empresa.
7. 7Para e-mails, acesse Configurações → Conexões e adicione uma conta de e-mail (SMTP/IMAP).
8. 8Se tiver API Oficial Meta (WABA), configure os Templates para campanhas aprovadas.

WhatsApp Web — Conexão via QR Code (Baileys)

Conecta qualquer número de WhatsApp lendo um QR Code, sem precisar de conta Meta Business.

1. 1Acesse Configurações → Conexões e clique em "+ Nova Conexão".
2. 2Na aba WhatsApp Web, preencha um nome para a instância (ex: Suporte, Vendas).
3. 3Opcionalmente informe o número no formato internacional (ex: 5541999990000).
4. 4Configure as preferências de comportamento (tabela abaixo) e clique em "Criar Instância".
5. 5O QR Code será exibido. No seu celular abra o WhatsApp → Aparelhos Conectados → Conectar um aparelho e escaneie.
6. 6Após a leitura, o status muda para Online (ponto verde pulsante).

Preferências disponíveis:

WhatsApp Business API — API Oficial Meta (WABA)

Para contas Meta Business verificadas. Maior estabilidade, suporte a templates aprovados e campanhas em escala.

Opção 1 — Login com Meta (recomendado)

A forma mais simples de conectar. O sistema abre o fluxo oficial da Meta diretamente no navegador.

1. 1Acesse Configurações → Conexões e clique em "+ Nova Conexão".
2. 2Selecione a aba API Oficial Meta (WABA).
3. 3Preencha um nome para a instância e clique no botão "Entrar com Meta".
4. 4Uma janela pop-up abrirá o fluxo oficial da Meta — faça login com sua conta do Facebook Business.
5. 5Selecione a conta Business, o número de telefone e conceda as permissões solicitadas.
6. 6Após autorizar, o sistema receberá o token automaticamente e a conexão será criada.
7. 7O card aparecerá com a badge API Oficial em azul.

Opção 2 — Token Manual

Para quem já tem um Token de Sistema de Usuário permanente gerado no Meta Developer.

1. 1Na aba API Oficial Meta (WABA), expanda a seção Configuração Manual.
2. 2Preencha o Token do Sistema, o ID da Conta Business e o ID do Número de Telefone.
3. 3Clique em "Criar Instância". A conexão é feita automaticamente via Meta.

Importar Contatos do WhatsApp

1. 1O número precisa estar com status Online.
2. 2No card da instância, clique no ícone 👥 (Importar Contatos).
3. 3Confirme. O sistema buscará todos os contatos individuais daquele número.
4. 4Um toast mostrará quantos contatos foram importados e quantos já existiam.
5. 5Os contatos aparecerão em Contatos no menu lateral.

Ações nos cards de conexão

Visão geral

Enviando mensagens

1. 1Clique numa conversa na lista para abri-la.
2. 2Digite na caixa de texto na parte inferior.
3. 3Use os botões de anexo para enviar imagens, documentos, áudios ou outros arquivos.
4. 4Pressione Enter ou clique no ícone de enviar.

Respostas Rápidas

1. 1Acesse Configurações → Respostas Rápidas.
2. 2Clique em "+ Nova Resposta", defina um atalho (ex: /ola) e o texto completo.
3. 3No chat, digite / para ver os atalhos disponíveis e selecione o desejado.

Tags, Funil e CRM dentro do chat

Configurar uma conta de e-mail

1. 1Acesse Configurações → Conexões e clique na aba E-mail.
2. 2Clique em "+ Adicionar Conta".
3. 3Preencha os dados do servidor SMTP (envio): host, porta, usuário e senha.
4. 4Preencha os dados do servidor IMAP (recebimento): host, porta, usuário e senha.
5. 5Clique em "Salvar e Testar" — o sistema enviará um e-mail de teste para confirmar.
6. 6Com a conta ativa, clique em Sincronizar para carregar os e-mails recebidos.

Usando a caixa de entrada

Enviando e-mails

1. 1Clique no botão "+ Novo" na barra superior da caixa de entrada.
2. 2Selecione a conta remetente, preencha destinatário, assunto e corpo da mensagem.
3. 3Use o editor de texto rico: negrito, itálico, listas, títulos, alinhamento, links e cores.
4. 4Opcionalmente selecione um Template para carregar um modelo pré-configurado.
5. 5Clique no ícone de Anexo (📎) para adicionar arquivos (PDF, imagens, documentos).
6. 6Clique em "Enviar".

Respondendo e-mails

1. 1Abra o e-mail no painel de detalhe.
2. 2Clique no botão "Responder" — o campo de resposta rápida aparece na parte inferior.
3. 3Digite sua resposta e clique em "Enviar Resposta".

Anexos

Templates de E-mail

1. 1Acesse a aba Templates dentro da seção de E-mail.
2. 2Clique em "+ Novo Template".
3. 3Defina um nome, assunto padrão, corpo da mensagem (com editor rico) e opcionalmente anexe arquivos (ex: proposta comercial em PDF).
4. 4Salve o template. Ao compor um novo e-mail, selecione o template para carregar tudo automaticamente — incluindo os anexos.

Excluir e-mails

Criar contato manualmente

1. 1Clique em "+ Novo Contato" na tela de Contatos.
2. 2Informe o nome e o número (formato internacional sem caracteres: ex: 5511999990000).
3. 3Preencha opcionalmente tags, funil, agente e campos personalizados.
4. 4Clique em "Salvar".

Importar via planilha (CSV / Excel)

1. 1Na tela de Contatos, clique no botão Importar (ícone de upload).
2. 2Baixe o modelo de planilha para ver o formato correto.
3. 3Preencha as colunas: name, phone, e opcionalmente stage, agentEmail, notes, tags.
4. 4Faça o upload e confirme a importação.

Exportar contatos

1. 1Clique no botão Exportar (ícone de planilha) na tela de Contatos.
2. 2Um arquivo .xlsx é gerado com todos os contatos visíveis (respeitando filtros ativos).

Campos Personalizados

1. 1Clique no ícone ⚙️ Gerenciar Campos na tela de Contatos.
2. 2Clique em "+ Novo Campo".
3. 3Defina nome, chave (identificador interno) e tipo (Texto ou Sim/Não).
4. 4O campo aparece em todos os contatos e pode ser preenchido no painel CRM de cada conversa.

Funil de Vendas (Kanban)

1. 1Acesse a aba Funil na tela de Contatos.
2. 2Crie as etapas do seu processo (ex: Novo Lead → Qualificação → Proposta → Fechado → Perdido).
3. 3Arraste os cards entre colunas para avançar um contato de etapa.
4. 4As etapas também podem ser alteradas diretamente no painel CRM dentro de uma conversa.

Como criar um fluxo

1. 1Acesse Automação e clique em "+ Novo Fluxo".
2. 2Dê um nome ao fluxo (ex: "Boas-vindas", "Suporte") e confirme.
3. 3O construtor visual abre com o nó Início já posicionado.
4. 4Adicione nós pela paleta lateral e conecte arrastando as saídas para as entradas.
5. 5Configure cada nó clicando sobre ele.
6. 6Quando terminar, clique em "Ativar" no topo para colocar em funcionamento.

Tipos de Gatilho (nó Início)

Nós disponíveis

Opções do nó Controle de IA:

Variáveis

Follow-up Automático

O nó Follow-up permite enviar mensagens automáticas quando um contato não responde dentro de um prazo definido — ideal para qualificação de leads, confirmação de visitas e reengajamento.

Gatilho Webhook — Integração com sistemas externos

1. 1No nó Início, selecione o tipo Webhook.
2. 2Copie a URL do Webhook exibida (ex: https://seu-dominio.com/api/webhook/trigger/TOKEN).
3. 3Configure qual campo do payload contém o número de telefone (ex: phone ou customer.phone).
4. 4Opcionalmente defina o campo de nome e outras variáveis a extrair.
5. 5Configure seu sistema externo (Kiwify, Hotmart, CRM) para enviar um POST para essa URL.
6. 6Quando a requisição chegar, o fluxo inicia automaticamente para o número recebido.

Configuração Global

A configuração global define o provedor, a chave de API e os padrões do agente. Todos os números sem persona própria usarão estas configurações.

1. 1Acesse Configurações → Agente IA no menu lateral.
2. 2Na aba Configuração Global, selecione o Provedor: OpenAI (GPT) ou Google Gemini.
3. 3Insira sua Chave de API do provedor escolhido.
4. 4Escolha o Modelo (ex: GPT-4o, GPT-4.1 Mini, Gemini 2.5 Flash).
5. 5Escreva o Prompt do Agente: quem é a IA, como se comportar e o que pode responder.
6. 6Configure o Debounce (segundos): intervalo de espera antes de responder — agrupa mensagens enviadas rapidamente em sequência.
7. 7Opcionalmente defina uma Assinatura que será adicionada ao final de todas as respostas.
8. 8Ative com o toggle "Agente Ativo" e clique em Salvar.

Parâmetros avançados:

Personas por Instância

Cada número conectado pode ter sua própria persona com identidade, prompt e comportamento diferentes — todos compartilhando a mesma chave de API global.

1. 1Na aba Personas em Agente IA, você verá todos os números conectados.
2. 2Clique em "Configurar Persona" no número desejado.
3. 3Preencha os campos da persona (detalhes na tabela abaixo) e salve.
4. 4O badge "Persona ativa" aparecerá no card daquele número.
5. 5Números sem persona configurada usam a Configuração Global.

Dicas para o Prompt

• Apresente a identidade: "Você é a Ana, assistente de vendas da Empresa X."
• Defina o tom: formal, informal, objetivo, amigável.
• Liste o que pode e o que não pode responder.
• Instrua quando escalar para um agente humano: "Se o cliente pedir falar com humano, use a ferramenta handover_to_human."
• Inclua informações sobre produtos, horários, preços e políticas diretamente no prompt ou na base de conhecimento.
• Use a base de conhecimento para PDFs e documentos extensos — não sobrecarregue o prompt.

Ferramentas (Function Calling)

As ferramentas permitem que a IA execute ações no sistema durante a conversa, além de apenas responder com texto.

Ferramentas built-in (disponíveis automaticamente):

Ferramentas personalizadas (aba Ferramentas):

Crie ferramentas que enviam arquivos de mídia (PDF, imagem, vídeo, áudio) ao cliente quando solicitado. Útil para enviar catálogos, propostas, tutoriais em vídeo etc.

1. 1Acesse a aba Ferramentas em Agente IA.
2. 2Clique em "+ Nova Ferramenta".
3. 3Defina um nome (ex: enviar_catalogo), descrição (para a IA saber quando usar) e o arquivo de mídia.
4. 4Opcionalmente defina uma mensagem de confirmação após o envio.
5. 5Ative a ferramenta — a IA passará a usá-la automaticamente quando identificar a intenção.

Usando o Agente de IA num Fluxo

Nos fluxos de automação, adicione o nó Controle de IA para ativar, pausar ou resetar o histórico do assistente em um ponto específico da conversa. Isso permite combinar fluxos estruturados com atendimento por IA de forma fluida.

O que são Templates?

Como criar e usar Templates

1. 1Certifique-se de ter uma instância WABA (API Oficial) conectada.
2. 2Acesse Modelos e clique em "+ Novo Template".
3. 3Preencha nome (sem espaços, ex: boas_vindas), categoria e idioma.
4. 4Escreva o corpo com variáveis {{1}}, {{2}}.
5. 5Clique em "Enviar para Aprovação". A Meta analisa em 24–48h.
6. 6Quando aprovado, o template fica disponível em Campanhas e Fluxos.

Sincronizar Templates

1. 1Se criou templates diretamente no Meta Business Manager, clique em "Sincronizar".
2. 2Isso importa todos os templates cadastrados na sua conta Meta para o sistema.

Como criar uma Campanha

1. 1Acesse Campanhas e clique em "+ Nova Campanha".
2. 2Dê um nome e selecione o número de envio (instância conectada).
3. 3Escolha o tipo: mensagem simples (WhatsApp Web) ou via Template (WABA).
4. 4Para Template: selecione o template aprovado e preencha os valores das variáveis.
5. 5Selecione o público-alvo: todos os contatos, por tag ou por etapa do funil.
6. 6Defina opcionalmente um intervalo entre envios para reduzir risco de bloqueio.
7. 7Clique em "Salvar" — a campanha fica em status Rascunho.
8. 8Quando pronto, clique em ▶ Iniciar no card da campanha para disparar.

Monitoramento

Métricas disponíveis

Pessoal

Equipe

Plataforma

Técnico

Desenvolvedores — API Keys

1. 1Acesse Configurações → Desenvolvedores.
2. 2Clique em "+ Nova Chave" e dê um nome descritivo (ex: "Integração Kiwify").
3. 3Copie e guarde a chave gerada — ela não será exibida novamente.
4. 4Use no header Authorization: Bearer SUA_CHAVE em todas as requisições à API.
5. 5Para revogar uma chave, clique no ícone de excluir ao lado dela.

Autenticação

Enviar mensagem (POST /api/v1/send)

Disparar Fluxo via Webhook