Integração e APIs
Conecte o OpsScript com suas ferramentas
Visão Geral
O OpsScript oferece diferentes formas de integração:
- Integrações nativas: notificações e automações no Slack e no Microsoft Teams. Veja a seção Integrações.
- Alertas (Webhooks de entrada): receba eventos de sistemas externos (ex.: Alertmanager) e abra chamados automaticamente. Veja Webhooks (Alertas).
- API REST: automatize ações usando um token pessoal.
- MCP server (Model Context Protocol): acesso às principais funcionalidades do sistema para clientes MCP (IDEs, assistentes com IA). Veja IA e Automação.
[Assista o vídeo de Integrações e APIs]
Alertas (Webhooks de entrada)
Os webhooks do OpsScript são de entrada: um sistema externo envia uma requisição HTTP para uma URL gerada pela plataforma e o OpsScript abre um chamado a partir dos dados recebidos. Esse é o caminho usado para converter alertas de monitoramento em chamados.
A configuração é feita em Integrações → Alertas. Consulte o guia completo em Webhooks (Alertas).
API REST
Autenticação
A API é autenticada por token pessoal. Para gerar um token:
- Acesse Configurações → Tokens de acesso (API)
- Clique em Novo token
- Informe:
- Descrição: para que serve o token (ex.: "Script de automação")
- Data de expiração: quando o token deixa de ser válido
- Copie o token e guarde-o em local seguro (ele não será exibido novamente)
O token herda as permissões do usuário que o criou — não há seleção de escopos por token. Trate-o como uma credencial e revogue-o assim que não for mais necessário.
Headers
Authorization: Bearer seu_token_aqui
Content-Type: application/jsonA URL base da API é https://api.opsscript.io.
Principais recursos
Os mesmos recursos que você utiliza na interface estão disponíveis pela API. As operações seguem os campos exibidos nas telas correspondentes.
| Recurso | Endpoint base |
|---|---|
| Chamados | /api/v1/ticket |
| Comentários | /api/v1/comment |
| Projetos | /api/v1/project |
| Sprints | /api/v1/sprint |
| Tokens pessoais | /api/v1/personal-token |
Exemplo de listagem de chamados:
curl -H "Authorization: Bearer seu_token_aqui" \
https://api.opsscript.io/api/v1/ticket[Assista o vídeo de APIs REST]
Erros
A API utiliza códigos de status HTTP padrão:
200 OK: Sucesso
201 Created: Recurso criado
400 Bad Request: Dados inválidos
401 Unauthorized: Token inválido ou ausente
403 Forbidden: Sem permissão
404 Not Found: Recurso não encontrado
500 Internal Server Error: Erro do servidorIntegrações nativas
O OpsScript possui integrações nativas com plataformas de comunicação para enviar notificações e replicar comentários de chamados:
- Slack — notificações, broadcasting e gatilhos em canais do Slack.
- Microsoft Teams — notificações e atualizações de chamados em canais do Teams.
A configuração de ambas é feita em Integrações, no menu lateral.
Acesso programático
Além da API REST, o OpsScript expõe suas principais funcionalidades por meio de um MCP server, que pode ser usado por IDEs e assistentes com IA compatíveis com o Model Context Protocol. Não há um SDK oficial: a automação é feita pela API REST (com token pessoal) ou pelo MCP server. Consulte IA e Automação para detalhes do MCP server.