## Conversation

**Type:** GraphQL objects

**Description:**
A conversation in the inbox representing a communication thread between
a customer and the support team. Conversations are created from integrations
(messenger, email, WhatsApp, etc.) and managed through the inbox workflow.

### Fields
- _id (String)
- content (String): The latest text content or snippet of the conversation.
- integrationId (String): The integration (channel) this conversation originated from.
- customerId (String): The customer participating in this conversation.
- departmentId (String): The department this conversation is routed to.
- userId (String): The user/agent who created or owns this conversation.
- assignedUserId (String): The user/agent currently assigned to handle this conversation.
- participatedUserIds (String): User IDs of agents participating in this conversation.
- readUserIds (String): User IDs of agents who have read this conversation.
- createdAt (Date): When this conversation was created.
- updatedAt (Date): When this conversation was last updated.
- slaTime (Float): SLA elapsed idle time in minutes (time since customer started waiting for a response).
- slaConfig (Float): Configured SLA threshold in minutes.
- idleTime (Float): Idle time in minutes (deprecated — use slaTime).
- idleTimeConfig (Float): Configured idle time threshold in minutes (deprecated — use slaConfig).
- isCustomerRespondedLast (Boolean): Whether the customer sent the most recent message.
- lastCustomerMessageAt (Date): Timestamp of the last customer message.
- lastUserMessageAt (Date): Timestamp of the last agent message.
- customerWaitingStartTime (Date): When the customer started waiting for a response.
- averageResponseTime (Float): Average agent response time in seconds.
- totalResponseTime (Float): Total cumulative response time in seconds.
- responseCount (Int): Number of agent responses in this conversation.
- status (String): Current workflow status: 'open', 'closed', 'pending', 'snoozed', or 'bot'.
- snoozedUntil (Date): When a snoozed conversation will auto-reopen (null if indefinite or not snoozed).
- messageCount (Int): Total number of messages in this conversation.
- number (Int): Auto-incremented conversation number for display.
- tagIds (String): Tag IDs applied to this conversation.
- messages (ConversationMessage): The most recent message in this conversation, resolved from the appropriate service (inbox, whatsapp, facebook, etc.).
  - _id (String)
  - type (String): Message type discriminator.
  - sender (MessageSender): Who sent this message.
  - visibility (String): Visibility level: 'public', 'internal', or 'hidden'.
  - text (MessageText): Text content (when type='text').
  - media (MessageMedia): Media content (image, audio, video, document — single or multiple).
  - template (MessageTemplate): Template content (when type='template').
  - interactive (MessageInteractive): Interactive content (when type='interactive').
  - toolCalls (JSON): Tool call data (when type='tool_call').
  - email (MessageEmail): Email envelope and body (when type='email').
  - context (MessageContext): Threading, forwarding, mention context.
  - delivery (MessageDelivery): Delivery status and error info.
  - reactions (MessageReaction): Reactions on this message.
  - origin (MessageOrigin): External origin tracking.
  - editHistory (MessageEditEntry): Message edit history.
  - metadata (JSON): Extensible metadata bucket.
  - replyForMsg (JSON): The resolved original message being replied to.
  - customer (Customer): The resolved customer who sent this message.
  - user (User): The resolved agent who sent this message.
  - conversation (Conversation): The parent conversation.
  - conversationId (String): The conversation this message belongs to.
  - createdAt (Date): When this message was created.
  - sticker (WASticker): Sticker attachment (when type='sticker').
  - location (WALocation): Location data (when type='location').
  - contacts (WAContact): Contact cards (when type='contacts').
  - system (MessageSystem): System event content (when type='system').
  - form (MessageForm): Form submission content (when type='form').
  - engage (MessageEngage): Engage/campaign content (when type='engage').
  - videoCall (MessageVideoCall): Video call content (when type='videoCall').
  - order (MessageOrder): Order/commerce content (when type='order').
  - referral (WAReferral): WhatsApp ad referral data.
  - updatedAt (Date): When this message was last updated.
