# Insighto.ai

Insighto.ai is an AI-powered communication platform that enables businesses to create and deploy conversational AI chatbots and voice agents for enhanced customer engagement across multiple channels.

- **Category:** ai chatbots
- **Auth:** API_KEY, OAUTH2
- **Composio Managed App Available?** No
- **Tools:** 65
- **Triggers:** 0
- **Slug:** `INSIGHTO_AI`
- **Version:** 20260227_00

## Tools

### Add Intent To Assistant

**Slug:** `INSIGHTO_AI_ADD_INTENT_TO_ASSISTANT`

Tool to add an intent to an assistant in Insighto.ai. Use when linking existing intents to an assistant for enhanced conversation handling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `intent_id` | string | Yes | The UUID id of the intent to add to the assistant |
| `attributes` | object | No | Custom key/value attributes for this assistant-intent link |
| `assistant_id` | string | Yes | The UUID id of the assistant |

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

**Slug:** `INSIGHTO_AI_CREATE_AGENCY`

Tool to create a new agency in Insighto.ai. Use when setting up a new agency with organization-specific configuration and branding.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | object | No | Optional domain configuration for the agency. Contains custom domain settings. |
| `org_id` | string | Yes | Organization ID for the agency. Required to associate the agency with an organization. |
| `branding` | object | No | Optional branding configuration for the agency. Contains logo, colors, and other visual customization. |
| `user_auth` | object | No | Optional user authentication configuration for the agency. Contains auth settings and providers. |
| `billing_plan` | object | No | Optional billing plan configuration for the agency. Contains billing-related settings and limits. |

#### 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 Contact Custom Field

**Slug:** `INSIGHTO_AI_CREATE_CONTACT_CUSTOM_FIELD`

Tool to create a new contact custom field in Insighto.ai. Use when you need to add custom metadata fields for contacts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | string | No | Organization ID (optional). If not provided, uses default organization. |
| `custom_field_name` | string | Yes | Name of the custom field to create. |
| `custom_field_type` | string | Yes | Type of the custom field (e.g., 'string', 'number'). |

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

**Slug:** `INSIGHTO_AI_CREATE_FORM`

Tool to create a new form in Insighto.ai. Use when you need to create either a natural (conversational AI-driven) or simple (traditional) form for collecting information from users.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the form to create. |
| `fields` | array | No | List of field definitions for the form. Each field can specify type, label, validation rules, etc. |
| `org_id` | string | No | Organization ID; defaults to API key's organization if not provided. |
| `form_type` | string ("natural" | "simple") | Yes | Type of form to create. 'natural' for conversational forms with AI-guided interactions, 'simple' for traditional static forms. |
| `attributes` | object | No | Custom key/value attributes for this form. |
| `webhook_id` | string | No | Webhook ID to associate with this form for triggering events. |
| `trigger_tools` | array | No | Tools that can be triggered during form interactions. |
| `contact_mapping` | object | No | Mapping configuration for contact fields in the form. |
| `trigger_instructions` | string | Yes | Instructions that trigger or guide the form behavior. Describes what data to collect and how. |

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

**Slug:** `INSIGHTO_AI_CREATE_INTENT`

Tool to create a new intent in Insighto.ai. Use when adding custom intents before training or deployment. Call after confirming intent attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the intent to create. |
| `is_active` | boolean | No | Whether the intent is active; defaults to true. |
| `attributes` | object | No | Custom key/value attributes for this intent. |
| `description` | string | No | Optional human-readable description for the intent. |
| `intent_type` | string | No | Type of the intent; defaults to '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 |

### Create Prompt

**Slug:** `INSIGHTO_AI_CREATE_PROMPT`

Tool to create a new prompt in Insighto.ai. Use when adding custom prompts for AI interactions. The prompt template can include variables in {{variable_name}} format.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Name of the prompt to create. |
| `owner_type` | string | No | Type of the owner for this prompt (e.g., 'user', 'organization'). |
| `description` | string | No | Optional human-readable description for the prompt. |
| `prompt_template` | string | No | The template text for the prompt. This is the actual content of the prompt. |

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

**Slug:** `INSIGHTO_AI_CREATE_PROVIDER`

