Conversations
Create New Conversation
Creating a conversation in Evolution requires a source id.
Learn more about source_id: https://evoai.app/hc/user-guide/articles/1677839703-how-to-create-an-api-channel-inbox#send-messages-to-the-api-channel
POST
/
api
/
v1
/
conversations
{
"success": true,
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"account_id": "123e4567-e89b-12d3-a456-426614174000",
"inbox_id": "660e8400-e29b-41d4-a716-446655440001"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z"
},
"message": "Conversation created successfully"
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/conversations",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "INVALID_TOKEN",
"message": "Invalid or missing authentication token"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/conversations",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "FORBIDDEN",
"message": "Access denied"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/conversations",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/conversations",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Validation failed",
"details": {
"source_id": [
"Source ID is required"
]
}
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/conversations",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "INTERNAL_ERROR",
"message": "An internal server error occurred"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/conversations",
"method": "POST"
}
}Authorizations
Body
application/json
The body is of type any.
⌘I
{
"success": true,
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"account_id": "123e4567-e89b-12d3-a456-426614174000",
"inbox_id": "660e8400-e29b-41d4-a716-446655440001"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z"
},
"message": "Conversation created successfully"
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/conversations",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "INVALID_TOKEN",
"message": "Invalid or missing authentication token"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/conversations",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "FORBIDDEN",
"message": "Access denied"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/conversations",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/conversations",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Validation failed",
"details": {
"source_id": [
"Source ID is required"
]
}
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/conversations",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "INTERNAL_ERROR",
"message": "An internal server error occurred"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/conversations",
"method": "POST"
}
}