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

- **Category:** ai sales tools
- **Auth:** API_KEY
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `CONVOLO_AI`
- **Version:** 20260211_00

## Tools

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

### Define or Update Character Actions

**Slug:** `CONVOLO_AI_DEFINE_ACTIONS`

Update character properties including actions, name, backstory, voice, and languages. Use this tool to: - Define or modify the list of action capabilities a character can perform (e.g., greet, wave, attack) - Update the character's display name - Modify the character's backstory that influences its personality and responses - Change the character's voice type for text-to-speech - Configure supported languages At least one optional field must be provided to update. Common use case is adding actions like ['help', 'guide', 'search'] to enable specific character behaviors.

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

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

### Get Character Response

**Slug:** `CONVOLO_AI_GET_CHARACTER_RESPONSE`

Tool to generate a response from a ConvAI character based on text or audio input. Use when needing a text or voice reply in an ongoing session.

### List Voices

**Slug:** `CONVOLO_AI_LIST_VOICES`

Tool to retrieve the list of available voice types. Use when selecting voices before generating speech.

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

### Update Character Backstory

**Slug:** `CONVOLO_AI_UPDATE_BACKSTORY`

Tool to update a character's backstory. Use when you need to modify the backstory of an existing character after confirming its ID. Only the provided fields will be updated.

### Update Character

**Slug:** `CONVOLO_AI_UPDATE_CHARACTER`

Tool to update existing character details. Use when you have a character ID and need to modify its attributes.

### Upload Knowledge Bank File

**Slug:** `CONVOLO_AI_UPLOAD_KNOWLEDGE_BANK`

Tool to upload a knowledge bank file. Use when you have a file ready to add to Convolo AI's knowledge bank (Enterprise plan only).
