Conectando um novo número passo a passo

Este guia mostra o caminho completo para colocar um número no ar na Zavvi. Reserve uns 20 minutos e tenha os pré-requisitos em mãos.

Passo 1 — Colete os dados na Meta

1. Acesse developers.facebook.com e abra o seu app do tipo Business (ou crie um).
2. Adicione o produto WhatsApp ao app.
3. No menu do WhatsApp, entre em Configuração da API. Ali você encontra:
   • o Phone Number ID do número que será usado;
   • o WABA ID (ID da conta do WhatsApp Business).
4. Gere um token de acesso permanente: no Business Manager, em Configurações do sistema → Usuários do sistema, crie um usuário de sistema (função Administrador), atribua o app e gere o token com as permissões whatsapp_business_messaging e whatsapp_business_management. Copie e guarde — ele é exibido uma única vez.

Passo 2 — Preencha o formulário na Zavvi

No painel, vá em Central de Atendimento → WhatsApp → Conectar WhatsApp. Preencha:

• Dados da conta
  • Nome do negócio — o nome que identifica essa conexão no painel (ex.: "Loja Centro").
  • Número WhatsApp — o número no formato internacional, ex.: +55 11 99999-0000.
• Credenciais da Meta
  • Phone Number ID
  • WABA ID
  • Access Token permanente — o token gerado no passo anterior. Ele é armazenado criptografado e nunca é exibido de volta.

Passo 3 — Teste a conexão

Clique em Testar Conexão. A Zavvi consulta a API da Meta com o WABA ID e o token informados e responde:

• "Conexão OK!" — pode seguir.
• "Token ou WABA ID inválido" — confira se copiou o WABA ID (e não o Phone Number ID) e se o token não expirou. Tokens temporários duram 24 horas.
• "Erro de conexão" — instabilidade momentânea; tente de novo em alguns segundos.

Depois clique em Conectar WhatsApp. Ao salvar, validamos o token mais uma vez; se estiver incorreto, o formulário devolve o aviso "Token inválido ou WABA ID incorreto."

Passo 4 — Configure o webhook na Meta

Depois que a conta é salva, a tela passa a exibir dois dados gerados automaticamente para você:

• Webhook configurado — uma URL no formato https://SEU-DOMINIO/webhook/whatsapp/{token}.
• Verify Token — uma sequência aleatória.

Volte ao app na Meta, em WhatsApp → Configuração → Webhook, clique em Editar e cole:

1. URL de callback: a URL de webhook mostrada na Zavvi.
2. Token de verificação: o Verify Token mostrado na Zavvi.
3. Clique em Verificar e salvar. A Meta faz uma chamada de teste ao nosso servidor; se os dados baterem, o webhook fica ativo.
4. Em Campos do webhook, assine pelo menos messages.

Sem o webhook, a Zavvi consegue enviar mensagens, mas não recebe as respostas dos clientes. É o erro mais comum de quem "consegue mandar, mas não vê nada chegar".

Passo 5 — Faça um teste real

Envie uma mensagem do seu celular pessoal para o número conectado. Ela deve aparecer na Central de Atendimento em poucos segundos, com status "Aberta". Responda pela Zavvi e confirme que chegou no celular.

Depois de conectar

• Em WhatsApp → Configurações você pode alterar o nome do negócio, o número exibido, trocar o token e ativar/desativar a conta.
• Desconectar remove a conta WhatsApp da Zavvi (as conversas e contatos permanecem no banco, mas o número deixa de receber mensagens até ser reconectado).
• Cada conta da Zavvi conecta um número de WhatsApp.
• Se o número ainda estiver com "modo de teste" na Meta, apenas números cadastrados como destinatários de teste receberão mensagens. Para uso real, adicione uma forma de pagamento na Meta e conclua a verificação da empresa.

Próximo passo recomendado: Templates de mensagem.