Set Integration
POST/api/v2/instance/:instanceId/chatwoot-integration
Set Integration
Request
Path Parameters
ID of the instance.
- application/json
Body
required
Objective:
This endpoint is used to configure the integration between a specific instance and Chatwoot, allowing control over various aspects of the integration.
Request Body:
accountId: Identifier for the Chatwoot account.- Type: String or Integer
- Required
enabled: Determines if the integration is enabled or not.- Type: Boolean
- Default:
true - Required: No
chatwootURL: URL of the Chatwoot frontend.- Type: String (URL)
- Required
chatwootAccessToken: Access token for the Chatwoot account.- Type: String
- Required
n8nWebhook: Webhook do fluxo de trabalhoCodeChat->Chatwootinbox: Inbox ID created in chatwoot.integrationOptions: Object with additional integration options.enabledGroup: Defines if group messages should be sent to Chatwoot.- Type: Boolean
- Default:
false - Required: No
displayAttendant: Enables the display of the attendant's name in the message header.- Type: Boolean
- Required: No
startConversationAs: Determines how a new conversation should start.- Type: String
- Possible Values:
open,pending - Default:
open - Required: No
Default value: true
Url of your chatwoot access
Access token for your chatwoot account
Workflow webhook.
integrationOptions object
Default value: false
Enables the exchange of messages with groups
Default value: true
Enable the display of the attendant's name in the message caput.
Possible values: [pending, open]
Default value: open
Define how you will start new conversations on Chatwoot.
Responses
- 201
- 400
- 401
- 403
- 404
Success - status: 201
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [pending, open]
{
"integrationId": "string",
"enabled": true,
"accountId": 0,
"inboxId": 0,
"chatwootURL": "string",
"chatwootAccessToken": "string",
"enabledGroup": true,
"displayAttendant": true,
"startConversationAs": "pending",
"createdAt": "2025-06-12T13:21:06.572Z",
"updatedAt": "2025-06-12T13:21:06.572Z",
"deletedAt": "2025-06-12T13:21:06.572Z",
"instanceInstanceId": "string",
"n8nWebhook": "string",
"query": "string"
}
BadRequestException
- application/json
- Schema
- Example (from schema)
Schema
Default value: string,[object Object]
{
"message": [
"string"
],
"error": "string",
"statusCode": 0
}
UnauthorizedException
- application/json
- Schema
- Example (from schema)
Schema
Default value: string,[object Object]
{
"message": [
"string"
],
"error": "string",
"statusCode": 0
}
ForbiddenException
- application/json
- Schema
- Example (from schema)
Schema
Default value: string,[object Object]
{
"message": [
"string"
],
"error": "string",
"statusCode": 0
}
NotFoundException
- application/json
- Schema
- Example (from schema)
Schema
Default value: string,[object Object]
{
"message": [
"string"
],
"error": "string",
"statusCode": 0
}