HSDesk APIHSDesk / API Pública
ReferenciaEntrada (v1)

Responder ticket (como cliente)

POST
/api/v1/tickets/{id}/respostas

Authorization

hsdeskKey
AuthorizationBearer <token>

HSDesk Key (credencial de aplicação). Envie como Authorization: Bearer <hsk_...> ou Authorization: Basic base64("<hsk_...>:") (chave como usuário, senha vazia).

In: header

Path Parameters

id*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/tickets/497f6eca-6276-4993-bfeb-53cbbbba6f08/respostas" \  -H "Content-Type: application/json" \  -d '{    "mensagem": "Tem previsão de solução?"  }'
{  "success": true,  "message": "Resposta registrada.",  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "mensagem": "Já estamos verificando.",    "origem": "agente",    "editado": false,    "autor": {      "tipo": "agente",      "nome": "Ana Atendente",      "email": "string",      "external_id": "string"    },    "criado_em": "2019-08-24T14:15:22Z"  },  "errors": []}
{  "success": false,  "message": "Erro de validação",  "errors": {    "nome": [      "O campo nome é obrigatório."    ],    "categoria": [      "O campo categoria é obrigatório."    ]  }}
{  "success": false,  "message": "Não autenticado.",  "status": 401,  "data": null,  "errors": {    "field": "api_key",    "message": "Credencial inválida ou revogada."  }}
{  "success": false,  "message": "Ticket não encontrado.",  "status": 404,  "data": null,  "errors": {    "field": "id",    "message": "Ticket não pertence a esta organização."  }}
{  "success": false,  "message": "Ticket sem contato vinculado.",  "status": 422,  "data": null,  "errors": {    "field": "contato",    "message": "Este ticket não possui um contato e não pode receber respostas via API."  }}