Conversation

A Groove conversation is a thread of messages (for example emails, chats, or notes) and associated actions or events (for example 'opened', 'snoozed', and 'assigned').

To fetch Messages/Ratings/StateChanges/etc. on a conversation, query the Events connection (on the QueryRoot) with the conversation ID.

To fetch all possible fields:

query Conversation {
  node(id: "cnv_12345678") {
    
        __typename
        ... on Conversation {
          assigned {
            at
            agent {
              id
              name
            }
            team {
              id
              name
            }
          }
          counts {
            attachments
            interactions
            messages
            notes
            stateChanges
          }
          createdAt
          contact {
            id
            email
          }
          deletedAt
          drafts {
            nodes {
              id
            }
          }
          followers {
            nodes {
              id
              email
            }
          }
          id
          number
          snoozed {
            by { id }
            until
          }
          starred
          state
          stateUpdatedAt
          summaryMessage {
            id
            bodyPlainText
          }
          subject
          systemUpdatedAt
          tags {
            nodes {
              id
              name
            }
          }
          updatedAt
          
        ... on FacebookConversation {
          facebookId
        }
      
          
        ... on TwitterConversation {
          twitterId
        }
      
          
        ... on WidgetConversation {
          browser
          referrer
          pageTitle
          pageUrl
          platform
          referrer
        }
      
        }
      
  }
}

To search conversations matching a specific keyword:

query Conversations {
  conversations(filter: { keywords: "rad" }) {
    edges {
      node {
        ... on Conversation {
          id
          number
          searchSummary {
            author {
              __typename
              ... on Agent {
                email
                role
              }
              ... on Contact {
                email
              }
            }
            body
            forwarded
            note
          }
        }
      }
    }
  }
}

interface Conversation {
  assigned: Assignment
  channel: Channel!
  contact: Contact
  counts: ConversationCounts!
  createdAt: DateTime!
  customFieldValues(
  after: String
  before: String
  filter: CustomFieldValuesFilter
  first: Int
  last: Int
): CustomFieldValueConnection
  deletedAt: DateTime
  drafts(
  after: String
  before: String
  first: Int
  last: Int
): DraftConnection
  followers(
  after: String
  before: String
  filter: AgentFilter
  first: Int
  last: Int
  orderBy: AgentOrder
): AgentConnection
  id: ID!
  lastUnansweredUserMessageAt: DateTime!
  mentions: [Mention!]!
  number: Int!
  searchSummary: SearchSummary
  snoozed: Snooze
  starred: Boolean!
  state: ConversationState!
  stateUpdatedAt: DateTime
  subject: String
  summaryMessage: SummaryMessage
  systemUpdatedAt: DateTime!
  tags(
  after: String
  before: String
  filter: TagFilter
  first: Int
  last: Int
  orderBy: TagOrder
): TagConnection
  updatedAt: DateTime!
}

Fields

`Conversation.assigned` ● `Assignment` object common

The agents and/or teams that are assigned to the conversation.

`Conversation.channel` ● `Channel!` non-null interface common

The channel in which the conversation is happening.

`Conversation.contact` ● `Contact` object common

The primary contact associated with the conversation.

`Conversation.counts` ● `ConversationCounts!` non-null object common

The statistics about the messages and interactions in the conversation.

`Conversation.createdAt` ● `DateTime!` non-null scalar common

The date and time that the object was created.

`Conversation.customFieldValues` ● `CustomFieldValueConnection` object common

Lists all custom fields.

Conversation.customFieldValues.after ● String scalar common

Returns the elements in the list that come after the specified cursor.

`Conversation.customFieldValues.before` ● `String` scalar common

Returns the elements in the list that come before the specified cursor.

`Conversation.customFieldValues.filter` ● `CustomFieldValuesFilter` input common

Filter custom field values.

`Conversation.customFieldValues.first` ● `Int` scalar common

Returns the first n elements from the list.

`Conversation.customFieldValues.last` ● `Int` scalar common

Returns the last n elements from the list.

`Conversation.deletedAt` ● `DateTime` scalar common

The date and time that the conversation was trashed.

`Conversation.drafts` ● `DraftConnection` object common

The current user's draft messages on the conversation.

Conversation.drafts.after ● String scalar common

Returns the elements in the list that come after the specified cursor.

`Conversation.drafts.before` ● `String` scalar common

Returns the elements in the list that come before the specified cursor.

`Conversation.drafts.first` ● `Int` scalar common

Returns the first n elements from the list.

`Conversation.drafts.last` ● `Int` scalar common

Returns the last n elements from the list.

`Conversation.followers` ● `AgentConnection` object common

Lists all agents that are following the conversation.

Conversation.followers.after ● String scalar common

Returns the elements in the list that come after the specified cursor.