Antes de iniciar a configuração, certifique-se de ter todos os itens abaixo:
- Conta pessoal no Facebook (ativa e verificada)
- Página comercial no Facebook (criada e configurada)
- Conta no Gerenciador de Negócios → business.facebook.com
- Número de telefone dedicado (para WhatsApp Business)
- Aplicativo no Facebook Developers → developers.facebook.com
- Cartão de crédito válido (para verificação e cobrança da API)
Referência completa: WhatsApp Business Management API - Get Started
Navegue até:
Menu > Módulos adicionais > Omnichannel > Canais de midias > Criar

- Exemplo:
5511910863661
- Função: Identificador único da mídia no sistema USCall
- Formato: Recomenda-se usar o próprio número do WhatsApp para facilitar identificação
- Observação: Este campo serve como referência interna para localizar e gerenciar a mídia
- Exemplo:
901 - FILAWHTAS
- Função: Define qual fila de atendimento receberá as conversas
- Impacto: Determina a equipe responsável e prioridade de atendimento
- Configuração: Deve estar previamente criada no módulo de filas do sistema
- Valor:
WhatsApp Oficial
- Função: Especifica que utiliza a API oficial do WhatsApp Business
- Diferencial: Distingue de outros canais não-oficiais ou integração via web
- Vantagens: Maior confiabilidade, recursos avançados e suporte oficial
- Exemplo:
5511910863661
- Formato:
[Código País][Código Área][Número]
- 55 = Brasil
- 11 = São Paulo
- 910863661 = Número específico
- Requisitos: Deve estar associado a uma conta WhatsApp Business verificada
- Exemplo:
206073595932887
- Origem: Gerado automaticamente pelo Facebook/Meta
- Localização: Encontrado no painel do WhatsApp Business API
- Função: Referência única do número no ecossistema Meta
- Exemplo:
219831897889373
- Origem: Criado ao configurar a conta no Gerenciador de Negócios
- Função: Vincula todos os recursos (números, templates, métricas) à conta
- Importância: Permite gerenciamento centralizado de múltiplos números
- Exemplo:
944774350491763
- Origem: Facebook Developers Console
- Função: Identifica sua aplicação nas chamadas da API
- Segurança: Usado em conjunto com o token para autenticação
- Exemplo:
EAANbRGuN0HMBO2RxkPQM8c4jRVH84OoF6bPhZCtlZBfj32D1cyc
- Função: Autentica todas as requisições à API
- Características:
- Possui prazo de validade
- Tem permissões específicas
- CRÍTICO: Deve ser mantido em absoluto sigilo
- Renovação: Monitore a validade e renove antes do vencimento
O USCall UC gera automaticamente um endereço único para receber as mensagens:
Este endereço deve ser cadastrado no Facebook Developers:

Visualize o endereço que será enviado todas as mensagens do whatsapp.
- Cadastre este endereço no facebook

Campo |
Descrição |
Onde Encontrar |
URL de Retorno de Chamada |
Endereço gerado automaticamente pelo USCall |
Tela de configuração da mídia |
Token de Verificação |
ID do Aplicativo |
Painel do Facebook Developers |
- Token do Usuário: Nunca compartilhe ou exponha em código público
- IDs de Sistema: Mantenha registro seguro para troubleshooting
- Logs de Auditoria: Monitore acessos e uso da API
- Validade do Token: Configure alertas para renovação
- Limites da API: Monitore uso para evitar bloqueios
- Status do Webhook: Verifique regularmente se está recebendo mensagens
- Token Expirado: Renove no Gerenciador de Negócios
- Webhook não funciona: Verifique URL e certificado SSL
- Mensagens não chegam: Confirme configuração de permissões
Antes de salvar a configuração, verifique:
- Descrição: Campo preenchido e único no sistema
- Fila Destino: Fila existe e está ativa no módulo de filas
- Número: Formato correto com código do país (55) e área
- IDs Meta: Todos os campos numéricos preenchidos corretamente
- Token: Token válido e com permissões adequadas
- ✅ Conta criada e verificada
- ✅ Página do Facebook vinculada à conta
- ✅ Permissões de administrador configuradas
- ✅ Método de pagamento adicionado e válido
- ✅ Aplicativo criado e configurado
- ✅ Produto WhatsApp adicionado ao app
- ✅ Webhook configurado com URL do USCall
- ✅ Token de verificação correspondente ao ID do App
- ✅ Permissões necessárias concedidas:
whatsapp_business_messaging
whatsapp_business_management
- ✅ Número de telefone verificado
- ✅ Conta WhatsApp Business criada
- ✅ Número vinculado à conta Business
- ✅ Status da conta: APROVADA
Possíveis causas:
- URL do webhook incorreta ou inacessível
- Token de verificação não corresponde ao ID do App
- Certificado SSL inválido no servidor USCall
Solução:
- Verificar URL gerada pelo USCall
- Confirmar token de verificação
- Testar conectividade do webhook
Possíveis causas:
- Token copiado incorretamente
- Token expirou por inatividade
- Permissões insuficientes no token
Solução:
- Gerar novo token no Gerenciador de Negócios
- Verificar permissões do token
- Atualizar token no USCall UC
Possíveis causas:
- ID do telefone incorreto
- Número não verificado no WhatsApp Business
- Número não vinculado ao aplicativo
Solução:
- Verificar ID do telefone no painel Meta
- Confirmar verificação do número
- Revisar vinculação app ↔ número
Possíveis causas:
- Informações comerciais incompletas
- Violação das políticas do WhatsApp
- Documentação empresarial inadequada
Solução:
- Revisar informações da empresa
- Completar verificação comercial
- Aguardar nova análise (pode levar 24-48h)