CONSTRUA
Referência da API
Endpoints, corpos e respostas da plataforma.
URL e autenticação
Base: https://support-ai.pontes.uk. Use Content-Type: application/json nos corpos JSON. A credencial sik_ é exclusiva do emissor; as rotas de conversa usam Bearer com o JWT temporário.
Os caminhos de bootstrap/contexto do aplicativo são definidos pelo seu time. A plataforma recebe contexto push; não exige as quatro rotas pull do contrato antigo.
POST /api/widget/sessions
Autorização: Bearer <sik_>. HTTP 200 retorna {jwt, tenantKey, expiresIn:900}. O corpo contém a identidade revalidada pelo seu backend.
{ "userId": "usr_exemplo", "userEmail": "", "userRoles": ["member"], "plan": "standard" }Conversas e mensagens
Todas as rotas abaixo verificam tenant e proprietário. Os identificadores são opacos. A criação bem-sucedida deve conter aiMessage e snapshot; confirme a resposta real na homologação.
| Método / rota | Corpo / resultado |
|---|---|
| POST /api/cases | {message, context} → {case, snapshot:{id}, aiMessage} |
| GET /api/cases/:caseId | → {case, messages, snapshot} |
| POST /api/cases/:caseId/messages | {content, replyToMessageId?} → {message} |
| POST /api/cases/:caseId/feedback | {feedback:"positive"|"negative"} → {ok:true} |
| POST /api/cases/:caseId/close | {resolution:"resolved"|"unresolved", rating:1…10} → {ok:true} |
message/content: 1–5.000 caracteres. replyToMessageId vincula uma confirmação à mensagem apresentada e é obrigatório para confirmar escrita.
Integrações opcionais
POST /api/cases/:caseId/escalate recebe {reason?}. Escalonamento ou ações sem conector/executor podem retornar 501. Não anuncie chamado criado ou alteração concluída sem resultado verificável.