Mutation

mutation CreateThreadFromSlackMessage($input: CreateThreadFromSlackMessageInput!) {
  createThreadFromSlackMessage(input: $input) {
    thread {
      id
      ref
      customer {
        id
        externalId
        fullName
        shortName
        email {
          __typename
        }
        avatarUrl
      }
      title
      description
      previewText
    }
    error {
      message
      type
      code
      fields {
        field
        message
        type
      }
    }
  }
}

Variables

{
  "input": {
    "slackChannelId": "string",
    "slackMessageTimestamp": "string"
  }
}

Response

{
  "data": {
    "createThreadFromSlackMessage": {
      "thread": {
        "id": "id",
        "ref": "string",
        "customer": {
          "id": "id",
          "externalId": "id",
          "fullName": "string",
          "shortName": "string",
          "email": {
            "__typename": "EmailAddress"
          },
          "avatarUrl": "string"
        },
        "title": "string",
        "description": "string",
        "previewText": "string"
      },
      "error": {
        "message": "string",
        "type": "VALIDATION",
        "code": "string",
        "fields": [
          {
            "field": "string",
            "message": "string",
            "type": "VALIDATION"
          }
        ]
      }
    }
  }
}

Mutations

createThreadFromSlackMessage

Creates a thread from a top-level message in a connected customer Slack channel, along with the replies Plain has already received for it. This is the trigger for the API_ONLY ingestion mode, and works in every other mode too. Ingestion runs asynchronously, so thread is returned only when the message had already been ingested. Requires the thread:create permission.

This is not a way to import historic conversations: only replies Plain saw over the Slack events API are included, so a message from before the Plain bot joined the channel becomes a thread missing everything that was said before then.

MUTATION

createThreadFromSlackMessage(input: CreateThreadFromSlackMessageInput!): CreateThreadFromSlackMessageOutput!

Arguments

input

CreateThreadFromSlackMessageInput!

required

Returns

CreateThreadFromSlackMessageOutput!

thread

Thread

The thread, when this Slack message had already been ingested. Null when the request was accepted and the thread is still being created — use threadBySlackPermalink or the thread.thread_created webhook to pick it up.

error

MutationError