Class PlainClient

Hierarchy

PlainClient

Constructors

constructor

new PlainClient(options): PlainClient
Parameters
- options: {
  apiKey: string;
  apiUrl?: string;
  }
  - apiKey: string
  - Optional apiUrl?: string
Returns PlainClient
- Defined in src/client.ts:90

Properties

`Private` #ctx

#ctx: Context

Methods

addCustomerToCustomerGroups

addCustomerToCustomerGroups(input): SDKResult<CustomerGroupMembershipPartsFragment[]>
Adds a customer to a customer groups.
Parameters
- input: AddCustomerToCustomerGroupsInput
Returns SDKResult<CustomerGroupMembershipPartsFragment[]>
- Defined in src/client.ts:292

addLabels

addLabels(input): SDKResult<LabelPartsFragment[]>
WARNING: This is experimental and subject to change at any time without a major version bump.
Parameters
- input: AddLabelsInput
Returns SDKResult<LabelPartsFragment[]>
- Defined in src/client.ts:578

archiveLabelType

archiveLabelType(input): SDKResult<LabelTypePartsFragment>
WARNING: This is experimental and subject to change at any time without a major version bump.
Parameters
- input: ArchiveLabelTypeInput
Returns SDKResult<LabelTypePartsFragment>
- Defined in src/client.ts:661

assignThread

assignThread(input): SDKResult<ThreadPartsFragment>
WARNING: This is experimental and subject to change at any time without a major version bump.
Parameters
- input: AssignThreadInput
Returns SDKResult<ThreadPartsFragment>
- Defined in src/client.ts:527

changeCustomerStatus

changeCustomerStatus(input): SDKResult<{
customer: CustomerPartsFragment;
}>
Parameters
- input: ChangeCustomerStatusInput
Returns SDKResult<{
customer: CustomerPartsFragment;
}>
- Defined in src/client.ts:180

changeThreadPriority

changeThreadPriority(input): SDKResult<ThreadPartsFragment>
WARNING: This is experimental and subject to change at any time without a major version bump.
Parameters
- input: ChangeThreadPriorityInput
Returns SDKResult<ThreadPartsFragment>
- Defined in src/client.ts:561

createAttachmentUploadUrl

createAttachmentUploadUrl(input): SDKResult<AttachmentUploadUrlPartsFragment>
Parameters
- input: CreateAttachmentUploadUrlInput
Returns SDKResult<AttachmentUploadUrlPartsFragment>
- Defined in src/client.ts:391

createCustomerCardConfig

createCustomerCardConfig(input): SDKResult<CustomerCardConfigPartsFragment>
Creates the configuration for a Customer Card. Useful if you want to programatically set up a customer card vs using the settings UI
Parameters
- input: CreateCustomerCardConfigInput
Returns SDKResult<CustomerCardConfigPartsFragment>
- Defined in src/client.ts:423

createIssue

createIssue(input): SDKResult<IssuePartsFragment>
Create an issue for a customer. If you want you can override the default issue priority in your settings by specifying a priority manually here.
Parameters
- input: CreateIssueInput
Returns SDKResult<IssuePartsFragment>
- Defined in src/client.ts:201

createThread

createThread(input): SDKResult<ThreadPartsFragment>
WARNING: This is experimental and subject to change at any time without a major version bump.
Parameters
- input: CreateThreadInput
Returns SDKResult<ThreadPartsFragment>
- Defined in src/client.ts:510

deleteCustomerCardConfig

deleteCustomerCardConfig(input): SDKResult<null>
Delete the configuration for a Customer Card.
Parameters
- input: DeleteCustomerCardConfigInput
Returns SDKResult<null>
- Defined in src/client.ts:459

deleteIssue

deleteIssue(input): SDKResult<IssuePartsFragment>
Parameters
- input: DeleteIssueInput
Returns SDKResult<IssuePartsFragment>
- Defined in src/client.ts:230

deleteLabels

deleteLabels(input): SDKResult<null>
WARNING: This is experimental and subject to change at any time without a major version bump.
Parameters
- input: DeleteLabelsInput
Returns SDKResult<null>
- Defined in src/client.ts:595

getCustomerByEmail

getCustomerByEmail(variables): SDKResult<null | CustomerPartsFragment>
If the customer is not found this will return null.
Parameters
- variables: Exact<{
  email: string;
  }>
Returns SDKResult<null | CustomerPartsFragment>
- Defined in src/client.ts:147

