lista de eventos
| evento | quando acontece |
|---|---|
case.created | novo caso foi aberto |
case.status_base.new | caso entrou com status base “novo” |
case.status_base.open | caso está em andamento |
case.status_base.pending | caso aguardando resposta |
case.status_base.closed | caso foi encerrado |
exemplo de payload
- novo caso
- alteração de status
{
"eventId": "7f3a1c2e-9b4d-4e8f-a1c2-5d3e6f8a0b1c",
"eventType": "case.created",
"eventVersion": "1.0",
"timestamp": "2026-04-16T09:30:00.123Z",
"subscriptionId": "a8fa74b1-af91-4dde-b68b-82e06e1d51a1",
"brand": {
"id": "5d84bfd8-c9ae-44bc-acfb-dbc1721fa1be",
"name": "nome da marca"
},
"entity": {
"type": "case",
"id": "b2c4d6e8-f0a2-4b8c-9d1e-3f5a7c9e1b3d",
"href": "https://integration.teceo.co/v1/cases/b2c4d6e8-f0a2-4b8c-9d1e-3f5a7c9e1b3d"
},
"data": {
"caseCode": "001",
"subject": "Produto chegou com defeito na embalagem",
"externalCode": null,
"currentStatus": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Novo",
"statusBase": "new"
},
"customer": {
"id": "e6892af7-75d6-4036-8779-9d2ad1336dab",
"commercialName": "Loja Centro"
},
"caseType": {
"id": "f1e2d3c4-b5a6-7890-abcd-123456789012",
"name": "Devolução"
}
},
"metadata": {
"changedBy": {
"type": "user",
"id": "30cac3a9-ceb1-46db-bd94-038c8a7f9331",
"name": "Nome do Usuário"
}
}
}
todos os eventos
case.status_base.* têm a mesma estrutura de payload.{
"eventId": "2d4f6a8c-0e2b-4c8f-a3d5-7e9b1f3a5c7e",
"eventType": "case.status_base.closed",
"eventVersion": "1.0",
"timestamp": "2026-04-16T16:00:00.456Z",
"subscriptionId": "a8fa74b1-af91-4dde-b68b-82e06e1d51a1",
"brand": {
"id": "5d84bfd8-c9ae-44bc-acfb-dbc1721fa1be",
"name": "nome da marca"
},
"entity": {
"type": "case",
"id": "b2c4d6e8-f0a2-4b8c-9d1e-3f5a7c9e1b3d",
"href": "https://integration.teceo.co/v1/cases/b2c4d6e8-f0a2-4b8c-9d1e-3f5a7c9e1b3d"
},
"data": {
"caseCode": "001",
"subject": "Produto chegou com defeito na embalagem",
"externalCode": null,
"previousStatus": {
"id": "c1d2e3f4-a5b6-7890-abcd-ef1234567890",
"name": "Em andamento",
"statusBase": "open"
},
"currentStatus": {
"id": "d1e2f3a4-b5c6-7890-abcd-123456789012",
"name": "Encerrado",
"statusBase": "closed"
},
"customer": {
"id": "e6892af7-75d6-4036-8779-9d2ad1336dab",
"commercialName": "Loja Centro"
},
"caseType": {
"id": "f1e2d3c4-b5a6-7890-abcd-123456789012",
"name": "Devolução"
}
},
"metadata": {
"changedBy": {
"type": "user",
"id": "30cac3a9-ceb1-46db-bd94-038c8a7f9331",
"name": "Nome do Usuário"
}
}
}
casos de uso comuns
sincronizar com helpdesk
quando um caso é aberto ou muda de status, você mantém seu sistema de suporte em sincronia.if (eventType === "case.created") {
createTicketInHelpdesk(data);
} else if (eventType.startsWith("case.status_base.")) {
updateTicketInHelpdesk(entity.id, data.currentStatus);
}
notificar cliente
quando um caso é encerrado, você notifica o cliente.if (eventType === "case.status_base.closed") {
notifyCustomer(data.customer.id, data.subject);
}
dados inclusos
o objetodata contém o código do caso, assunto, cliente, tipo e status (anterior e atual). se precisar de mais informações, use entity.href para buscar os dados completos via API.