- tags (Tag): Resolved tags applied to this conversation.
  - _id (String)
  - name (String)
  - type (String)
  - colorCode (String)
  - createdAt (Date)
  - objectCount (Int)
  - totalObjectCount (Int)
  - parentId (String)
  - order (String)
  - relatedIds (String)
  - childTags (Tag)
- customer (Customer): The customer associated with this conversation.
  - state (String)
  - createdAt (Date)
  - modifiedAt (Date)
  - avatar (String)
  - integrationId (String)
  - firstName (String)
  - lastName (String)
  - birthDate (Date)
  - sex (Int)
  - email (String)
  - primaryEmail (String)
  - emails (String)
  - primaryPhone (String)
  - phones (String)
  - primaryAddress (JSON)
  - addresses (JSON)
  - phone (String)
  - tagIds (String)
  - customFieldsData (JSON)
  - customFieldsDataByFieldCode (JSON)
  - ownerId (String)
  - leadStatus (String)
  - leadStageHistory (LeadStageHistoryEntry)
  - description (String)
  - isSubscribed (String)
  - code (String)
  - emailValidationStatus (String)
  - phoneValidationStatus (String)
  - links (JSON)
  - companies (Company)
  - getTags (Tag)
  - integration (Integration)
  - owner (User)
  - score (Float)
  - segmentsV2 (CustomerSegmentV2Membership): Active segments-v2 memberships for this customer (active version only).
  - _id (String)
  - conversations (Conversation)
- integration (Integration): The integration (channel) this conversation came from.
  - _id (String)
  - kind (String)
  - name (String)
  - languageCode (String)
  - code (String)
  - formId (String)
  - tagIds (String)
  - createdAt (Date)
  - workspaceId (String)
  - tags (Tag)
  - leadData (JSON)
  - messengerData (JSON)
  - whatsappData (WhatsappIntegration)
  - uiOptions (JSON)
  - isActive (Boolean)
  - isConnected (Boolean)
  - webhookData (JSON)
  - form (Form)
  - departmentId (String)
  - department (Department)
  - workspace (Workspace)
  - websiteMessengerApps (MessengerApp)
  - knowledgeBaseMessengerApps (MessengerApp)
  - leadMessengerApps (MessengerApp)
  - healthStatus (JSON)
  - visibility (String)
  - departmentIds (String)
  - details (JSON)
- user (User): The user/agent who owns this conversation.
  - _id (String)
  - createdAt (Date)
  - username (String)
  - email (String)
  - userPreferences (JSON)
  - availability (UserChatStatus)
  - isActive (Boolean)
  - details (UserDetailsType)
  - links (JSON)
  - status (String)
  - emailSignatures (JSON)
  - groupIds (String)
  - workspaceIds (String)
  - isSubscribed (String)
  - customFieldsData (JSON)
  - workspaces (Workspace)
  - isOwner (Boolean)
  - permissionActions (JSON)
  - configs (JSON)
  - configsConstants (JSON)
  - onboardingHistory (OnboardingHistory)
  - departmentIds (String)
  - departments (Department)
  - branchIds (String)
  - branches (Branch)
  - positionIds (String)
  - positions (Position)
  - score (Float)
  - scoreCategories (ScoreCategories)
  - leaderBoardPosition (Int)
  - employeeId (String)
  - isOnline (Boolean)
- assignedUser (User): The agent currently assigned to this conversation.
  - _id (String)
  - createdAt (Date)
  - username (String)
  - email (String)
  - userPreferences (JSON)
  - availability (UserChatStatus)
  - isActive (Boolean)
  - details (UserDetailsType)
  - links (JSON)
  - status (String)
  - emailSignatures (JSON)
  - groupIds (String)
  - workspaceIds (String)
  - isSubscribed (String)
  - customFieldsData (JSON)
  - workspaces (Workspace)
  - isOwner (Boolean)
  - permissionActions (JSON)
  - configs (JSON)
  - configsConstants (JSON)
  - onboardingHistory (OnboardingHistory)
  - departmentIds (String)
  - departments (Department)
  - branchIds (String)
  - branches (Branch)
  - positionIds (String)
  - positions (Position)
  - score (Float)
  - scoreCategories (ScoreCategories)
  - leaderBoardPosition (Int)
  - employeeId (String)
  - isOnline (Boolean)
