Integrações
Abra o hub Integrations do Admin Panel para conectar EventHub, conectores de data warehouse e o API Console. Disponibilidade depende do plano e do rollout.
O hub Integrations no Admin Panel é onde administradores conectam o PetroBench a sistemas corporativos de dados e abrem o API Console da organização.
Esta superfície do Admin Panel está em rollout e pode não aparecer em toda organização ainda. Quando habilitada para seu plano, você a encontra em Admin Panel > API & Integrations. Guias detalhados de setup estão em Enterprise Integrations.
Abrir Integrations
- Alterne para Admin Panel
- Abra API & Integrations > Overview (o rótulo pode aparecer como Integrations)
- Revise conectores em destaque e listas por categoria (Oil & Gas, Cloud & Data, Identity & Access e grupos relacionados)
O hub mostra totais de integrações disponíveis e conectadas quando sua org tem acesso.
O que você gerencia aqui
| Área | Finalidade |
|---|---|
| Connector catalog | Navegar integrações disponíveis para sua organização |
| Connection status | Ver quais conectores estão habilitados ou em breve |
| EventHub | Abrir configuração de sync e logs de conexão ativa com warehouse |
| API Console | Service Tokens, webhooks, uso e configs de connect para clientes |
API keys pessoais continuam em Settings. O hub do Admin Panel é a superfície de desenvolvedor no nível da organização.
EventHub e sync com warehouse
Para EventHub, Snowflake e fluxos de sync relacionados, use os guias Enterprise:
Pelo Admin Panel você normalmente:
- Abre o card da integração conectada
- Revisa field mappings, agenda de sync e logs recentes
- Resolve revisões de match de equipamento quando o conector enfileira matches de baixa confiança
Matches de equipamento com confiança menor vindos de sync inbound ficam na fila de revisão admin para que engenheiros não recebam silenciosamente a pumping unit ou grau de haste errado.
Console da API
O API Console é a home in-app para acesso à API da organização. Abra Admin Panel > API & Integrations > API Console.
Inclui quatro abas:
| Aba | Finalidade |
|---|---|
| Service Tokens | Criar e gerenciar tokens da divisão para servidores e jobs |
| Webhooks | Registrar endpoints HTTP para eventos da plataforma |
| Usage | Volume de requests ao vivo, limites do plano e quotas mensais |
| Connect | Config pronta para copiar para CLI, clientes MCP e REST |
Usage
Usage mostra volume de requests da API, quotas e consumo de tokens no período atual.
Cards típicos incluem:
- Contagens de requests da organização e pessoais, tempo médio de resposta e taxa de erro
- Plan limits: requests por minuto, agregado da divisão, runs concorrentes, teto diário de tokens
- Monthly quotas: reads, writes, simulation runs e entregas de webhook
- Daily activity mais top endpoints e consumidores quando há tráfego
Use esta aba ao diagnosticar rate limits, pressão de quota ou erros inesperados de API. Veja também Rate limits.
Service Tokens
Service Tokens são credenciais de longa duração da divisão, não de uma pessoa. Continuam funcionando depois que o criador sai.
Criar um service token
- Vá para Admin Panel > API & Integrations > API Console
- Abra a aba Service Tokens
- Clique em Create service token
- Informe Token name (por exemplo,
Nightly Snowflake Sync) - Escolha Expiration (30 dias, 90 dias ou 1 ano)
- Opcionalmente defina IP allowlist
- Selecione Permissions (scopes) para Wells, Simulations, Equipment e Organization
- Clique em Create service token
- Copie o token em texto imediatamente: ele é exibido apenas uma vez
No menu da linha você pode renomear, rotacionar ou revogar um token. Cada divisão tem número limitado de tokens ativos (mostrado como usado do total na lista).
Prefira service tokens para jobs agendados e integrações. Prefira personal API keys apenas quando um engenheiro chama a API de forma interativa.
Detalhes completos de auth: API authentication.
Webhooks
Webhooks registram endpoints HTTP que o PetroBench chama quando eventos ocorrem (por exemplo, well.created ou simulation.failed).
- Abra a aba Webhooks
- Clique em Add Webhook
- Informe a URL do endpoint e selecione eventos
- Salve e use o controle send/test para verificar entrega
Connect
A aba Connect ajuda a apontar CLI, clientes MCP (Claude, ChatGPT, Cursor), cURL ou Python ao seu workspace. Copie a config do cliente e substitua o placeholder da API key por um service token ou personal key.
Para setup passo a passo de clientes, veja Getting started e a referência MCP.
Quem pode acessar
| Ação | HQ Admin | Division Admin | Region Admin |
|---|---|---|---|
| Ver hub Integrations | Sim | Varia por plano | Não |
| Configurar EventHub | Sim | Varia por plano | Não |
| Abrir API Console (Usage, Connect) | Sim | Sim (própria divisão) | Não |
| Gerenciar Service Tokens | Sim | Sim (própria divisão) | Não |
| Gerenciar Webhooks | Sim | Sim (própria divisão) | Não |
Relacionado
- Apps para apps instalados e habilitação pelo marketplace
- Getting started with the API
- API authentication
- Rate limits
- RBAC para quem pode gerenciar settings da organização