Primeiros Passos

Bem-vindo ao Moppyz — a plataforma omnichannel mais completa para automação de atendimento ao cliente. Centralize WhatsApp, Instagram e Telegram em um único painel inteligente.

Criando sua conta

1

Acesse moppyz.com/register

Você pode se cadastrar com Email e Senha ou com Google (1-click).
2

Configure sua empresa

Após o cadastro, o sistema cria automaticamente seu Tenant (workspace) com o nome da sua empresa e configura o plano padrão com Free Trial.
3

Conecte seus canais

Vá em Configurações → Canais para conectar WhatsApp, Instagram ou Telegram.

Visão geral do Dashboard

O painel principal mostra suas conversas ativas no menu lateral. Use a barra de navegação para acessar: Conversas, Contatos (CRM), Agentes IA,Fluxos, Templates, Campanhas,Analytics e Configurações.

WhatsApp Business

O Moppyz se conecta diretamente à WhatsApp Cloud API oficial da Meta, sem intermediários ou provedores terceiros.

O que é a WhatsApp Cloud API?

É a API oficial da Meta para empresas enviarem e receberem mensagens via WhatsApp. Diferente do app pessoal, a Cloud API permite automação, múltiplos agentes e integração com sistemas.

Como conectar (Embedded Signup)

1

Acesse Configurações → Canais → WhatsApp

Na seção WhatsApp, clique no botão "Conectar WhatsApp Business".
2

Meta Embedded Signup

Um popup do Facebook abrirá. Faça login com sua conta Meta Business e selecione ou crie uma Meta Business Account. Depois, selecione ou crie um WhatsApp Business Account (WABA).
3

Registre seu número

Escolha o número de telefone que deseja usar. Ele será verificado por SMS ou ligação.
4

Pronto!

Após a verificação, o Moppyz salva automaticamente o Phone Number ID, o WABA ID e gera um Token de acesso permanente. Os webhooks são configurados automaticamente.

ℹ️ Info

Você precisa de uma conta Meta Business verificada. Se ainda não tem, o processo do Embedded Signup permite criá-la durante o fluxo.

Janela de 24 horas

A Meta impõe uma regra: após o cliente enviar uma mensagem, você tem 24 horas para responder livremente (mensagens de sessão). Após esse período, só pode enviar Templates pré-aprovados.

Instagram Direct Messages

Integre sua conta Instagram Profissional para receber e responder DMs diretamente no painel do Moppyz.

Requisitos

  • Conta Instagram Profissional (Business ou Creator)
  • Conta conectada a uma Página do Facebook
  • Ser administrador da Página

Como conectar (OAuth)

1

Acesse Configurações → Canais → Instagram

Clique em "Conectar Instagram".
2

Autorize no Instagram

Você será redirecionado para instagram.com/oauth/authorize. Faça login e autorize o Moppyz a acessar suas mensagens.
3

Conta conectada!

O Moppyz salva o token de acesso e configura os webhooks automaticamente. Seu @username aparecerá na tela de Configurações.

⚠️ Atenção

Não use conta pessoal. O Instagram exige conta Profissional (Business ou Creator)para acessar a API de mensagens.

Human Agent

Com a permissão Human Agent, o Moppyz pode responder mensagens até 7 dias após o envio pelo cliente (ao invés de apenas 24 horas). Isso é essencial para empresas que fecham nos finais de semana.

Telegram Bot

O Telegram é o canal mais rápido de configurar. Basta criar um bot e colar o token.

Como criar um bot

1

Abra o Telegram e busque @BotFather

O BotFather é o bot oficial do Telegram para criar bots.
2

Envie /newbot

Siga as instruções: escolha um nome e um username(deve terminar em "bot", ex: MeuAtendimentoBot).
3

Copie o token

O BotFather vai te dar um token no formato: 123456789:ABCdef...
4

Cole no Moppyz

Vá em Configurações → Canais → Telegram, cole o token e clique em Salvar. O Moppyz configura o webhook automaticamente.

💡 Dica

O bot começa a receber mensagens instantaneamente após a configuração. Teste enviando uma mensagem para seu bot no Telegram.

Conversas & Chat

A tela de Conversas é o coração do Moppyz. Todas as mensagens de todos os canais aparecem em uma única inbox unificada.