- assignedDepartment (Department): The department this conversation is routed to.
  - _id (String)
  - title (String)
  - description (String)
  - parentId (String)
  - supervisorId (String)
  - supervisor (User)
  - code (String)
  - order (String)
  - parent (Department)
  - children (Department)
  - childCount (Int)
  - users (User)
  - userCount (Int)
  - userIds (String)
- participatedUsers (User): Users participating in this conversation.
  - _id (String)
  - createdAt (Date)
  - username (String)
  - email (String)
  - userPreferences (JSON)
  - availability (UserChatStatus)
  - isActive (Boolean)
  - details (UserDetailsType)
  - links (JSON)
  - status (String)
  - emailSignatures (JSON)
  - groupIds (String)
  - workspaceIds (String)
  - isSubscribed (String)
  - customFieldsData (JSON)
  - workspaces (Workspace)
  - isOwner (Boolean)
  - permissionActions (JSON)
  - configs (JSON)
  - configsConstants (JSON)
  - onboardingHistory (OnboardingHistory)
  - departmentIds (String)
  - departments (Department)
  - branchIds (String)
  - branches (Branch)
  - positionIds (String)
  - positions (Position)
  - score (Float)
  - scoreCategories (ScoreCategories)
  - leaderBoardPosition (Int)
  - employeeId (String)
  - isOnline (Boolean)
- readUsers (User): Users who have read this conversation.
  - _id (String)
  - createdAt (Date)
  - username (String)
  - email (String)
  - userPreferences (JSON)
  - availability (UserChatStatus)
  - isActive (Boolean)
  - details (UserDetailsType)
  - links (JSON)
  - status (String)
  - emailSignatures (JSON)
  - groupIds (String)
  - workspaceIds (String)
  - isSubscribed (String)
  - customFieldsData (JSON)
  - workspaces (Workspace)
  - isOwner (Boolean)
  - permissionActions (JSON)
  - configs (JSON)
  - configsConstants (JSON)
  - onboardingHistory (OnboardingHistory)
  - departmentIds (String)
  - departments (Department)
  - branchIds (String)
  - branches (Branch)
  - positionIds (String)
  - positions (Position)
  - score (Float)
  - scoreCategories (ScoreCategories)
  - leaderBoardPosition (Int)
  - employeeId (String)
  - isOnline (Boolean)
- participatorCount (Int): Number of participants in this conversation.
- customFieldsData (JSON)

---

## ConversationListResponse

**Type:** GraphQL objects

**Description:**
Paginated list of conversations.

### Fields
- data (Conversation): The list of conversations for the current page.
  - _id (String)
  - content (String): The latest text content or snippet of the conversation.
  - integrationId (String): The integration (channel) this conversation originated from.
  - customerId (String): The customer participating in this conversation.
  - departmentId (String): The department this conversation is routed to.
  - userId (String): The user/agent who created or owns this conversation.
  - assignedUserId (String): The user/agent currently assigned to handle this conversation.
  - participatedUserIds (String): User IDs of agents participating in this conversation.
  - readUserIds (String): User IDs of agents who have read this conversation.
  - createdAt (Date): When this conversation was created.
  - updatedAt (Date): When this conversation was last updated.
  - slaTime (Float): SLA elapsed idle time in minutes (time since customer started waiting for a response).
  - slaConfig (Float): Configured SLA threshold in minutes.
  - idleTime (Float): Idle time in minutes (deprecated — use slaTime).
  - idleTimeConfig (Float): Configured idle time threshold in minutes (deprecated — use slaConfig).
  - isCustomerRespondedLast (Boolean): Whether the customer sent the most recent message.
  - lastCustomerMessageAt (Date): Timestamp of the last customer message.
  - lastUserMessageAt (Date): Timestamp of the last agent message.
  - customerWaitingStartTime (Date): When the customer started waiting for a response.
  - averageResponseTime (Float): Average agent response time in seconds.
  - totalResponseTime (Float): Total cumulative response time in seconds.
  - responseCount (Int): Number of agent responses in this conversation.
  - status (String): Current workflow status: 'open', 'closed', 'pending', 'snoozed', or 'bot'.
  - snoozedUntil (Date): When a snoozed conversation will auto-reopen (null if indefinite or not snoozed).
  - messageCount (Int): Total number of messages in this conversation.
  - number (Int): Auto-incremented conversation number for display.
  - tagIds (String): Tag IDs applied to this conversation.
  - messages (ConversationMessage): The most recent message in this conversation, resolved from the appropriate service (inbox, whatsapp, facebook, etc.).
  - tags (Tag): Resolved tags applied to this conversation.
  - customer (Customer): The customer associated with this conversation.
  - integration (Integration): The integration (channel) this conversation came from.
  - user (User): The user/agent who owns this conversation.
  - assignedUser (User): The agent currently assigned to this conversation.
  - assignedDepartment (Department): The department this conversation is routed to.
  - participatedUsers (User): Users participating in this conversation.
  - readUsers (User): Users who have read this conversation.
  - participatorCount (Int): Number of participants in this conversation.
  - customFieldsData (JSON)
