Chaves de API
Configure as chaves de API públicas para os widgets de suporte do Next.js e do React.
Pegue a sua chave pública
Abra o seu painel em Configurações → Desenvolvedores e crie ou copie uma chave pública.
Configure as variáveis de ambiente
NEXT_PUBLIC_FLUXO_API_KEY=pk_live_xxxxxxxxxxxxO SDK procura VITE_FLUXO_API_KEY (Vite), NEXT_PUBLIC_FLUXO_API_KEY
(Next.js) ou FLUXO_API_KEY quando o seu empacotador a expõe explicitamente
ao código do navegador. O Create React App, o Remix e os empacotadores
genéricos não expõem automaticamente variáveis de ambiente do servidor;
nesses casos, passe publicKey pela configuração de cliente documentada.
Chaves públicas versus privadas
| Tipo | Prefixo | Para que serve | Segura no navegador |
|---|---|---|---|
| Pública | pk_live_*, pk_test_* | Integrar o widget | Sim |
| Privada | sk_live_*, sk_test_* | API entre servidores | Não |
Use apenas chaves públicas no código do widget no frontend.
Domínios permitidos
As chaves públicas só funcionam nos domínios da lista de permitidos.
- As chaves de produção (
pk_live_*) exigem que o domínio esteja na lista. - As chaves de teste (
pk_test_*) aceitam HTTP em localhost, mas o localhost ainda precisa estar nos domínios permitidos da chave. - Permitir um domínio principal também permite os seus subdomínios.
Use origens completas ou domínios simples, por exemplo:
example.comhttps://staging.example.comhttp://localhost:3000
Solução de problemas
Erro de configuração no widget
Confira se:
- o nome da variável de ambiente está correto para o seu framework
- a chave continua ativa
- você reiniciou o app depois de alterar as variáveis
Domínio não permitido
Confira se:
- o domínio aparece em Configurações → Desenvolvedores → Domínios permitidos
- as chaves de produção usam HTTPS
Esta página foi útil?
Abra uma issue de documentação já preenchida para que a equipe possa agir.