Mutations

importThreadDiscussion

Import an existing external conversation as a discussion on a Plain thread, backfilling all messages. Currently supports Slack threads via permalink — the entire thread (root message and all replies) is imported. If the Slack channel is not yet connected to Plain, the bot will automatically join and register it as a DISCUSSION channel (requires the connectedSlackChannel:edit permission). Private channels must have the Plain bot invited via /invite @Plain first. The call is idempotent: re-importing the same Slack thread onto the same Plain thread resumes from where the previous import left off; importing onto a different thread returns an error. Threads with more than 800 messages cannot be imported.

MUTATION

importThreadDiscussion(input: ImportThreadDiscussionInput!): ImportThreadDiscussionOutput!

Arguments

input

ImportThreadDiscussionInput!

required

Returns

ImportThreadDiscussionOutput!

threadDiscussion

ThreadDiscussion

error

MutationError

Mutation

mutation ImportThreadDiscussion($input: ImportThreadDiscussionInput!) {
  importThreadDiscussion(input: $input) {
    threadDiscussion {
      id
      threadId
      thread {
        id
        ref
        customer {
          __typename
        }
        title
        description
        previewText
      }
      title
      messages {
        edges {
          __typename
        }
        pageInfo {
          __typename
        }
      }
      status
    }
    error {
      message
      type
      code
      fields {
        field
        message
        type
      }
    }
  }
}

Variables

{
  "input": {
    "threadId": "id",
    "type": "SLACK"
  }
}

Response

{
  "data": {
    "importThreadDiscussion": {
      "threadDiscussion": {
        "id": "id",
        "threadId": "id",
        "thread": {
          "id": "id",
          "ref": "string",
          "customer": {
            "__typename": "Customer"
          },
          "title": "string",
          "description": "string",
          "previewText": "string"
        },
        "title": "string",
        "messages": {
          "edges": [
            {
              "__typename": "ThreadDiscussionMessageEdge"
            }
          ],
          "pageInfo": {
            "__typename": "PageInfo"
          }
        },
        "status": "OPEN"
      },
      "error": {
        "message": "string",
        "type": "VALIDATION",
        "code": "string",
        "fields": [
          {
            "field": "string",
            "message": "string",
            "type": "VALIDATION"
          }
        ]
      }
    }
  }
}

⌘I