Pular para o conteúdo principal

Perguntas frequentes

Resumo: As dúvidas mais comuns dos administradores e usuários da plataforma, em formato de pergunta e resposta direta.

Sobre a plataforma​

O que é o wpp-gateway?​

É uma plataforma que conecta seu sistema ao WhatsApp e ao Instagram, permitindo enviar e receber mensagens dos seus clientes. Veja O que é o wpp-gateway.

Preciso instalar alguma coisa?​

Não. Tudo funciona pelo navegador.

Para quem é indicado?​

Empresas que atendem clientes pelo WhatsApp e Instagram e querem centralizar essas conversas dentro do próprio sistema — clínicas, escritórios, e-commerce, restaurantes, qualquer negócio com volume relevante de mensagens.

Conexão de canais​

Qual a diferença entre WhatsApp Baileys e WABA?​

  • Baileys = número comum (do app que você usa no celular). Conecta via QR Code ou pareamento. Bom para atendimento pequeno/médio.
  • WABA = WhatsApp Business oficial registrado na Meta. Tem selo verde, templates, alta estabilidade. Bom para volume e proatividade.

Veja Entendendo números vs canais.

Posso usar o mesmo número em Baileys e WABA?​

Não. Cada número fica em um dos dois (ou WhatsApp comum ou WhatsApp Business). Migrar de Baileys para WABA exige apagar a conta do app comum.

Quantos canais posso ter?​

Depende do plano. Cada canal é um número/conta diferente.

Posso conectar Instagram pessoal?​

Não. Só Instagram Business ou Creator. Veja Como conectar uma conta do Instagram.

Conectei mas o canal não aparece como CONNECTED​

Veja o status atual:

  • PENDING_QR → Aguardando escanear o QR.
  • PENDING_WEBHOOK → Aguardando confirmação Meta (WABA).
  • CONNECTING → Em processo.
  • DISCONNECTED → Caiu — veja Meu número desconectou.
  • TOKEN_EXPIRED → Token Instagram/WABA expirou — reconecte.
  • FAILED → Falha na configuração — verifique os logs do canal.

Envio de mensagens​

Que tipos de mensagem posso enviar?​

Texto, imagem, vídeo, áudio (voice note), documento, figurinha, localização, contato, botões, listas, templates WABA, formulários (Flows). Veja Tipos de mensagem suportados.

Posso enviar mensagem proativa pelo WhatsApp Business?​

Só com template aprovado, se passou de 24h sem o cliente te mandar nada. Veja Quando preciso usar template vs mensagem livre.

Posso editar uma mensagem?​

Sim, mas só texto e dentro de 15 minutos do envio. Mídia não pode ser editada. Veja Editando mensagem enviada.

Posso apagar uma mensagem para o cliente?​

Sim, dentro de aproximadamente 48 horas. Aparece como "esta mensagem foi apagada". Veja Apagando mensagem.

Tem como agendar uma mensagem?​

Sim. Você pode criar uma "mensagem agendada" para um horário futuro. Limite: máximo 10.000 agendadas pendentes por conta, mínimo 5 segundos no futuro.

Posso enviar para um grupo?​

Sim, no Baileys (que suporta API de grupos). No WABA, não — grupos não são suportados oficialmente.

Tem cobrança por mensagem?​

  • Baileys: não há custo por mensagem além da mensalidade do plano.
  • WABA: a Meta cobra por conversa iniciada (Marketing, Utility, Authentication). Service (dentro da janela 24h) tem franquia grátis.

Veja Entendendo a fatura mensal.

Recebimento​

Como meu sistema recebe mensagens?​

Via webhook — uma URL pública do seu sistema que o gateway chama toda vez que algo acontece (mensagem recebida, status atualizado, etc.). Veja Webhooks explicado para leigo.

O gateway guarda o histórico das mensagens?​

Por padrão, não. Só mídia (por 7 dias) e mensagens enviadas (para tracking de status). Histórico de conversas fica no seu sistema.

Mensagens recebidas durante uma desconexão são perdidas?​