Funcionalidades

  • Chat em tempo real — mensagens chegam instantaneamente via webhooks
  • Mídias — envie e receba imagens, vídeos, áudios e documentos
  • Templates — envie templates aprovados diretamente pelo chat
  • Assumir Conversa — tome o controle do AI a qualquer momento
  • Notas internas — adicione notas visíveis apenas para a equipe
  • Indicador de canal — cada conversa mostra o ícone do canal (WhatsApp, Instagram, Telegram)

ℹ️ Info

Quando um Agente IAestá ativo, ele responde automaticamente. Clique em "Assumir Conversa" para desativar o AI e responder manualmente.

Templates

O que são Templates?

Templates são mensagens pré-aprovadas pela Meta que você pode enviar para iniciar ou retomar conversas fora da janela de 24 horas. São obrigatórios para campanhas em massa e para o WhatsApp.

Categorias

Marketing

Promoções, ofertas, lançamentos

Utility

Confirmações, atualizações, lembretes

Authentication

Códigos de verificação, OTPs

Como criar um Template

1

Vá em Templates → Criar Novo

Escolha a categoria, idioma e dê um nome ao template.
2

Escreva o conteúdo

Use variáveis dinâmicas com {{1}}, {{2}}, etc. Exemplo:Olá {{1}}, seu pedido {{2}} foi confirmado!
3

Envie para aprovação

Clique em "Enviar". A Meta analisa o template (geralmente leva de minutos a horas). Status possíveis: Pendente, Aprovado, Rejeitado.

Fluxos Visuais (FlowStudio)

O FlowStudio é o construtor visual de chatbots do Moppyz. Crie automações complexas sem escrever uma linha de código.

Tipos de Nodes

💬 Mensagem

Envia uma mensagem de texto, imagem ou template ao contato.

🔀 Condição (If/Else)

Cria ramificações baseadas em condições (tags, variáveis, horário).

⏰ Delay

Pausa o fluxo por X minutos/horas antes de continuar.

📝 Coleta

Solicita uma informação ao contato e salva como variável.

🏷️ Ação CRM

Adiciona tags, atualiza campos do contato ou transfere para humano.

📋 Template

Envia um template aprovado pela Meta com variáveis dinâmicas.

Como criar um fluxo

1

Vá em Fluxos → Criar Novo

Dê um nome ao fluxo e defina o gatilho (palavra-chave, primeiro contato, etc.).
2

Monte no canvas

Arraste nodes do painel lateral para o canvas. Conecte-os arrastando as setas entre as portas de saída e entrada.
3

Configure cada node

Clique em um node para editar seu conteúdo: texto da mensagem, condição, duração do delay, etc.
4

Publique

Clique em "Publicar". O fluxo ficará ativo imediatamente e começará a ser executado quando o gatilho for ativado.

Agentes de IA

Os Agentes de IA do Moppyz são assistentes virtuais alimentados pelo Google Gemini. Eles respondem automaticamente aos clientes com base em instruções personalizadas e uma base de conhecimento da sua empresa.

Como configurar

1

Vá em Agentes IA → Criar Novo

Dê um nome ao agente (ex: "Atendimento Geral", "Vendas").
2

Configure a personalidade

Defina as instruções do sistema: tom de voz, regras de resposta, quando escalar para humano, idioma, etc.
3

Adicione a Base de Conhecimento

Cole textos com informações sobre sua empresa: produtos, preços, horários, políticas, FAQ. O AI usará essas informações para responder.
4

Ative o agente

Marque o agente como ativo. Ele será automaticamente atribuído às novas conversas.

💡 Dica

Use o botão "Assumir Conversa" na tela de chat a qualquer momento para desativar o AI e responder pessoalmente.

WebChat Widget

O WebChat Widget permite que você adicione um chat em tempo real ao seu site. Os visitantes conversam diretamente com sua equipe (ou Agente IA) e as mensagens aparecem no omnichannel junto com WhatsApp, Instagram e Telegram.

Como criar um Widget

1

Vá em WebChat → Novo Widget

Dê um nome ao widget (ex: "Widget Site Principal").
2

Personalize

Configure cores, tema (claro/escuro), ícone do botão flutuante, posição, mensagem de boas-vindas, formulário pré-chat e agente IA vinculado.
3