Creates a new AI provider configuration (e.g., OpenAI, ElevenLabs, Azure Speech, Cartesia, PlayHT) for use in voice and text-to-speech workflows. The provider stores credentials and settings in the attributes field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Provider display name |
| `org_id` | string | No | Organization ID under which the provider will be created |
| `status` | boolean | No | Whether the provider is active or not |
| `attributes` | object | No | Provider-specific configuration (e.g., API keys, voice IDs, regions). For ElevenLabs: voice_id, model. For Azure Speech: subscription_key, region. For PlayHT: api_key, user_id. |
| `provider_key` | string | Yes | Unique key for the provider |
| `provider_name` | string ("openai" | "elevenlabs" | "azure_speech" | "cartesia" | "playht") | No | Identifier of the provider type |

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

**Slug:** `INSIGHTO_AI_CREATE_TAG`

Tool to create a new tag in Insighto.ai. Use when categorizing contacts, conversations, or other entities with custom labels.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the tag to create. |
| `attributes` | object | No | Custom key/value attributes for the tag. |
| `color_code` | string | Yes | Hex color code for the tag (e.g., #FF5733). |
| `description` | string | Yes | Description of the tag. |

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

**Slug:** `INSIGHTO_AI_CREATE_TOOLFUNCTION`

Tool to create a new toolfunction in Insighto.ai. Use when you need to register a new tool function (SDK, CURL, or query index type) before using it in workflows or assistant operations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the toolfunction to create. |
| `details` | object | No | Additional custom details or configuration for the toolfunction. |
| `tool_id` | string | No | Optional tool ID to associate with this toolfunction. |
| `is_enabled` | boolean | No | Whether the toolfunction is enabled or disabled. Defaults to false. |
| `description` | string | Yes | Description of the toolfunction and its purpose. |
| `tool_function_type` | string ("sdk" | "curl" | "query_index") | Yes | Type of the toolfunction. Must be one of: 'sdk', 'curl', or 'query_index'. |

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

**Slug:** `INSIGHTO_AI_CREATE_WEBHOOK`

Tool to create a new outbound webhook in Insighto.ai. Use when you need to configure webhook endpoints for event notifications.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the webhook to create. |
| `enabled` | boolean | No | Whether the webhook is enabled. Defaults to true. |
| `endpoint` | string | Yes | URL endpoint where webhook events will be sent. Must be a valid HTTP/HTTPS URL. |

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

**Slug:** `INSIGHTO_AI_CREATE_WIDGET`

Tool to create a new widget with specified attributes. Use after confirming assistant_id and widget_type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Internal name for the widget. |
| `org_id` | string | No | Organization ID; defaults to API key's organization. |
| `attributes` | object | No | Custom key/value pairs for metadata. |
| `bubble_text` | string | No | Default text in bubble. |
| `description` | string | No | Detailed description of the widget. |
| `widget_type` | string ("chat" | "html" | "whatsapp" | "phone" | "html_call" | "leadconnector" | "leadconnector_call" | "sms" | "fb_messenger" | "instagram" | "web_call" | "plivo_call" | "telnyx_call" | "telegram" | "render_form") | Yes | Type of widget to create. Supported types: 'chat' (web chat), 'html' (embeddable HTML), 'whatsapp', 'phone', 'html_call', 'leadconnector', 'leadconnector_call', 'sms', 'fb_messenger', 'instagram', 'web_call', 'plivo_call', 'telnyx_call', 'telegram', 'render_form'. Note: Some widget types (e.g., phone, telegram) may require additional provider setup. |
| `assistant_id` | string | No | Assistant ID to attach this widget to. |
| `bubble_color` | string | No | Hex code for bubble background. |
| `display_name` | string | No | Name shown to end users. |
| `header_color` | string | No | Hex code for header background. |
| `style_params` | object | No | Additional style overrides for provider. |
| `intro_message` | string | No | One-time welcome message. |
| `action_buttons` | array | Yes | Quick action buttons displayed in the widget. Can be an array of strings (e.g., ['Yes', 'No']) or objects with 'label' and 'action' keys (e.g., [{'label': 'Help', 'action': 'help'}]). |
| `bot_icon_color` | string | No | Hex code for bot avatar/icon. |
| `ice_break_color` | string | No | Hex code for ice-break messages. |
| `remove_branding` | boolean | No | If true, hides Insighto.ai branding. |
| `bot_message_color` | string | No | Hex code for bot message text. |
| `header_text_color` | string | No | Hex code for header text. |
| `user_message_color` | string | No | Hex code for user message text. |
| `action_buttons_color` | string | No | Hex code for action button backgrounds. |
| `textbox_default_text` | string | No | Placeholder text in input box. |
| `user_opening_messages` | array | Yes | Messages shown when the widget is first opened. |
| `bot_text_message_color` | string | No | Hex code for bot text messages. |
| `user_text_message_color` | string | No | Hex code for user text messages. |

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

### Delete Assistant By ID

**Slug:** `INSIGHTO_AI_DELETE_ASSISTANT_BY_ID`

Tool to delete an assistant by its ID. Use when you need to permanently remove an assistant from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `assistant_id` | string | Yes | The UUID id of the assistant to delete |

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

### Delete Bulk Forms By IDs

**Slug:** `INSIGHTO_AI_DELETE_BULK_FORMS_BY_IDS`

Tool to delete multiple forms by their IDs in a single operation. Use when you need to remove multiple forms at once.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_ids` | array | Yes | List of UUIDs of the forms to delete. |

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

### Delete Contacts In Bulk

**Slug:** `INSIGHTO_AI_DELETE_CONTACTS_IN_BULK`

Tool to delete multiple contacts in bulk. Use when you need to remove several contacts at once by providing their UUIDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_ids` | array | Yes | List of contact UUIDs to delete. Each must be a valid UUID format. |

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

### Delete Form By ID

**Slug:** `INSIGHTO_AI_DELETE_FORM_BY_ID`

Tool to delete a form by its unique identifier. Use when you need to permanently remove a form from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_id` | string | Yes | Unique identifier of the form to delete |

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

### Delete Linked Assistant Datasource

**Slug:** `INSIGHTO_AI_DELETE_LINKED_ASSISTANT_DATASOURCE`

Tool to delete (unlink) a datasource from a linked assistant in Insighto.ai. Use when you need to remove a specific datasource from an assistant's knowledge base. Requires valid datasource_id and assistant_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `assistant_id` | string | Yes | Unique identifier (UUID) of the assistant from which to unlink the datasource |
| `datasource_id` | string | Yes | Unique identifier (UUID) of the datasource to delete |

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

### Delete Link Tag Entity By ID

**Slug:** `INSIGHTO_AI_DELETE_LINK_TAG_ENTITY_BY_ID`

Tool to delete a link_tag_entity by its ID. Use when you need to remove a specific link_tag_entity from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `link_tag_entity_id` | string | Yes | Unique identifier of the link_tag_entity to delete |

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

### Delete Prompt By ID

**Slug:** `INSIGHTO_AI_DELETE_PROMPT_BY_ID`

Tool to delete a prompt by its unique ID. Use when you need to remove a prompt from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `prompt_id` | string | Yes | Unique identifier of the prompt to delete |

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

### Delete Provider By ID

**Slug:** `INSIGHTO_AI_DELETE_PROVIDER_BY_ID`

Tool to delete an AI provider configuration by its unique identifier. Use when you need to permanently remove a provider from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `provider_id` | string | Yes | Unique identifier of the provider to delete |

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

### Delete Tag By ID

**Slug:** `INSIGHTO_AI_DELETE_TAG_BY_ID`

Tool to delete a tag by its unique identifier. Use when you need to permanently remove a tag from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_id` | string | Yes | Unique identifier of the tag to delete |

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

### Delete Tool By ID

**Slug:** `INSIGHTO_AI_DELETE_TOOL_BY_ID`

Tool to delete a tool by its ID. Use when you need to remove a tool from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tool_id` | string | Yes | Unique identifier of the tool to delete |

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

### Delete Toolfunction By ID

**Slug:** `INSIGHTO_AI_DELETE_TOOLFUNCTION_BY_ID`

Tool to delete a toolfunction by its ID. Use when you need to remove a toolfunction from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `toolfunction_id` | string | Yes | Unique identifier of the toolfunction to delete |

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

### Delete Twilio Auth By ID

**Slug:** `INSIGHTO_AI_DELETE_TWILIO_AUTH_BY_ID`

Tool to delete a Twilio authentication configuration by its ID. Use when you need to remove a Twilio auth integration from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `twilio_auth_id` | string | Yes | Unique identifier of the Twilio authentication to delete |

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

### Delete UserWhatsApp By ID

**Slug:** `INSIGHTO_AI_DELETE_USERWHATSAPP_BY_ID`

Tool to delete a UserWhatsApp by its ID. Use when you need to remove a specific UserWhatsApp connection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `userwhatsapp_id` | string | Yes | Unique identifier of the UserWhatsApp to delete |

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

### Delete Widget By ID

**Slug:** `INSIGHTO_AI_DELETE_WIDGET_BY_ID`

Tool to delete a widget by its unique ID. Use when you need to permanently remove a widget from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `widget_id` | string | Yes | Unique identifier of the widget to delete |

#### 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 Agency Billing Plan

**Slug:** `INSIGHTO_AI_GET_AGENCY_BILLING_PLAN`

Tool to retrieve details of a specific agency billing plan by ID. Use when you need to view billing plan information including limits for bots, queries, words, voice seconds, and support options.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `billing_plan_id` | string | Yes | Unique identifier of the billing plan to retrieve |

#### 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 Agency Branding By ID

**Slug:** `INSIGHTO_AI_GET_AGENCY_BRANDING_BY_ID`

Tool to retrieve branding configuration for a specific agency by agency ID. Use when you have a valid agency ID and need its branding settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `agency_id` | string | Yes | Unique identifier of the agency whose branding to retrieve |

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

**Slug:** `INSIGHTO_AI_GET_AGENT_LIST`

Tool to fetch a paginated list of agents. Use when you need to retrieve user/agent information with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number, must be at least 1. Default is 1. |
| `size` | integer | No | Number of agents per page, between 1 and 100. Default is 50. |

#### 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 Assistant By ID

**Slug:** `INSIGHTO_AI_GET_ASSISTANT_BY_ID`

Tool to retrieve details of a specific assistant by assistant ID. Use when you have a valid assistant ID and need the full assistant profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `assistant_id` | string | Yes | Unique identifier of the assistant to retrieve |

#### 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 Captured Form By Form ID

**Slug:** `INSIGHTO_AI_GET_CAPTURED_FORM_BY_FORM_ID`

Tool to retrieve captured form submissions by form ID. Use when you have a valid form ID and need to fetch all submissions for that specific form with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be at least 1. Default is 1. |
| `size` | integer | No | Number of captured forms per page, between 1 and 100. Default is 50. |
| `form_id` | string | Yes | Unique identifier of the form to retrieve captured submissions for |

#### 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 Contact By ID

**Slug:** `INSIGHTO_AI_GET_CONTACT_BY_ID`

Tool to retrieve details of a specific contact by contact ID. Use when you have a valid contact ID and need the full contact profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact to retrieve |

#### 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 Datasource By ID

**Slug:** `INSIGHTO_AI_GET_DATASOURCE_BY_ID`

Tool to retrieve details of a specific datasource by datasource ID. Use when you have a valid datasource ID and need the full datasource details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datasource_id` | string | Yes | Unique identifier of the datasource to retrieve |

#### 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 Intent By ID

**Slug:** `INSIGHTO_AI_GET_INTENT_BY_ID`

Tool to retrieve details of a specific intent by its ID. Use when you have a valid intent ID and need the full intent details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `intent_id` | string | Yes | Unique identifier of the intent to retrieve |

#### 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 List Of Contacts

**Slug:** `INSIGHTO_AI_GET_LIST_OF_CONTACTS`

Tool to fetch a paginated list of contacts. Use after confirming a valid API key to iterate through pages of contacts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number, must be at least 1. Default is 1. |
| `size` | integer | No | Number of contacts per page, between 1 and 100. Default is 50. |

#### 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 List Of Conversations

**Slug:** `INSIGHTO_AI_GET_LIST_OF_CONVERSATIONS`

Tool to fetch a list of conversations. Use after specifying date range and filters to retrieve conversation metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (>=1) |
| `size` | integer | No | Number of items per page (1-100) |
| `date_to` | string | Yes | End date (inclusive) in ISO 8601 format with zero time (midnight UTC). Must use T00:00:00Z time component. |
| `date_from` | string | Yes | Start date (inclusive) in ISO 8601 format with zero time (midnight UTC). Must use T00:00:00Z time component. |
| `intent_id` | string | No | Filter by intent ID |
| `assistant_id` | string | No | Filter by assistant ID |
| `includes_voice` | boolean | No | If true, only return voice-enabled conversations |

#### 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 List Of Datasources

**Slug:** `INSIGHTO_AI_GET_LIST_OF_DATASOURCES`

Retrieves a paginated list of data sources from Insighto AI. Data sources contain the knowledge base content (text, files, URLs) used by AI assistants. Use this to discover available data sources, get their IDs for further operations, or check if specific data sources exist. Requires admin or manager role.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starts at 1) |
| `size` | integer | No | Number of items per page (1-100, default 50) |