Algumas podem ser. O gateway tenta reentregar webhooks por algumas horas, mas mensagens muito antigas no celular (Baileys) podem ser perdidas se a sessão ficar offline demais.

AI Agent​

Como funciona o agente IA?​

Você sobe uma base de conhecimento (FAQ, manual), configura uma personalidade (prompt), ativa, e ele responde automaticamente seus contatos baseado nessas informações. Veja O que é o AI Agent.

Preciso pagar por isso?​

Você paga o modelo de IA usado (OpenAI, com sua própria API key). Custo médio: R$ 30-80/mês para uma clínica típica usando gpt-4o-mini.

O agente pode marcar consulta no meu sistema?​

Não diretamente. Ele responde sobre como marcar, mas a integração com sua agenda é o seu próprio sistema que faz, baseado no que o agente coleta na conversa.

O agente entende áudios?​

Em V1, não. Ele só processa texto e cliques em botões/listas. Para áudio, use a transcrição e depois passe o texto para o agente.

Templates​

Como criar um template?​

Pelo painel → Templates → Novo template. Veja Criando um template no Meta.

Quanto tempo demora a aprovação?​

De 1 minuto a 24 horas, dependendo da categoria. Authentication é mais rápido, Marketing é mais lento.

Por que meu template foi rejeitado?​

Veja o motivo no painel e consulte Template rejeitado pela Meta.

Posso usar emojis em templates?​

Sim no corpo (com moderação). Não no nome do template (ele é um identificador interno).

Cobrança​

Quando recebo a fatura?​

No início do mês seguinte ao consumo (entre os dias 1 e 5). Veja Como funciona a cobrança.

O que acontece se eu atrasar?​

Até 6 dias: alerta. 7-13 dias: alerta forte. 14+ dias: conta suspensa. Veja Inadimplência e suspensão.

Posso pagar com cartão?​

Sim. No Asaas (que processa a cobrança), você pode cadastrar cartão para pagamento automático.

Por que minha fatura veio mais cara que o esperado?​

Geralmente é repasse Meta (WABA) aumentando — campanhas Marketing são caras. Confira o detalhamento da fatura. Veja Entendendo a fatura mensal.

Problemas comuns​

O número desconectou. O que fazer?​

Veja Meu número desconectou — o que fazer.

A sessão Baileys cai toda hora.​

Veja Sessão cai toda hora.

A mensagem que enviei não chegou.​

Veja Mensagem não foi entregue.

O QR Code não aparece.​

Veja QR Code não aparece.

Privacidade e segurança​

O gateway lê minhas mensagens?​

Tecnicamente, o gateway processa as mensagens (precisa, para entregar webhook). Não armazena conteúdo de mensagens recebidas após repassar. Mídia fica 7 dias. Auditoria interna não acessa conteúdo de cliente, só metadados.

As credenciais (token Meta, OpenAI key) ficam seguras?​

Sim. Todas as credenciais sensíveis (tokens Meta, secrets webhook, OpenAI keys) são criptografadas no banco com AES-256-GCM. Mesmo um vazamento do banco não exporia os valores.

Sou conforme LGPD?​

O gateway provê ferramentas para LGPD (audit log, eventos rastreáveis). Mas a conformidade final depende do seu sistema e da sua relação com o cliente final. Avalie com seu DPO.

Posso exportar todos os dados de um contato?​

Tecnicamente sim — o gateway tem endpoints administrativos para isso. Pelo painel comum não está exposto ainda. Para casos de direito de portabilidade LGPD, contate o suporte do seu fornecedor.

Suporte​

Como entro em contato com o suporte?​

Pelo canal oferecido pelo seu fornecedor do software (não é o gateway diretamente — o gateway é a infraestrutura que seu fornecedor usa).

O que preciso informar ao contatar suporte?​

  • ID da sua conta (encontra em Configurações no painel)
  • ID do canal afetado
  • Horário e descrição do problema
  • Mensagem de erro literal (se houver)
  • Print da tela, se possível

Artigos por categoria​