diff --git a/swagger/definitions/index.yml b/swagger/definitions/index.yml index e6ca1a041..edde31d68 100644 --- a/swagger/definitions/index.yml +++ b/swagger/definitions/index.yml @@ -82,10 +82,16 @@ audit_log: ## public resources public_contact: $ref: ./resource/public/contact.yml +public_contact_record: + $ref: ./resource/public/contact_record.yml public_conversation: $ref: ./resource/public/conversation.yml public_message: $ref: ./resource/public/message.yml +public_message_attachment: + $ref: ./resource/public/message_attachment.yml +public_message_sender: + $ref: ./resource/public/message_sender.yml public_inbox: $ref: ./resource/public/inbox.yml diff --git a/swagger/definitions/resource/public/contact.yml b/swagger/definitions/resource/public/contact.yml index 453ac5c97..b9451067f 100644 --- a/swagger/definitions/resource/public/contact.yml +++ b/swagger/definitions/resource/public/contact.yml @@ -7,11 +7,20 @@ properties: type: string description: The session identifier of the contact name: - type: string - description: Name of the contact + type: + - string + - 'null' + description: Name of the contact when available email: - type: string + type: + - string + - 'null' description: Email of the contact + phone_number: + type: + - string + - 'null' + description: Phone number of the contact pubsub_token: type: string description: The token to be used to connect to chatwoot websocket diff --git a/swagger/definitions/resource/public/contact_record.yml b/swagger/definitions/resource/public/contact_record.yml new file mode 100644 index 000000000..e3de7b875 --- /dev/null +++ b/swagger/definitions/resource/public/contact_record.yml @@ -0,0 +1,93 @@ +type: object +additionalProperties: true +description: Full serialized contact record returned when the public API renders a Contact model directly. +properties: + id: + type: integer + description: Id of the contact + name: + type: + - string + - 'null' + description: Name of the contact when available + email: + type: + - string + - 'null' + description: Email of the contact + phone_number: + type: + - string + - 'null' + description: Phone number of the contact + identifier: + type: + - string + - 'null' + description: Identifier of the contact + blocked: + type: boolean + description: Whether the contact is blocked + additional_attributes: + type: + - object + - 'null' + description: Additional attributes of the contact when present + custom_attributes: + type: + - object + - 'null' + description: Custom attributes of the contact when present + contact_type: + type: + - string + - 'null' + description: Contact type of the contact when available + country_code: + type: + - string + - 'null' + description: Country code of the contact + last_activity_at: + type: + - string + - 'null' + description: Last activity timestamp of the contact in ISO 8601 format + created_at: + type: + - string + - 'null' + description: Created timestamp of the contact in ISO 8601 format + updated_at: + type: + - string + - 'null' + description: Updated timestamp of the contact in ISO 8601 format + last_name: + type: + - string + - 'null' + description: Last name of the contact + middle_name: + type: + - string + - 'null' + description: Middle name of the contact + location: + type: + - string + - 'null' + description: Location of the contact + account_id: + type: integer + description: Account id of the contact + company_id: + type: + - integer + - 'null' + description: Company id of the contact + label_list: + type: array + description: Labels applied to the contact + items: + type: string diff --git a/swagger/definitions/resource/public/conversation.yml b/swagger/definitions/resource/public/conversation.yml index 67febca2d..68133b0e7 100644 --- a/swagger/definitions/resource/public/conversation.yml +++ b/swagger/definitions/resource/public/conversation.yml @@ -3,14 +3,26 @@ properties: id: type: integer description: Id of the conversation - inbox_id: + uuid: type: string + description: UUID of the conversation + inbox_id: + type: integer description: The inbox id of the conversation + contact_last_seen_at: + type: integer + description: Timestamp of when the contact last seen the conversation (Unix timestamp) + status: + type: string + enum: ['open', 'resolved', 'pending', 'snoozed'] + description: The status of the conversation + agent_last_seen_at: + type: integer + description: Timestamp of when the agent last seen the conversation (Unix timestamp) messages: type: array items: - $ref: '#/components/schemas/message' + $ref: '#/components/schemas/public_message' description: Messages in the conversation contact: - type: object - description: The contact information associated to the conversation + $ref: '#/components/schemas/public_contact_record' diff --git a/swagger/definitions/resource/public/message.yml b/swagger/definitions/resource/public/message.yml index 242a4fbf4..530264ee6 100644 --- a/swagger/definitions/resource/public/message.yml +++ b/swagger/definitions/resource/public/message.yml @@ -1,38 +1,32 @@ type: object properties: id: - type: string + type: integer description: Id of the message content: - type: string - description: Text content of the message + type: + - string + - 'null' + description: Text content of the message. Can be null for attachment-only messages. message_type: - type: string - description: Denotes the message type + type: integer + description: "Denotes the message type. Possible values: 0 (incoming), 1 (outgoing), 2 (activity), 3 (template)" content_type: type: string description: Content type of the message content_attributes: - type: string + type: object description: Additional content attributes of the message created_at: - type: string - description: Created at time stamp of the message + type: integer + description: Created at Unix timestamp of the message conversation_id: - type: string - description: Conversation Id of the message + type: integer + description: Display Id of the conversation the message belongs to attachments: type: array - items: - type: object description: Attachments if any + items: + $ref: '#/components/schemas/public_message_attachment' sender: - type: object - description: Details of the sender - - - - - - - + $ref: '#/components/schemas/public_message_sender' diff --git a/swagger/definitions/resource/public/message_attachment.yml b/swagger/definitions/resource/public/message_attachment.yml new file mode 100644 index 000000000..995c46f34 --- /dev/null +++ b/swagger/definitions/resource/public/message_attachment.yml @@ -0,0 +1,60 @@ +type: object +additionalProperties: true +description: Attachment payload. Available fields vary by attachment file_type. +properties: + id: + type: integer + description: Id of the attachment + message_id: + type: integer + description: Id of the parent message + file_type: + type: string + enum: ['image', 'audio', 'video', 'file', 'location', 'fallback', 'share', 'story_mention', 'contact', 'ig_reel', 'ig_post', 'ig_story', 'embed'] + description: Type of the attached file + account_id: + type: integer + description: Id of the account + extension: + type: + - string + - 'null' + description: File extension + data_url: + type: + - string + - 'null' + description: URL of the file. Can be null when an attachment variant has no external URL. + thumb_url: + type: string + description: URL of the file thumbnail + file_size: + type: integer + description: File size in bytes + width: + type: + - integer + - 'null' + description: Width of the attachment when available + height: + type: + - integer + - 'null' + description: Height of the attachment when available + coordinates_lat: + type: number + description: Latitude for location attachments + coordinates_long: + type: number + description: Longitude for location attachments + fallback_title: + type: + - string + - 'null' + description: Fallback title for location, fallback, and contact attachments when available + meta: + type: object + description: Metadata for contact attachments + transcribed_text: + type: string + description: Transcribed text for audio attachments diff --git a/swagger/definitions/resource/public/message_sender.yml b/swagger/definitions/resource/public/message_sender.yml new file mode 100644 index 000000000..71b79d2d9 --- /dev/null +++ b/swagger/definitions/resource/public/message_sender.yml @@ -0,0 +1,70 @@ +type: object +additionalProperties: true +description: Polymorphic sender payload returned by push_event_data. Available fields vary by sender type. +properties: + id: + type: integer + description: Id of the sender + name: + type: + - string + - 'null' + description: Name of the sender when available + avatar_url: + type: string + description: Avatar URL of the sender. Present for senders of type user, agent_bot, and captain_assistant. Not present for contact senders (use thumbnail instead). + thumbnail: + type: string + description: Avatar/thumbnail URL of the sender. Contact senders use this field; user senders may also include it. + type: + type: string + enum: ['contact', 'user', 'agent_bot', 'captain_assistant'] + description: Type of the sender + available_name: + type: + - string + - 'null' + description: Display name for user senders + availability_status: + type: + - string + - 'null' + description: Availability status for user senders + email: + type: + - string + - 'null' + description: Email of the sender when the sender is a contact + phone_number: + type: + - string + - 'null' + description: Phone number of the sender when the sender is a contact + identifier: + type: + - string + - 'null' + description: Identifier of the sender when the sender is a contact + blocked: + type: boolean + description: Whether the sender is blocked when the sender is a contact + additional_attributes: + type: + - object + - 'null' + description: Additional attributes when the sender is a contact and available + custom_attributes: + type: + - object + - 'null' + description: Custom attributes when the sender is a contact and available + description: + type: + - string + - 'null' + description: Description when the sender is a captain assistant + created_at: + type: + - string + - 'null' + description: Created timestamp in ISO 8601 format when the sender is a captain assistant diff --git a/swagger/paths/public/inboxes/contacts/update.yml b/swagger/paths/public/inboxes/contacts/update.yml index 8134d7bfd..16435d1e0 100644 --- a/swagger/paths/public/inboxes/contacts/update.yml +++ b/swagger/paths/public/inboxes/contacts/update.yml @@ -16,7 +16,7 @@ responses: content: application/json: schema: - $ref: '#/components/schemas/public_contact' + $ref: '#/components/schemas/public_contact_record' '401': description: Unauthorized content: diff --git a/swagger/swagger.json b/swagger/swagger.json index 5044585c1..3a9c39728 100644 --- a/swagger/swagger.json +++ b/swagger/swagger.json @@ -971,7 +971,7 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/public_contact" + "$ref": "#/components/schemas/public_contact_record" } } } @@ -10750,19 +10750,163 @@ "description": "The session identifier of the contact" }, "name": { - "type": "string", - "description": "Name of the contact" + "type": [ + "string", + "null" + ], + "description": "Name of the contact when available" }, "email": { - "type": "string", + "type": [ + "string", + "null" + ], "description": "Email of the contact" }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the contact" + }, "pubsub_token": { "type": "string", "description": "The token to be used to connect to chatwoot websocket" } } }, + "public_contact_record": { + "type": "object", + "additionalProperties": true, + "description": "Full serialized contact record returned when the public API renders a Contact model directly.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the contact" + }, + "name": { + "type": [ + "string", + "null" + ], + "description": "Name of the contact when available" + }, + "email": { + "type": [ + "string", + "null" + ], + "description": "Email of the contact" + }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the contact" + }, + "identifier": { + "type": [ + "string", + "null" + ], + "description": "Identifier of the contact" + }, + "blocked": { + "type": "boolean", + "description": "Whether the contact is blocked" + }, + "additional_attributes": { + "type": [ + "object", + "null" + ], + "description": "Additional attributes of the contact when present" + }, + "custom_attributes": { + "type": [ + "object", + "null" + ], + "description": "Custom attributes of the contact when present" + }, + "contact_type": { + "type": [ + "string", + "null" + ], + "description": "Contact type of the contact when available" + }, + "country_code": { + "type": [ + "string", + "null" + ], + "description": "Country code of the contact" + }, + "last_activity_at": { + "type": [ + "string", + "null" + ], + "description": "Last activity timestamp of the contact in ISO 8601 format" + }, + "created_at": { + "type": [ + "string", + "null" + ], + "description": "Created timestamp of the contact in ISO 8601 format" + }, + "updated_at": { + "type": [ + "string", + "null" + ], + "description": "Updated timestamp of the contact in ISO 8601 format" + }, + "last_name": { + "type": [ + "string", + "null" + ], + "description": "Last name of the contact" + }, + "middle_name": { + "type": [ + "string", + "null" + ], + "description": "Middle name of the contact" + }, + "location": { + "type": [ + "string", + "null" + ], + "description": "Location of the contact" + }, + "account_id": { + "type": "integer", + "description": "Account id of the contact" + }, + "company_id": { + "type": [ + "integer", + "null" + ], + "description": "Company id of the contact" + }, + "label_list": { + "type": "array", + "description": "Labels applied to the contact", + "items": { + "type": "string" + } + } + } + }, "public_conversation": { "type": "object", "properties": { @@ -10770,20 +10914,41 @@ "type": "integer", "description": "Id of the conversation" }, - "inbox_id": { + "uuid": { "type": "string", + "description": "UUID of the conversation" + }, + "inbox_id": { + "type": "integer", "description": "The inbox id of the conversation" }, + "contact_last_seen_at": { + "type": "integer", + "description": "Timestamp of when the contact last seen the conversation (Unix timestamp)" + }, + "status": { + "type": "string", + "enum": [ + "open", + "resolved", + "pending", + "snoozed" + ], + "description": "The status of the conversation" + }, + "agent_last_seen_at": { + "type": "integer", + "description": "Timestamp of when the agent last seen the conversation (Unix timestamp)" + }, "messages": { "type": "array", "items": { - "$ref": "#/components/schemas/message" + "$ref": "#/components/schemas/public_message" }, "description": "Messages in the conversation" }, "contact": { - "type": "object", - "description": "The contact information associated to the conversation" + "$ref": "#/components/schemas/public_contact_record" } } }, @@ -10791,43 +10956,245 @@ "type": "object", "properties": { "id": { - "type": "string", + "type": "integer", "description": "Id of the message" }, "content": { - "type": "string", - "description": "Text content of the message" + "type": [ + "string", + "null" + ], + "description": "Text content of the message. Can be null for attachment-only messages." }, "message_type": { - "type": "string", - "description": "Denotes the message type" + "type": "integer", + "description": "Denotes the message type. Possible values: 0 (incoming), 1 (outgoing), 2 (activity), 3 (template)" }, "content_type": { "type": "string", "description": "Content type of the message" }, "content_attributes": { - "type": "string", + "type": "object", "description": "Additional content attributes of the message" }, "created_at": { - "type": "string", - "description": "Created at time stamp of the message" + "type": "integer", + "description": "Created at Unix timestamp of the message" }, "conversation_id": { - "type": "string", - "description": "Conversation Id of the message" + "type": "integer", + "description": "Display Id of the conversation the message belongs to" }, "attachments": { "type": "array", + "description": "Attachments if any", "items": { - "type": "object" - }, - "description": "Attachments if any" + "$ref": "#/components/schemas/public_message_attachment" + } }, "sender": { + "$ref": "#/components/schemas/public_message_sender" + } + } + }, + "public_message_attachment": { + "type": "object", + "additionalProperties": true, + "description": "Attachment payload. Available fields vary by attachment file_type.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the attachment" + }, + "message_id": { + "type": "integer", + "description": "Id of the parent message" + }, + "file_type": { + "type": "string", + "enum": [ + "image", + "audio", + "video", + "file", + "location", + "fallback", + "share", + "story_mention", + "contact", + "ig_reel", + "ig_post", + "ig_story", + "embed" + ], + "description": "Type of the attached file" + }, + "account_id": { + "type": "integer", + "description": "Id of the account" + }, + "extension": { + "type": [ + "string", + "null" + ], + "description": "File extension" + }, + "data_url": { + "type": [ + "string", + "null" + ], + "description": "URL of the file. Can be null when an attachment variant has no external URL." + }, + "thumb_url": { + "type": "string", + "description": "URL of the file thumbnail" + }, + "file_size": { + "type": "integer", + "description": "File size in bytes" + }, + "width": { + "type": [ + "integer", + "null" + ], + "description": "Width of the attachment when available" + }, + "height": { + "type": [ + "integer", + "null" + ], + "description": "Height of the attachment when available" + }, + "coordinates_lat": { + "type": "number", + "description": "Latitude for location attachments" + }, + "coordinates_long": { + "type": "number", + "description": "Longitude for location attachments" + }, + "fallback_title": { + "type": [ + "string", + "null" + ], + "description": "Fallback title for location, fallback, and contact attachments when available" + }, + "meta": { "type": "object", - "description": "Details of the sender" + "description": "Metadata for contact attachments" + }, + "transcribed_text": { + "type": "string", + "description": "Transcribed text for audio attachments" + } + } + }, + "public_message_sender": { + "type": "object", + "additionalProperties": true, + "description": "Polymorphic sender payload returned by push_event_data. Available fields vary by sender type.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the sender" + }, + "name": { + "type": [ + "string", + "null" + ], + "description": "Name of the sender when available" + }, + "avatar_url": { + "type": "string", + "description": "Avatar URL of the sender. Present for senders of type user, agent_bot, and captain_assistant. Not present for contact senders (use thumbnail instead)." + }, + "thumbnail": { + "type": "string", + "description": "Avatar/thumbnail URL of the sender. Contact senders use this field; user senders may also include it." + }, + "type": { + "type": "string", + "enum": [ + "contact", + "user", + "agent_bot", + "captain_assistant" + ], + "description": "Type of the sender" + }, + "available_name": { + "type": [ + "string", + "null" + ], + "description": "Display name for user senders" + }, + "availability_status": { + "type": [ + "string", + "null" + ], + "description": "Availability status for user senders" + }, + "email": { + "type": [ + "string", + "null" + ], + "description": "Email of the sender when the sender is a contact" + }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the sender when the sender is a contact" + }, + "identifier": { + "type": [ + "string", + "null" + ], + "description": "Identifier of the sender when the sender is a contact" + }, + "blocked": { + "type": "boolean", + "description": "Whether the sender is blocked when the sender is a contact" + }, + "additional_attributes": { + "type": [ + "object", + "null" + ], + "description": "Additional attributes when the sender is a contact and available" + }, + "custom_attributes": { + "type": [ + "object", + "null" + ], + "description": "Custom attributes when the sender is a contact and available" + }, + "description": { + "type": [ + "string", + "null" + ], + "description": "Description when the sender is a captain assistant" + }, + "created_at": { + "type": [ + "string", + "null" + ], + "description": "Created timestamp in ISO 8601 format when the sender is a captain assistant" } } }, diff --git a/swagger/tag_groups/application_swagger.json b/swagger/tag_groups/application_swagger.json index 85bad5cfb..a013b3694 100644 --- a/swagger/tag_groups/application_swagger.json +++ b/swagger/tag_groups/application_swagger.json @@ -9257,19 +9257,163 @@ "description": "The session identifier of the contact" }, "name": { - "type": "string", - "description": "Name of the contact" + "type": [ + "string", + "null" + ], + "description": "Name of the contact when available" }, "email": { - "type": "string", + "type": [ + "string", + "null" + ], "description": "Email of the contact" }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the contact" + }, "pubsub_token": { "type": "string", "description": "The token to be used to connect to chatwoot websocket" } } }, + "public_contact_record": { + "type": "object", + "additionalProperties": true, + "description": "Full serialized contact record returned when the public API renders a Contact model directly.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the contact" + }, + "name": { + "type": [ + "string", + "null" + ], + "description": "Name of the contact when available" + }, + "email": { + "type": [ + "string", + "null" + ], + "description": "Email of the contact" + }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the contact" + }, + "identifier": { + "type": [ + "string", + "null" + ], + "description": "Identifier of the contact" + }, + "blocked": { + "type": "boolean", + "description": "Whether the contact is blocked" + }, + "additional_attributes": { + "type": [ + "object", + "null" + ], + "description": "Additional attributes of the contact when present" + }, + "custom_attributes": { + "type": [ + "object", + "null" + ], + "description": "Custom attributes of the contact when present" + }, + "contact_type": { + "type": [ + "string", + "null" + ], + "description": "Contact type of the contact when available" + }, + "country_code": { + "type": [ + "string", + "null" + ], + "description": "Country code of the contact" + }, + "last_activity_at": { + "type": [ + "string", + "null" + ], + "description": "Last activity timestamp of the contact in ISO 8601 format" + }, + "created_at": { + "type": [ + "string", + "null" + ], + "description": "Created timestamp of the contact in ISO 8601 format" + }, + "updated_at": { + "type": [ + "string", + "null" + ], + "description": "Updated timestamp of the contact in ISO 8601 format" + }, + "last_name": { + "type": [ + "string", + "null" + ], + "description": "Last name of the contact" + }, + "middle_name": { + "type": [ + "string", + "null" + ], + "description": "Middle name of the contact" + }, + "location": { + "type": [ + "string", + "null" + ], + "description": "Location of the contact" + }, + "account_id": { + "type": "integer", + "description": "Account id of the contact" + }, + "company_id": { + "type": [ + "integer", + "null" + ], + "description": "Company id of the contact" + }, + "label_list": { + "type": "array", + "description": "Labels applied to the contact", + "items": { + "type": "string" + } + } + } + }, "public_conversation": { "type": "object", "properties": { @@ -9277,20 +9421,41 @@ "type": "integer", "description": "Id of the conversation" }, - "inbox_id": { + "uuid": { "type": "string", + "description": "UUID of the conversation" + }, + "inbox_id": { + "type": "integer", "description": "The inbox id of the conversation" }, + "contact_last_seen_at": { + "type": "integer", + "description": "Timestamp of when the contact last seen the conversation (Unix timestamp)" + }, + "status": { + "type": "string", + "enum": [ + "open", + "resolved", + "pending", + "snoozed" + ], + "description": "The status of the conversation" + }, + "agent_last_seen_at": { + "type": "integer", + "description": "Timestamp of when the agent last seen the conversation (Unix timestamp)" + }, "messages": { "type": "array", "items": { - "$ref": "#/components/schemas/message" + "$ref": "#/components/schemas/public_message" }, "description": "Messages in the conversation" }, "contact": { - "type": "object", - "description": "The contact information associated to the conversation" + "$ref": "#/components/schemas/public_contact_record" } } }, @@ -9298,43 +9463,245 @@ "type": "object", "properties": { "id": { - "type": "string", + "type": "integer", "description": "Id of the message" }, "content": { - "type": "string", - "description": "Text content of the message" + "type": [ + "string", + "null" + ], + "description": "Text content of the message. Can be null for attachment-only messages." }, "message_type": { - "type": "string", - "description": "Denotes the message type" + "type": "integer", + "description": "Denotes the message type. Possible values: 0 (incoming), 1 (outgoing), 2 (activity), 3 (template)" }, "content_type": { "type": "string", "description": "Content type of the message" }, "content_attributes": { - "type": "string", + "type": "object", "description": "Additional content attributes of the message" }, "created_at": { - "type": "string", - "description": "Created at time stamp of the message" + "type": "integer", + "description": "Created at Unix timestamp of the message" }, "conversation_id": { - "type": "string", - "description": "Conversation Id of the message" + "type": "integer", + "description": "Display Id of the conversation the message belongs to" }, "attachments": { "type": "array", + "description": "Attachments if any", "items": { - "type": "object" - }, - "description": "Attachments if any" + "$ref": "#/components/schemas/public_message_attachment" + } }, "sender": { + "$ref": "#/components/schemas/public_message_sender" + } + } + }, + "public_message_attachment": { + "type": "object", + "additionalProperties": true, + "description": "Attachment payload. Available fields vary by attachment file_type.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the attachment" + }, + "message_id": { + "type": "integer", + "description": "Id of the parent message" + }, + "file_type": { + "type": "string", + "enum": [ + "image", + "audio", + "video", + "file", + "location", + "fallback", + "share", + "story_mention", + "contact", + "ig_reel", + "ig_post", + "ig_story", + "embed" + ], + "description": "Type of the attached file" + }, + "account_id": { + "type": "integer", + "description": "Id of the account" + }, + "extension": { + "type": [ + "string", + "null" + ], + "description": "File extension" + }, + "data_url": { + "type": [ + "string", + "null" + ], + "description": "URL of the file. Can be null when an attachment variant has no external URL." + }, + "thumb_url": { + "type": "string", + "description": "URL of the file thumbnail" + }, + "file_size": { + "type": "integer", + "description": "File size in bytes" + }, + "width": { + "type": [ + "integer", + "null" + ], + "description": "Width of the attachment when available" + }, + "height": { + "type": [ + "integer", + "null" + ], + "description": "Height of the attachment when available" + }, + "coordinates_lat": { + "type": "number", + "description": "Latitude for location attachments" + }, + "coordinates_long": { + "type": "number", + "description": "Longitude for location attachments" + }, + "fallback_title": { + "type": [ + "string", + "null" + ], + "description": "Fallback title for location, fallback, and contact attachments when available" + }, + "meta": { "type": "object", - "description": "Details of the sender" + "description": "Metadata for contact attachments" + }, + "transcribed_text": { + "type": "string", + "description": "Transcribed text for audio attachments" + } + } + }, + "public_message_sender": { + "type": "object", + "additionalProperties": true, + "description": "Polymorphic sender payload returned by push_event_data. Available fields vary by sender type.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the sender" + }, + "name": { + "type": [ + "string", + "null" + ], + "description": "Name of the sender when available" + }, + "avatar_url": { + "type": "string", + "description": "Avatar URL of the sender. Present for senders of type user, agent_bot, and captain_assistant. Not present for contact senders (use thumbnail instead)." + }, + "thumbnail": { + "type": "string", + "description": "Avatar/thumbnail URL of the sender. Contact senders use this field; user senders may also include it." + }, + "type": { + "type": "string", + "enum": [ + "contact", + "user", + "agent_bot", + "captain_assistant" + ], + "description": "Type of the sender" + }, + "available_name": { + "type": [ + "string", + "null" + ], + "description": "Display name for user senders" + }, + "availability_status": { + "type": [ + "string", + "null" + ], + "description": "Availability status for user senders" + }, + "email": { + "type": [ + "string", + "null" + ], + "description": "Email of the sender when the sender is a contact" + }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the sender when the sender is a contact" + }, + "identifier": { + "type": [ + "string", + "null" + ], + "description": "Identifier of the sender when the sender is a contact" + }, + "blocked": { + "type": "boolean", + "description": "Whether the sender is blocked when the sender is a contact" + }, + "additional_attributes": { + "type": [ + "object", + "null" + ], + "description": "Additional attributes when the sender is a contact and available" + }, + "custom_attributes": { + "type": [ + "object", + "null" + ], + "description": "Custom attributes when the sender is a contact and available" + }, + "description": { + "type": [ + "string", + "null" + ], + "description": "Description when the sender is a captain assistant" + }, + "created_at": { + "type": [ + "string", + "null" + ], + "description": "Created timestamp in ISO 8601 format when the sender is a captain assistant" } } }, diff --git a/swagger/tag_groups/client_swagger.json b/swagger/tag_groups/client_swagger.json index dccfe52cc..f95b1bed3 100644 --- a/swagger/tag_groups/client_swagger.json +++ b/swagger/tag_groups/client_swagger.json @@ -141,7 +141,7 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/public_contact" + "$ref": "#/components/schemas/public_contact_record" } } } @@ -2522,19 +2522,163 @@ "description": "The session identifier of the contact" }, "name": { - "type": "string", - "description": "Name of the contact" + "type": [ + "string", + "null" + ], + "description": "Name of the contact when available" }, "email": { - "type": "string", + "type": [ + "string", + "null" + ], "description": "Email of the contact" }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the contact" + }, "pubsub_token": { "type": "string", "description": "The token to be used to connect to chatwoot websocket" } } }, + "public_contact_record": { + "type": "object", + "additionalProperties": true, + "description": "Full serialized contact record returned when the public API renders a Contact model directly.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the contact" + }, + "name": { + "type": [ + "string", + "null" + ], + "description": "Name of the contact when available" + }, + "email": { + "type": [ + "string", + "null" + ], + "description": "Email of the contact" + }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the contact" + }, + "identifier": { + "type": [ + "string", + "null" + ], + "description": "Identifier of the contact" + }, + "blocked": { + "type": "boolean", + "description": "Whether the contact is blocked" + }, + "additional_attributes": { + "type": [ + "object", + "null" + ], + "description": "Additional attributes of the contact when present" + }, + "custom_attributes": { + "type": [ + "object", + "null" + ], + "description": "Custom attributes of the contact when present" + }, + "contact_type": { + "type": [ + "string", + "null" + ], + "description": "Contact type of the contact when available" + }, + "country_code": { + "type": [ + "string", + "null" + ], + "description": "Country code of the contact" + }, + "last_activity_at": { + "type": [ + "string", + "null" + ], + "description": "Last activity timestamp of the contact in ISO 8601 format" + }, + "created_at": { + "type": [ + "string", + "null" + ], + "description": "Created timestamp of the contact in ISO 8601 format" + }, + "updated_at": { + "type": [ + "string", + "null" + ], + "description": "Updated timestamp of the contact in ISO 8601 format" + }, + "last_name": { + "type": [ + "string", + "null" + ], + "description": "Last name of the contact" + }, + "middle_name": { + "type": [ + "string", + "null" + ], + "description": "Middle name of the contact" + }, + "location": { + "type": [ + "string", + "null" + ], + "description": "Location of the contact" + }, + "account_id": { + "type": "integer", + "description": "Account id of the contact" + }, + "company_id": { + "type": [ + "integer", + "null" + ], + "description": "Company id of the contact" + }, + "label_list": { + "type": "array", + "description": "Labels applied to the contact", + "items": { + "type": "string" + } + } + } + }, "public_conversation": { "type": "object", "properties": { @@ -2542,20 +2686,41 @@ "type": "integer", "description": "Id of the conversation" }, - "inbox_id": { + "uuid": { "type": "string", + "description": "UUID of the conversation" + }, + "inbox_id": { + "type": "integer", "description": "The inbox id of the conversation" }, + "contact_last_seen_at": { + "type": "integer", + "description": "Timestamp of when the contact last seen the conversation (Unix timestamp)" + }, + "status": { + "type": "string", + "enum": [ + "open", + "resolved", + "pending", + "snoozed" + ], + "description": "The status of the conversation" + }, + "agent_last_seen_at": { + "type": "integer", + "description": "Timestamp of when the agent last seen the conversation (Unix timestamp)" + }, "messages": { "type": "array", "items": { - "$ref": "#/components/schemas/message" + "$ref": "#/components/schemas/public_message" }, "description": "Messages in the conversation" }, "contact": { - "type": "object", - "description": "The contact information associated to the conversation" + "$ref": "#/components/schemas/public_contact_record" } } }, @@ -2563,43 +2728,245 @@ "type": "object", "properties": { "id": { - "type": "string", + "type": "integer", "description": "Id of the message" }, "content": { - "type": "string", - "description": "Text content of the message" + "type": [ + "string", + "null" + ], + "description": "Text content of the message. Can be null for attachment-only messages." }, "message_type": { - "type": "string", - "description": "Denotes the message type" + "type": "integer", + "description": "Denotes the message type. Possible values: 0 (incoming), 1 (outgoing), 2 (activity), 3 (template)" }, "content_type": { "type": "string", "description": "Content type of the message" }, "content_attributes": { - "type": "string", + "type": "object", "description": "Additional content attributes of the message" }, "created_at": { - "type": "string", - "description": "Created at time stamp of the message" + "type": "integer", + "description": "Created at Unix timestamp of the message" }, "conversation_id": { - "type": "string", - "description": "Conversation Id of the message" + "type": "integer", + "description": "Display Id of the conversation the message belongs to" }, "attachments": { "type": "array", + "description": "Attachments if any", "items": { - "type": "object" - }, - "description": "Attachments if any" + "$ref": "#/components/schemas/public_message_attachment" + } }, "sender": { + "$ref": "#/components/schemas/public_message_sender" + } + } + }, + "public_message_attachment": { + "type": "object", + "additionalProperties": true, + "description": "Attachment payload. Available fields vary by attachment file_type.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the attachment" + }, + "message_id": { + "type": "integer", + "description": "Id of the parent message" + }, + "file_type": { + "type": "string", + "enum": [ + "image", + "audio", + "video", + "file", + "location", + "fallback", + "share", + "story_mention", + "contact", + "ig_reel", + "ig_post", + "ig_story", + "embed" + ], + "description": "Type of the attached file" + }, + "account_id": { + "type": "integer", + "description": "Id of the account" + }, + "extension": { + "type": [ + "string", + "null" + ], + "description": "File extension" + }, + "data_url": { + "type": [ + "string", + "null" + ], + "description": "URL of the file. Can be null when an attachment variant has no external URL." + }, + "thumb_url": { + "type": "string", + "description": "URL of the file thumbnail" + }, + "file_size": { + "type": "integer", + "description": "File size in bytes" + }, + "width": { + "type": [ + "integer", + "null" + ], + "description": "Width of the attachment when available" + }, + "height": { + "type": [ + "integer", + "null" + ], + "description": "Height of the attachment when available" + }, + "coordinates_lat": { + "type": "number", + "description": "Latitude for location attachments" + }, + "coordinates_long": { + "type": "number", + "description": "Longitude for location attachments" + }, + "fallback_title": { + "type": [ + "string", + "null" + ], + "description": "Fallback title for location, fallback, and contact attachments when available" + }, + "meta": { "type": "object", - "description": "Details of the sender" + "description": "Metadata for contact attachments" + }, + "transcribed_text": { + "type": "string", + "description": "Transcribed text for audio attachments" + } + } + }, + "public_message_sender": { + "type": "object", + "additionalProperties": true, + "description": "Polymorphic sender payload returned by push_event_data. Available fields vary by sender type.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the sender" + }, + "name": { + "type": [ + "string", + "null" + ], + "description": "Name of the sender when available" + }, + "avatar_url": { + "type": "string", + "description": "Avatar URL of the sender. Present for senders of type user, agent_bot, and captain_assistant. Not present for contact senders (use thumbnail instead)." + }, + "thumbnail": { + "type": "string", + "description": "Avatar/thumbnail URL of the sender. Contact senders use this field; user senders may also include it." + }, + "type": { + "type": "string", + "enum": [ + "contact", + "user", + "agent_bot", + "captain_assistant" + ], + "description": "Type of the sender" + }, + "available_name": { + "type": [ + "string", + "null" + ], + "description": "Display name for user senders" + }, + "availability_status": { + "type": [ + "string", + "null" + ], + "description": "Availability status for user senders" + }, + "email": { + "type": [ + "string", + "null" + ], + "description": "Email of the sender when the sender is a contact" + }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the sender when the sender is a contact" + }, + "identifier": { + "type": [ + "string", + "null" + ], + "description": "Identifier of the sender when the sender is a contact" + }, + "blocked": { + "type": "boolean", + "description": "Whether the sender is blocked when the sender is a contact" + }, + "additional_attributes": { + "type": [ + "object", + "null" + ], + "description": "Additional attributes when the sender is a contact and available" + }, + "custom_attributes": { + "type": [ + "object", + "null" + ], + "description": "Custom attributes when the sender is a contact and available" + }, + "description": { + "type": [ + "string", + "null" + ], + "description": "Description when the sender is a captain assistant" + }, + "created_at": { + "type": [ + "string", + "null" + ], + "description": "Created timestamp in ISO 8601 format when the sender is a captain assistant" } } }, diff --git a/swagger/tag_groups/other_swagger.json b/swagger/tag_groups/other_swagger.json index 6c6d88176..50bf2212b 100644 --- a/swagger/tag_groups/other_swagger.json +++ b/swagger/tag_groups/other_swagger.json @@ -1937,19 +1937,163 @@ "description": "The session identifier of the contact" }, "name": { - "type": "string", - "description": "Name of the contact" + "type": [ + "string", + "null" + ], + "description": "Name of the contact when available" }, "email": { - "type": "string", + "type": [ + "string", + "null" + ], "description": "Email of the contact" }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the contact" + }, "pubsub_token": { "type": "string", "description": "The token to be used to connect to chatwoot websocket" } } }, + "public_contact_record": { + "type": "object", + "additionalProperties": true, + "description": "Full serialized contact record returned when the public API renders a Contact model directly.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the contact" + }, + "name": { + "type": [ + "string", + "null" + ], + "description": "Name of the contact when available" + }, + "email": { + "type": [ + "string", + "null" + ], + "description": "Email of the contact" + }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the contact" + }, + "identifier": { + "type": [ + "string", + "null" + ], + "description": "Identifier of the contact" + }, + "blocked": { + "type": "boolean", + "description": "Whether the contact is blocked" + }, + "additional_attributes": { + "type": [ + "object", + "null" + ], + "description": "Additional attributes of the contact when present" + }, + "custom_attributes": { + "type": [ + "object", + "null" + ], + "description": "Custom attributes of the contact when present" + }, + "contact_type": { + "type": [ + "string", + "null" + ], + "description": "Contact type of the contact when available" + }, + "country_code": { + "type": [ + "string", + "null" + ], + "description": "Country code of the contact" + }, + "last_activity_at": { + "type": [ + "string", + "null" + ], + "description": "Last activity timestamp of the contact in ISO 8601 format" + }, + "created_at": { + "type": [ + "string", + "null" + ], + "description": "Created timestamp of the contact in ISO 8601 format" + }, + "updated_at": { + "type": [ + "string", + "null" + ], + "description": "Updated timestamp of the contact in ISO 8601 format" + }, + "last_name": { + "type": [ + "string", + "null" + ], + "description": "Last name of the contact" + }, + "middle_name": { + "type": [ + "string", + "null" + ], + "description": "Middle name of the contact" + }, + "location": { + "type": [ + "string", + "null" + ], + "description": "Location of the contact" + }, + "account_id": { + "type": "integer", + "description": "Account id of the contact" + }, + "company_id": { + "type": [ + "integer", + "null" + ], + "description": "Company id of the contact" + }, + "label_list": { + "type": "array", + "description": "Labels applied to the contact", + "items": { + "type": "string" + } + } + } + }, "public_conversation": { "type": "object", "properties": { @@ -1957,20 +2101,41 @@ "type": "integer", "description": "Id of the conversation" }, - "inbox_id": { + "uuid": { "type": "string", + "description": "UUID of the conversation" + }, + "inbox_id": { + "type": "integer", "description": "The inbox id of the conversation" }, + "contact_last_seen_at": { + "type": "integer", + "description": "Timestamp of when the contact last seen the conversation (Unix timestamp)" + }, + "status": { + "type": "string", + "enum": [ + "open", + "resolved", + "pending", + "snoozed" + ], + "description": "The status of the conversation" + }, + "agent_last_seen_at": { + "type": "integer", + "description": "Timestamp of when the agent last seen the conversation (Unix timestamp)" + }, "messages": { "type": "array", "items": { - "$ref": "#/components/schemas/message" + "$ref": "#/components/schemas/public_message" }, "description": "Messages in the conversation" }, "contact": { - "type": "object", - "description": "The contact information associated to the conversation" + "$ref": "#/components/schemas/public_contact_record" } } }, @@ -1978,43 +2143,245 @@ "type": "object", "properties": { "id": { - "type": "string", + "type": "integer", "description": "Id of the message" }, "content": { - "type": "string", - "description": "Text content of the message" + "type": [ + "string", + "null" + ], + "description": "Text content of the message. Can be null for attachment-only messages." }, "message_type": { - "type": "string", - "description": "Denotes the message type" + "type": "integer", + "description": "Denotes the message type. Possible values: 0 (incoming), 1 (outgoing), 2 (activity), 3 (template)" }, "content_type": { "type": "string", "description": "Content type of the message" }, "content_attributes": { - "type": "string", + "type": "object", "description": "Additional content attributes of the message" }, "created_at": { - "type": "string", - "description": "Created at time stamp of the message" + "type": "integer", + "description": "Created at Unix timestamp of the message" }, "conversation_id": { - "type": "string", - "description": "Conversation Id of the message" + "type": "integer", + "description": "Display Id of the conversation the message belongs to" }, "attachments": { "type": "array", + "description": "Attachments if any", "items": { - "type": "object" - }, - "description": "Attachments if any" + "$ref": "#/components/schemas/public_message_attachment" + } }, "sender": { + "$ref": "#/components/schemas/public_message_sender" + } + } + }, + "public_message_attachment": { + "type": "object", + "additionalProperties": true, + "description": "Attachment payload. Available fields vary by attachment file_type.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the attachment" + }, + "message_id": { + "type": "integer", + "description": "Id of the parent message" + }, + "file_type": { + "type": "string", + "enum": [ + "image", + "audio", + "video", + "file", + "location", + "fallback", + "share", + "story_mention", + "contact", + "ig_reel", + "ig_post", + "ig_story", + "embed" + ], + "description": "Type of the attached file" + }, + "account_id": { + "type": "integer", + "description": "Id of the account" + }, + "extension": { + "type": [ + "string", + "null" + ], + "description": "File extension" + }, + "data_url": { + "type": [ + "string", + "null" + ], + "description": "URL of the file. Can be null when an attachment variant has no external URL." + }, + "thumb_url": { + "type": "string", + "description": "URL of the file thumbnail" + }, + "file_size": { + "type": "integer", + "description": "File size in bytes" + }, + "width": { + "type": [ + "integer", + "null" + ], + "description": "Width of the attachment when available" + }, + "height": { + "type": [ + "integer", + "null" + ], + "description": "Height of the attachment when available" + }, + "coordinates_lat": { + "type": "number", + "description": "Latitude for location attachments" + }, + "coordinates_long": { + "type": "number", + "description": "Longitude for location attachments" + }, + "fallback_title": { + "type": [ + "string", + "null" + ], + "description": "Fallback title for location, fallback, and contact attachments when available" + }, + "meta": { "type": "object", - "description": "Details of the sender" + "description": "Metadata for contact attachments" + }, + "transcribed_text": { + "type": "string", + "description": "Transcribed text for audio attachments" + } + } + }, + "public_message_sender": { + "type": "object", + "additionalProperties": true, + "description": "Polymorphic sender payload returned by push_event_data. Available fields vary by sender type.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the sender" + }, + "name": { + "type": [ + "string", + "null" + ], + "description": "Name of the sender when available" + }, + "avatar_url": { + "type": "string", + "description": "Avatar URL of the sender. Present for senders of type user, agent_bot, and captain_assistant. Not present for contact senders (use thumbnail instead)." + }, + "thumbnail": { + "type": "string", + "description": "Avatar/thumbnail URL of the sender. Contact senders use this field; user senders may also include it." + }, + "type": { + "type": "string", + "enum": [ + "contact", + "user", + "agent_bot", + "captain_assistant" + ], + "description": "Type of the sender" + }, + "available_name": { + "type": [ + "string", + "null" + ], + "description": "Display name for user senders" + }, + "availability_status": { + "type": [ + "string", + "null" + ], + "description": "Availability status for user senders" + }, + "email": { + "type": [ + "string", + "null" + ], + "description": "Email of the sender when the sender is a contact" + }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the sender when the sender is a contact" + }, + "identifier": { + "type": [ + "string", + "null" + ], + "description": "Identifier of the sender when the sender is a contact" + }, + "blocked": { + "type": "boolean", + "description": "Whether the sender is blocked when the sender is a contact" + }, + "additional_attributes": { + "type": [ + "object", + "null" + ], + "description": "Additional attributes when the sender is a contact and available" + }, + "custom_attributes": { + "type": [ + "object", + "null" + ], + "description": "Custom attributes when the sender is a contact and available" + }, + "description": { + "type": [ + "string", + "null" + ], + "description": "Description when the sender is a captain assistant" + }, + "created_at": { + "type": [ + "string", + "null" + ], + "description": "Created timestamp in ISO 8601 format when the sender is a captain assistant" } } }, diff --git a/swagger/tag_groups/platform_swagger.json b/swagger/tag_groups/platform_swagger.json index 4be91b8b2..f1e471e79 100644 --- a/swagger/tag_groups/platform_swagger.json +++ b/swagger/tag_groups/platform_swagger.json @@ -2698,19 +2698,163 @@ "description": "The session identifier of the contact" }, "name": { - "type": "string", - "description": "Name of the contact" + "type": [ + "string", + "null" + ], + "description": "Name of the contact when available" }, "email": { - "type": "string", + "type": [ + "string", + "null" + ], "description": "Email of the contact" }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the contact" + }, "pubsub_token": { "type": "string", "description": "The token to be used to connect to chatwoot websocket" } } }, + "public_contact_record": { + "type": "object", + "additionalProperties": true, + "description": "Full serialized contact record returned when the public API renders a Contact model directly.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the contact" + }, + "name": { + "type": [ + "string", + "null" + ], + "description": "Name of the contact when available" + }, + "email": { + "type": [ + "string", + "null" + ], + "description": "Email of the contact" + }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the contact" + }, + "identifier": { + "type": [ + "string", + "null" + ], + "description": "Identifier of the contact" + }, + "blocked": { + "type": "boolean", + "description": "Whether the contact is blocked" + }, + "additional_attributes": { + "type": [ + "object", + "null" + ], + "description": "Additional attributes of the contact when present" + }, + "custom_attributes": { + "type": [ + "object", + "null" + ], + "description": "Custom attributes of the contact when present" + }, + "contact_type": { + "type": [ + "string", + "null" + ], + "description": "Contact type of the contact when available" + }, + "country_code": { + "type": [ + "string", + "null" + ], + "description": "Country code of the contact" + }, + "last_activity_at": { + "type": [ + "string", + "null" + ], + "description": "Last activity timestamp of the contact in ISO 8601 format" + }, + "created_at": { + "type": [ + "string", + "null" + ], + "description": "Created timestamp of the contact in ISO 8601 format" + }, + "updated_at": { + "type": [ + "string", + "null" + ], + "description": "Updated timestamp of the contact in ISO 8601 format" + }, + "last_name": { + "type": [ + "string", + "null" + ], + "description": "Last name of the contact" + }, + "middle_name": { + "type": [ + "string", + "null" + ], + "description": "Middle name of the contact" + }, + "location": { + "type": [ + "string", + "null" + ], + "description": "Location of the contact" + }, + "account_id": { + "type": "integer", + "description": "Account id of the contact" + }, + "company_id": { + "type": [ + "integer", + "null" + ], + "description": "Company id of the contact" + }, + "label_list": { + "type": "array", + "description": "Labels applied to the contact", + "items": { + "type": "string" + } + } + } + }, "public_conversation": { "type": "object", "properties": { @@ -2718,20 +2862,41 @@ "type": "integer", "description": "Id of the conversation" }, - "inbox_id": { + "uuid": { "type": "string", + "description": "UUID of the conversation" + }, + "inbox_id": { + "type": "integer", "description": "The inbox id of the conversation" }, + "contact_last_seen_at": { + "type": "integer", + "description": "Timestamp of when the contact last seen the conversation (Unix timestamp)" + }, + "status": { + "type": "string", + "enum": [ + "open", + "resolved", + "pending", + "snoozed" + ], + "description": "The status of the conversation" + }, + "agent_last_seen_at": { + "type": "integer", + "description": "Timestamp of when the agent last seen the conversation (Unix timestamp)" + }, "messages": { "type": "array", "items": { - "$ref": "#/components/schemas/message" + "$ref": "#/components/schemas/public_message" }, "description": "Messages in the conversation" }, "contact": { - "type": "object", - "description": "The contact information associated to the conversation" + "$ref": "#/components/schemas/public_contact_record" } } }, @@ -2739,43 +2904,245 @@ "type": "object", "properties": { "id": { - "type": "string", + "type": "integer", "description": "Id of the message" }, "content": { - "type": "string", - "description": "Text content of the message" + "type": [ + "string", + "null" + ], + "description": "Text content of the message. Can be null for attachment-only messages." }, "message_type": { - "type": "string", - "description": "Denotes the message type" + "type": "integer", + "description": "Denotes the message type. Possible values: 0 (incoming), 1 (outgoing), 2 (activity), 3 (template)" }, "content_type": { "type": "string", "description": "Content type of the message" }, "content_attributes": { - "type": "string", + "type": "object", "description": "Additional content attributes of the message" }, "created_at": { - "type": "string", - "description": "Created at time stamp of the message" + "type": "integer", + "description": "Created at Unix timestamp of the message" }, "conversation_id": { - "type": "string", - "description": "Conversation Id of the message" + "type": "integer", + "description": "Display Id of the conversation the message belongs to" }, "attachments": { "type": "array", + "description": "Attachments if any", "items": { - "type": "object" - }, - "description": "Attachments if any" + "$ref": "#/components/schemas/public_message_attachment" + } }, "sender": { + "$ref": "#/components/schemas/public_message_sender" + } + } + }, + "public_message_attachment": { + "type": "object", + "additionalProperties": true, + "description": "Attachment payload. Available fields vary by attachment file_type.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the attachment" + }, + "message_id": { + "type": "integer", + "description": "Id of the parent message" + }, + "file_type": { + "type": "string", + "enum": [ + "image", + "audio", + "video", + "file", + "location", + "fallback", + "share", + "story_mention", + "contact", + "ig_reel", + "ig_post", + "ig_story", + "embed" + ], + "description": "Type of the attached file" + }, + "account_id": { + "type": "integer", + "description": "Id of the account" + }, + "extension": { + "type": [ + "string", + "null" + ], + "description": "File extension" + }, + "data_url": { + "type": [ + "string", + "null" + ], + "description": "URL of the file. Can be null when an attachment variant has no external URL." + }, + "thumb_url": { + "type": "string", + "description": "URL of the file thumbnail" + }, + "file_size": { + "type": "integer", + "description": "File size in bytes" + }, + "width": { + "type": [ + "integer", + "null" + ], + "description": "Width of the attachment when available" + }, + "height": { + "type": [ + "integer", + "null" + ], + "description": "Height of the attachment when available" + }, + "coordinates_lat": { + "type": "number", + "description": "Latitude for location attachments" + }, + "coordinates_long": { + "type": "number", + "description": "Longitude for location attachments" + }, + "fallback_title": { + "type": [ + "string", + "null" + ], + "description": "Fallback title for location, fallback, and contact attachments when available" + }, + "meta": { "type": "object", - "description": "Details of the sender" + "description": "Metadata for contact attachments" + }, + "transcribed_text": { + "type": "string", + "description": "Transcribed text for audio attachments" + } + } + }, + "public_message_sender": { + "type": "object", + "additionalProperties": true, + "description": "Polymorphic sender payload returned by push_event_data. Available fields vary by sender type.", + "properties": { + "id": { + "type": "integer", + "description": "Id of the sender" + }, + "name": { + "type": [ + "string", + "null" + ], + "description": "Name of the sender when available" + }, + "avatar_url": { + "type": "string", + "description": "Avatar URL of the sender. Present for senders of type user, agent_bot, and captain_assistant. Not present for contact senders (use thumbnail instead)." + }, + "thumbnail": { + "type": "string", + "description": "Avatar/thumbnail URL of the sender. Contact senders use this field; user senders may also include it." + }, + "type": { + "type": "string", + "enum": [ + "contact", + "user", + "agent_bot", + "captain_assistant" + ], + "description": "Type of the sender" + }, + "available_name": { + "type": [ + "string", + "null" + ], + "description": "Display name for user senders" + }, + "availability_status": { + "type": [ + "string", + "null" + ], + "description": "Availability status for user senders" + }, + "email": { + "type": [ + "string", + "null" + ], + "description": "Email of the sender when the sender is a contact" + }, + "phone_number": { + "type": [ + "string", + "null" + ], + "description": "Phone number of the sender when the sender is a contact" + }, + "identifier": { + "type": [ + "string", + "null" + ], + "description": "Identifier of the sender when the sender is a contact" + }, + "blocked": { + "type": "boolean", + "description": "Whether the sender is blocked when the sender is a contact" + }, + "additional_attributes": { + "type": [ + "object", + "null" + ], + "description": "Additional attributes when the sender is a contact and available" + }, + "custom_attributes": { + "type": [ + "object", + "null" + ], + "description": "Custom attributes when the sender is a contact and available" + }, + "description": { + "type": [ + "string", + "null" + ], + "description": "Description when the sender is a captain assistant" + }, + "created_at": { + "type": [ + "string", + "null" + ], + "description": "Created timestamp in ISO 8601 format when the sender is a captain assistant" } } },