---
canonical_url: "https://docs.composio.dev/toolkits/kommunicate"
markdown_url: "https://docs.composio.dev/toolkits/kommunicate.md"
product: "platform"
version: null
last_updated: null
---

# Kommunicate

Kommunicate is a customer support platform for managing conversations, users, messages, and agent assignments across human and AI support workflows.

- **Category:** communication
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 6
- **Triggers:** 0
- **Slug:** `KOMMUNICATE`
- **Version:** 00000000_00

## Tools

### Change Conversation Assignee

**Slug:** `KOMMUNICATE_CHANGE_CONVERSATION_ASSIGNEE`

Assign one Kommunicate conversation to a human agent, changing live routing. By default, this sends a user-visible notification that cannot be undone; it can also remove all AI agents when take_over_from_bot=true.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `actor_user_id` | string | Yes | Kommunicate user ID performing the assignment; sent as the Of-User-Id header. |
| `conversation_id` | integer | Yes | Numeric Kommunicate conversation/group ID whose assignee will change. |
| `assignee_user_id` | string | Yes | Human-agent ID to assign, documented by Kommunicate as the agent's email address. |
| `send_notification` | boolean | No | Whether to send a user-visible notification message about the assignment. Defaults to true; set false to assign silently. |
| `take_over_from_bot` | boolean | No | Whether to remove all AI agents from the conversation while assigning the human agent. Defaults to false; removal may disrupt active bot handling. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Change Conversation Status

**Slug:** `KOMMUNICATE_CHANGE_CONVERSATION_STATUS`

Change one Kommunicate conversation to open, closed, or spam. By default, this also sends a user-visible notification message, which cannot be undone; set send_notification=false to suppress it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("open" | "closed" | "spam") | Yes | New conversation status: open, closed, or spam. |
| `actor_user_id` | string | Yes | Kommunicate user ID performing the status change; sent as the Of-User-Id header. |
| `conversation_id` | integer | Yes | Numeric Kommunicate conversation/group ID whose status will change. |
| `send_notification` | boolean | No | Whether to send a user-visible notification message about the status change. Defaults to true; set false to change status silently. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Conversation

**Slug:** `KOMMUNICATE_CREATE_CONVERSATION`

Create a persistent Kommunicate conversation with the specified members. This can create missing users, add account-default bots or assignees, and cannot be undone through this toolkit; provider business errors are treated as failures even when returned with HTTP 2xx.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip_routing` | boolean | No | Whether to skip normal conversation routing. Account defaults may still add a bot or assignee. |
| `member_user_ids` | array | Yes | Non-empty list of user, human-agent, or AI-agent IDs to add. Missing user IDs may be created automatically. |
| `conversation_name` | string | Yes | Requested conversation title. Kommunicate may return a different name based on account behavior. |
| `client_conversation_id` | integer | No | Optional caller-generated unique conversation ID. Kommunicate generates one when omitted. |
| `conversation_assignee_user_id` | string | No | Optional initial assignee ID. Allowed only when skip_routing is true and the ID is included in member_user_ids. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Details

**Slug:** `KOMMUNICATE_GET_USER_DETAILS`

Return details for one or more specified Kommunicate user IDs. Requires a non-empty user list and fails on provider business errors even when the HTTP response is successful.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_ids` | array | Yes | Non-empty list of Kommunicate user IDs to retrieve. Unknown IDs are omitted from the result. |
| `fetch_latest_message_time` | boolean | No | Whether to request each user's latest message timestamp. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Message

**Slug:** `KOMMUNICATE_SEND_MESSAGE`

Immediately send one plain-text message to a Kommunicate conversation as a specified user. This is a user-visible, irreversible side effect. Rich messages and attachments are not supported.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | Yes | Plain-text message to send. |
| `skip_bot` | boolean | No | Whether to prevent Kommunicate's bot from responding to this message. Defaults to false. |
| `sender_user_id` | string | Yes | Kommunicate user ID to record as the message sender. |
| `conversation_id` | string | Yes | Immutable Kommunicate conversation/group ID that will receive the message. |
| `client_conversation_id` | string | No | Optional client-generated conversation ID when the conversation has one. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update User Details

**Slug:** `KOMMUNICATE_UPDATE_USER_DETAILS`

Update selected profile fields for one explicitly identified non-agent Kommunicate user. This mutates persistent user data and fails on provider business errors even when the HTTP response is successful.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | New email address for the user. |
| `user_id` | string | Yes | ID of the non-agent Kommunicate user whose details will be updated; sent as the Of-User-Id header. |
| `metadata` | object | No | Arbitrary user metadata visible to dashboard agents. |
| `image_url` | string | No | New HTTP or HTTPS profile image URL for the user. |
| `display_name` | string | No | New display name for the user. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |