Pular para o conteúdo
Conversas

Listar mensagens da conversa

v1.0.0
GEThttps://api.growthaisystem.com/api/v1/conversations/{id}/messages
  • ExigeAuthorization: Bearer gos_…— Chave de API (gos_…)· escoposconversations.read

Mais recentes primeiro, paginado por cursor; limit até 200 (padrão 50). createdAfter (ISO, exclusivo) traz só o que foi enviado depois de um instante — para buscar só o que chegou desde a última leitura.

actor diz quem escreveu: contact, user (pessoa do time, com userId), ia (IA da plataforma), automation, system, api (integração — inclusive as suas respostas) ou unknown.

Áudio: transcription traz o texto quando a transcrição termina (transcriptionStatus: done); enquanto for pending/processing, leia de novo em alguns segundos. Mídia: hasMedia + mediaType; o arquivo sai por GET /conversations/{id}/messages/{messageId}/media. Mensagem apagada sai com deletedAt e sem texto. Ficam de fora os marcadores internos do fio ("Fulano assumiu a conversa") e a bolha de ligação.

Parâmetros de caminho

Entram no próprio endereço, no lugar das chaves.

  • idstringobrigatório
    • tamanho 1–80

Parâmetros de consulta

Vão na querystring, depois do ?.

  • createdAfterstringopcional
  • cursorstringopcional
  • limitintegeropcional
    • padrão 50
    • faixa 1–200

Respostas

7 respostas documentadas — o código, o que ele significa nesta rota e a forma do corpo.

200Deu certoapplication/json

Mensagens da conversa, da mais recente para a mais antiga (providerTimestamp DESC). nextCursor: null = acabou.

  • Cada item — V1ConversationMessage

    • idstring
    • conversationIdstring
    • contactIdstring | null
    • channelstring
    • connectionIdstring | null
    • directionstring
      • um de"inbound""outbound"
    • actorstring
      • um de"user""contact""ia""automation""system""api""unknown"
    • userIdstring | null
    • typestring
    • textstring | null
    • transcriptionstring | null
    • transcriptionStatusstring | null
    • mediaTypestring | null
    • hasMediaboolean
    • statusstring
    • statusReasonstring | null
    • providerTimestampstring
    • createdAtstring
    • deletedAtstring | null
  • nextCursorstring | null

    Cursor opaco da PRÓXIMA página — passe em ?cursor=. null = acabou a lista.