Pular para o conteúdo principal
Blog UzzAIConfigurações

Integrações — Conecte suas APIs e Ferramentas

Como configurar as integrações do UzzApp com OpenAI, Groq, Meta WhatsApp API e como usar o Vault para gerenciar credenciais com segurança.

05/03/20266 minPor Equipe Uzz.Ai
Role para descobrir a jornada completa
Integrações — Conecte suas APIs e Ferramentas

O UzzApp é um orquestrador que conecta WhatsApp, provedores de IA e outras ferramentas usando suas próprias chaves de API. Cada empresa usa credenciais independentes — armazenadas com criptografia AES-256 no Vault. Você tem controle total sobre qual provedor de IA usa e quanto gasta.

Integrações Disponíveis

  • Meta WhatsApp Business API: obrigatória. Necessária para enviar e receber mensagens.
  • OpenAI: para GPT-4o (chat avançado + visão), Whisper (transcrição de áudio), TTS (texto para voz) e Embeddings (base de conhecimento RAG).
  • Groq: para Llama 3.3 70B (chat ultra rápido e de baixo custo).
  • ElevenLabs: opcional. Para TTS multilíngue com vozes mais realistas.

Configurando as Credenciais no Vault

  1. 1Acesse Dashboard → Configurações → aba "Credenciais".
  2. 2Para cada credencial, clique no campo correspondente e insira a chave.
  3. 3Clique em "Salvar". A chave é criptografada e armazenada no Vault antes de ser salva.
  4. 4Para atualizar uma credencial, simplesmente insira o novo valor e salve — a chave antiga é sobrescrita.
  5. 5Para verificar se uma credencial está configurada (sem ver o valor): o campo exibe "••••••••" quando preenchido.
Painel de credenciais do Vault no UzzApp
Configurações → Credenciais — todas as integrações em um único lugar

Onde Obter Cada Chave de API

  • Meta (WhatsApp): developers.facebook.com → seu app → WhatsApp → Configuração da API.
  • OpenAI: platform.openai.com/api-keys → "Create new secret key".
  • Groq: console.groq.com/keys → "Create API Key".
  • ElevenLabs: elevenlabs.io → perfil → API Keys.

Vault — Segurança das credenciais

As credenciais são criptografadas com AES-256 antes de serem salvas no banco de dados. Nem os administradores da Uzz.Ai têm acesso aos valores das suas chaves. Se uma chave for comprometida, gere uma nova chave no provedor e atualize aqui — a chave antiga fica imediatamente inativa.

Gerenciando o Budget de IA

  1. 1Acesse Dashboard → Configurações → "Budget de IA".
  2. 2Defina um limite mensal em tokens ou em reais.
  3. 3Quando o limite for atingido, as chamadas de IA são automaticamente bloqueadas.
  4. 4Você recebe um alerta por e-mail ao atingir 80% do budget.
  5. 5Para aumentar o budget no meio do mês, basta atualizar o valor nas configurações.
  6. 6Útil para evitar surpresas em contas de IA durante testes ou picos de mensagens.

Webhook — Configuração e Verificação

  • URL do Webhook: https://chat.uzzai.com.br/api/webhook/SEU_CLIENT_ID
  • Encontre seu Client ID em Configurações → Perfil → Client ID.
  • Configure esta URL no Meta Developers como URL de Callback.
  • Token de verificação: defina em Configurações → Credenciais → META_VERIFY_TOKEN.
  • Insira o mesmo token no campo "Token de Verificação" no Meta Developers.
  • Se o webhook parar de funcionar, verifique se o token de acesso da Meta não expirou.

Dúvidas sobre integrações?

Nossa equipe de suporte ajuda na configuração de qualquer integração.

Falar com Suporte →
Integrações — Conecte suas APIs e Ferramentas | Help Center UzzApp | UZZAI - Automação Criativa, Realizada