- pagination (PaginationInfo, Not Null): Pagination metadata.
  - currentPage (Int): The current page number (1-based).
  - perPage (Int): Number of items per page.
  - totalCount (Int): Total number of items matching the query.
  - totalPages (Int): Total number of pages.
  - hasNextPage (Boolean): Whether there are more pages after the current one.
  - hasPreviousPage (Boolean): Whether there are pages before the current one.

---

## ConversationMessage

**Type:** GraphQL objects

**Description:**
A single message within a conversation. Uses a discriminated-union pattern
where the `type` field determines which content sub-object is populated.

### Fields
- _id (String)
- type (String): Message type discriminator.
- sender (MessageSender): Who sent this message.
  - kind (String): Sender kind: 'user', 'customer', 'bot', 'ai_assistant', 'system', 'visitor'.
  - id (String): The sender's ID (user, customer, bot, etc.).
- visibility (String): Visibility level: 'public', 'internal', or 'hidden'.
- text (MessageText): Text content (when type='text').
  - body (String): The message body content.
  - preview (String): An optional short preview for long messages.
- media (MessageMedia): Media content (image, audio, video, document — single or multiple).
  - attachments (Attachment): List of file attachments.
  - caption (String): Optional caption for the media.
- template (MessageTemplate): Template content (when type='template').
  - name (String): Template name.
  - params (JSON): Template parameters (resolved key-value pairs).
  - language (JSON): Template language code.
  - category (String): Template category (MARKETING, UTILITY, AUTHENTICATION).
  - rendered (TemplateRendered): Pre-rendered snapshot of what the customer received.
- interactive (MessageInteractive): Interactive content (when type='interactive').
  - type (String): Interactive type discriminator (button, list, cta_url, carousel, quickReplies, button_reply, list_reply, nfm_reply, etc.).
  - header (JSON): Optional header (text, image, video, document).
  - body (JSON): Body content.
  - footer (JSON): Footer text.
  - action (JSON): Action configuration (buttons, sections, cards, parameters, etc.).
  - button_reply (JSON): Customer button tap reply (incoming).
  - list_reply (JSON): Customer list selection reply (incoming).
  - nfm_reply (JSON): Customer WA Flow / native form submission (incoming).
- toolCalls (JSON): Tool call data (when type='tool_call').
- email (MessageEmail): Email envelope and body (when type='email').
  - subject (String): Email subject line.
  - integrationId (String): Integration ID this email belongs to.
  - from (EmailAddress): Sender address(es).
  - to (EmailAddress): To recipients.
  - cc (EmailAddress): CC recipients.
  - bcc (EmailAddress): BCC recipients (only visible to sender).
  - references (String): RFC 5322 References header chain for threading.
  - htmlBody (String): Sanitized HTML body.
  - textBody (String): Plain-text fallback body.
  - snippet (String): Short preview snippet.
  - attachments (EmailAttachment): Email-native attachment metadata.
  - newContent (String): Extracted new content (stripped of quoted/replied text).
  - quotedContent (String): The quoted/replied portion of the email body.
  - signature (String): Detected email signature block.
