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->Chatwoot
inbox
: 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
}