TwitterConversation
A Groove conversation initiated from Twitter.
To fetch a specific Twitter conversation by ID:
query Conversation {
node(id: "cnv_12345678") {
... on TwitterConversation {
twitterId
}
}
})
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
}
}
}
})
type TwitterConversation implements Conversation, Node {
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
twitterId: String
updatedAt: DateTime!
}
Fields
TwitterConversation.assigned ● Assignment object common
The agents and/or teams that are assigned to the conversation.
TwitterConversation.channel ● Channel! non-null interface common
The channel in which the conversation is happening.
TwitterConversation.contact ● Contact object common
The primary contact associated with the conversation.
TwitterConversation.counts ● ConversationCounts! non-null object common
The statistics about the messages and interactions in the conversation.
TwitterConversation.createdAt ● DateTime! non-null scalar common
The date and time that the object was created.
TwitterConversation.customFieldValues ● CustomFieldValueConnection object common
Lists all custom fields.
TwitterConversation.customFieldValues.after●Stringscalar commonReturns the elements in the list that come after the specified cursor.
TwitterConversation.customFieldValues.before ● String scalar common
Returns the elements in the list that come before the specified cursor.
TwitterConversation.customFieldValues.filter ● CustomFieldValuesFilter input common
Filter custom field values.
TwitterConversation.customFieldValues.first ● Int scalar common
Returns the first n elements from the list.
TwitterConversation.customFieldValues.last ● Int scalar common
Returns the last n elements from the list.
TwitterConversation.deletedAt ● DateTime scalar common
The date and time that the conversation was trashed.
TwitterConversation.drafts ● DraftConnection object common
The current user's draft messages on the conversation.
TwitterConversation.drafts.after●Stringscalar commonReturns the elements in the list that come after the specified cursor.
TwitterConversation.drafts.before ● String scalar common
Returns the elements in the list that come before the specified cursor.
TwitterConversation.drafts.first ● Int scalar common
Returns the first n elements from the list.
TwitterConversation.drafts.last ● Int scalar common
Returns the last n elements from the list.
TwitterConversation.followers ● AgentConnection object common
Lists all agents that are following the conversation.
TwitterConversation.followers.after●Stringscalar commonReturns the elements in the list that come after the specified cursor.
TwitterConversation.followers.before ● String scalar common
Returns the elements in the list that come before the specified cursor.
TwitterConversation.followers.filter ● AgentFilter input common
The fields by which to filter the results.
TwitterConversation.followers.first ● Int scalar common
Returns the first n elements from the list.
TwitterConversation.followers.last ● Int scalar common
Returns the last n elements from the list.
TwitterConversation.followers.orderBy ● AgentOrder input common
The field and direction by which to order the results.
TwitterConversation.id ● ID! non-null scalar common
TwitterConversation.lastUnansweredUserMessageAt ● DateTime! non-null scalar common
The date and time of the last unanswered user message.
TwitterConversation.mentions ● [Mention!]! non-null object common
The mentions for the conversation.
TwitterConversation.number ● Int! non-null scalar common
The ID of the conversation within the account.
TwitterConversation.searchSummary ● SearchSummary object common
The comment that matched the given search keywords.
TwitterConversation.snoozed ● Snooze object common
The agent that snoozed the conversation and when it is snoozed until.
TwitterConversation.starred ● Boolean! non-null scalar common
True if the conversation is starred; false otherwise.
TwitterConversation.state ● ConversationState! non-null enum common
The state of the conversation.
TwitterConversation.stateUpdatedAt ● DateTime scalar common
The date and time that the conversation state was last updated.
TwitterConversation.subject ● String scalar common
The subject of the conversation.
TwitterConversation.summaryMessage ● SummaryMessage object common
The conversation summary, which is usually the first MessageChange in the conversation.
TwitterConversation.systemUpdatedAt ● DateTime! non-null scalar common
The date and time that the conversation was last updated.
TwitterConversation.tags ● TagConnection object common
Lists all tags.
TwitterConversation.tags.after●Stringscalar commonReturns the elements in the list that come after the specified cursor.
TwitterConversation.tags.before ● String scalar common
Returns the elements in the list that come before the specified cursor.
TwitterConversation.tags.filter ● TagFilter input common
The fields by which to filter the results.
TwitterConversation.tags.first ● Int scalar common
Returns the first n elements from the list.
TwitterConversation.tags.last ● Int scalar common
Returns the last n elements from the list.
TwitterConversation.tags.orderBy ● TagOrder input common
The field and direction by which to order the results.
TwitterConversation.twitterId ● String scalar common
The external Twitter ID of the conversation.
TwitterConversation.updatedAt ● DateTime! non-null scalar common
The date and time that the object was last updated.
Interfaces
Conversation interface common
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
}
}
}
}
}
}
Node interface common
An object with an ID.
Implemented by
CustomFieldSubjectType union