Abrir chamado a partir do seu sistema | Desenvolvedores Steel

export STEEL_MONITOR_URL="https://homologacao.stratustelecom.com.br/api/servicedesk/monitoring/<token>"

curl -X POST "$STEEL_MONITOR_URL" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "erp-pedido-1042",
    "status": "PROBLEM",
    "severity": "high",
    "host": "erp-01",
    "subject": "Pedido 1042 travado no faturamento",
    "body": "A nota fiscal do pedido 1042 foi recusada pela SEFAZ (rejeição 539).",
    "tags": ["erp", "faturamento"]
  }'

{
  "success": true,
  "statusCode": 200,
  "data": {
    "alertId": "ckx3alrt0000ab7d3k1e5xyz",
    "status": "OPEN",
    "outcome": "ticket_created",
    "ticket": { "id": "ckx3tckt0000ab7d3k1e5xyz", "number": 42, "code": "INC-000042" }
  }
}

curl -X POST "$STEEL_MONITOR_URL" \
  -H "Content-Type: application/json" \
  -d '{ "externalId": "erp-pedido-1042", "status": "RESOLVED", "subject": "Pedido 1042 faturado" }'

// Node.js 18+
export async function reportToSteel(event) {
  const response = await fetch(process.env.STEEL_MONITOR_URL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(event),
  })
  const body = await response.json()
  if (!body.success) throw new Error(`${body.statusCode} ${body.error.code}`)
  return body.data // { alertId, status, outcome, ticket }
}

await reportToSteel({
  externalId: 'erp-pedido-1042',
  status: 'PROBLEM',
  severity: 'high',
  subject: 'Pedido 1042 travado no faturamento',
})

import os
import requests

def report_to_steel(event: dict) -> dict:
    response = requests.post(os.environ["STEEL_MONITOR_URL"], json=event, timeout=10)
    body = response.json()
    if not body["success"]:
        raise RuntimeError(f"{body['statusCode']} {body['error']['code']}")
    return body["data"]

report_to_steel({
    "externalId": "erp-pedido-1042",
    "status": "RESOLVED",
    "subject": "Pedido 1042 faturado",
})

Campo	Obrigatório	O que faz
`subject`	Sim (ou `body`)	Título do chamado; só a primeira linha, até 200 caracteres. Sem ele, vale a primeira linha de `body`
`externalId`	Recomendado	Seu identificador do evento, até 200 caracteres. Sem ele, o Steel usa um hash de `host` com `subject`
`status`	Não	`PROBLEM` ou `FIRING` abrem; `OK` ou `RESOLVED` encerram. Sem `status`, é problema
`severity`	Não	Procurada no mapa de severidade da origem (sem diferenciar maiúsculas)
`host`	Não	Liga o chamado ao item de configuração de mesmo nome, código ou IP
`body`	Não	Descrição do chamado, até 8.000 caracteres
`tags`	Não	Lista de textos ou texto separado por vírgulas, até 20
`startedAt`	Não	Início do problema: data ISO 8601 ou epoch em segundos/milissegundos

`outcome`	Quando
`ticket_created`	Problema novo: chamado aberto
`ticket_reopened`	O mesmo problema voltou dentro da janela de instabilidade
`alert_updated`	O problema já estava aberto: o alerta foi atualizado
`ticket_resolved`	Normalizou e o chamado foi para a fase de resolvido
`alert_resolved`	Normalizou, mas o chamado ficou para uma pessoa resolver (ou não havia chamado)

Status	Código	Causa
`401`	`SD_MONITOR_TOKEN_INVALID`	Token errado, gerado de novo ou origem desativada
`403`	`MODULE_DISABLED`	O ServiceDesk foi desabilitado no workspace
`422`	`SD_MONITOR_PAYLOAD_INVALID`	JSON malformado, sem `subject` nem `body`, ou acima de 64 KB
`429`	`RATE_LIMITED`	Mais de 100 chamadas por minuto do mesmo IP

Abrir chamado a partir do seu sistema

Como funciona

1. Crie a origem

2. Abra um chamado

3. Encerre quando o problema acabar

O mesmo fluxo em JavaScript e Python

Os campos

As respostas

E se for uma pessoa pedindo?