#### 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 List Of Data Sources Linked To Assistant Id

**Slug:** `INSIGHTO_AI_GET_LIST_OF_DATA_SOURCES_LINKED_TO_ASSISTANT_ID`

Tool to retrieve a paginated list of data sources linked to a specific assistant. Use when you need to discover which data sources are associated with an assistant ID. Requires admin or manager role.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be at least 1. Default is 1. |
| `size` | integer | No | Number of data sources per page, between 1 and 100. Default is 50. |
| `assistant_id` | string | Yes | Unique identifier (UUID) of the assistant to get data sources for |

#### 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 List Of Widgets Linked To Assistant Id

**Slug:** `INSIGHTO_AI_GET_LIST_OF_WIDGETS_LINKED_TO_ASSISTANT_ID`

Tool to fetch a paginated list of widgets linked to a specific assistant. Use when you need to discover which widgets are associated with an assistant ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be at least 1. Default is 1. |
| `size` | integer | No | Number of widgets per page, between 1 and 100. Default is 50. |
| `assistant_id` | string | Yes | Unique identifier (UUID) of the assistant to get widgets for |

#### 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 Pricing For User

**Slug:** `INSIGHTO_AI_GET_PRICING_FOR_USER`

Tool to retrieve pricing information for Insighto.ai services. Use when you need to calculate costs for LLM, voice, or transcription services.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `llm_model_id` | string | No | Optional identifier of the LLM model to get pricing for. |
| `voice_stt_id` | string | No | Optional identifier of the speech-to-text (STT) voice model to get pricing for. |
| `voice_tts_id` | string | No | Optional identifier of the text-to-speech (TTS) voice model to get pricing for. |

