Pular para o conteúdo
Conversas

Buscar conversa por id

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

Uma conversa do Atendimento (WhatsApp, Instagram, Facebook, Telefone). O id chega no evento message.received (data.conversationId).

Antes de responder como agente, confira ai.paused: true = a conversa foi passada para humano (handoff) ou alguém do time respondeu e a pausa ainda vale — fique quieto até ela soltar. messagingWindow.open: false = WhatsApp oficial fora da janela de 24h: texto livre será recusado.

assignedUserId é o dono do atendimento, não um sinal de silêncio: uma conversa pode ter dono e seguir com o agente.

Parâmetros de caminho

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

  • idstringobrigatório
    • tamanho 1–80

Respostas

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

200Deu certoapplication/json

A conversa, com o contato resumido, o dono do atendimento, o estado da IA (ai) e a janela de 24h.

V1Conversation

  • idstring
  • channelstring
  • connectionIdstring | null
  • contactIdstring | null
    • idstring
    • namestring
    • phonestring | null
    • emailstring | null
  • contactDisplaystring | null
  • contactPhonestring | null
  • assignedUserIdstring | null
  • humanAssignedboolean
  • assignedAtstring | null
  • lastMessageAtstring | null
  • lastMessageDirectionstring | null
    • um de"inbound""outbound"
  • lastMessageActorstring | null
    • um de"user""contact""ia""automation""system""api""unknown"
  • archivedboolean
    • pausedboolean
    • pausedUntilstring | null
    • pausedReasonstring | null
    • appliesboolean
    • openboolean
    • expiresAtstring | null
  • createdAtstring
  • updatedAtstring