- context (MessageContext): Threading, forwarding, mention context.
  - replyTo (String): The message ID this is replying to.
  - isForwarded (Boolean): Whether this message was forwarded.
  - mentions (String): User IDs mentioned in this message.
- delivery (MessageDelivery): Delivery status and error info.
  - status (String): Delivery status: 'sending', 'sent', 'delivered', 'seen', 'failed'.
  - error (String): Error message if delivery failed.
- reactions (MessageReaction): Reactions on this message.
  - emoji (String): The emoji string.
  - fromKind (String): Who reacted: 'user', 'customer', etc.
  - fromId (String): The ID of the person who reacted.
- origin (MessageOrigin): External origin tracking.
  - externalId (String): External message ID from the integration platform.
  - app (String): Origin application identifier.
- editHistory (MessageEditEntry): Message edit history.
  - content (String): The previous content before this edit.
  - editedAt (Date): When the edit was made.
- metadata (JSON): Extensible metadata bucket.
- replyForMsg (JSON): The resolved original message being replied to.
- customer (Customer): The resolved customer who sent this message.
  - state (String)
  - createdAt (Date)
  - modifiedAt (Date)
  - avatar (String)
  - integrationId (String)
  - firstName (String)
  - lastName (String)
  - birthDate (Date)
  - sex (Int)
  - email (String)
  - primaryEmail (String)
  - emails (String)
  - primaryPhone (String)
  - phones (String)
  - primaryAddress (JSON)
  - addresses (JSON)
  - phone (String)
  - tagIds (String)
  - customFieldsData (JSON)
  - customFieldsDataByFieldCode (JSON)
  - ownerId (String)
  - leadStatus (String)
  - leadStageHistory (LeadStageHistoryEntry)
  - description (String)
  - isSubscribed (String)
  - code (String)
  - emailValidationStatus (String)
  - phoneValidationStatus (String)
  - links (JSON)
  - companies (Company)
  - getTags (Tag)
  - integration (Integration)
  - owner (User)
  - score (Float)
  - segmentsV2 (CustomerSegmentV2Membership): Active segments-v2 memberships for this customer (active version only).
  - _id (String)
  - conversations (Conversation)
- user (User): The resolved agent who sent this message.
  - _id (String)
  - createdAt (Date)
  - username (String)
  - email (String)
  - userPreferences (JSON)
  - availability (UserChatStatus)
  - isActive (Boolean)
  - details (UserDetailsType)
  - links (JSON)
  - status (String)
  - emailSignatures (JSON)
  - groupIds (String)
  - workspaceIds (String)
  - isSubscribed (String)
  - customFieldsData (JSON)
  - workspaces (Workspace)
  - isOwner (Boolean)
  - permissionActions (JSON)
  - configs (JSON)
  - configsConstants (JSON)
  - onboardingHistory (OnboardingHistory)
  - departmentIds (String)
  - departments (Department)
  - branchIds (String)
  - branches (Branch)
  - positionIds (String)
  - positions (Position)
  - score (Float)
  - scoreCategories (ScoreCategories)
  - leaderBoardPosition (Int)
  - employeeId (String)
  - isOnline (Boolean)