#### 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 Prompt By ID

**Slug:** `INSIGHTO_AI_GET_PROMPT_BY_ID`

Tool to retrieve details of a specific prompt by prompt ID. Use when you have a valid prompt ID and need the full prompt details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `prompt_id` | string | Yes | Unique identifier of the prompt to retrieve |

#### 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 Provider By ID

**Slug:** `INSIGHTO_AI_GET_PROVIDER_BY_ID`

Tool to retrieve details of a specific provider by provider ID. Use when you have a valid provider ID and need the full provider configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `provider_id` | string | Yes | Unique identifier of the provider to retrieve |

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

**Slug:** `INSIGHTO_AI_GET_SPEECHTOTEXT_LIST`

Tool to fetch a paginated list of available speech-to-text voice configurations. Use when you need to retrieve available languages and providers for voice-to-text conversion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be at least 1. Default is 1. |
| `size` | integer | No | Number of items per page, between 1 and 1000. Default is 50. |

#### 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 Widget By ID

**Slug:** `INSIGHTO_AI_GET_WIDGET_BY_ID`

Tool to retrieve details of a specific widget by widget ID. Use when you have a valid widget ID and need the widget configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `widget_id` | string | Yes | Unique identifier of the widget to retrieve |

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

### List Channels

**Slug:** `INSIGHTO_AI_LIST_CHANNELS`