getCustomerById

getCustomerById(variables): SDKResult<null | CustomerPartsFragment>
If the customer is not found this will return null.
Parameters
- variables: Exact<{
  customerId: string;
  }>
Returns SDKResult<null | CustomerPartsFragment>
- Defined in src/client.ts:133

getCustomerGroupById

getCustomerGroupById(variables): SDKResult<null | CustomerGroupPartsFragment>
If the customer group is not found this will return null.
Parameters
- variables: Exact<{
  customerGroupId: string;
  }>
Returns SDKResult<null | CustomerGroupPartsFragment>
- Defined in src/client.ts:261

getCustomerGroups

getCustomerGroups(variables): SDKResult<{
customerGroups: CustomerGroupPartsFragment[];
pageInfo: PageInfo;
}>
Get a paginated list of customer groups.
Parameters
- variables: Exact<{
      after?: InputMaybe<string>;
      before?: InputMaybe<string>;
      first?: InputMaybe<number>;
      last?: InputMaybe<number>;
  }>
Returns SDKResult<{
customerGroups: CustomerGroupPartsFragment[];
pageInfo: PageInfo;
}>
- Defined in src/client.ts:275

getCustomers

getCustomers(variables): SDKResult<{
    customers: CustomerPartsFragment[];
    pageInfo: PageInfoPartsFragment;
    totalCount: number;
}>
Get a paginated list of customers.
Parameters
- variables: Exact<{
      after?: InputMaybe<string>;
      before?: InputMaybe<string>;
      filters?: InputMaybe<CustomersFilter>;
      first?: InputMaybe<number>;
      last?: InputMaybe<number>;
      sortBy?: InputMaybe<CustomersSort>;
  }>
Returns SDKResult<{
    customers: CustomerPartsFragment[];
    pageInfo: PageInfoPartsFragment;
    totalCount: number;
}>
- Defined in src/client.ts:113

getIssues

getIssues(variables): SDKResult<{
issues: IssuePartsFragment[];
pageInfo: PageInfoPartsFragment;
}>
Parameters
- variables: Exact<{
      after?: InputMaybe<string>;
      before?: InputMaybe<string>;
      filters?: InputMaybe<IssuesFilter>;
      first?: InputMaybe<number>;
      last?: InputMaybe<number>;
      sortBy?: InputMaybe<IssuesSort>;
  }>
Returns SDKResult<{
issues: IssuePartsFragment[];
pageInfo: PageInfoPartsFragment;
}>
- Defined in src/client.ts:243

getLabelType

getLabelType(variables): SDKResult<null | LabelTypePartsFragment>
WARNING: This is experimental and subject to change at any time without a major version bump.
Parameters
- variables: Exact<{
  labelTypeId: string;
  }>
Returns SDKResult<null | LabelTypePartsFragment>
- Defined in src/client.ts:697

getLabelTypes

getLabelTypes(variables): SDKResult<{
labelTypes: LabelTypePartsFragment[];
pageInfo: PageInfoPartsFragment;
}>
WARNING: This is experimental and subject to change at any time without a major version bump.
Parameters
- variables: Exact<{
      after?: InputMaybe<string>;
      before?: InputMaybe<string>;
      filters?: InputMaybe<LabelTypeFilter>;
      first?: InputMaybe<number>;
      last?: InputMaybe<number>;
  }>
Returns SDKResult<{
labelTypes: LabelTypePartsFragment[];
pageInfo: PageInfoPartsFragment;
}>
- Defined in src/client.ts:678

getMyWorkspace

getMyWorkspace(): SDKResult<WorkspacePartsFragment>
Fetch the workspace for the authenticated API key.

Returns SDKResult<WorkspacePartsFragment>
- Defined in src/client.ts:409

getThread

getThread(variables): SDKResult<null | ThreadPartsFragment>
WARNING: This is experimental and subject to change at any time without a major version bump.
Parameters
- variables: Exact<{
  threadId: string;
  }>
Returns SDKResult<null | ThreadPartsFragment>
- Defined in src/client.ts:495

getThreads

getThreads(variables): SDKResult<{
pageInfo: PageInfoPartsFragment;
threads: ThreadPartsFragment[];
}>
WARNING: This is experimental and subject to change at any time without a major version bump.
Parameters
- variables: Exact<{
      after?: InputMaybe<string>;
      before?: InputMaybe<string>;
      filters?: InputMaybe<ThreadsFilter>;
      first?: InputMaybe<number>;
      last?: InputMaybe<number>;
      sortBy?: InputMaybe<ThreadsSort>;
  }>
