1. Contatos
Titov
  • Titov
    • Enviar Mensagens
      • Enviar template HSM
      • Enviar mensagem livre
      • Enviar mídia
    • Contatos
      • Listar contatos
        GET
      • Listar conversa do contato
        GET
      • Criar contato
        POST
      • Atualizar contato
        PUT
      • Excluir contato
        DELETE
    • Mobile
      • Widget de Chat — Guia de Implementação (Web e App Mobile)
      • Cria uma sessão anônima
      • Histórico da sessão
      • Envia mensagem de texto
      • Envia arquivo (imagem, áudio ou documento)
      • Stream SSE das respostas em tempo real
      • Continuar a conversa no WhatsApp
    • Grupos de Contatos
      • Listar grupos de contatos
      • Criar grupo de contatos
      • Atualizar grupo de contatos
      • Excluir grupo de contatos
    • Respostas Rápidas
      • Listar respostas rápidas
      • Criar resposta rápida
      • Atualizar resposta rápida
      • Excluir resposta rápida
    • Template
      • Listar templates aprovados por número
    • Webhooks
      • Mensagens
        • Mensagem recebida de um contato
        • Mensagem enviada pela plataforma
      • Tickets
        • Ticket de atendimento aberto
        • Ticket de atendimento fechado
      • Contatos
        • Contato criado
        • IA pediu atendimento humano
        • Lead qualificado como quente (score ≥ 70)
        • IA converteu o contato
      • Rádio
        • Áudio de ouvinte aprovado (Rádio)
    • Esquemas
      • Error
      • Contact
      • Envelope
      • HistoryMessage
      • ContactInput
      • ContactRef
      • SseMessage
      • Message
      • MessageEvent
      • PhoneTemplates
      • TicketCreatedEvent
      • ContactGroup
      • TicketClosedEvent
      • ContactGroupInput
      • ContactCreatedEvent
      • CannedReply
      • ContactHelpEvent
      • CannedReplyTextInput
      • ContactHotEvent
      • CannedReplyMediaInput
      • ContactConvertedEvent
      • PaginationLinks
      • RadioAudioEvent
      • PaginationMeta
      • CodedError
      • LegacyError
  1. Contatos

Listar conversa do contato

GET
/api/contacts/{uuid}/messages
Mensagens trocadas com o contato, paginadas da mais recente para a mais antiga.
Útil para acompanhar o resultado real de um POST /api/send/*, já que aquele 202
não confirma entrega — aqui o campo status reflete o estado da mensagem.

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros de Caminho

Parâmetros de Consulta

Exemplos de Requisição

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://titov.com.br/api/contacts//messages?page=undefined&per_page=undefined' \
--header 'Authorization: Bearer <token>'

Respostas

🟢200OK
application/json
Coleção paginada de mensagens
Bodyapplication/json

Exemplo
{
    "data": [
        {
            "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
            "type": "inbound",
            "direction": "inbound",
            "content": "string",
            "media": {
                "name": "string",
                "type": "string",
                "url": "string",
                "size": "string"
            },
            "sent_by_assistant": true,
            "read": true,
            "status": "string",
            "created_at": "2019-08-24T14:15:22.123Z"
        }
    ],
    "links": {
        "first": "string",
        "last": "string",
        "prev": "string",
        "next": "string"
    },
    "meta": {
        "current_page": 0,
        "from": 0,
        "last_page": 0,
        "path": "string",
        "per_page": 0,
        "to": 0,
        "total": 0
    }
}
🟠400Requisição Inválida
🟠401Não Autorizado
🟠404Registo Não Encontrado
Modificado em 2026-07-17 11:51:13
Página anterior
Listar contatos
Próxima página
Criar contato
Built with