Tool to retrieve a paginated list of channels. Use after authenticating to fetch all available channels and their configurations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch, must be at least 1. Default is 1. |
| `size` | integer | No | Number of channels per page, must be at least 1. Default is 50. |

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

### Read Campaign Contact List

**Slug:** `INSIGHTO_AI_READ_CAMPAIGN_CONTACT_LIST`

Tool to retrieve a paginated list of contacts associated with a specific campaign. Use when you need to fetch all contacts enrolled in a campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch, must be at least 1. Default is 1. |
| `size` | integer | No | Number of contacts per page, between 1 and 100. Default is 50. |
| `campaign_id` | string | Yes | Unique identifier of the campaign. Must be a valid UUID format. |

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

### Read Contact Custom Field List

**Slug:** `INSIGHTO_AI_READ_CONTACT_CUSTOM_FIELD_LIST`

Tool to retrieve a list of custom fields associated with contacts. Use when you need to inspect or sync contact metadata definitions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch, must be at least 1. Default is 1. |
| `size` | integer | No | Number of custom fields per page, between 1 and 100. Default is 50. |

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

### Read Contact Sync Log List

**Slug:** `INSIGHTO_AI_READ_CONTACT_SYNC_LOG_LIST`

Tool to retrieve a paginated list of contact sync logs. Use when you need to inspect sync history, troubleshoot sync issues, or audit contact synchronization operations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch, must be at least 1. Default is 1. |
| `size` | integer | No | Number of sync logs per page, between 1 and 100. Default is 50. |

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

