> ## 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.

# Convolo AI

> Convolo.ai is an AI-powered communications platform designed to enhance sales calls and improve conversion rates through rapid lead response and integration capabilities.

![Convolo AI logo](https://mintcdn.com/composio-preview/NPf8agM6UrvZD-Iu/images/toolkits/convolo_ai.svg?fit=max\&auto=format\&n=NPf8agM6UrvZD-Iu\&q=85\&s=3a5b7ecd4dcb94ff0803ba29622c2f07)

* **Category:** ai sales tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 7
* **Triggers:** 0
* **Slug:** `CONVOLO_AI`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Character
>
> **Slug:** `CONVOLO_AI_CREATE_CHARACTER`
>
> Tool to create a new character. Use when you have name, voice type, backstory, and optional actions ready.
>
> #### Input Parameters
>
> **actions** `array`
>
> Optional list of actions the character can perform.
>
> **charName** `string` *required*
>
> Name of the character to create.
>
> **backstory** `string` *required*
>
> Background information or story for the character.
>
> **voiceType** `string` *required*
>
> Voice type to assign; see Voice List API for available values.
>
> #### 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] Evaluate Character Performance
>
> **Slug:** `CONVOLO_AI_EVALUATE_CHARACTER`
>
> Evaluates a conversation session across 9 quality dimensions (clarity, courtesy, product knowledge, etc.) using AI analysis. Returns structured ratings and feedback. Prerequisites: - A valid session\_id from Get Character Response - A character\_id from Create Character - Prompt must include `[[conversation_history]]` placeholder Note: This API requires Professional Plan or higher access.
>
> #### Input Parameters
>
> **prompt** `string` *required*
>
> Evaluation instructions that MUST include the placeholder `[[conversation_history]]`. The conversation history will be automatically fetched and inserted. You can add other placeholders and provide their values via the 'variables' parameter.
>
> **variables** `object`
>
> Optional key-value pairs for custom variables referenced in your prompt (e.g., `[[customer_name]]`, `[[product]]`). Do NOT include `[[conversation_history]]` here—it's automatically provided.
>
> **session\_id** `string` *required*
>
> The ID of the conversation session to evaluate. Obtain this from a Get Character Response action.
>
> **character\_id** `string` *required*
>
> The ID of the character that will perform the evaluation. Obtain this from a Create Character action.
>
> #### 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] Generate Starter Conversation
>
> **Slug:** `CONVOLO_AI_GENERATE_STARTER_CONVERSATION`
>
> Generates AI-powered conversation starter suggestions for a character. This tool creates contextually relevant opening lines or follow-up dialogue suggestions that can be used to initiate or continue conversations with AI characters. Perfect for chatbots, virtual assistants, game NPCs, or interactive storytelling applications. Use this when you need: - Opening conversation starters for a new interaction (sessionId="-1") - Follow-up suggestions based on an ongoing conversation (provide existing sessionId) - Multiple conversation options to choose from
>
> #### Input Parameters
>
> **charId** `string` *required*
>
> The unique identifier of the character for which to generate conversation starters. Obtain this from the Create Character action.
>
> **sessionId** `string` *required*
>
> The session identifier for context-aware suggestions. Use "-1" to generate opening conversation starters for a new session, or provide an existing session ID for follow-up dialogue suggestions.
>
> #### 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 Character Response
>
> **Slug:** `CONVOLO_AI_GET_CHARACTER_RESPONSE`
>
> Generates a ConvAI character response from text or audio input for a new or ongoing session, with optional voice audio. The returned text may contain an API error or raw response rather than a generated reply.
>
> #### Input Parameters
>
> **file** `string`
>
> Mono WAV audio file bytes; provide only if not sending userText
>
> **charID** `string` *required*
>
> ID of the character to interact with
>
> **stream** `string ("True" | "False")`
>
> Enable SSE streaming; "True" or "False"
>
> **userText** `string`
>
> User text input; provide only if not sending audio
>
> **sessionID** `string` *required*
>
> Session identifier; use "-1" to start a new session
>
> **sample\_rate** `string`
>
> Sample rate of the uploaded audio in Hz
>
> **voiceResponse** `boolean` *required*
>
> Whether to return response audio
>
> #### 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] List Voices
>
> **Slug:** `CONVOLO_AI_LIST_VOICES`
>
> Tool to retrieve the list of available voice types. Use when selecting voices before generating speech.
>
> #### Input Parameters
>
> **accept** `string`
>
> Override the Accept header if provided.
>
> **contentType** `string`
>
> Override the Content-Type header if provided.
>
> **use\_alt\_domain** `boolean`
>
> If true, use [https://api.convai.com](https://api.convai.com) as base URL instead of default.
>
> #### 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] Set Core AI Settings
>
> **Slug:** `CONVOLO_AI_SET_CORE_AI_SETTINGS`
>
> Updates the core AI settings (model and/or temperature) for an existing Convai character. Use this action to: - Switch the AI model powering a character (e.g., from GPT-4o to Claude) - Adjust response creativity via temperature parameter (0.0=deterministic, 1.0=creative) - Fine-tune character behavior without recreating the character Prerequisites: Requires a valid charID from a previously created character. At least one of model\_group\_name or temperature must be specified.
>
> #### Input Parameters
>
> **charID** `string` *required*
>
> The unique identifier (charID) of the character to update. Obtain this from CREATE\_CHARACTER or character listing endpoints.
>
> **temperature** `number`
>
> Controls response randomness/creativity (0.0-1.0). Lower values (0.0-0.3) make responses more focused and deterministic; higher values (0.7-1.0) increase creativity and variation. Default behavior maintained if not specified. Optional - provide only when adjusting.
>
> **model\_group\_name** `string ("claude-3-5-sonnet" | "gemini-1.5-pro" | "gemini-1.5-flash" | "llama3-70b" | "llama-2-13b" | "gpt-3.5-turbo" | "gpt-4o" | "gpt-4o-mini" | "uncensored-small")`
>
> AI language model to use for this character. Choose based on desired capabilities: GPT models for general use, Claude for nuanced conversations, Gemini for multimodal, Llama for open-source. Optional - provide only when changing the model.
>
> #### 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] Upload Knowledge Bank File
>
> **Slug:** `CONVOLO_AI_UPLOAD_KNOWLEDGE_BANK`
>
> Uploads a file to Convai's character knowledge bank. Enterprise plan only.
>
> #### Input Parameters
>
> **file** `string` *required*
>
> Raw bytes of the knowledge bank file to upload
>
> **file\_name** `string` *required*
>
> Name of the file being uploaded
>
> #### 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