- conversation (Conversation): The parent conversation.
  - _id (String)
  - content (String): The latest text content or snippet of the conversation.
  - integrationId (String): The integration (channel) this conversation originated from.
  - customerId (String): The customer participating in this conversation.
  - departmentId (String): The department this conversation is routed to.
  - userId (String): The user/agent who created or owns this conversation.
  - assignedUserId (String): The user/agent currently assigned to handle this conversation.
  - participatedUserIds (String): User IDs of agents participating in this conversation.
  - readUserIds (String): User IDs of agents who have read this conversation.
  - createdAt (Date): When this conversation was created.
  - updatedAt (Date): When this conversation was last updated.
  - slaTime (Float): SLA elapsed idle time in minutes (time since customer started waiting for a response).
  - slaConfig (Float): Configured SLA threshold in minutes.
  - idleTime (Float): Idle time in minutes (deprecated — use slaTime).
  - idleTimeConfig (Float): Configured idle time threshold in minutes (deprecated — use slaConfig).
  - isCustomerRespondedLast (Boolean): Whether the customer sent the most recent message.
  - lastCustomerMessageAt (Date): Timestamp of the last customer message.
  - lastUserMessageAt (Date): Timestamp of the last agent message.
  - customerWaitingStartTime (Date): When the customer started waiting for a response.
  - averageResponseTime (Float): Average agent response time in seconds.
  - totalResponseTime (Float): Total cumulative response time in seconds.
  - responseCount (Int): Number of agent responses in this conversation.
  - status (String): Current workflow status: 'open', 'closed', 'pending', 'snoozed', or 'bot'.
  - snoozedUntil (Date): When a snoozed conversation will auto-reopen (null if indefinite or not snoozed).
  - messageCount (Int): Total number of messages in this conversation.
  - number (Int): Auto-incremented conversation number for display.
  - tagIds (String): Tag IDs applied to this conversation.
  - messages (ConversationMessage): The most recent message in this conversation, resolved from the appropriate service (inbox, whatsapp, facebook, etc.).
  - tags (Tag): Resolved tags applied to this conversation.
  - customer (Customer): The customer associated with this conversation.
  - integration (Integration): The integration (channel) this conversation came from.
  - user (User): The user/agent who owns this conversation.
  - assignedUser (User): The agent currently assigned to this conversation.
  - assignedDepartment (Department): The department this conversation is routed to.
  - participatedUsers (User): Users participating in this conversation.
  - readUsers (User): Users who have read this conversation.
  - participatorCount (Int): Number of participants in this conversation.
  - customFieldsData (JSON)
- conversationId (String): The conversation this message belongs to.
- createdAt (Date): When this message was created.
- sticker (WASticker): Sticker attachment (when type='sticker').
  - id (String): Media ID.
  - link (String): Direct link to the sticker file.
  - url (String): Resolved URL for the sticker.
  - mime_type (String): MIME type (e.g. 'image/webp').
  - sha256 (String): SHA-256 hash.
  - animated (Boolean): Whether this is an animated sticker.
- location (WALocation): Location data (when type='location').
  - latitude (Float): Latitude.
  - longitude (Float): Longitude.
  - name (String): Location name/label.
  - address (String): Street address.
  - url (String): URL to open in maps.
- contacts (WAContact): Contact cards (when type='contacts').
  - name (WAContactName): Contact name.
  - phones (JSON): Phone numbers.
  - emails (JSON): Email addresses.
  - urls (JSON): URLs.
  - org (JSON): Organization info.
  - birthday (String): Birthday (YYYY-MM-DD).
  - addresses (JSON): Postal addresses.
- system (MessageSystem): System event content (when type='system').
  - action (String): The action that occurred (e.g. 'assigned', 'status_changed', 'tagged').
  - payload (ActionsPayload): Structured action-specific payload based on action type.
  - label (String): Human-readable label for the event.
- form (MessageForm): Form submission content (when type='form').
  - data (JSON): The raw form submission data.
- engage (MessageEngage): Engage/campaign content (when type='engage').
  - messageId (String): The engage message ID.
  - workspaceId (String): The workspace associated with the engage campaign.
  - content (String): The campaign content/body.
  - fromUserId (String): The user who initiated the campaign.
  - kind (String): Campaign kind.
  - sentAs (String): How the campaign was sent.
  - rules (JSON): Campaign targeting rules.
- videoCall (MessageVideoCall): Video call content (when type='videoCall').
  - url (String): URL to join the video call.
  - status (String): Current call status.
  - provider (String): Provider name (e.g. 'dailyco').
- order (MessageOrder): Order/commerce content (when type='order').
  - catalogId (String): Commerce catalog identifier.
  - productItems (MessageOrderProductItem): Products in this order.
  - text (String): Order summary text.
