Pré-requisitos para conectar o WhatsApp

Antes de conectar um número WhatsApp na Zavvi, vale separar alguns itens. Fazer isso com calma evita a maioria dos erros de configuração.

1. Um plano da Zavvi que inclua o WhatsApp

O recurso de WhatsApp não está disponível no plano gratuito. Se a sua conta estiver no plano Free, ao acessar o menu de WhatsApp você verá uma tela convidando a fazer upgrade. Veja Planos, limites e faturamento.

2. Uma conta no Meta Business (Business Manager)

É a conta corporativa da Meta, em business.facebook.com. Se a sua empresa já anuncia no Facebook ou Instagram, provavelmente já tem uma. Caso contrário, crie uma com o e-mail da empresa. Você precisa ser administrador dessa conta para criar apps e gerar tokens.

3. Um app na plataforma Meta for Developers

Em developers.facebook.com, crie um app do tipo Business e adicione o produto WhatsApp. Ao fazer isso, a Meta cria (ou pede para você vincular) uma conta do WhatsApp Business (WABA). É dali que saem os identificadores que a Zavvi pede: Phone Number ID e WABA ID.

4. Um número de telefone

O número precisa atender a uma destas condições:

• Não estar em uso no WhatsApp (nem no aplicativo comum, nem no WhatsApp Business App). Pode ser um número fixo ou móvel, desde que consiga receber uma ligação ou SMS para verificação.
• Ou já estar no WhatsApp Business App e ser migrado para a API. Nesse caso, siga o guia Migrando um número que já usa WhatsApp Business App.

Números fixos funcionam bem: a verificação pode ser feita por ligação de voz. Números que já estão em um aplicativo comum precisam primeiro ser removidos dele (o histórico do aplicativo não é importado para a API).

5. Verificação da empresa (recomendado)

A verificação da empresa no Meta Business não é obrigatória para começar a testar, mas ela:

• Libera limites maiores de conversas iniciadas pela empresa por dia.
• Permite exibir o nome da empresa (em vez do número) e solicitar o selo de conta comercial oficial.
• Costuma exigir documentos como CNPJ, comprovante de endereço ou conta de serviços em nome da empresa.

Recomendamos iniciar a verificação em paralelo com a configuração, porque a análise pode levar alguns dias.

6. Um token de acesso permanente

A Zavvi precisa de um token de acesso permanente (gerado por um usuário de sistema no Business Manager, com as permissões whatsapp_business_messaging e whatsapp_business_management). Tokens temporários (de 24 horas) até funcionam no teste de conexão, mas param de funcionar no dia seguinte — por isso pedimos o permanente.

Checklist rápido

• Plano da Zavvi com WhatsApp incluído.
• Conta Meta Business com você como administrador.
• App Business com produto WhatsApp adicionado (WABA criada).
• Número livre ou pronto para migração.
• Token de acesso permanente com as permissões corretas.
• Verificação da empresa iniciada (opcional, mas recomendada).

Com tudo isso pronto, siga para Conectando um novo número passo a passo.