Returns SDKResult<{
pageInfo: PageInfoPartsFragment;
threads: ThreadPartsFragment[];
}>
- Defined in src/client.ts:476

markThreadAsDone

markThreadAsDone(input): SDKResult<ThreadPartsFragment>
WARNING: This is experimental and subject to change at any time without a major version bump.
Parameters
- input: MarkThreadAsDoneInput
Returns SDKResult<ThreadPartsFragment>
- Defined in src/client.ts:610

markThreadAsTodo

markThreadAsTodo(input): SDKResult<ThreadPartsFragment>
WARNING: This is experimental and subject to change at any time without a major version bump.
Parameters
- input: MarkThreadAsTodoInput
Returns SDKResult<ThreadPartsFragment>
- Defined in src/client.ts:644

rawRequest

rawRequest(args): SDKResult<unknown>
If you need to do something custom you can use this method to do
Parameters
- args: {
  query: string;
  variables: Record<string, unknown>;
  }
  - query: string
  - variables: Record<string, unknown>
Returns SDKResult<unknown>
- Defined in src/client.ts:100

removeCustomerFromCustomerGroups

removeCustomerFromCustomerGroups(input): SDKResult<null>
Remove a customer from customer groups.
Parameters
- input: RemoveCustomerFromCustomerGroupsInput
Returns SDKResult<null>
- Defined in src/client.ts:310

replyToEmail

replyToEmail(input): SDKResult<EmailPartsFragment>
Parameters
- input: ReplyToEmailInput
Returns SDKResult<EmailPartsFragment>
- Defined in src/client.ts:361

resolveIssue

resolveIssue(input): SDKResult<IssuePartsFragment>
Resolve an issue for a customer.
Parameters
- input: ResolveIssueInput
Returns SDKResult<IssuePartsFragment>
- Defined in src/client.ts:217

sendChat

sendChat(input): SDKResult<ChatPartsFragment>
Parameters
- input: SendChatInput
Returns SDKResult<ChatPartsFragment>
- Defined in src/client.ts:376

sendNewEmail

sendNewEmail(input): SDKResult<EmailPartsFragment>
Parameters
- input: SendNewEmailInput
Returns SDKResult<EmailPartsFragment>
- Defined in src/client.ts:346

snoozeThread

snoozeThread(input): SDKResult<ThreadPartsFragment>
WARNING: This is experimental and subject to change at any time without a major version bump.
Parameters
- input: SnoozeThreadInput
Returns SDKResult<ThreadPartsFragment>
- Defined in src/client.ts:627

unassignThread

unassignThread(input): SDKResult<ThreadPartsFragment>
WARNING: This is experimental and subject to change at any time without a major version bump.
Parameters
- input: UnassignThreadInput
Returns SDKResult<ThreadPartsFragment>
- Defined in src/client.ts:544

updateCustomerCardConfig

updateCustomerCardConfig(input): SDKResult<CustomerCardConfigPartsFragment>
Updates the configuration for a Customer Card.
Parameters
- input: UpdateCustomerCardConfigInput
Returns SDKResult<CustomerCardConfigPartsFragment>
- Defined in src/client.ts:441

upsertCustomTimelineEntry

upsertCustomTimelineEntry(input): SDKResult<{
result: UpsertResult;
timelineEntry: TimelineEntryPartsFragment;
}>
Add a custom timeline entry to a customer's timeline.

This can be used to power custom contact forms, log events from your own systems and much more.
Parameters
- input: UpsertCustomTimelineEntryInput
Returns SDKResult<{
result: UpsertResult;
timelineEntry: TimelineEntryPartsFragment;
}>
- Defined in src/client.ts:328

upsertCustomer

upsertCustomer(input): SDKResult<{
customer: CustomerPartsFragment;
result: UpsertResult;
}>
Allows you to create or update a customer. If you need to get the customer id for a customer in Plain, this is typically your first step.
Parameters
- input: UpsertCustomerInput
Returns SDKResult<{
customer: CustomerPartsFragment;
result: UpsertResult;
}>
- Defined in src/client.ts:162

Class PlainClient

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

options: { apiKey: string; apiUrl?: string; }

apiKey: string

Optional apiUrl?: string

Returns PlainClient

Properties

Private #ctx

Methods

addCustomerToCustomerGroups

