Tíquetes

Consultar tíquete

GEThttps://api.picchat.com.br/v1/tickets/{id}

Devolve um tíquete pelo ID (UUID) ou pelo número público (public_id, só dígitos). Inclui os totais de mensagens e notas. Tíquete de canal fora do escopo do usuário responde 404.

Autenticação: Bearer tokenPermissão: Inbox › ver

Parâmetros de caminho

idstringobrigatório
UUID do tíquete ou número público (`public_id`, ex.: `10482`).

Respostas

200OK

idstring (uuid)obrigatório
ID do tíquete.
public_idintegerobrigatório
Número público sequencial do tíquete (o que aparece na inbox).
created_atstring (date-time)obrigatório
Criação.
updated_atstring (date-time)obrigatório
Última atualização.
end_atstring (date-time) | nullobrigatório
Quando foi encerrado.
expiration_atstring (date-time) | nullobrigatório
Fim da janela de atendimento de 24 h do WhatsApp oficial, quando aplicável.
openboolean | nullobrigatório
true = em aberto; false = encerrado.
unreadinteger | nullobrigatório
Quantidade de mensagens não lidas.
fromMeboolean | nullobrigatório
Se a última mensagem foi enviada pela conta.
created_fromMeboolean | nullobrigatório
Se o tíquete foi aberto pela conta (envio ativo) e não pelo contato.
typestring | nullobrigatório
Tipo da última mensagem.
textimagevideoaudiodocumentlocationcontactsstickerinteractiveunsupportedreactiontemplatebuttonnull
categorystring | nullobrigatório
Categoria atribuída ao tíquete.
commentstring | nullobrigatório
Comentário/resumo do tíquete.
last_messagestring | nullobrigatório
Texto da última mensagem.
last_message_datestring (date-time) | nullobrigatório
Data da última mensagem.
first_message_date_from_mestring (date-time) | nullobrigatório
Data da primeira resposta da conta.
ticket_statusobject | nullobrigatório
Status atual.
ticket_status.idstring (uuid)obrigatório
ID do status.
ticket_status.namestring | nullobrigatório
Nome interno (ex.: ABERTOS, RESOLVIDOS).
ticket_status.public_namestring | nullobrigatório
Nome exibido, quando houver.
ticket_status.colorstring | nullobrigatório
Cor do status (token de cor do front).
contactobject | nullobrigatório
Contato do tíquete.
contact.idstring (uuid)obrigatório
ID do contato.
contact.first_namestring | nullobrigatório
Nome.
contact.last_namestring | nullobrigatório
Sobrenome.
contact.mobilephonestring | nullobrigatório
Telefone só com dígitos, com DDI (ex.: 5511999990000).
contact.emailstring | nullobrigatório
E-mail.
contact.userNamestring | nullobrigatório
Usuário do Instagram, quando o contato veio de lá.
userobject | nullobrigatório
Atendente responsável (null = sem responsável).
user.idstring (uuid)obrigatório
ID do usuário.
user.namestringobrigatório
Nome.
user.lastNamestring | nullobrigatório
Sobrenome.
channelobjectobrigatório
Canal resumido.
channel.idstring (uuid)obrigatório
ID do canal.
channel.namestringobrigatório
Nome do canal.
channel.typestringobrigatório
Tipo do canal.
whatsappwhatsapp_litesmsemailwebhookchatinstagramrcs
tagsarray<TagRef>obrigatório
Tags aplicadas ao tíquete.
tags[].idstring (uuid)obrigatório
ID da tag.
tags[].namestringobrigatório
Nome da tag.
tags[].colorstring | nullobrigatório
Cor da tag.
messages_countintegerobrigatório
Total de mensagens do tíquete.
notes_countintegerobrigatório
Total de notas internas do tíquete.

403Acesso negado: usuário do token sem a permissão da rota (`permission_denied`) ou token não ligado a um usuário ativo (`token_without_user`) — para token de integração da conta isso só é aplicado quando `access.enforced` é true (veja GET /v1/me); token pessoal e JWT de sessão são sempre verificados; `account_id` na query diferente da conta do token; conta do tipo INFRA.

404Registro não existe, é de outra conta, foi excluído ou está fora do escopo de canais do usuário.

498Token ausente, inválido, de outra finalidade (ex.: token do canal chat) ou revogado. Note o status não padrão 498.