SunshineConversationsClient::Conversation

August 27, 2025 ยท View on GitHub

Properties

NameTypeDescriptionNotes
idStringThe unique ID of the conversation.[optional]
typeConversationType[optional]
metadataHash<String, Object>Flat object containing custom properties. Strings, numbers and booleans are the only supported format that can be passed to metadata. The metadata is limited to 4KB in size.[optional]
active_switchboard_integrationSwitchboardIntegrationWebhookThe current switchboard integration that is in control of the conversation. This field is omitted if no `activeSwitchboardIntegration` exists for the conversation.[optional]
pending_switchboard_integrationSwitchboardIntegrationWebhookThe switchboard integration that is awaiting control. This field is omitted if no switchboard integration has been previously offered control.[optional]
is_defaultBooleanWhether the conversation is the default conversation for the user. Will be true for the first personal conversation created for the user, and false in all other cases.[optional]
display_nameStringA friendly name for the conversation, may be displayed to the business or the user.[optional]
descriptionStringA short text describing the conversation.[optional]
icon_urlStringA custom conversation icon url. The image must be in either JPG, PNG, or GIF format[optional]
business_last_readStringA datetime string with the format YYYY-MM-DDThh:mm:ss.SSSZ representing the moment the conversation was last marked as read with role business.[optional]
last_updated_atStringA datetime string with the format YYYY-MM-DDThh:mm:ss.SSSZ representing the moment the last message was received in the conversation, or the creation time if no messages have been received yet.[optional]
created_atStringA datetime string with the format YYYY-MM-DDThh:mm:ss.SSSZ representing the creation time of the conversation.[optional]

Example

require 'sunshine-conversations-client'

instance = SunshineConversationsClient::Conversation.new(
  id: c93bb9c14dde8ffb94564eae,
  type: null,
  metadata: {lang&#x3D;en-ca},
  active_switchboard_integration: null,
  pending_switchboard_integration: null,
  is_default: false,
  display_name: null,
  description: Conversation between Rogers and Carl.,
  icon_url: https://www.gravatar.com/image.jpg,
  business_last_read: 2020-06-23T14:33:47.492Z,
  last_updated_at: 2020-06-26T14:33:47.120Z,
  created_at: 2020-06-20T11:26:07.001Z
)