> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Kommunicate

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

![Kommunicate logo](https://mintcdn.com/composio-preview/tIuAovF9-7pXq2wA/images/toolkits/kommunicate.svg?fit=max\&auto=format\&n=tIuAovF9-7pXq2wA\&q=85\&s=d13c89bb10a582242d72cdabcb8c2c29)

* **Category:** communication
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 6
* **Triggers:** 0
* **Slug:** `KOMMUNICATE`
* **Version:** 20261030\_00

## Tools

> [accordion] 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
>
> **actor\_user\_id** `string` *required*
>
> Kommunicate user ID performing the assignment; sent as the Of-User-Id header.
>
> **conversation\_id** `integer` *required*
>
> Numeric Kommunicate conversation/group ID whose assignee will change.
>
> **assignee\_user\_id** `string` *required*
>
> Human-agent ID to assign, documented by Kommunicate as the agent's email address.
>
> **send\_notification** `boolean`
>
> Whether to send a user-visible notification message about the assignment. Defaults to true; set false to assign silently.
>
> **take\_over\_from\_bot** `boolean`
>
> Whether to remove all AI agents from the conversation while assigning the human agent. Defaults to false; removal may disrupt active bot handling.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **status** `string ("open" | "closed" | "spam")` *required*
>
> New conversation status: open, closed, or spam.
>
> **actor\_user\_id** `string` *required*
>
> Kommunicate user ID performing the status change; sent as the Of-User-Id header.
>
> **conversation\_id** `integer` *required*
>
> Numeric Kommunicate conversation/group ID whose status will change.
>
> **send\_notification** `boolean`
>
> Whether to send a user-visible notification message about the status change. Defaults to true; set false to change status silently.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **skip\_routing** `boolean`
>
> Whether to skip normal conversation routing. Account defaults may still add a bot or assignee.
>
> **member\_user\_ids** `array` *required*
>
> Non-empty list of user, human-agent, or AI-agent IDs to add. Missing user IDs may be created automatically.
>
> **conversation\_name** `string` *required*
>
> Requested conversation title. Kommunicate may return a different name based on account behavior.
>
> **client\_conversation\_id** `integer`
>
> Optional caller-generated unique conversation ID. Kommunicate generates one when omitted.
>
> **conversation\_assignee\_user\_id** `string`
>
> Optional initial assignee ID. Allowed only when skip\_routing is true and the ID is included in member\_user\_ids.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **user\_ids** `array` *required*
>
> Non-empty list of Kommunicate user IDs to retrieve. Unknown IDs are omitted from the result.
>
> **fetch\_latest\_message\_time** `boolean`
>
> Whether to request each user's latest message timestamp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **message** `string` *required*
>
> Plain-text message to send.
>
> **skip\_bot** `boolean`
>
> Whether to prevent Kommunicate's bot from responding to this message. Defaults to false.
>
> **sender\_user\_id** `string` *required*
>
> Kommunicate user ID to record as the message sender.
>
> **conversation\_id** `string` *required*
>
> Immutable Kommunicate conversation/group ID that will receive the message.
>
> **client\_conversation\_id** `string`
>
> Optional client-generated conversation ID when the conversation has one.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **email** `string`
>
> New email address for the user.
>
> **user\_id** `string` *required*
>
> ID of the non-agent Kommunicate user whose details will be updated; sent as the Of-User-Id header.
>
> **metadata** `object`
>
> Arbitrary user metadata visible to dashboard agents.
>
> **image\_url** `string`
>
> New HTTP or HTTPS profile image URL for the user.
>
> **display\_name** `string`
>
> New display name for the user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
