Este guia explica como conectar o WhatsApp Business da sua loja à Unefesta, o que muda no dia a dia, custos cobrados pela Meta (não pela Unefesta) e como evitar erros comuns.
A Unefesta atua como provedor de tecnologia Meta. Você continua usando o app WhatsApp Business no celular e, ao mesmo tempo, responde clientes pelo chat da Unefesta — as conversas ficam sincronizadas quando a Meta permite (modo coexistência).
Referência oficial Meta: Onboard WhatsApp Business app users (Coexistence)
Visão geral
Como as mensagens circulam depois da conexão:
- O cliente fala pelo WhatsApp no celular.
- A mensagem passa pela plataforma WhatsApp Business (Meta).
- Você pode responder pelo app WhatsApp Business no celular ou pelo chat da Unefesta no painel — as conversas ficam sincronizadas quando a Meta permite (modo coexistência).
| Canal | Para que serve |
|---|---|
| App WhatsApp Business (celular) | Conversas 1:1 como você já usa hoje; mensagens enviadas pelo app não geram cobrança de API pela Meta |
| Chat Unefesta | Atender compradores e leads no painel; respostas em texto podem ir também para o WhatsApp do cliente |
| Contatos da loja | Enviar modelos aprovados (marketing ou utilitários) para contatos da sua agenda |
Cada loja conecta um número WhatsApp Business. Se você tem várias lojas, conecte uma por vez em Integrações das Lojas.
Requisitos mínimos
Antes de conectar, confira:
| Requisito | Detalhe |
|---|---|
| App WhatsApp Business no celular | Versão 2.24.17 ou superior (atualize pela loja de apps) |
| Conta Meta Business | Portfólio comercial verificado ou em uso regular no Gerenciador de Negócios |
| Número já no WhatsApp Business | O fluxo conecta o número existente (coexistência), não cria linha nova pela Unefesta |
| Assinatura Unefesta ativa | Acesso ao painel do vendedor |
| Integração liberada | Se a seção WhatsApp Business (Meta) não aparecer, a funcionalidade ainda não está disponível para sua conta — aguarde o rollout |
Depois de conectar:
| Requisito | Por quê |
|---|---|
| Forma de pagamento na Meta | A Meta exige método de pagamento na conta WhatsApp Business para enviar mensagens pela API (respostas no chat, modelos, notificações de pedido). Sem isso, o envio pela plataforma pode falhar |
| Manter o app aberto na primeira sincronização | Facilita a conexão e a sincronização inicial de dados entre Meta e Unefesta |
Como conectar
- No menu lateral, abra Integrações das Lojas.
- Role até a seção WhatsApp Business (Meta).
- No campo Loja, escolha a loja que receberá o número.
- Escolha a política de sincronização (veja abaixo) e clique em Conectar.
- Mantenha esta aba do navegador aberta — o código de autorização expira em cerca de 30 segundos.
- No popup da Meta:
- Faça login na conta correta (a mesma do Gerenciador de Negócios).
- Escolha conectar o WhatsApp Business existente (coexistência).
- No celular, abra o app WhatsApp Business, confirme Conectar à plataforma comercial e informe o código de verificação se solicitado.
- Quando perguntado, você pode compartilhar o histórico de conversas com a plataforma (recomendado se a política for “sincronizar tudo”).
- Ao concluir, a tela mostra Conectado, o número e as etapas 2 e 3 (pagamento na Meta e conta pronta para enviar).
Depois de conectar: as três etapas
Na própria tela de integração:
| Etapa | O que significa |
|---|---|
| 1. Conectar | Número vinculado à loja (coexistência) |
| 2. Pagamento na Meta | Método de pagamento cadastrado na conta WhatsApp Business — obrigatório para a API enviar |
| 3. Conta pronta para enviar | A Meta liberou o envio (pagamento ok e conta sem pendência). Sem isso, chat, modelos e notificações de pedido podem falhar |
Use Atualizar status se a etapa 3 continuar pendente depois de cadastrar o pagamento.
Política de sincronização (contatos e mensagens)
Antes de conectar (e depois, nas configurações da conexão), você escolhe o que a Unefesta deve guardar:
| Opção | O que entra na Unefesta |
|---|---|
| Sincronizar tudo | Agenda WhatsApp, histórico compartilhado e mensagens novas (incluindo respostas enviadas pelo app no celular) |
| Só contatos e pedidos Unefesta | Mensagens e contatos somente se o telefone já estiver em Contatos da loja ou tiver qualquer pedido na Unefesta |
No modo restrito, a mesma regra vale para:
- sincronização inicial (histórico e agenda SMB da Meta);
- mensagens novas via webhook;
- ecos da loja (mensagens que você envia pelo app WhatsApp Business no celular e a Meta espelha na Unefesta).
Importante:
- A Meta continua enviando os dados; a Unefesta filtra no ingest. O que for descartado não fica guardado para reaproveitar depois.
- Você pode alterar a política em Integrações enquanto estiver conectado. A mudança vale para mensagens e contatos novos. Histórico já ignorado não volta; o que já foi importado não é apagado só por mudar a opção.
- O histórico completo da Meta só pode ser pedido de novo em condições limitadas (janela curta após o onboarding / novo Embedded Signup). Mudar a política não dispara um segundo sync completo sozinho.
Sincronização de histórico e contatos
Na primeira conexão (coexistência), a Unefesta pede à Meta o histórico de conversas (se você compartilhou) e os contatos da agenda do WhatsApp Business — e aplica a política escolhida. Na tela aparece:
- Histórico: aguardando a Meta / em andamento / concluído / não compartilhado
- Contatos: aguardando a Meta / concluído (ou “a Meta não enviou contatos”, se a agenda estiver vazia)
Deixe o app aberto nos primeiros minutos. A tela atualiza sozinha; se ficar em “aguardando” por vários minutos com agenda vazia, isso é esperado.
Configurar pagamento na Meta (etapa 2)
Na etapa Pagamento na Meta:
- Clique em Abrir pagamento na Meta (abre o Gerenciador de Negócios).
- Cadastre cartão ou outro método aceito pela Meta para a conta WhatsApp Business.
- Volte à Unefesta e clique em Atualizar status.
Sem forma de pagamento válida, mensagens enviadas pelo chat Unefesta ou modelos podem não ser entregues, mesmo com a conexão aparentemente ativa.
Como usar no dia a dia
Atender clientes no chat
Abra Chats no menu.
Conversas vindas do WhatsApp aparecem como Lead WhatsApp quando o contato ainda não tem conta de comprador na Unefesta (e, no modo restrito, só se forem elegíveis pela política de sincronização).
Quando o WhatsApp estiver conectado e a janela de 24 horas estiver aberta, você verá:
Respostas em texto serão enviadas também pelo WhatsApp Business da loja (coexistência com o app no celular).
Digite a mensagem em Digite sua mensagem… e envie normalmente.
Mensagens que você envia pelo app no celular também podem aparecer no chat Unefesta (espelhamento), respeitando a política de sincronização.
Se a janela de 24h estiver fechada, aparece um aviso em amarelo: suas respostas ficam somente no chat Unefesta até o cliente mandar uma nova mensagem pelo WhatsApp.
Excluir conversas de lead (sem conta Unefesta)
Em Chats, nos cards de conversa Lead WhatsApp ou grupo sem usuário comprador na Unefesta, o vendedor vê um ícone de lixeira.
- Pede confirmação antes de apagar.
- Exclui o chat e todas as mensagens daquela conversa (incluindo anexos).
- Não aparece em chats de clientes com conta Unefesta.
- Conversas vinculadas a pedidos não podem ser excluídas por este caminho.
Enviar modelos (marketing ou campanhas)
- Abra Contatos no menu (Contatos da loja).
- Selecione a loja no seletor superior, se necessário.
- Clique em um contato com telefone.
- Na área Enviar modelo WhatsApp, escolha o modelo e clique em Enviar modelo.
Para criar modelos:
- Em Contatos da loja, clique em Modelos WhatsApp.
- Use Novo modelo e aguarde a aprovação da Meta (pode levar até 24 horas).
Modelos de marketing exigem que o contato tenha autorizado receber promoções. Se ainda não autorizou, a Unefesta envia automaticamente um pedido com botões Sim / Não no WhatsApp.
Notificações de pedido pelo WhatsApp (opcional)
Por padrão, atualizações de checkout e pagamento ficam somente no chat Unefesta (sem custo Meta de conversa UTILITY).
Para enviar também pelo WhatsApp:
Em Integrações das Lojas, na conexão da loja, marque a opção:
Quero enviar notificações de pedido e pagamento também pelo WhatsApp (modelos UTILITY aprovados pela Meta).
Confirme no diálogo — a Meta cobra por conversa UTILITY enviada ao comprador. Este custo será por sua conta.
Para ver a lista completa de modelos enviados (checkout, pagamento, contrato, cancelamento, trilha de status, pós-venda), consulte Notificações de pedido pelo WhatsApp.
Custos: quem cobra o quê
| Item | Quem cobra | Observação |
|---|---|---|
| Assinatura Unefesta | Unefesta | Plano para uso da plataforma — não inclui mensagens WhatsApp da Meta |
| Mensagens pelo app WhatsApp Business (celular) | Meta | Grátis (fora da tarifação Cloud API), conforme política Meta para app Business |
| Respostas em texto pelo chat Unefesta (janela 24h aberta) | Meta | Grátis — mensagens fora de template (type: text, imagem, etc.) com janela de atendimento (CSW) aberta após o cliente ter escrito no WhatsApp. Na Meta: categoria service, billable: false |
| Modelos UTILITY com janela 24h aberta | Meta | Grátis (inclui confirmação de pedido por template se o cliente falou recentemente) |
| Modelos UTILITY com janela fechada (ex.: notificações de pedido) | Meta | Tarifa por mensagem-template entregue — situação comum quando o comprador não escreveu no WhatsApp nas últimas 24h |
| Modelos MARKETING | Meta | Sempre tarifados; exige opt-in do contato |
| Forma de pagamento na Meta | Meta | Cartão ou método cadastrado no Gerenciador de Negócios — obrigatório para envio via API |
Desde julho/2025, a Meta cobra por mensagem-template entregue (type: template), não por “conversa”. Mensagens de atendimento (texto livre na CSW) e templates UTILITY dentro da CSW são gratuitas. A Unefesta não repassa nem marca margem sobre tarifas da Meta. Consulte a página de preços WhatsApp Business Platform e o material API Solutions for WhatsApp Business App Users (PDF da Meta) para cenários de coexistência.
Janela de atendimento de 24 horas
Regra da Meta para mensagens enviadas pela API (inclui respostas que a Unefesta dispara pelo chat):
| Situação | O que você pode fazer pela Unefesta |
|---|---|
| Cliente mandou mensagem no WhatsApp nas últimas 24 horas | Responder em texto livre pelo chat (vai para o WhatsApp dele) — sem custo Meta (mensagem de atendimento) |
| Passou mais de 24 horas sem mensagem do cliente no WhatsApp | Texto livre não vai para o WhatsApp — só fica no chat Unefesta |
| Cliente nunca falou no WhatsApp depois da conexão | Só modelos aprovados (não texto livre) até abrir a janela |
Importante: mensagens enviadas direto pelo app no celular não dependem dessa janela de 24h da API e não abrem a janela da Cloud API para a Unefesta.
O que é permitido e o que não é
Permitido na Unefesta (com WhatsApp conectado)
- Responder clientes no chat (com espelhamento para WhatsApp quando a janela 24h estiver aberta).
- Usar o app WhatsApp Business no celular em paralelo (coexistência).
- Escolher sincronizar tudo ou só contatos/pedidos Unefesta (no connect e nas settings).
- Enviar modelos aprovados para contatos da agenda da loja.
- Opcionalmente espelhar notificações de pedido via modelos UTILITY (com custo Meta).
- Receber leads que escrevem no seu número comercial (conforme a política de sync).
- Excluir conversas de lead/grupo sem conta Unefesta (lixeira no card do chat).
- Ao desconectar, opcionalmente limpar mensagens e contatos importados elegíveis.
Limitações da Meta (coexistência)
Com base na documentação oficial de coexistência:
| Recurso no app WhatsApp Business | Depois de conectar à API |
|---|---|
| Conversas 1:1 | Continua; mensagens recentes podem sincronizar com a Unefesta |
| Grupos | Não sincronizam com a Unefesta |
| Listas de transmissão | Novas listas desabilitadas; listas antigas ficam só leitura |
| Mensagens que desaparecem e visualização única | Desativadas em chats 1:1 |
| Localização ao vivo | Desativada em chats 1:1 |
| Chamadas de voz/vídeo | Sem mudança no app; não integradas ao chat Unefesta |
| Catálogo, status, ferramentas Business do app | Sem mudança no app; não controlados pela Unefesta |
Limitações na Unefesta
- Uma conexão por loja — o mesmo número não pode estar em duas lojas.
- Texto livre via chat só com janela 24h aberta (regra Meta).
- Imagens e anúncios enviados pelo chat Unefesta não são espelhados automaticamente para o WhatsApp (apenas texto, nas condições acima).
- Campanhas em massa fora da agenda de contatos ou sem opt-in não são permitidas para modelos marketing.
- Com política Só contatos e pedidos Unefesta, leads novos no WhatsApp que não estão na agenda nem têm pedido não aparecem no chat Unefesta (nem o espelhamento do celular).
- Alterar a política de sincronização não reprocessa histórico já descartado.
- A Unefesta não substitui o Gerenciador de Negócios para disputas de cobrança, qualidade do número ou bloqueios da Meta.
O que muda no seu celular
Após conectar:
- O app WhatsApp Business indica que o número está ligado à plataforma comercial.
- Até quatro dispositivos vinculados (companions) podem ser desvinculados na conexão; você pode vincular de novo os suportados pela Meta.
- Mantenha o app atualizado e, na primeira hora após conectar, deixe-o aberto para ajudar na sincronização.
Para desconectar só da Unefesta, use Desconectar em Integrações das Lojas.
Para desconectar da plataforma comercial por completo, no app: Configurações → Conta → Plataforma comercial → Desconectar conta. Isso também remove a integração na Unefesta.
Desconectar
Pela Unefesta
- Integrações das Lojas → seção WhatsApp Business (Meta).
- Na loja conectada, clique em Desconectar.
- No diálogo, você pode:
- Só desconectar — para de enviar/receber pela API; dados locais permanecem.
- Marcar e Desconectar e excluir — além de desconectar, remove dados elegíveis importados pela integração (veja abaixo).
A Meta deixa de receber webhooks da loja; o token local é invalidado.
Exclusão opcional na desconexão (e depois)
Ao desconectar (ou na tela pós-desconexão), a Unefesta pode limpar só o que não tem vínculo com clientes da plataforma:
| O quê | Critério (resumo) |
|---|---|
| Mensagens WhatsApp | Conversas de lead/grupo sem conta Unefesta, canal WhatsApp, sem vínculo com pedido |
| Contatos importados | Origem WhatsApp, status importado, sem usuário/comprador, sem interação, sem pedidos pagos, sem campanhas/notas relevantes |
Não são excluídos automaticamente: chats de clientes Unefesta, mensagens de sistema/pedido, contatos vinculados ou que já conversaram.
Em Contatos da loja, com filtro de origem WhatsApp, também há ação para excluir em massa os importados elegíveis (mesmas regras).
Pelo app WhatsApp Business ou Gerenciador Meta
Se você remover o acesso da Unefesta na Meta, a conexão na plataforma será marcada como desconectada. Será necessário Conectar WhatsApp Business de novo para voltar a usar. Os dados locais não são apagados automaticamente — use a exclusão opcional na tela de integração ou limpe conversas/contatos manualmente.
Problemas comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Botão Conectar não aparece ou mensagem de rollout | Funcionalidade ainda não liberada para sua conta | Aguarde; a Unefesta habilita por etapas |
| Popup bloqueado | Navegador bloqueou janela da Meta | Permita pop-ups para o site da Unefesta e tente de novo |
| Tempo esgotado aguardando resposta da Meta | Aba fechada ou popup cancelado | Mantenha a aba aberta; refaça Conectar WhatsApp Business |
| Cadastro cancelado | Fluxo interrompido no popup Meta | Conclua todas as etapas; use a conta Meta Business correta |
| Conectado, mas campanhas/modelos não saem | Sem forma de pagamento ou verificação de negócio pendente | Configure o pagamento e a verificação; na integração, clique em Atualizar status (etapa 3). Respostas na janela de 24h no chat não exigem isso |
| Contatos: “aguardando a Meta…” | Sync inicial ainda sem retorno (agenda vazia ou atraso) | Espere alguns minutos com o app aberto; se a agenda for vazia, vira “concluído — a Meta não enviou contatos” |
| Poucos contatos/mensagens após sync | Política Só contatos e pedidos Unefesta ou histórico não compartilhado na Meta | Confira a política em Integrações; mude para Sincronizar tudo se quiser leads novos daqui pra frente (histórico antigo descartado não volta) |
| Aviso de janela 24h fechada | Cliente não falou no WhatsApp há mais de 24h | Responda no chat Unefesta ou envie modelo aprovado em Contatos |
| Este WhatsApp já está vinculado a outra loja | Número usado em outra loja Unefesta | Desconecte da outra loja ou use outro número |
| Modelo pendente ou rejeitado | Análise Meta | Edite o texto em Modelos WhatsApp e reenvie |
| Marketing não envia | Contato sem opt-in | Aguarde resposta Sim no WhatsApp ou use modelo utilitário |
| Mensagem só no celular, não no chat Unefesta | Atraso de webhook, companion não suportado ou telefone inelegível no modo restrito | Verifique app, política de sync e se o contato/pedido existe na Unefesta |
| Cliente escreveu antes da conexão | Janela de serviço não existia na API | Só modelo até o cliente mandar nova mensagem depois de conectado |
| Não consigo excluir um chat | É chat de usuário Unefesta ou está ligado a pedido | Só leads/grupos sem conta; use desconexão + limpeza ou suporte se precisar de outro caso |
| Qualidade do número / limite de envio | Política Meta | Acesse o Gerenciador de Negócios; reduza envios em massa e conteúdo reportado |
Erros esperados (Meta)
- Primeira mensagem de um cliente (ex.: clicou em anúncio Click to WhatsApp): pode haver atraso de alguns segundos — peça para verificar também o app no celular.
- Dispositivo companion não suportado: a mensagem pode não aparecer no chat Unefesta; o cliente ainda vê no WhatsApp.
Boas práticas
- Configure a forma de pagamento na Meta assim que conectar.
- Escolha a política de sincronização cedo: use Só contatos e pedidos se a agenda WhatsApp for grande e você só quer CRM/pedidos Unefesta; use Sincronizar tudo se quiser atender leads novos pelo painel.
- Responda pelo chat Unefesta ou pelo celular — evite duplicar a mesma resposta nos dois canais ao mesmo tempo.
- Use modelos para campanhas e lembretes; peça opt-in antes de marketing.
- Deixe notificações de pedido pelo WhatsApp desligadas se quiser evitar custos UTILITY — o padrão é só chat Unefesta.
- Mantenha o WhatsApp Business atualizado (versão mínima 2.24.17).
- Ao desconectar, use a exclusão opcional se não quiser manter histórico de leads só WhatsApp na Unefesta.
- Não compartilhe o login Meta; use sempre o fluxo Conectar autenticado.
Resumo rápido
| Pergunta | Resposta |
|---|---|
| Preciso abandonar o app no celular? | Não — coexistência mantém os dois |
| A Unefesta cobra por mensagem WhatsApp? | Não — tarifas são da Meta quando usa API |
| O que é obrigatório na Meta após conectar? | Forma de pagamento na conta WhatsApp Business |
| Onde atendo clientes? | Chats (painel) e/ou app no celular |
| Onde envio campanhas? | Contatos da loja → Enviar modelo WhatsApp |
| Pedidos vão automaticamente pro WhatsApp? | Só se você marcar a opção de notificações de pedido |
| Posso sincronizar só quem já conheço? | Sim — política Só contatos e pedidos Unefesta (no connect e nas settings) |
| Posso mudar a política depois? | Sim — vale para o futuro; histórico descartado não volta |
| Desconectar apaga mensagens? | Só se você marcar exclusão no diálogo (ou limpar depois na tela / Contatos / lixeira no chat) |
Pedido, chat e contratos: E-mails e mensagens de sistema.
Precisa de ajuda?
- Unefesta: suporte pelo canal habitual do vendedor (chat ou e-mail de suporte).
- Meta / WhatsApp Business: qualidade do número, cobrança, bloqueios e conta Business — Central de Ajuda Meta Business e suporte do Gerenciador de Negócios.
Para dúvidas técnicas de coexistência na Meta, a documentação indica o tópico Embedded Signup - Coexistence Onboarding no suporte para desenvolvedores.