Enums
AccountState#
The possible account states.
AdminEmailNotification#
The possible types of admin email notifications.
Values#
ADD_MORE_CREDITS_REQUEST_FOR_AI_DRAFTSSends email that agent requested more credits.UPGRADE_ACCOUNT_REQUEST_FOR_AI_OVERVIEWSends email that agent request account upgrade.
AgentNotificationPreferenceNotificationNamespaceType#
Possible notification preference namespace
AgentNotificationPreferenceNotificationType#
Possible notification types
Values#
EMAILEmail notification type.DESKTOPWeb browser desktop notification type.
AgentOrderField#
The possible fields by which agents can be ordered.
Values#
CREATED_ATOrders by the date that the agent was created.NAMEOrders by the agent name.UPDATED_ATOrders by the date that the agent was last updated.ASSIGNMENT_COUNTOrders by the number of times you assigned them to a conversation.
AgentRole#
The possible agent roles.
Values#
OWNERThe owner of the account.ADMINA user with administrative privileges.AGENTA user with a login.
AgentState#
The possible states of an agent.
Values#
INVITEDThe agent has been invited but has not yet accepted.ACTIVEThe agent accepted the invitation and is not archived.ARCHIVEDThe agent was archived.
AgentTwoFactorAuthStatus#
The possible status of an agent's 2fa.
Values#
LOCKEDThe agent has a locked 2fa.CONFIRMEDThe agent has a confirmed 2fa.ENABLEDThe agent has an enabled 2fa.DISABLEDThe agent has a disabled 2fa.
AiConversationSuggestionType#
The possible types of conversation's AI suggestion.
Values#
TAGSTags suggestion.SENTIMENTSentiment priority.SUMMARYSummary suggestion.
ArticleOrderField#
The possible fields by which Knowledge Base articles can be ordered.
Values#
AVERAGE_RATINGSOrders by the average rating of the article.TITLEOrders by the article title.UPDATED_ATOrders by the date that the article was last updated.
ArticleRatingTypes#
The possible types of Knowledge Base article ratings.
Values#
EMOJIAllows rating with a scale of 4 emojis.UPVOTEAllows rating with a thumbs up or a thumbs down.
AttachmentScanReportStatus#
The possible types of scan report status.
Values#
OKNothing was found.WARNINGA warning was found in the database.PENDINGScan is still in progress, fetch the scan again.
AttachmentType#
The possible types of Attachments.
Values#
ATTACHMENTSimple attachment.API_ATTACHMENTAPI attachment.MAILED_ATTACHMENTIncoming mail attachment.UPLOADED_ATTACHMENTUploaded attachment.
AttachmentsConversationTypeEnum#
No description
Values#
ALLAll conversations.CURRENTThe current conversation.
AuthState#
No description
BodyPartTypeEnum#
No description
Values#
TEXTText part.QUOTEDQuoted text part.
CannedReplyOrderField#
The possible fields by which canned replies can be ordered.
Values#
CREATED_ATOrders by the date that the canned reply was created.NAMEOrders by the canned reply name.CATEGORYOrders by the canned reply category name.UPDATED_ATOrders by the date that the canned reply was last updated.
CategoryOrderField#
The possible fields by which canned reply categories can be ordered.
Values#
CREATED_ATOrders by the date that the canned reply category was created.NAMEOrders by the canned reply category name.UPDATED_ATOrders by the date that the canned reply category was last updated.
ChannelOrderField#
The possible fields by which channels can be ordered.
Values#
CREATED_ATOrders by the date that the channel was created.NAMEOrders by the channel name.POSITIONOrders by the agent's preferred row order for the channel.UPDATED_ATOrders by the date that the channel was last updated.
ChannelRestrictionType#
The possible channel restriction types, for resources linked to channels.
Values#
ALLAccessible to all channels.SPECIFICAccessible to specified channels.
ChannelScope#
The permission scope applied to the list of channels
Values#
CURRENT_USERShows channels that you have access to.
ChannelState#
The possible states of a channel.
Values#
UNCONFIRMEDThe initial value.CONFIRMEDThe channel has been confirmed by the owner.SYNCINGThe mailbox is currently syncing the latest remote changes.ACTIVEA message has been received on the channel.ERRORThe mailbox is unable to connect to the remote server.DISCONNECTEDThe channel no longer receives messages.MIGRATINGThe channel is being migrated.
ChannelType#
The possible types of channels, representing various communication platforms.
Values#
FORWARDINGA channel for forwarding emails or messages.GOOGLEA channel for managing communication via Google services.FACEBOOKA channel for communication through Facebook.TWITTERA channel for communication through Twitter.OFFICE365A channel for managing communication via Office 365 services.IMAPA channel for handling email using IMAP.
CompanyOrderField#
The possible fields to order companies by.
Values#
CONTACT_COUNTOrders by the number of contacts within the company.CONVERSATION_COUNTOrders by the number of conversations within the company.CREATED_ATOrders by the date that the company was created.DOMAINOrders by the company's primary domain.NAMEOrders by the company name.UPDATED_ATOrders by the date that the company was last updated.
ConditionOperator#
The possible operators for folder conditions.
Values#
CONTAINSThe parameter appears in the list.DOES_NOT_CONTAINThe parameter does not appear in the list.EQThe parameter is equal to the value.GTThe parameter is greater than the value.GTEQThe parameter is greater than or equal to the value.LTThe parameter is less than the value.LTEQThe parameter is less than or equal to the value.NOT_EQThe parameter is not equal to the value.
ConditionOrderField#
The possible fields by which folder conditions can be ordered.
Values#
CREATED_ATOrders by the date that the folder was created.PARAMOrders by the parameter name.UPDATED_ATOrders by the date that the folder was last updated.
ConditionParam#
The possible parameters for folder conditions.
ConditionSystem#
Represents the different condition systems an object can support.
Values#
FOLDERThe object supports the folder system.RULEThe object supports the rule system.
ContactOrderField#
The possible fields to order contacts by.
Values#
CREATED_ATOrders by the date that the contact was created.COMPANY_NAMEOrders by the name of the contact's company.CONVERSATION_COUNTOrders by the number of conversations of the contact.EMAILOrders by the contact's primary email.JOB_TITLEOrders by the contact's job title.LAST_SEEN_ATOrders by the date that the agent was last seen.NAMEOrders by the contact name.UPDATED_ATOrders by the date that the contact was last updated.
ContactRole#
The possible contact roles.
Values#
CUSTOMERThe contact is the main customer of the conversation.
ContactType#
The possible types of contacts.
Values#
leadThe contact is a lead.contactThe contact is a contact.
ConversationOrderField#
The possible fields by which conversations can be ordered.
Values#
STATEOrders by the state of the conversation.UPDATED_ATOrders by the date the conversation was last updated by a user.LAST_UNANSWERED_USER_MESSAGE_ATOrders by the date of the last unanswered user message.DELETED_ATOrders by the date the conversation was deleted.CREATED_ATOrders by the date the conversation was first created.
ConversationReplyState#
No description
ConversationRestoreState#
The possible states of a conversation to be restored to.
Values#
UNREADThe conversation is new or contains unread messages.OPENEDThe conversation has been viewed by an agent.CLOSEDThe conversation is closed.SPAMThe conversation is marked as spam.
ConversationState#
The possible states of a conversation.
Values#
UNREADThe conversation is new or contains unread messages.OPENEDThe conversation has been viewed by an agent.CLOSEDThe conversation is closed.SNOOZEDThe conversation is snoozed.SPAMThe conversation is marked as spam.TRASHThe conversation is in the trash.
ConversationType#
The possible types of conversations.
Values#
CHATA chat conversation.EMAILAn email conversation.FACEBOOKA Facebook conversation.TWITTERA Twitter conversation.WIDGETA Widget conversation.
CouponDuration#
The possible coupon durations.
Values#
FOREVERApplies to all charges from a subscription with this coupon applied.ONCEApplies to the first charge from a subscription with this coupon applied.REPEATINGApplies to charges in the first duration_in_months months from a subscription with this coupon applied.
CreditCardFunding#
The funding options for a credit card
CustomFieldCategoryType#
The possible types of custom field categories.
Values#
CONTACTThe category is associated with a contact.COMPANYThe category is associated with a company.CHANNELThe category is associated with a channel.
CustomFieldFileContentDisposition#
The possible custom field file dispositions.
Values#
attachmentThe file should be downloaded.
CustomFieldHandleType#
The handle types available for custom fields.
CustomFieldIcon#
The icons available for custom fields.
Values#
ATAt icon.AWARDAward icon.BOOKBook icon.BOOKSBooks icon.BUILDINGBuilding icon.CALENDARCalendar icon.CLOCKClock icon.COINSCoins icon.COPYCopy icon.DOLLARDollar icon.DROPDOWNDropdown icon.EDITEdit icon.EXTERNAL_LINKExternal link icon.FACEBOOKFacebook icon.FILE_EDITFile edit icon.FILEFile icon.GIFTGift icon.GLOBEGlobe icon.GRADUATIONGraduation icon.HASHTAGHashtag icon.HOURGLASSHourglass icon.IMAGEImage icon.INSTITUTIONInstitution icon.LANGUAGELanguage icon.LINE_CHARTLine chart icon.LINKEDINLinkedIn icon.LOCATIONLocation icon.NETWORKNetwork icon.NOTEBOOKNotebook icon.PAGEPage icon.PAPERCLIPPaperclip icon.PENPen icon.PEOPLEPeople icon.PERSONPerson icon.PHONEPhone icon.PIE_CHARTPie chart icon.PRESENTPresent icon.RECEIPTReceipt icon.STOPWATCHStopwatch icon.TWITTERTwitter icon.WINDOWWindow icon.
CustomFieldLinkScope#
Defines the scope in which a custom field is applicable, determining its availability across different channels.
Values#
GLOBALThe custom field is available across all channels.CHANNELThe custom field is restricted to a specific channels.
CustomFieldType#
The possible types of custom fields.
Values#
ADDRESSAn address.BOOLEANA boolean.DATEA date.DROPDOWNA list of textual items.FILEA file.FIRST_SESSIONThe first session.IP_ADDRESSAn IP address.LATEST_SESSIONThe Latest session.LINKA link.MULTI_LINEMultiple lines of text.MONEYA money object.NUMBERA number.SINGLE_LINEA single line of text.SUMA sum.USER_AGENTA user agent.TIMEZONEA time zone.MULTI_SELECTA list of textual items which allows multiple selections.
customFieldValueUpdateMode#
The possible modes by which to update custom field values.
DeleteMode#
The possible modes of deleted conversations.
Values#
SOFTThe conversation has been moved to trash.HARDThe conversation has been permanently deleted.
DiscountType#
The possible discount types.
Values#
SUBSCRIPTIONDiscount being used on this account was applied to the subscription.ACCOUNTDiscount being used on this account was applied to the account.
DraftOrderField#
The possible fields by which drafts can be ordered.
Values#
CREATED_ATOrders by the date that the draft was created.VERSIONOrders by the draft version.UPDATED_ATOrders by the date that the draft was last updated.
DraftType#
No description
Values#
REPLYA draft of a reply to a conversation.REPLY_ALLA draft of a reply to all participants in a conversation.NOTEA draft of a note on a conversation.
EmailMarketingIntegrationType#
No description
EmailTemplateState#
The possible states of an EmailTemplate, determining its availability and usage within the system.
Values#
ENABLEDThe email template is active and can be used for sending emails.
EmailTemplateTrigger#
The events that can trigger the use of an email template.
Values#
NEW_TICKET_NOTIFICATIONTriggered when a new conversation is created, notifying the sender through this email template.
EncryptionType#
The type of encryption used for the connection.
Values#
NONENo encryption.SSLSecure Socket Layer encryption.
EphemeralJobResultState#
No description
EventType#
The possible types of events.
Values#
AGENT_CHANGEDThe agent assigned to the conversation changed.CHANNEL_CHANGEDThe channel of the conversation changed.CONTACT_CHANGEDThe conversation was assigned to a different contact.CONTACT_READThe contact read a message.DELETEDThe conversation was deleted.FOLLOWED_OR_UNFOLLOWEDA follower was added or removed from the conversation.INTEGRATION_ADDEDAn integration was added to the conversation.INTEGRATION_REMOVEDAn integration was removed from the conversation.INTEGRATION_EXTERNAL_CHANGEA change occurred on a linked integration.MERGEDA conversation was merged into this conversation.MESSAGE_CREATEDA new message was created in the conversation.RATEDA contact rated a message in the conversation.SNOOZEDThe conversation was snoozed.PRIORITY_CHANGEDThe priority of the conversation changed.SHOPIFY_EXTERNAL_EVENTAn external event happened on Shopify.STATE_CHANGEDThe state of the conversation changed.SUBJECT_CHANGEDThe subject of the conversation changed.TAGGEDA tag was added to the conversation.UNTAGGEDA tag was removed from the conversation.TEAM_CHANGEDThe team assigned to the conversation changed.UNDELETEDThe conversation was undeleted.UNSNOOZEDThe conversation was unsnoozed.
ExportOrderField#
The possible fields by which exports can be ordered.
Values#
REQUESTED_BY_IDOrders by the ID of user who requested the export.STATEOrders by the state of the export.CREATED_ATOrders by the date that the export was created.COMPLETED_ATOrders by the date that the export was completed.
ExportState#
The possible states of an export.
Values#
REQUESTEDThe export has been requested.QUEUEDThe export is queued for processing.EXPORTINGThe export is being processed.UPLOAdINGThe export is being uploaded.COMPLETEDThe export has been completed.CANCELLEDThe export has been cancelled.FAILEDThe export has failed.DELETEDThe export has been deleted.
FolderMatchTypes#
The possible types of folder condition matches.
Values#
ANYMatches any condition.ALLMatches all conditions.
FolderOrderField#
The possible fields by which folders can be ordered.
Values#
CREATED_ATOrders by the date that the folder was created.NAMEOrders by the folder name.POSITIONOrders by the preferred row order.UPDATED_ATOrders by the date that the folder was last updated.
FolderScope#
The types of resources this folder can be used for
Values#
DEFAULTShows folders that you have access to.CURRENT_USERShows folders that you have access to.
FolderState#
The possible states of a folder.
Values#
ACTIVEThe folder is enabled.INACTIVEThe folder is hidden.
FolderType#
The types of resources this folder can be used for
Values#
TICKETFolders for tickets.CHATFolders for chats.ALLFolders for chats and tickets.
IntegrationProvider#
The possible integration providers.
Values#
CHATGroove Chat integration.GITHUBGithub integration.GOOGLEGoogle integration.OPTIMIZECXOptimizeCX integration.HUBSPOTHubspot integration.JIRA_CLOUDJira Cloud integration.JIRA_SERVERJira Server integration.SALESFORCESalesforce integration.SHOPIFY_V2Shopify V2 integration.STRIPEStripe integration.TRELLOTrello integration.RECHARGERecharge integration.
KbRating#
The possible types of Knowledge Base article ratings.
Values#
EMOJIAllows rating with a scale of 4 emojis.UPVOTEAllows rating with a thumbs up or a thumbs down.
Operator#
Represents all available operators for various condition systems.
OrderDirection#
The possible directions in which to order results.
PinnedSearchOrderField#
The possible fields by which pinned searches can be ordered.
Values#
POSITIONOrders by the preferred row order.
PlanState#
The possible plan states.
PresenceStatusType#
The possible types of Live Chat presence statuses.
PricingModel#
The possible pricing models.
Values#
FLATPricing that bills a fixed amount regardless of quantity.
PricingType#
The possible pricing types.
Values#
KBPricing that only give access to kb features.INBOXPricing that gives access to any groove feature.ADDONPricing that can extend the available features on an account.
PricingUsageFrom#
The possible sources for determining quantity billed.
Values#
KBSQuantity is determined by looking at the number of published knowledge bases.CHANNELSQuantity is determined by looking at the number of channels added to the account.USERSQuantity is determined by looking at the number of Owner,Admin and Agent users added to the account.VIEWER_USERSQuantity is determined by looking at the number of Owner,Admin and Agent users added to the account.MAILBOXESQuantity is determined by looking at the number mailboxes added to the account.
ProtocolType#
The communication protocol used by the server.
Values#
SMTPSimple Mail Transfer Protocol for sending emails.IMAPInternet Message Access Protocol for retrieving emails.
PublishState#
The possible states of a Knowledge Base article.
Values#
DRAFTThe article is not yet published.WIPThe article is live but contains changes.PUBLISHEDThe article is live.DELETEDThe article is trashed.
RatingEnum#
The possible types of Inbox message ratings.
Values#
ANYAny rating.AWESOMEAn awesome rating.OKAn OK rating.BADA bad rating.
RestrictionType#
The possible restriction types, defining who has access to a resource or action.
Values#
EVERYONEAccessible to everyone, no restrictions.TEAMSRestricted to members of specific teams.MERestricted to the current user only.AGENTSRestricted to specified agents within the account.
RoomChannelTypeEnum#
The types of rooms in the groove system
RoomKindType#
The possible types of Live Chat room kinds.
RoomOrderField#
The possible fields by which Live Chat rooms can be ordered.
Values#
UPDATED_ATOrders by the date that the chat room was last updated.LAST_USER_MESSAGE_ATOrders by the date of the last user message.LAST_USER_OR_AGENT_MESSAGE_ATOrders by the date of the last message from an agent or user.LAST_USER_OR_NOTE_MESSAGE_ATOrders by the date of the last agent note or user message.LAST_USER_AGENT_OR_NOTE_MESSAGE_ATOrders by the date of the last message from an agent or user or agent note.LAST_UNANSWERED_USER_MESSAGE_ATOrders by the date of the last unanswered user message.EXPIRES_ATOrders by the expiration date.
RoomStateType#
The possible types of Live Chat room states.
RuleActionType#
The possible action types for rules.
RuleConditionOperator#
The possible operators for rule conditions.
RuleConditionParam#
The possible parameters for rule conditions.
RuleMatchTypes#
The possible types of rule condition matches.
Values#
ANYMatches any condition.ALLMatches all conditions.
RuleOrderField#
The possible fields by which rules can be ordered.
Values#
CREATED_ATOrders by the date that the rule was created.NAMEOrders by the rule name.POSITIONOrders by the preferred row order.UPDATED_ATOrders by the date that the rule was last updated.
RuleState#
The possible states of a rule.
Values#
ACTIVEThe rule is enabled.INACTIVEThe rule is hidden.
RuleTriggerType#
The possible types for rule triggers.
ScheduleType#
The possible schedule parameters for rules.
SetupIntentStatus#
The possible status types for setup intents.
Values#
REQUIRES_PAYMENT_METHODSetupIntent is created, it has a status of requires_payment_method1 until a payment method is attached.REQUIRES_CONFIRMATIONAfter the customer provides their payment information, the SetupIntent is ready to be confirmed.REQUIRES_ACTIONIf the payment requires additional actions, such as authenticating with 3D Secure, the SetupIntent has a status of requires_action.PROCESSINGAfter required actions are handled, the SetupIntent moves to processing for asynchronous payment methods, such as bank debits.SUCCEEDEDA SetupIntent with a status of succeeded means that the payment flow it is driving is complete.
SetupIntentUsage#
The possible usage types for setup intents.
Values#
ON_SESSIONThe setup intent will be used during the current session like a shopping card checkout.OFF_SESSIONThe setup intent will be used to setup a payment method which can be used with subscriptions.
ShopifyChangeType#
No description
Values#
ORDER_CANCELEDAn order was canceled.ORDER_CREATEDAn order was created.ORDER_DUPLICATEDAn order was duplicated.ORDER_REFUNDEDAn order was refunded.DRAFT_ORDER_INVOICE_SENTAn invoice was sent for a draft order.
TagOrderField#
The possible fields by which tags can be ordered.
Values#
COLOROrders by the tag color code.COUNTOrders by the the number of times the tag is used.CONVERSATION_COUNTSorts tags by how many times they are used, based on the channel_id and conversation_states filters.CREATED_ATOrders by the date that the tag was created.NAMEOrders by the tag name.UPDATED_ATOrders by the date that the tag was last updated.LAST_USED_ATOrders by the last time the tag was used.CREATOR_IDOrders by the creator id.
TagState#
The possible states of a tag.
Values#
ANYAny tag, regardless of how many conversations it has been applied to.
TeamOrderField#
The possible fields by which teams can be ordered.
Values#
CREATED_ATOrders by the date that the team was created.NAMEOrders by the team name.SIZEOrders by the number of agents in the team.UPDATED_ATOrders by the date that the team was last updated.
ThreadingType#
The possible threading types that define how messages are grouped or handled in a channel.
Values#
LEGACYThreading based on legacy systems or methods.REGULARStandard message threading without special grouping logic.SUBJECTThreading based on message subjects.NONENo threading applied to messages.
WidgetChannelType#
No description
Values#
WIDGETA regular widget.SOCIALA social widget.
WidgetKind#
No description
Values#
FACEBOOKA facebook widget.INSTAGRAMAn instagram widget.
WidgetStatus#
No description
Values#
CONNECTEDThe widget is connected.DISCONNECTEDThe widget is disconnected.