Parameters

input: AddCustomerToCustomerGroupsInput

Returns SDKResult<CustomerGroupMembershipPartsFragment[]>

addLabels

Parameters

input: AddLabelsInput

Returns SDKResult<LabelPartsFragment[]>

archiveLabelType

Parameters

input: ArchiveLabelTypeInput

Returns SDKResult<LabelTypePartsFragment>

assignThread

Parameters

input: AssignThreadInput

Returns SDKResult<ThreadPartsFragment>

changeCustomerStatus

Parameters

input: ChangeCustomerStatusInput

Returns SDKResult<{ customer: CustomerPartsFragment; }>

changeThreadPriority

Parameters

input: ChangeThreadPriorityInput

Returns SDKResult<ThreadPartsFragment>

createAttachmentUploadUrl

Parameters

input: CreateAttachmentUploadUrlInput

Returns SDKResult<AttachmentUploadUrlPartsFragment>

createCustomerCardConfig

Parameters

input: CreateCustomerCardConfigInput

Returns SDKResult<CustomerCardConfigPartsFragment>

createIssue

Parameters

input: CreateIssueInput

Returns SDKResult<IssuePartsFragment>

createThread

Parameters

input: CreateThreadInput

Returns SDKResult<ThreadPartsFragment>

deleteCustomerCardConfig

Parameters

input: DeleteCustomerCardConfigInput

Returns SDKResult<null>

deleteIssue

Parameters

input: DeleteIssueInput

Returns SDKResult<IssuePartsFragment>

deleteLabels

Parameters

input: DeleteLabelsInput

Returns SDKResult<null>

getCustomerByEmail

Parameters

variables: Exact<{ email: string; }>

Returns SDKResult<null | CustomerPartsFragment>

getCustomerById

Parameters

variables: Exact<{ customerId: string; }>

Returns SDKResult<null | CustomerPartsFragment>

getCustomerGroupById

Parameters

variables: Exact<{ customerGroupId: string; }>

Returns SDKResult<null | CustomerGroupPartsFragment>

options: {
apiKey: string;
apiUrl?: string;
}

`Optional` apiUrl?: string

`Private` #ctx

Returns SDKResult<{
customer: CustomerPartsFragment;
}>

variables: Exact<{
email: string;
}>

variables: Exact<{
customerId: string;
}>

variables: Exact<{
customerGroupId: string;
}>

variables: Exact<{
after?: InputMaybe<string>;
before?: InputMaybe<string>;
first?: InputMaybe<number>;
last?: InputMaybe<number>;
}>

Returns SDKResult<{
customerGroups: CustomerGroupPartsFragment[];
pageInfo: PageInfo;
}>

variables: Exact<{
after?: InputMaybe<string>;
before?: InputMaybe<string>;
filters?: InputMaybe<CustomersFilter>;
first?: InputMaybe<number>;
last?: InputMaybe<number>;
sortBy?: InputMaybe<CustomersSort>;
}>

Returns SDKResult<{
customers: CustomerPartsFragment[];
pageInfo: PageInfoPartsFragment;
totalCount: number;
}>

variables: Exact<{
after?: InputMaybe<string>;
before?: InputMaybe<string>;
filters?: InputMaybe<IssuesFilter>;
first?: InputMaybe<number>;
last?: InputMaybe<number>;
sortBy?: InputMaybe<IssuesSort>;
}>

Returns SDKResult<{
issues: IssuePartsFragment[];
pageInfo: PageInfoPartsFragment;
}>

variables: Exact<{
labelTypeId: string;
}>

variables: Exact<{
after?: InputMaybe<string>;
before?: InputMaybe<string>;
filters?: InputMaybe<LabelTypeFilter>;
first?: InputMaybe<number>;
last?: InputMaybe<number>;
}>

Returns SDKResult<{
labelTypes: LabelTypePartsFragment[];
pageInfo: PageInfoPartsFragment;
}>

variables: Exact<{
threadId: string;
}>

variables: Exact<{
after?: InputMaybe<string>;
before?: InputMaybe<string>;
filters?: InputMaybe<ThreadsFilter>;
first?: InputMaybe<number>;
last?: InputMaybe<number>;
sortBy?: InputMaybe<ThreadsSort>;
}>

Returns SDKResult<{
pageInfo: PageInfoPartsFragment;
threads: ThreadPartsFragment[];
}>

args: {
query: string;
variables: Record<string, unknown>;
}