Blog UzzAIPrimeiros Passos
Como Conectar seu WhatsApp Business ao UzzApp
Passo a passo completo para conectar seu número do WhatsApp Business ao UzzApp usando a API Oficial da Meta.
05/03/2026•8 min•Por Equipe Uzz.Ai
Role para descobrir a jornada completa
SUMÁRIO14 seções
Para começar a usar o UzzApp, você precisa conectar seu número de WhatsApp Business à plataforma usando a API Oficial da Meta (WhatsApp Business API). Este processo envolve configurar um aplicativo no Meta Developers, obter as credenciais necessárias e registrá-las no UzzApp.
Pré-requisitos
Antes de começar, certifique-se de ter: (1) Uma conta no Meta Business Suite verificada. (2) Um número de telefone exclusivo para o WhatsApp Business — não pode ser um número já em uso no WhatsApp pessoal. (3) Acesso ao painel do Meta Developers (developers.facebook.com). (4) Suas credenciais de acesso ao UzzApp.
Siga os passos abaixo na ordem correta. O processo leva em média 20 a 40 minutos na primeira vez.
Passo 1 — Criar o App no Meta Developers
- 1Acesse developers.facebook.com e entre com sua conta Meta Business.
- 2Clique em "Meus Apps" → "Criar App".
- 3Selecione o tipo "Business" e dê um nome ao app (ex: "UzzApp MeuNegocio").
- 4Após criar, vá em "Adicionar Produto" e adicione o produto "WhatsApp".
- 5Selecione ou crie uma conta do WhatsApp Business associada ao seu Meta Business.
Passo 2 — Obter as Credenciais
- 1No painel do app, vá em WhatsApp → Configuração da API.
- 2Copie o "Token de Acesso Temporário" (começa com EAA...) — você precisará gerar um Token Permanente depois.
- 3Anote o "ID do Número de Telefone" (Phone Number ID).
- 4Anote o "ID da Conta do WhatsApp Business" (WABA ID).
- 5Em Configurações do App → Básicas, copie o "App Secret".
Token Permanente vs. Temporário
O token temporário expira em 24 horas e é apenas para testes. Para produção, você deve gerar um Token Permanente via um Usuário do Sistema no Meta Business Suite. Acesse: Meta Business Suite → Configurações → Usuários do Sistema → Gerar Token.
Passo 3 — Configurar as Credenciais no UzzApp
- 1Acesse seu painel UzzApp e vá em Configurações → Credenciais (Vault).
- 2Insira o Token de Acesso (META_ACCESS_TOKEN).
- 3Insira o ID do Número de Telefone (META_PHONE_NUMBER_ID).
- 4Insira o App Secret (META_APP_SECRET).
- 5Defina um Token de Verificação personalizado (META_VERIFY_TOKEN) — pode ser qualquer texto seguro, ex: "minha-empresa-2026".
- 6Salve as credenciais. Elas são criptografadas automaticamente com AES-256.
Passo 4 — Configurar o Webhook no Meta
- 1De volta ao Meta Developers, vá em WhatsApp → Configuração.
- 2Na seção "Webhooks", clique em "Configurar Webhooks".
- 3No campo URL de Callback, insira: https://chat.uzzai.com.br/api/webhook/SEU_CLIENT_ID
- 4No campo Token de Verificação, insira exatamente o mesmo texto que você definiu no passo anterior (META_VERIFY_TOKEN).
- 5Clique em "Verificar e Salvar". O Meta fará uma requisição ao UzzApp para confirmar.
- 6Após verificar, ative as assinaturas: messages e message_status_updates.
Como encontrar seu Client ID
Seu Client ID é o identificador único da sua empresa no UzzApp. Você encontra em: Configurações → Minha Conta → Client ID. Ele tem o formato de um UUID (ex: 550e8400-e29b-41d4-a716-446655440000).
Passo 5 — Testar a Conexão
- 1Envie uma mensagem de texto para o número de WhatsApp configurado.
- 2Acesse o Dashboard UzzApp → Conversas e verifique se a mensagem apareceu.
- 3Se a mensagem apareceu, a conexão está funcionando corretamente.
- 4Se não apareceu, verifique se o webhook está ativo e se o token de acesso é válido.
Número em produção
Durante o desenvolvimento, a Meta limita o envio de mensagens a apenas 5 números de teste cadastrados. Para liberar o número para produção e enviar para qualquer contato, você precisa passar pelo processo de verificação do negócio na Meta Business Suite e configurar o número para produção.
Conexão feita? Próximo passo
Agora configure seu assistente de IA e faça o setup inicial da plataforma.
Setup Inicial →