Mensagens
Consultar mensagem
https://api.picchat.com.br/v1/messages/{id}Devolve uma mensagem pelo ID com atendente, contato, participante (grupos), modelo e automação. Mensagem de canal fora do escopo do usuário responde 404.
Parâmetros de caminho
idstring (uuid)obrigatórioUUID da mensagem.
Respostas
200OK
idstring (uuid)obrigatórioID da mensagem.
ticket_idstring (uuid) | nullobrigatórioTíquete da mensagem (null em disparos sem tíquete).
contact_idstring (uuid) | nullobrigatórioContato da conversa.
channel_idstring (uuid)obrigatórioCanal por onde passou.
automation_idstring (uuid) | nullobrigatórioAutomação que disparou a mensagem, se houver.
template_idstring (uuid) | nullobrigatórioModelo usado, se houver.
fromMeboolean | nullobrigatóriotrue = enviada pela conta; false = recebida do contato.
typestringobrigatórioTipo da mensagem.
textimagevideoaudiodocumentlocationcontactsstickerinteractiveunsupportedtemplatebuttonstatusstringobrigatórioStatus de envio. Mensagens recebidas ficam como `received`.
receivedpendingprocessingsendingcompletedcanceledpausederrorbodystring | nullobrigatórioTexto da mensagem.
captionstring | nullobrigatórioLegenda da mídia.
filestring | nullobrigatórioURL do arquivo de mídia.
mime_typestring | nullobrigatórioMIME type da mídia.
latitudestring | nullobrigatórioLatitude (mensagens de localização), como texto.
longitudestring | nullobrigatórioLongitude (mensagens de localização), como texto.
vcardanyobrigatórioContatos compartilhados (JSON livre, pode ser null).
contextanyobrigatórioContexto da mensagem (ex.: mensagem respondida) (JSON livre, pode ser null).
reactionsanyobrigatórioReações recebidas (JSON livre, pode ser null).
editedboolean | nullobrigatórioSe a mensagem foi editada.
errorstring | nullobrigatórioMotivo do erro de envio.
ex_idstring | nullobrigatórioID da mensagem no provedor (ex.: wamid da Meta).
sent_atstring (date-time) | nullobrigatórioEnviada ao provedor.
delivery_atstring (date-time) | nullobrigatórioEntregue.
read_atstring (date-time) | nullobrigatórioLida.
replied_atstring (date-time) | nullobrigatórioRespondida pelo contato.
error_atstring (date-time) | nullobrigatórioQuando falhou.
schedule_atstring (date-time) | nullobrigatórioAgendada para.
created_atstring (date-time)obrigatórioCriação.
usersobject | nullobrigatórioAtendente que enviou (mensagens manuais).
users.idstring (uuid)obrigatórioID do usuário.
users.namestringobrigatórioNome.
users.lastNamestring | nullobrigatórioSobrenome.
contactsobject | nullobrigatórioContato da conversa.
contacts.idstring (uuid)obrigatórioID do contato.
contacts.first_namestring | nullobrigatórioNome.
contacts.last_namestring | nullobrigatórioSobrenome.
contacts.mobilephonestring | nullobrigatórioTelefone só com dígitos, com DDI.
messageParticipantobject | nullobrigatórioParticipante que escreveu, em conversas de grupo.
messageParticipant.idstring (uuid)obrigatórioID do contato.
messageParticipant.first_namestring | nullobrigatórioNome.
messageParticipant.last_namestring | nullobrigatórioSobrenome.
messageParticipant.mobilephonestring | nullobrigatórioTelefone só com dígitos, com DDI.
templatesobject | nullobrigatórioModelo usado.
templates.idstring (uuid)obrigatórioID.
templates.namestring | nullobrigatórioNome.
automationsobject | nullobrigatórioAutomação de origem.
automations.idstring (uuid)obrigatórioID.
automations.namestring | nullobrigatórioNome.
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.