- referral (WAReferral): WhatsApp ad referral data.
  - source_url (String): Source URL of the ad.
  - source_type (String): Source type (e.g. 'ad').
  - source_id (String): Source identifier.
  - headline (String): Ad headline text.
  - body (String): Ad body text.
  - media_type (String): Media type of the ad ('image' or 'video').
  - image_url (String): Image URL from the ad.
  - video_url (String): Video URL from the ad.
  - thumbnail_url (String): Thumbnail URL from the ad.
- updatedAt (Date): When this message was last updated.

---

## ConversationMessageListResponse

**Type:** GraphQL objects

**Description:**
Paginated list of conversation messages.

### Fields
- data (ConversationMessage): The list of messages for the current page.
  - _id (String)
  - type (String): Message type discriminator.
  - sender (MessageSender): Who sent this message.
  - visibility (String): Visibility level: 'public', 'internal', or 'hidden'.
  - text (MessageText): Text content (when type='text').
  - media (MessageMedia): Media content (image, audio, video, document — single or multiple).
  - template (MessageTemplate): Template content (when type='template').
  - interactive (MessageInteractive): Interactive content (when type='interactive').
  - toolCalls (JSON): Tool call data (when type='tool_call').
  - email (MessageEmail): Email envelope and body (when type='email').
  - context (MessageContext): Threading, forwarding, mention context.
  - delivery (MessageDelivery): Delivery status and error info.
  - reactions (MessageReaction): Reactions on this message.
  - origin (MessageOrigin): External origin tracking.
  - editHistory (MessageEditEntry): Message edit history.
  - metadata (JSON): Extensible metadata bucket.
  - replyForMsg (JSON): The resolved original message being replied to.
  - customer (Customer): The resolved customer who sent this message.
  - user (User): The resolved agent who sent this message.
  - conversation (Conversation): The parent conversation.
  - conversationId (String): The conversation this message belongs to.
  - createdAt (Date): When this message was created.
  - sticker (WASticker): Sticker attachment (when type='sticker').
  - location (WALocation): Location data (when type='location').
  - contacts (WAContact): Contact cards (when type='contacts').
  - system (MessageSystem): System event content (when type='system').
  - form (MessageForm): Form submission content (when type='form').
  - engage (MessageEngage): Engage/campaign content (when type='engage').
  - videoCall (MessageVideoCall): Video call content (when type='videoCall').
  - order (MessageOrder): Order/commerce content (when type='order').
  - referral (WAReferral): WhatsApp ad referral data.
  - updatedAt (Date): When this message was last updated.
- pagination (PaginationInfo, Not Null): Pagination metadata.
  - currentPage (Int): The current page number (1-based).
  - perPage (Int): Number of items per page.
  - totalCount (Int): Total number of items matching the query.
  - totalPages (Int): Total number of pages.
  - hasNextPage (Boolean): Whether there are more pages after the current one.
  - hasPreviousPage (Boolean): Whether there are pages before the current one.

---

## Integration

**Type:** GraphQL objects

### Fields
- _id (String)
- kind (String)
- name (String)
- languageCode (String)
- code (String)
- formId (String)
- tagIds (String)
- createdAt (Date)
- workspaceId (String)
- tags (Tag): undefined
  - _id (String)
  - name (String)
  - type (String)
  - colorCode (String)
  - createdAt (Date)
  - objectCount (Int)
  - totalObjectCount (Int)
  - parentId (String)
  - order (String)
  - relatedIds (String)
  - childTags (Tag)
- leadData (JSON)
- messengerData (JSON)
- whatsappData (WhatsappIntegration): undefined
  - _id (String)
  - accountId (String)
  - kind (String)
  - provider (String)
  - phoneNumberId (String)
  - wabaId (String)
  - error (String)
  - healthStatus (String)
  - accountMode (String)
  - profile (WhatsappBusinessProfile)
  - businessPhoneNumber (WhatsappBusinessPhone)