Preview em Tempo Real

No painel lateral, veja uma prévia ao vivo do widget que atualiza conforme você modifica as opções.
4

Copie o Snippet

Na aba "Instalação", copie o código HTML e cole antes do </body> do seu site.

Personalização

  • Cores — cor principal, cor do botão, cor do texto, gradiente do header
  • Tema — claro, escuro ou automático (segue o sistema do visitante)
  • Botão flutuante — ícone (chat, suporte, acenar), tamanho e posição
  • Formulário pré-chat — colete nome, email, telefone antes da conversa
  • Agente IA — vincule um agente para resposta automática
  • Domínios — restrinja em quais domínios o widget funciona

Código de Integração

O snippet é simplesmente uma tag <script> que carrega o widget automaticamente:

<script src="https://seudominio.com/api/widget/ID/embed.js" async></script>

💡 Dica

Você pode criar múltiplos widgets com configurações diferentes para cada página do seu site ou para diferentes finalidades.

Campanhas em Massa

Envie mensagens de marketing para centenas ou milhares de contatos simultaneamente usando Templates aprovados pela Meta.

Como criar uma Campanha

1

Vá em Campanhas → Criar Nova

Dê um nome e selecione o template aprovado que será enviado.
2

Selecione a audiência

Escolha os contatos por tags, segmentos ou selecione manualmente.
3

Configure variáveis

Preencha as variáveis do template (nome do contato, dados personalizados).
4

Dispare!

Clique em Enviar Campanha. O Moppyz processa o envio em lotes respeitando os rate limits da Meta.

⚠️ Atenção

Campanhas só podem ser enviadas com Templates aprovados. Templates em status Pendente ou Rejeitado não podem ser usados.

CRM & Contatos

O CRM do Moppyz centraliza todos os seus contatos com histórico completo de conversas, tags e segmentação.

Funcionalidades

  • Tags — organize contatos com tags coloridas para segmentação
  • Busca avançada — busque por nome, número, email ou tag
  • Importação CSV — importe contatos em massa via arquivo CSV
  • Exportação — exporte seus contatos para backup ou análise
  • Histórico — veja todo o histórico de conversas de cada contato
  • Criação automática — contatos são criados automaticamente quando enviam a primeira mensagem

Analytics

O painel de Analytics mostra métricas em tempo real da sua operação de atendimento.

Métricas disponíveis

Mensagens Enviadas

Total de mensagens enviadas no período

Contatos Ativos

Número de contatos que interagiram

Tempo de Resposta

Média do tempo para primeira resposta

Taxa IA

Porcentagem de conversas resolvidas por AI

Por Canal

Distribuição de mensagens por WhatsApp, Instagram, Telegram

Performance

Ranking de agentes por conversas e satisfação

Equipe & Permissões

Gerencie sua equipe com diferentes níveis de acesso. Cada membro recebe um Role que define o que pode ver e fazer na plataforma.

Roles disponíveis

Owner

Acesso total. Gerencia billing, equipe e configurações.

Admin

Tudo exceto billing. Gerencia equipe e configurações.

Supervisor

Gerencia conversas, contatos, campanhas e fluxos. Sem acesso a settings.

Agent

Atende conversas e gerencia contatos. Sem acesso a configurações.

Viewer

Acesso somente leitura. Pode ver conversas, contatos e analytics.

Billing & Planos

Free Trial

Ao criar sua conta, você recebe automaticamente um período de teste gratuitocom acesso completo ao plano padrão. A duração do trial é definida por cada plano. Não é necessário cadastrar cartão de crédito.

Como assinar um plano

1

Vá em Configurações → Faturamento

Você verá os planos disponíveis com preços e funcionalidades.
2

Escolha seu plano

Clique em "Assinar" no plano desejado. Você será redirecionado para o Stripe Checkout seguro.
3

Complete o pagamento

Preencha os dados do cartão e confirme. A assinatura é ativada imediatamente.

Gerenciar assinatura

Após assinar, o botão "Gerenciar Assinatura" abre o Stripe Portalonde você pode: alterar plano, atualizar dados de pagamento, ver histórico de faturas e cancelar.

ℹ️ Info

Todos os pagamentos são processados pela Stripe. O Moppyz não armazena dados de cartão.