POST /conversations

This endpoint is used to create a conversation entry in the BodyShop Booster system.

A conversation entry is an element within the Repair Record history - for example, a text message from a customer, a text message to a customer, the detail of an assignment used to create or update a record, a set of photos received as part of a customer completing a damage assessment tool, etc - basically any sort of communication. It also includes internal notes for example communication within the body shop.

Using this endpoint allows external systems to add conversation entries related to a repair, including text, images, audio, and video content, which will be visible within the repair conversation history. Note that the conversation history is visible by various AI powered tools, for example the texting agent that responds to customer enquiries.

Environment	Region	URL	Documentation

Environment	Region	URL	Documentation
Staging	US	`https://stg.us-east-1.api.bodyshopbooster.com/open-api/v1/conversations`	`https://stg.us-east-1.api.bodyshopbooster.com/open-api/swagger`
	Canada	`https://stg.ca-central-1.api.bodyshopbooster.com/open-api/v1/conversations`	`https://stg.ca-central-1.api.bodyshopbooster.com/open-api/swagger`
Production	US	`https://us-east-1.api.bodyshopbooster.com/open-api/v1/conversations`	`https://us-east-1.api.bodyshopbooster.com/open-api/swagger`
	Canada	`https://ca-central-1.api.bodyshopbooster.com/open-api/v1/conversations`	`https://ca-central-1.api.bodyshopbooster.com/open-api/swagger`

Request Payload

Required Fields

repairId : Unique identifier for the repair record.
cardType : The type of the card (Eg: CONVERSATION)
cardInfo : The information related to the card (Eg: Text, Image URLs, Audio URLs & Video URLs)

Following are the values accepted for cardType

CONVERSATION

{
  "repairId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "cardType": "CONVERSATION",
  "cardInfo": {
    "text": "Customer confirmed drop-off time for Feb 15 at 9:00 AM.",
    "imageUrls": [
      "https://example.com/uploads/photo1.jpg",
      "https://example.com/uploads/photo2.jpg"
    ],
    "audioUrls": [],
    "videoUrls": []
  }
}