Skip to main content
Convolo AI logo
  • Category: ai sales tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 7
  • Triggers: 0
  • Slug: CONVOLO_AI
  • Version: 20261101_00

Tools

Slug: CONVOLO_AI_CREATE_CHARACTERTool to create a new character. Use when you have name, voice type, backstory, and optional actions ready.

Input Parameters

array
Optional list of actions the character can perform.
string
required
Name of the character to create.
string
required
Background information or story for the character.
string
required
Voice type to assign; see Voice List API for available values.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONVOLO_AI_EVALUATE_CHARACTEREvaluates 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

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.
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.
string
required
The ID of the conversation session to evaluate. Obtain this from a Get Character Response action.
string
required
The ID of the character that will perform the evaluation. Obtain this from a Create Character action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONVOLO_AI_GENERATE_STARTER_CONVERSATIONGenerates 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

string
required
The unique identifier of the character for which to generate conversation starters. Obtain this from the Create Character action.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONVOLO_AI_GET_CHARACTER_RESPONSEGenerates 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

string
Mono WAV audio file bytes; provide only if not sending userText
string
required
ID of the character to interact with
string ("True" | "False")
Enable SSE streaming; “True” or “False”
string
User text input; provide only if not sending audio
string
required
Session identifier; use “-1” to start a new session
string
Sample rate of the uploaded audio in Hz
boolean
required
Whether to return response audio

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONVOLO_AI_LIST_VOICESTool to retrieve the list of available voice types. Use when selecting voices before generating speech.

Input Parameters

string
Override the Accept header if provided.
string
Override the Content-Type header if provided.
boolean
If true, use https://api.convai.com as base URL instead of default.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONVOLO_AI_SET_CORE_AI_SETTINGSUpdates 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

string
required
The unique identifier (charID) of the character to update. Obtain this from CREATE_CHARACTER or character listing endpoints.
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.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONVOLO_AI_UPLOAD_KNOWLEDGE_BANKUploads a file to Convai’s character knowledge bank. Enterprise plan only.

Input Parameters

string
required
Raw bytes of the knowledge bank file to upload
string
required
Name of the file being uploaded

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not