### Read Intents List

**Slug:** `INSIGHTO_AI_READ_INTENTS_LIST`

Tool to retrieve a list of all intents. Use after authenticating; supports pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (>= 1) |
| `size` | integer | No | Number of intents per page (1-100) |

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

### Read Tag List

**Slug:** `INSIGHTO_AI_READ_TAG_LIST`

Tool to retrieve a paginated list of tags. Use after authenticating to fetch and browse through all available tags.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch, must be at least 1. Default is 1. |
| `size` | integer | No | Number of tags per page, between 1 and 100. Default is 50. |

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

### Read Tool Function Invoke Log List

**Slug:** `INSIGHTO_AI_READ_TOOL_FUNCTION_INVOKE_LOG_LIST`

Tool to retrieve a paginated list of tool function invoke logs. Use when you need to inspect function invocation history, troubleshoot tool execution issues, or audit tool function calls.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch, must be at least 1. Default is 1. |
| `size` | integer | No | Number of logs per page, between 1 and 100. Default is 50. |
| `conversation_id` | string | No | Filter logs by conversation ID (UUID). If provided, only returns logs for the specified conversation. |

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

### Read Tool Toolfunction List

**Slug:** `INSIGHTO_AI_READ_TOOL_TOOLFUNCTION_LIST`

Tool to retrieve a paginated list of tool functions for a specific tool. Use after authenticating to fetch and browse through all tool functions associated with a given tool ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch, must be at least 1. Default is 1. |
| `size` | integer | No | Number of tool functions per page, between 1 and 100. Default is 50. |
| `tool_id` | string | Yes | Unique identifier of the tool to fetch functions for |

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

### Read Twilio Auth List

**Slug:** `INSIGHTO_AI_READ_TWILIO_AUTH_LIST`

Tool to retrieve a paginated list of Twilio authentications. Use after authenticating to fetch and browse through all configured Twilio auth integrations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch, must be at least 1. Default is 1. |
| `size` | integer | No | Number of Twilio authentications per page, between 1 and 100. Default is 50. |

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

### Retrieve Linked Tool And User

**Slug:** `INSIGHTO_AI_RETRIEVE_LINKED_TOOL_AND_USER`

Tool to retrieve linked tool and user information for a specific tool. Use when you need to fetch users linked to a tool by tool ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve, must be at least 1. Default is 1. |
| `size` | integer | No | Number of items per page, between 1 and 100. Default is 50. |
| `tool_id` | string | Yes | Unique identifier of the tool (UUID format) |

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

### Retrieve List Of User Custom Voice

**Slug:** `INSIGHTO_AI_RETRIEVE_LIST_OF_USER_CUSTOM_VOICE`

Tool to retrieve a paginated list of user custom voices. Use after authenticating to fetch available custom voices.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve, must be at least 1. Default is 1. |
| `size` | integer | No | Number of voices per page, between 1 and 1000. Default is 50. |

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