- uiOptions (JSON)
- isActive (Boolean)
- isConnected (Boolean)
- webhookData (JSON)
- form (Form): undefined
  - _id (String)
  - name (String)
  - title (String)
  - code (String)
  - type (String)
  - description (String)
  - buttonText (String)
  - createdUserId (String)
  - createdUser (User)
  - createdDate (Date)
  - numberOfPages (Int)
  - status (String)
  - googleMapApiKey (String)
  - fields (Field)
  - visibility (String)
  - leadData (JSON)
  - languageCode (String)
  - departmentIds (String)
  - tagIds (String)
  - tags (Tag)
  - workspaceId (String)
  - workspace (Workspace)
  - integrationId (String)
- departmentId (String)
- department (Department): undefined
  - _id (String)
  - title (String)
  - description (String)
  - parentId (String)
  - supervisorId (String)
  - supervisor (User)
  - code (String)
  - order (String)
  - parent (Department)
  - children (Department)
  - childCount (Int)
  - users (User)
  - userCount (Int)
  - userIds (String)
- workspace (Workspace): undefined
  - _id (String)
  - name (String)
  - description (String)
  - code (String)
  - userId (String)
  - createdAt (Date)
  - memberIds (String)
- websiteMessengerApps (MessengerApp): undefined
  - _id (String)
  - kind (String)
  - name (String)
  - showInInbox (Boolean)
  - credentials (JSON)
  - accountId (String)
- knowledgeBaseMessengerApps (MessengerApp): undefined
  - _id (String)
  - kind (String)
  - name (String)
  - showInInbox (Boolean)
  - credentials (JSON)
  - accountId (String)
- leadMessengerApps (MessengerApp): undefined
  - _id (String)
  - kind (String)
  - name (String)
  - showInInbox (Boolean)
  - credentials (JSON)
  - accountId (String)
- healthStatus (JSON)
- visibility (String)
- departmentIds (String)
- details (JSON)

---

## MessengerApp

**Type:** GraphQL objects

### Fields
- _id (String)
- kind (String)
- name (String)
- showInInbox (Boolean)
- credentials (JSON)
- accountId (String)

---

## WhatsappBusinessPhone

**Type:** GraphQL objects

### Fields
- id (String)
- status (String)
- quality_rating (String)
- platform_type (String)
- whatsappBusinessManagerMessagingLimit (String)
- messaging_limit_tier (String)
- is_pin_enabled (Boolean)
- display_phone_number (String)
- name_status (String)
- account_mode (String)
- is_official_business_account (Boolean)
- code_verification_status (String)
- verified_name (String)
- new_name_status (String)
- throughput (Throughput): undefined
  - level (String)
- health_status (WhatsappHealthStatus): undefined
  - can_send_message (String)
  - entities (HealthEntity)

---

## WhatsappBusinessProfile

**Type:** GraphQL objects

### Fields
- about (String)
- email (String)
- description (String)
- websites (String)
- vertical (String)
- address (String)
- messaging_product (String)
- profile_picture_url (String)
- status (String)
- error (String)

---

## WhatsappHealthStatus

**Type:** GraphQL objects

### Fields
- can_send_message (String)
- entities (HealthEntity): undefined
  - entity_type (String)
  - id (String)
  - can_send_message (String)
  - additional_info (String)

---

## WhatsappIntegration

**Type:** GraphQL objects

### Fields
- _id (String)
- accountId (String)
- kind (String)
- provider (String)
- phoneNumberId (String)
- wabaId (String)
- error (String)
- healthStatus (String)
- accountMode (String)
- profile (WhatsappBusinessProfile): undefined
  - about (String)
  - email (String)
  - description (String)
  - websites (String)
  - vertical (String)
  - address (String)
  - messaging_product (String)
  - profile_picture_url (String)
  - status (String)
  - error (String)
- businessPhoneNumber (WhatsappBusinessPhone): undefined
  - id (String)
  - status (String)
  - quality_rating (String)
  - platform_type (String)
  - whatsappBusinessManagerMessagingLimit (String)
  - messaging_limit_tier (String)
  - is_pin_enabled (Boolean)
  - display_phone_number (String)
  - name_status (String)
  - account_mode (String)
  - is_official_business_account (Boolean)
  - code_verification_status (String)
  - verified_name (String)
  - new_name_status (String)
  - throughput (Throughput)
  - health_status (WhatsappHealthStatus)