Thank you for your help!
", "bodyMarkdown": "Thank you for your help!", "author": { "type": "customer", "id": "676f0f6765bdaa7d7d760f88", "name": "John Doe", "email": "john@example.com" }, "channel": "desktop", "createdAt": "2025-01-15T10:40:00.000Z", "updatedAt": "2025-01-15T10:40:00.000Z" } ``` ### Version Availability This endpoint is only available in API version 2026-01-01.nova and newer. ### Path Parameters - `id: string` Conversation ID (short ID) ### Header Parameters - `"Featurebase-Version": optional "2026-01-01.nova" or "2025-12-12.clover"` - `"2026-01-01.nova"` - `"2025-12-12.clover"` ### Body Parameters - `body: object { bodyMarkdown, messageType, type, 3 more } or object { id, bodyMarkdown, messageType, 2 more }` Reply from a customer or lead - `Contact object { bodyMarkdown, messageType, type, 3 more }` Reply from a customer or lead - `bodyMarkdown: string` The content of the reply message in markdown format. Images referenced by URL or as base64 data URIs will be automatically uploaded and stored. - `messageType: "reply"` The type of message. Always "reply" for contact replies. - `"reply"` - `type: "contact"` The type of author. Use "contact" for customer/lead replies. - `"contact"` - `id: optional string` The Featurebase contact ID - `skipNotifications: optional boolean` Skip sending notifications (default: false). Useful for bulk imports. - `userId: optional string` The external user ID from your system - `Admin object { id, bodyMarkdown, messageType, 2 more }` Reply or internal note from an admin - `id: string` The Featurebase admin ID - `bodyMarkdown: string` The content of the reply message in markdown format. Images referenced by URL or as base64 data URIs will be automatically uploaded and stored. - `messageType: "reply" or "note"` The type of message. "reply" is visible to the customer, "note" is an internal note only visible to admins. - `"reply"` - `"note"` - `type: "admin"` The type of author. Use "admin" for admin replies. - `"admin"` - `skipNotifications: optional boolean` Skip sending notifications (default: false). Useful for bulk imports. ### Returns - `ConversationPart = object { id, bodyHtml, bodyMarkdown, 8 more } or object { id, bodyHtml, bodyMarkdown, 8 more } or object { id, bodyHtml, bodyMarkdown, 7 more } or 14 more` Message from a customer or lead - `UserMsg object { id, bodyHtml, bodyMarkdown, 8 more }` Message from a customer or lead - `id: string` Unique part identifier - `bodyHtml: string` Message body content as HTML with signed image URLs - `bodyMarkdown: string` Message body content as markdown - `channel: "unknown" or "desktop" or "android" or 2 more` Channel through which the message was sent - `"unknown"` - `"desktop"` - `"android"` - `"ios"` - `"email"` - `createdAt: string` ISO timestamp when the part was created - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "user_msg"` User message type - `"user_msg"` - `updatedAt: string` ISO timestamp when the part was last updated - `author: optional ConversationPartAuthor` - `id: string` Author ID - `type: "customer" or "lead" or "admin" or 3 more` Type of author - `"customer"` - `"lead"` - `"admin"` - `"bot"` - `"guest"` - `"integration"` - `email: optional string` Author email address - `name: optional string` Author display name - `profilePicture: optional string` Author profile picture URL - `redacted: optional boolean` Whether this message has been redacted - `tagApplications: optional array of ConversationTagApplication` Reply-level tag applications and provenance for this conversation part - `appliedAt: string` ISO timestamp when the tag was applied to this reply - `tagId: string` Identifier of the applied tag - `appliedBy: optional ConversationTagMutationActor` Actor that applied the tag - `type: "admin" or "customer" or "lead" or 4 more` Actor that caused the tag mutation - `"admin"` - `"customer"` - `"lead"` - `"bot"` - `"integration"` - `"system"` - `"workflow"` - `id: optional string` Actor identifier when available - `name: optional string` Actor display name when available - `removedAt: optional string` ISO timestamp when the tag was removed from this reply, if it was removed - `removedBy: optional ConversationTagMutationActor` Actor that applied the tag - `tag: optional ConversationTag` Resolved tag object when the tag still exists in the shared workspace catalog - `id: string` Unique tag identifier - `name: string` Current tag name - `type: "tag"` Object type identifier for a tag - `"tag"` - `AdminMsg object { id, bodyHtml, bodyMarkdown, 8 more }` Message from an admin or support agent - `id: string` Unique part identifier - `bodyHtml: string` Message body content as HTML with signed image URLs - `bodyMarkdown: string` Message body content as markdown - `channel: "unknown" or "desktop" or "android" or 2 more` Channel through which the message was sent - `"unknown"` - `"desktop"` - `"android"` - `"ios"` - `"email"` - `createdAt: string` ISO timestamp when the part was created - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "admin_msg"` Admin message type - `"admin_msg"` - `updatedAt: string` ISO timestamp when the part was last updated - `author: optional ConversationPartAuthor` - `redacted: optional boolean` Whether this message has been redacted - `tagApplications: optional array of ConversationTagApplication` Reply-level tag applications and provenance for this conversation part - `appliedAt: string` ISO timestamp when the tag was applied to this reply - `tagId: string` Identifier of the applied tag - `appliedBy: optional ConversationTagMutationActor` Actor that applied the tag - `removedAt: optional string` ISO timestamp when the tag was removed from this reply, if it was removed - `removedBy: optional ConversationTagMutationActor` Actor that applied the tag - `tag: optional ConversationTag` Resolved tag object when the tag still exists in the shared workspace catalog - `AdminNote object { id, bodyHtml, bodyMarkdown, 7 more }` Internal note visible only to admins - `id: string` Unique part identifier - `bodyHtml: string` Note body content as HTML with signed image URLs - `bodyMarkdown: string` Note body content as markdown - `createdAt: string` ISO timestamp when the part was created - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "admin_note"` Admin internal note type - `"admin_note"` - `updatedAt: string` ISO timestamp when the part was last updated - `author: optional ConversationPartAuthor` - `redacted: optional boolean` Whether this message has been redacted - `tagApplications: optional array of ConversationTagApplication` Reply-level tag applications and provenance for this conversation part - `appliedAt: string` ISO timestamp when the tag was applied to this reply - `tagId: string` Identifier of the applied tag - `appliedBy: optional ConversationTagMutationActor` Actor that applied the tag - `removedAt: optional string` ISO timestamp when the tag was removed from this reply, if it was removed - `removedBy: optional ConversationTagMutationActor` Actor that applied the tag - `tag: optional ConversationTag` Resolved tag object when the tag still exists in the shared workspace catalog - `EmailMsg object { id, bodyHtml, bodyMarkdown, 8 more }` Message sent via email - `id: string` Unique part identifier - `bodyHtml: string` Email body content as HTML with signed image URLs - `bodyMarkdown: string` Email body content as markdown - `channel: "email"` Email channel - `"email"` - `createdAt: string` ISO timestamp when the part was created - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "email_msg"` Email message type - `"email_msg"` - `updatedAt: string` ISO timestamp when the part was last updated - `author: optional ConversationPartAuthor` - `redacted: optional boolean` Whether this message has been redacted - `tagApplications: optional array of ConversationTagApplication` Reply-level tag applications and provenance for this conversation part - `appliedAt: string` ISO timestamp when the tag was applied to this reply - `tagId: string` Identifier of the applied tag - `appliedBy: optional ConversationTagMutationActor` Actor that applied the tag - `removedAt: optional string` ISO timestamp when the tag was removed from this reply, if it was removed - `removedBy: optional ConversationTagMutationActor` Actor that applied the tag - `tag: optional ConversationTag` Resolved tag object when the tag still exists in the shared workspace catalog - `BotMsg object { id, bodyHtml, bodyMarkdown, 8 more }` Automated message from AI or bot - `id: string` Unique part identifier - `bodyHtml: string` Bot message body content as HTML with signed image URLs - `bodyMarkdown: string` Bot message body content as markdown - `createdAt: string` ISO timestamp when the part was created - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "bot_msg"` Bot message type - `"bot_msg"` - `updatedAt: string` ISO timestamp when the part was last updated - `author: optional ConversationPartAuthor` - `channel: optional "unknown" or "desktop" or "android" or 2 more` Channel through which the message was sent - `"unknown"` - `"desktop"` - `"android"` - `"ios"` - `"email"` - `redacted: optional boolean` Whether this message has been redacted - `tagApplications: optional array of ConversationTagApplication` Reply-level tag applications and provenance for this conversation part - `appliedAt: string` ISO timestamp when the tag was applied to this reply - `tagId: string` Identifier of the applied tag - `appliedBy: optional ConversationTagMutationActor` Actor that applied the tag - `removedAt: optional string` ISO timestamp when the tag was removed from this reply, if it was removed - `removedBy: optional ConversationTagMutationActor` Actor that applied the tag - `tag: optional ConversationTag` Resolved tag object when the tag still exists in the shared workspace catalog - `QuickReplyOpts object { id, createdAt, object, 6 more }` Presents options for user to choose from - `id: string` Unique part identifier - `createdAt: string` ISO timestamp when the part was created - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "quick_reply_opts"` Quick reply options type - `"quick_reply_opts"` - `replyOptions: array of object { id, text }` Available reply options - `id: string` Option ID - `text: string` Option text - `updatedAt: string` ISO timestamp when the part was last updated - `author: optional ConversationPartAuthor` - `redacted: optional boolean` Whether this message has been redacted - `tagApplications: optional array of ConversationTagApplication` Reply-level tag applications and provenance for this conversation part - `appliedAt: string` ISO timestamp when the tag was applied to this reply - `tagId: string` Identifier of the applied tag - `appliedBy: optional ConversationTagMutationActor` Actor that applied the tag - `removedAt: optional string` ISO timestamp when the tag was removed from this reply, if it was removed - `removedBy: optional ConversationTagMutationActor` Actor that applied the tag - `tag: optional ConversationTag` Resolved tag object when the tag still exists in the shared workspace catalog - `QuickReplyResp object { id, bodyHtml, bodyMarkdown, 8 more }` User's selection from quick reply options - `id: string` Unique part identifier - `bodyHtml: string` The selected option text as HTML - `bodyMarkdown: string` The selected option text as markdown - `createdAt: string` ISO timestamp when the part was created - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "quick_reply_resp"` Quick reply response type - `"quick_reply_resp"` - `selectedOptionId: string` ID of the selected option - `updatedAt: string` ISO timestamp when the part was last updated - `author: optional ConversationPartAuthor` - `redacted: optional boolean` Whether this message has been redacted - `tagApplications: optional array of ConversationTagApplication` Reply-level tag applications and provenance for this conversation part - `appliedAt: string` ISO timestamp when the tag was applied to this reply - `tagId: string` Identifier of the applied tag - `appliedBy: optional ConversationTagMutationActor` Actor that applied the tag - `removedAt: optional string` ISO timestamp when the tag was removed from this reply, if it was removed - `removedBy: optional ConversationTagMutationActor` Actor that applied the tag - `tag: optional ConversationTag` Resolved tag object when the tag still exists in the shared workspace catalog - `RatingRequested object { id, createdAt, csat, 3 more }` Represents a persisted CSAT request in the conversation thread - `id: string` Unique part identifier - `createdAt: string` ISO timestamp when the part was created - `csat: object { channel, requestedAt, requestId, 7 more }` Canonical CSAT request payload for this thread event - `channel: "desktop" or "email"` Channel used for the CSAT request - `"desktop"` - `"email"` - `requestedAt: string` ISO timestamp when the request was created - `requestId: string` Canonical CSAT request ID - `requestSource: "workflow"` Source that created the CSAT request - `"workflow"` - `status: "pending" or "rated" or "canceled" or "expired"` Status of the CSAT request represented by this part - `"pending"` - `"rated"` - `"canceled"` - `"expired"` - `changeLockWindowEndsAt: optional string` ISO timestamp after which changing the rating is no longer allowed - `expiredAt: optional string` ISO timestamp when the request expired, when applicable - `lateSubmitWindowEndsAt: optional string` ISO timestamp after which late submission is no longer allowed - `ratedAgent: optional CsatRatedAgent` - `type: "teammate" or "fibi" or "chatbot"` Type of agent the CSAT request is attributed to - `"teammate"` - `"fibi"` - `"chatbot"` - `id: optional string` Identifier of the rated agent when applicable - `workflow: optional CsatWorkflowLink` - `workflowActionId: optional string` Workflow action ID associated with the CSAT request - `workflowId: optional string` Workflow ID associated with the CSAT request - `workflowRunId: optional string` Workflow run ID associated with the CSAT request - `workflowStepId: optional string` Workflow step ID associated with the CSAT request - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "rating_requested"` CSAT rating requested part type - `"rating_requested"` - `updatedAt: string` ISO timestamp when the part was last updated - `RatingSubmitted object { id, createdAt, csat, 3 more }` Represents a persisted CSAT submission in the conversation thread - `id: string` Unique part identifier - `createdAt: string` ISO timestamp when the part was created - `csat: object { channel, ratedAt, requestId, 7 more }` Canonical CSAT submission payload for this thread event - `channel: "desktop" or "email"` Channel used for the CSAT request - `"desktop"` - `"email"` - `ratedAt: string` ISO timestamp when the customer submitted the rating - `requestId: string` Canonical CSAT request ID - `requestSource: "workflow"` Source that created the CSAT request - `"workflow"` - `score: number` CSAT score from 1 to 5 - `status: "rated"` Submitted ratings are always in the rated state - `"rated"` - `ratedAgent: optional CsatRatedAgent` - `remark: optional string` Optional remark left with the rating - `requestedAt: optional string` ISO timestamp when the request was created - `workflow: optional CsatWorkflowLink` - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "rating_submitted"` CSAT rating submitted part type - `"rating_submitted"` - `updatedAt: string` ISO timestamp when the part was last updated - `AttrPrompt object { id, createdAt, form, 6 more }` Requests information from user via form - `id: string` Unique part identifier - `createdAt: string` ISO timestamp when the part was created - `form: object { id, attributes }` Form configuration - `id: string` Form ID - `attributes: array of object { identifier, name, type }` Form fields - `identifier: string` Field identifier - `name: string` Field display name - `type: string` Field type - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "attr_prompt"` Attribute collection prompt type - `"attr_prompt"` - `updatedAt: string` ISO timestamp when the part was last updated - `author: optional ConversationPartAuthor` - `redacted: optional boolean` Whether this message has been redacted - `tagApplications: optional array of ConversationTagApplication` Reply-level tag applications and provenance for this conversation part - `appliedAt: string` ISO timestamp when the tag was applied to this reply - `tagId: string` Identifier of the applied tag - `appliedBy: optional ConversationTagMutationActor` Actor that applied the tag - `removedAt: optional string` ISO timestamp when the tag was removed from this reply, if it was removed - `removedBy: optional ConversationTagMutationActor` Actor that applied the tag - `tag: optional ConversationTag` Resolved tag object when the tag still exists in the shared workspace catalog - `AttrComplete object { id, createdAt, object, 2 more }` Indicates form was completed - `id: string` Unique part identifier - `createdAt: string` ISO timestamp when the part was created - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "attr_complete"` Attribute collection complete type - `"attr_complete"` - `updatedAt: string` ISO timestamp when the part was last updated - `Assign object { id, createdAt, object, 5 more }` Conversation assigned to admin or team - `id: string` Unique part identifier - `createdAt: string` ISO timestamp when the part was created - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "assign"` Assignment type - `"assign"` - `updatedAt: string` ISO timestamp when the part was last updated - `adminAssigneeId: optional string` ID of the admin assigned to the conversation - `adminAssignerId: optional string` ID of the admin who made the assignment - `teamAssigneeId: optional string` ID of the team assigned to the conversation - `Status object { id, createdAt, object, 4 more }` Conversation state changed (open/closed/snoozed) - `id: string` Unique part identifier - `createdAt: string` ISO timestamp when the part was created - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "status"` Status change type - `"status"` - `status: "open" or "closed" or "snoozed"` New conversation status - `"open"` - `"closed"` - `"snoozed"` - `updatedAt: string` ISO timestamp when the part was last updated - `snoozedUntil: optional string` ISO timestamp until conversation is snoozed (if snoozed) - `Tags object { id, action, createdAt, 8 more }` A tag was added to or removed from a specific reply - `id: string` Unique part identifier - `action: "added" or "removed"` Whether the tag was added or removed - `"added"` - `"removed"` - `createdAt: string` ISO timestamp when the part was created - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `occurredAt: string` ISO timestamp when the tag mutation occurred - `partType: "tags"` Tag update type - `"tags"` - `tagId: string` Identifier of the affected tag - `updatedAt: string` ISO timestamp when the part was last updated - `actor: optional ConversationTagMutationActor` Actor that applied the tag - `tagName: optional string` Tag name at the time of the event or the best available current display name - `targetPartId: optional string` Conversation part that the tag mutation targeted - `WorkflowWait object { id, createdAt, object, 3 more }` Represents a workflow wait start, finish, or interruption in the conversation thread - `id: string` Unique part identifier - `createdAt: string` ISO timestamp when the part was created - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "workflow_wait"` Workflow wait event part type - `"workflow_wait"` - `updatedAt: string` ISO timestamp when the part was last updated - `workflowWait: object { eventType, occurredAt, interruptedByUserType, 3 more }` Workflow wait event payload for this thread event - `eventType: "started" or "finished" or "interrupted"` Lifecycle stage of the workflow wait event - `"started"` - `"finished"` - `"interrupted"` - `occurredAt: string` ISO timestamp when the wait event occurred - `interruptedByUserType: optional "admin" or "customer" or "lead"` User type that interrupted the wait when applicable - `"admin"` - `"customer"` - `"lead"` - `waitLabel: optional string` Human-readable wait duration or preset label - `workflowId: optional string` Workflow ID associated with the wait event - `workflowName: optional string` Workflow display name at the time of the wait event - `Priority object { id, createdAt, isPriority, 3 more }` Conversation priority was updated - `id: string` Unique part identifier - `createdAt: string` ISO timestamp when the part was created - `isPriority: boolean` Whether the conversation is now marked as priority - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `partType: "priority"` Priority change type - `"priority"` - `updatedAt: string` ISO timestamp when the part was last updated - `PartAdd object { id, createdAt, object, 3 more }` New participant joined the conversation - `id: string` Unique part identifier - `createdAt: string` ISO timestamp when the part was created - `object: "conversation_part"` Object type identifier - `"conversation_part"` - `participant: object { id, type }` The added participant - `id: string` Participant ID - `type: "customer" or "lead" or "admin"` Participant type - `"customer"` - `"lead"` - `"admin"` - `partType: "part_add"` Participant added type - `"part_add"` - `updatedAt: string` ISO timestamp when the part was last updated ### Example ```http curl https://do.featurebase.app/v2/conversations/$ID/reply \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $FEATUREBASE_API_KEY" \ -d '{ "bodyMarkdown": "Thank you for your help!", "messageType": "reply", "type": "contact", "id": "676f0f6765bdaa7d7d760f88", "userId": "user_123" }' ``` #### Response ```json { "id": "1", "bodyHtml": "Hello, I have a question about your product.
", "bodyMarkdown": "Hello, I have a question about your product.", "channel": "desktop", "createdAt": "2025-01-15T10:30:00.000Z", "object": "conversation_part", "partType": "user_msg", "updatedAt": "2025-01-15T10:30:00.000Z", "author": { "id": "676f0f6765bdaa7d7d760f88", "type": "customer", "email": "john@example.com", "name": "John Doe", "profilePicture": "https://cdn.example.com/avatars/user.png" }, "redacted": false, "tagApplications": [ { "appliedAt": "2025-01-15T10:30:00.000Z", "tagId": "67ec1234abcd5678ef901234", "appliedBy": { "type": "admin", "id": "507f1f77bcf86cd799439011", "name": "John Doe" }, "removedAt": "2025-01-15T11:00:00.000Z", "removedBy": { "type": "admin", "id": "507f1f77bcf86cd799439011", "name": "John Doe" }, "tag": { "id": "67ec1234abcd5678ef901234", "name": "Churn", "type": "tag" } } ] } ```