### Retrieve User Monthly Usages Aggregation

**Slug:** `INSIGHTO_AI_RETRIEVE_USER_MONTHLY_USAGES_AGGREGATION`

Tool to retrieve user monthly usages aggregation data. Use when you need to fetch analytics about user usage patterns aggregated by month.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be at least 1. Default is 1. |
| `size` | integer | No | Number of records per page, between 1 and 100. Default is 50. |

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

### Retrieve Webhook Log

**Slug:** `INSIGHTO_AI_RETRIEVE_WEBHOOK_LOG`

Tool to retrieve webhook logs for a specific webhook. Use to monitor webhook delivery status and debug webhook issues.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch, must be at least 1. Default is 1. |
| `size` | integer | No | Number of webhook logs per page, between 1 and 100. Default is 50. |
| `webhook_id` | string | Yes | Unique identifier of the webhook to retrieve logs for. |

#### 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 Messages To Contacts

**Slug:** `INSIGHTO_AI_SEND_MESSAGES_TO_CONTACTS`

Tool to send messages to a list of contacts in bulk. Use when your widget is connected to WhatsApp or SMS and you have the contact IDs ready.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | No | Text message to send (only for chat-based assistants; ignored for calling). |
| `widget_id` | string | Yes | Widget ID connected to WhatsApp or SMS. |
| `contact_ids` | array | Yes | List of UUIDs identifying contacts to receive messages. |
| `start_new_conversation` | boolean | No | Start a new conversation thread instead of replying to the existing 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 Link Tool User

**Slug:** `INSIGHTO_AI_UPDATE_LINK_TOOL_USER`

Tool to update a link tool user by its ID. Use when you need to modify properties of an existing tool integration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Name of the link tool user |
| `org_id` | string | No | Organization ID associated with the link tool user |
| `tool_id` | string | No | Tool ID associated with the link tool user |
| `attributes` | object | No | Custom attributes for the link tool user |
| `credentials` | object | No | Credentials object for the tool integration |
| `link_tool_user_id` | string | Yes | Unique identifier of the link tool user to update |

#### 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 Tool By ID

**Slug:** `INSIGHTO_AI_UPDATE_TOOL_BY_ID`

