Integrações de Provedores
As integrações de provedores permitem que você conecte suas próprias chaves API de serviços externos de IA diretamente ao SipPulse AI. Em vez de usar créditos da plataforma, você pode usar suas próprias contas com provedores como OpenAI, Anthropic, Google e outros.
Benefícios de Usar Suas Próprias Chaves
- Controle de Custos: Pague diretamente ao provedor com sua própria faixa de preços
- Limites Maiores: Acesse os limites de taxa do seu provedor em vez dos limites compartilhados da plataforma
- Faturamento Direto: Gerencie custos através das suas contas existentes com os provedores
- Modelos Exclusivos: Alguns modelos podem estar disponíveis apenas através de suas próprias credenciais devido à complexidade de precificação
Visão Geral da Página
A página de Integrações é dividida em duas seções:
- Adicionar: Mostra provedores disponíveis mas ainda não configurados. Clique em qualquer tag de provedor para adicionar sua chave API.
- Integrações: Mostra suas integrações configuradas como cards, exibindo a chave API mascarada e os modelos aplicáveis.
Adicionando uma Credencial de Provedor
Para adicionar uma nova integração de provedor:
- Navegue até Integrações no menu lateral
- Na seção Adicionar, clique no provedor que deseja configurar
- No modal que abre, cole sua chave API no campo de entrada
- Revise os Modelos aplicáveis que serão desbloqueados com esta integração
- Clique em Salvar
TIP
Após adicionar uma credencial, as requisições para esses modelos usarão sua chave API e serão cobradas diretamente pelo provedor. Seu uso aparecerá no dashboard com custo de R$0,00, pois a cobrança é feita pelo provedor. Em alguns casos, certos modelos podem ficar disponíveis apenas após adicionar suas credenciais.
Validação da Chave API
Quando você salva uma nova credencial, o SipPulse AI valida a chave API com o provedor para garantir que ela é válida. Se a chave for inválida ou tiver permissões insuficientes, você verá uma mensagem de erro e a credencial não será salva.
Substituindo uma Credencial
Para substituir uma chave API existente:
- Navegue até Integrações
- Encontre o card do provedor na seção Integrações
- Clique no botão de edição (ícone de lápis) no card
- No modal, você verá:
- Chave atual: Sua chave API existente mascarada
- Nova Chave de API: Campo de entrada para a chave de substituição
- Modelos aplicáveis: Todos os modelos que usam este provedor
- Digite a nova chave API no campo Nova Chave de API
- Clique em Substituir
A nova chave será validada antes de salvar. Sua chave anterior será substituída e não poderá mais ser usada.
Removendo uma Credencial
Para remover uma integração de provedor:
- Clique no botão de edição (ícone de lápis) no card do provedor
- Clique no botão Remover (vermelho, no lado esquerdo)
- Confirme a remoção
Após a remoção, as requisições para os modelos desse provedor usarão os créditos da sua organização em vez da sua própria chave API.
Visualizando Modelos Aplicáveis
Cada integração mostra quais modelos usarão sua chave API:
- No card: Você verá os primeiros modelos aplicáveis com um indicador "+N" se houver mais
- No modal: A lista completa de modelos aplicáveis é exibida, incluindo modelos LLM e modelos TTS (mostrados com ícones diferentes)
Isso ajuda você a entender exatamente quais recursos e modelos usarão seus próprios créditos.
Segurança
Suas chaves API são protegidas com segurança de nível empresarial:
- Criptografia: Todas as chaves API são criptografadas usando AES-256-CBC antes do armazenamento
- Armazenamento Seguro: As chaves são armazenadas de forma segura e nunca expostas após salvar
- Acesso Apenas em Requisições: As chaves são descriptografadas apenas no momento das requisições de API
- Exibição Mascarada: Após salvar, apenas uma dica (primeiros 4 e últimos 4 caracteres) é mostrada
- Sem Registro: As chaves API nunca são registradas ou armazenadas em texto simples
WARNING
Mantenha suas chaves API confidenciais. Se você acredita que uma chave foi comprometida, remova-a do SipPulse AI imediatamente e regenere-a no console do provedor.
Permissões de Acesso
Apenas usuários com funções de Admin ou Owner podem gerenciar integrações de provedores. Isso garante que as credenciais de API sejam controladas por membros autorizados da equipe e previne acesso não autorizado a configurações sensíveis de faturamento.
Membros regulares da equipe podem usar os modelos habilitados por essas integrações, mas não podem visualizar ou modificar as credenciais em si.
Integrações vs Chaves API
É importante entender a diferença entre Integrações de Provedores e Chaves API:
| Recurso | Integrações de Provedores | Chaves API |
|---|---|---|
| Propósito | Conectar provedores externos de IA (OpenAI, Anthropic, etc.) | Acessar a API do SipPulse AI |
| Quem gerencia | Apenas Admin/Owner | Todos os usuários |
| Faturamento | Direto ao provedor | Créditos SipPulse AI |
| Localização | Página de Integrações | Página de Chaves API |
| Caso de uso | Usar suas próprias contas de provedores | Integrar o SipPulse AI em seus apps |
FAQ
Posso usar minhas próprias chaves e créditos da plataforma ao mesmo tempo?
Quando você adiciona uma credencial de provedor, as chamadas para os modelos desse provedor usarão sua chave. Para provedores sem credenciais configuradas, a plataforma usará os créditos da sua organização.
Como funciona o faturamento com minhas próprias chaves?
Ao usar suas próprias chaves API, você é cobrado diretamente pelo provedor (OpenAI, Anthropic, etc.) de acordo com a precificação deles. O SipPulse AI não cobra taxas adicionais pelo uso de suas próprias credenciais.
O que acontece se minha chave API expirar ou for inválida?
Se sua chave API se tornar inválida, as requisições para esse provedor falharão. Você precisará atualizar a credencial com uma chave válida. A plataforma mostrará uma mensagem de erro indicando a falha de autenticação.
Posso ter múltiplas chaves para o mesmo provedor?
Atualmente, apenas uma credencial por provedor é suportada por organização. Se você precisar trocar de chaves, edite a integração existente e substitua a chave.
Onde posso obter chaves API para cada provedor?
Cada provedor tem seu próprio console para gerenciar chaves API:
- OpenAI: OpenAI Platform
- Anthropic: Anthropic Console
- Google AI Studio: Google AI Studio
- Eleven Labs: Eleven Labs