Send a message
To initiate a chat, do not provide a sessionId nor a message.
Continue the conversation by providing the sessionId and the message that should answer the previous question.
Set the isPreview option to true to chat with the non-published version of the typebot.
| Request Body  —  REQUIRED | 
|---|
| messagestringThe answer to the previous chat input. Do not provide it if you are starting a new chat. | 
| sessionIdstringSession ID that you get from the initial chat request to a bot. If not provided, it will create a new session. | 
| startParamsobject| typebot—  REQUIRED |  | isPreviewbooleanIf set to true, it will start a Preview session with the unpublished bot and it won't be saved in the Results tab. You need to be authenticated for this to work. |  | resultIdstringProvide it if you'd like to overwrite an existing result. |  | startGroupIdstringStart chat from a specific group. |  | prefilledVariablesobject | 
 | 
| Responses | 
|---|
| | Schema | 
|---|
 | messagesobject[] |  | inputobject| prefilledValuestring |  | runtimeOptionsobject| paymentIntentSecretstring |  | amountLabelstring |  | publicKeystring | 
 | 
 |  | clientSideActionsobject[] |  | sessionIdstring |  | typebotobject| idstring |  | themeobject| generalobject| fontstring |  | backgroundobject| typestringPossible values: [Color,Image,None] |  | contentstring | 
 | 
 |  | chatobject| hostAvatarobject| isEnabledboolean |  | urlstring | 
 |  | guestAvatarobject| isEnabledboolean |  | urlstring | 
 |  | hostBubblesobject| backgroundColorstring |  | colorstring | 
 |  | guestBubblesobject| backgroundColorstring |  | colorstring | 
 |  | buttonsobject| backgroundColorstring |  | colorstring | 
 |  | inputsobject| backgroundColorstring |  | colorstring |  | placeholderColorstring | 
 |  | roundnessstringPossible values: [none,medium,large] | 
 |  | customCssstring | 
 |  | settingsobject| generalobject| isBrandingEnabledboolean |  | isTypingEmulationEnabledboolean |  | isInputPrefillEnabledboolean |  | isHideQueryParamsEnabledboolean |  | isNewResultOnRefreshEnabledboolean | 
 |  | typingEmulationobject| enabledboolean |  | speednumber |  | maxDelaynumber | 
 |  | metadataobject| titlestring |  | descriptionstring |  | imageUrlstring |  | favIconUrlstring |  | customHeadCodestring |  | googleTagManagerIdstring | 
 | 
 | 
 |  | resultIdstring |  | dynamicThemeobject| hostAvatarUrlstring |  | guestAvatarUrlstring | 
 |  | logsobject[]| statusstring |  | descriptionstring |  | details | 
 | 
 | 
| | Schema | 
|---|
 | messagestring |  | codestring |  | issuesobject[] | 
 |