Tool to update a tool by its ID. Use when you need to modify properties of an existing tool such as name, description, or enabled status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sdk` | object | No | SDK configuration for the tool as a dictionary |
| `name` | string | No | Name of the tool |
| `org_id` | string | No | Organization ID associated with the tool |
| `enabled` | boolean | No | Whether the tool is enabled |
| `tool_id` | string | Yes | Unique identifier of the tool to update |
| `base_url` | string | No | Base URL for the tool's API endpoint |
| `category` | string | No | Category of the tool (IToolCategoryEnum) |
| `logo_url` | string | No | URL to the tool's logo |
| `tool_type` | string | No | Type of the tool (IToolTypeEnum) |
| `attributes` | object | No | Custom attributes for the tool as a dictionary |
| `description` | string | No | Description of the tool |
| `tool_provider` | string | No | Tool provider identifier (IChannelProviderEnum) |
| `authentication` | object | No | Authentication configuration for the tool as a dictionary |

#### 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 Toolfunction By ID

**Slug:** `INSIGHTO_AI_UPDATE_TOOLFUNCTION_BY_ID`

Tool to update an existing toolfunction by its ID. Use when you need to modify properties of a toolfunction such as name, description, type, or enabled status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Name of the toolfunction. |
| `details` | object | No | Additional custom details or configuration for the toolfunction. |
| `tool_id` | string | No | Tool ID to associate with this toolfunction. |
| `is_enabled` | boolean | No | Whether the toolfunction is enabled or disabled. |
| `description` | string | No | Description of the toolfunction and its purpose. |
| `toolfunction_id` | string | Yes | Unique identifier of the toolfunction to update. |
| `tool_function_type` | string ("sdk" | "curl" | "query_index") | No | Enum for tool function types based on API documentation. |

#### 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 Twilio Auth By ID

**Slug:** `INSIGHTO_AI_UPDATE_TWILIO_AUTH_BY_ID`

Tool to update a Twilio authentication configuration by its ID. Use when you need to modify Twilio auth credentials or settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Display name for the Twilio authentication |
| `twilio_auth_id` | string | Yes | Unique identifier of the Twilio authentication to update |
| `twilio_auth_token` | string | No | Twilio authentication token |
| `twilio_account_sid` | string | No | Twilio account SID for authentication |

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

**Slug:** `INSIGHTO_AI_UPDATE_USER_PROFILE`

Tool to update a user profile in Insighto.ai. Use when modifying user account details, contact information, or billing settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | No | User's city |
| `email` | string | No | User's email address |
| `phone` | string | No | User's phone number in E.164 format |
| `state` | string | No | User's state or province |
| `address` | string | No | User's physical address |
| `country` | string | No | User's country |
| `role_id` | string | No | Role identifier for the user |
| `user_id` | string | Yes | Unique identifier of the user to update |
| `is_trial` | boolean | No | Whether the user is on a trial subscription |
| `birthdate` | string | No | User's birthdate in ISO 8601 format |
| `is_active` | boolean | No | Whether the user account is active |
| `is_paying` | boolean | No | Whether the user has a paid subscription |
| `last_name` | string | No | User's last name |
| `first_name` | string | No | User's first name |
| `used_trial` | boolean | No | Whether the user has previously used a trial |
| `is_superuser` | boolean | No | Whether the user has superuser privileges |
| `is_enterprise` | boolean | No | Whether the user is an enterprise customer |
| `billing_updated_at` | string | No | Timestamp when billing information was last updated |
| `stripe_customer_id` | string | No | Stripe customer identifier |
| `last_credits_refresh` | string | No | Timestamp of the last credits refresh |
| `next_billing_plan_id` | string | No | Identifier of the billing plan scheduled for next billing cycle |
| `next_credits_refresh` | string | No | Timestamp of the next scheduled credits refresh |
| `active_billing_plan_id` | string | No | Identifier of the user's current active billing plan |
| `stripe_subscription_id` | string | No | Stripe subscription identifier |
| `stripe_last_payment_date` | string | No | Date of the last payment processed via Stripe |
| `stripe_has_payment_method` | boolean | No | Whether the user has a payment method on file in Stripe |
| `stripe_subscription_status` | string | No | Current status of the Stripe subscription |

#### 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 UserWhatsApp By ID

**Slug:** `INSIGHTO_AI_UPDATE_USERWHATSAPP_BY_ID`

Tool to update a UserWhatsApp configuration by its ID. Use when you need to modify WhatsApp Business API settings for a user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone_number_id` | string | No | Phone number ID associated with WhatsApp Business API |
| `userwhatsapp_id` | string | Yes | Unique identifier of the UserWhatsApp to update |
| `phone_business_id` | string | No | Phone business ID associated with WhatsApp Business API |
| `facebook_app_secret` | string | No | Facebook app secret for WhatsApp Business API integration |
| `whatsapp_access_token` | string | No | WhatsApp access token for authentication |
| `whatsapp_phone_number` | string | No | WhatsApp phone number to update |

#### 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 Webhook By ID

**Slug:** `INSIGHTO_AI_UPDATE_WEBHOOK_BY_ID`

Tool to update an outbound webhook by its unique ID. Use when you need to modify webhook configuration such as name, endpoint URL, or enabled status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New name for the webhook |
| `enabled` | boolean | No | Whether the webhook should be enabled or disabled |
| `endpoint` | string | No | New URL endpoint where webhook events will be sent. Must be a valid HTTP/HTTPS URL. |
| `webhook_id` | string | Yes | Unique identifier of the webhook to update |

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

### Upsert Contact By Email Or Phone Number

**Slug:** `INSIGHTO_AI_UPSERT_CONTACT_BY_EMAIL_OR_PHONE_NUMBER`

Tool to upsert (create or update) a contact in Insighto.ai using email or phone number. Use when you need to create a new contact or update an existing one by email or phone number.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address of the contact. Used as a unique identifier for upserting. |
| `last_name` | string | Yes | Last name of the contact. |
| `first_name` | string | Yes | First name of the contact. |
| `phone_number` | string | Yes | Phone number of the contact including the country code. For example: 16501111234 (no spaces or special characters). |

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