Skip to main content
Insighto.ai logo
  • Category: ai chatbots
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 65
  • Triggers: 0
  • Slug: INSIGHTO_AI
  • Version: 20261101_00

Tools

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

Input Parameters

string
required
The UUID id of the intent to add to the assistant
object
Custom key/value attributes for this assistant-intent link
string
required
The UUID id of the assistant

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: INSIGHTO_AI_CREATE_AGENCYTool to create a new agency in Insighto.ai. Use when setting up a new agency with organization-specific configuration and branding.

Input Parameters

object
Optional domain configuration for the agency. Contains custom domain settings.
string
required
Organization ID for the agency. Required to associate the agency with an organization.
object
Optional branding configuration for the agency. Contains logo, colors, and other visual customization.
object
Optional user authentication configuration for the agency. Contains auth settings and providers.
object
Optional billing plan configuration for the agency. Contains billing-related settings and limits.

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: INSIGHTO_AI_CREATE_CONTACT_CUSTOM_FIELDTool to create a new contact custom field in Insighto.ai. Use when you need to add custom metadata fields for contacts.

Input Parameters

string
Organization ID (optional). If not provided, uses default organization.
string
required
Name of the custom field to create.
string
required
Type of the custom field (e.g., ‘string’, ‘number’).

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: INSIGHTO_AI_CREATE_FORMTool 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

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

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: INSIGHTO_AI_CREATE_INTENTTool to create a new intent in Insighto.ai. Use when adding custom intents before training or deployment. Call after confirming intent attributes.

Input Parameters

string
required
Name of the intent to create.
boolean
Whether the intent is active; defaults to true.
object
Custom key/value attributes for this intent.
string
Optional human-readable description for the intent.
string
Type of the intent; defaults to ‘user’.

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: INSIGHTO_AI_CREATE_PROMPTTool 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

string
Name of the prompt to create.
string
Type of the owner for this prompt (e.g., ‘user’, ‘organization’).
string
Optional human-readable description for the prompt.
string
The template text for the prompt. This is the actual content of the prompt.

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: INSIGHTO_AI_CREATE_PROVIDERCreates 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

string
required
Provider display name
string
Organization ID under which the provider will be created
boolean
Whether the provider is active or not
object
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.
string
required
Unique key for the provider
string ("openai" | "elevenlabs" | "azure_speech" | "cartesia" | "playht")
Identifier of the provider type

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: INSIGHTO_AI_CREATE_TAGTool to create a new tag in Insighto.ai. Use when categorizing contacts, conversations, or other entities with custom labels.

Input Parameters

string
required
Name of the tag to create.
object
Custom key/value attributes for the tag.
string
required
Hex color code for the tag (e.g., #FF5733).
string
required
Description of the tag.

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: INSIGHTO_AI_CREATE_TOOLFUNCTIONTool 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

string
required
Name of the toolfunction to create.
object
Additional custom details or configuration for the toolfunction.
string
Optional tool ID to associate with this toolfunction.
boolean
Whether the toolfunction is enabled or disabled. Defaults to false.
string
required
Description of the toolfunction and its purpose.
string ("sdk" | "curl" | "query_index")
required
Type of the toolfunction. Must be one of: ‘sdk’, ‘curl’, or ‘query_index’.

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: INSIGHTO_AI_CREATE_WEBHOOKTool to create a new outbound webhook in Insighto.ai. Use when you need to configure webhook endpoints for event notifications.

Input Parameters

string
required
Name of the webhook to create.
boolean
Whether the webhook is enabled. Defaults to true.
string
required
URL endpoint where webhook events will be sent. Must be a valid HTTP/HTTPS URL.

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: INSIGHTO_AI_CREATE_WIDGETTool to create a new widget with specified attributes. Use after confirming assistant_id and widget_type.

Input Parameters

string
Internal name for the widget.
string
Organization ID; defaults to API key’s organization.
object
Custom key/value pairs for metadata.
string
Default text in bubble.
string
Detailed description of the widget.
string ("chat" | "html" | "whatsapp" | "phone" | "html_call" | "leadconnector" | "leadconnector_call" | "sms" | "fb_messenger" | "instagram" | "web_call" | "plivo_call" | "telnyx_call" | "telegram" | "render_form")
required
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.
string
Assistant ID to attach this widget to.
string
Hex code for bubble background.
string
Name shown to end users.
string
Hex code for header background.
object
Additional style overrides for provider.
string
One-time welcome message.
array
required
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’}]).
string
Hex code for bot avatar/icon.
string
Hex code for ice-break messages.
boolean
If true, hides Insighto.ai branding.
string
Hex code for bot message text.
string
Hex code for header text.
string
Hex code for user message text.
string
Hex code for action button backgrounds.
string
Placeholder text in input box.
array
required
Messages shown when the widget is first opened.
string
Hex code for bot text messages.
string
Hex code for user text messages.

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: INSIGHTO_AI_DELETE_ASSISTANT_BY_IDTool to delete an assistant by its ID. Use when you need to permanently remove an assistant from the system.

Input Parameters

string
required
The UUID id of the assistant to delete

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: INSIGHTO_AI_DELETE_BULK_FORMS_BY_IDSTool to delete multiple forms by their IDs in a single operation. Use when you need to remove multiple forms at once.

Input Parameters

array
required
List of UUIDs of the forms to delete.

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: INSIGHTO_AI_DELETE_CONTACTS_IN_BULKTool to delete multiple contacts in bulk. Use when you need to remove several contacts at once by providing their UUIDs.

Input Parameters

array
required
List of contact UUIDs to delete. Each must be a valid UUID format.

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: INSIGHTO_AI_DELETE_FORM_BY_IDTool to delete a form by its unique identifier. Use when you need to permanently remove a form from the system.

Input Parameters

string
required
Unique identifier of the form to delete

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: INSIGHTO_AI_DELETE_LINKED_ASSISTANT_DATASOURCETool 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

string
required
Unique identifier (UUID) of the assistant from which to unlink the datasource
string
required
Unique identifier (UUID) of the datasource to delete

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: INSIGHTO_AI_DELETE_PROMPT_BY_IDTool to delete a prompt by its unique ID. Use when you need to remove a prompt from the system.

Input Parameters

string
required
Unique identifier of the prompt to delete

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: INSIGHTO_AI_DELETE_PROVIDER_BY_IDDelete an Insighto.ai AI provider configuration by its unique identifier.

Input Parameters

string
required
Unique identifier of the provider to delete

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: INSIGHTO_AI_DELETE_TAG_BY_IDTool to delete a tag by its unique identifier. Use when you need to permanently remove a tag from the system.

Input Parameters

string
required
Unique identifier of the tag to delete

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: INSIGHTO_AI_DELETE_TOOL_BY_IDTool to delete a tool by its ID. Use when you need to remove a tool from the system.

Input Parameters

string
required
Unique identifier of the tool to delete

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: INSIGHTO_AI_DELETE_TOOLFUNCTION_BY_IDTool to delete a toolfunction by its ID. Use when you need to remove a toolfunction from the system.

Input Parameters

string
required
Unique identifier of the toolfunction to delete

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: INSIGHTO_AI_DELETE_TWILIO_AUTH_BY_IDTool to delete a Twilio authentication configuration by its ID. Use when you need to remove a Twilio auth integration from the system.

Input Parameters

string
required
Unique identifier of the Twilio authentication to delete

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: INSIGHTO_AI_DELETE_USERWHATSAPP_BY_IDTool to delete a UserWhatsApp by its ID. Use when you need to remove a specific UserWhatsApp connection.

Input Parameters

string
required
Unique identifier of the UserWhatsApp to delete

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: INSIGHTO_AI_DELETE_WIDGET_BY_IDTool to delete a widget by its unique ID. Use when you need to permanently remove a widget from the system.

Input Parameters

string
required
Unique identifier of the widget to delete

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: INSIGHTO_AI_GET_AGENCY_BILLING_PLANRetrieve an agency billing plan by ID to view its details, including limits for bots, queries, words and voice seconds, and its support options.

Input Parameters

string
required
Unique identifier of the billing plan to retrieve

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: INSIGHTO_AI_GET_AGENCY_BRANDING_BY_IDTool 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

string
required
Unique identifier of the agency whose branding to retrieve

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: INSIGHTO_AI_GET_AGENT_LISTTool to fetch a paginated list of agents. Use when you need to retrieve user/agent information with pagination support.

Input Parameters

integer
Page number, must be at least 1. Default is 1.
integer
Number of agents per page, between 1 and 100. Default is 50.

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: INSIGHTO_AI_GET_ASSISTANT_BY_IDTool 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

string
required
Unique identifier of the assistant to retrieve

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: INSIGHTO_AI_GET_CAPTURED_FORM_BY_FORM_IDTool 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

integer
Page number for pagination, must be at least 1. Default is 1.
integer
Number of captured forms per page, between 1 and 100. Default is 50.
string
required
Unique identifier of the form to retrieve captured submissions for

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: INSIGHTO_AI_GET_CONTACT_BY_IDTool 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

string
required
Unique identifier of the contact to retrieve

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: INSIGHTO_AI_GET_DATASOURCE_BY_IDTool 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

string
required
Unique identifier of the datasource to retrieve

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: INSIGHTO_AI_GET_INTENT_BY_IDTool 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

string
required
Unique identifier of the intent to retrieve

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: INSIGHTO_AI_GET_LIST_OF_CONTACTSTool to fetch a paginated list of contacts. Use after confirming a valid API key to iterate through pages of contacts.

Input Parameters

integer
Page number, must be at least 1. Default is 1.
integer
Number of contacts per page, between 1 and 100. Default is 50.

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: INSIGHTO_AI_GET_LIST_OF_CONVERSATIONSTool to fetch a list of conversations. Use after specifying date range and filters to retrieve conversation metadata.

Input Parameters

integer
Page number for pagination (>=1)
integer
Number of items per page (1-100)
string
required
End date (inclusive) in ISO 8601 format with zero time (midnight UTC). Must use T00:00:00Z time component.
string
required
Start date (inclusive) in ISO 8601 format with zero time (midnight UTC). Must use T00:00:00Z time component.
string
Filter by intent ID
string
Filter by assistant ID
boolean
If true, only return voice-enabled conversations

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: INSIGHTO_AI_GET_LIST_OF_DATASOURCESList Insighto.ai data sources to discover available knowledge sources and their IDs. Results are paginated, with a default page size of 50 and a maximum of 100. Requires an admin or manager role.

Input Parameters

integer
Page number for pagination (starts at 1)
integer
Number of items per page (1-100, default 50)

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: INSIGHTO_AI_GET_LIST_OF_DATA_SOURCES_LINKED_TO_ASSISTANT_IDTool 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

integer
Page number for pagination, must be at least 1. Default is 1.
integer
Number of data sources per page, between 1 and 100. Default is 50.
string
required
Unique identifier (UUID) of the assistant to get data sources for

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: INSIGHTO_AI_GET_LIST_OF_WIDGETS_LINKED_TO_ASSISTANT_IDTool 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

integer
Page number for pagination, must be at least 1. Default is 1.
integer
Number of widgets per page, between 1 and 100. Default is 50.
string
required
Unique identifier (UUID) of the assistant to get widgets for

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: INSIGHTO_AI_GET_PRICING_FOR_USERTool to retrieve pricing information for Insighto.ai services. Use when you need to calculate costs for LLM, voice, or transcription services.

Input Parameters

string
Optional identifier of the LLM model to get pricing for.
string
Optional identifier of the speech-to-text (STT) voice model to get pricing for.
string
Optional identifier of the text-to-speech (TTS) voice model to get pricing for.

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: INSIGHTO_AI_GET_PROMPT_BY_IDTool 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

string
required
Unique identifier of the prompt to retrieve

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: INSIGHTO_AI_GET_PROVIDER_BY_IDTool 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

string
required
Unique identifier of the provider to retrieve

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: INSIGHTO_AI_GET_SPEECHTOTEXT_LISTTool 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

integer
Page number for pagination, must be at least 1. Default is 1.
integer
Number of items per page, between 1 and 1000. Default is 50.

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: INSIGHTO_AI_GET_WIDGET_BY_IDTool 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

string
required
Unique identifier of the widget to retrieve

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: INSIGHTO_AI_LIST_CHANNELSTool to retrieve a paginated list of channels. Use after authenticating to fetch all available channels and their configurations.

Input Parameters

integer
Page number to fetch, must be at least 1. Default is 1.
integer
Number of channels per page, must be at least 1. Default is 50.

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: INSIGHTO_AI_READ_CAMPAIGN_CONTACT_LISTTool 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

integer
Page number to fetch, must be at least 1. Default is 1.
integer
Number of contacts per page, between 1 and 100. Default is 50.
string
required
Unique identifier of the campaign. Must be a valid UUID format.

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: INSIGHTO_AI_READ_CONTACT_CUSTOM_FIELD_LISTTool to retrieve a list of custom fields associated with contacts. Use when you need to inspect or sync contact metadata definitions.

Input Parameters

integer
Page number to fetch, must be at least 1. Default is 1.
integer
Number of custom fields per page, between 1 and 100. Default is 50.

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: INSIGHTO_AI_READ_CONTACT_SYNC_LOG_LISTTool 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

integer
Page number to fetch, must be at least 1. Default is 1.
integer
Number of sync logs per page, between 1 and 100. Default is 50.

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: INSIGHTO_AI_READ_INTENTS_LISTTool to retrieve a list of all intents. Use after authenticating; supports pagination.

Input Parameters

integer
Page number to retrieve (>= 1)
integer
Number of intents per page (1-100)

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: INSIGHTO_AI_READ_TAG_LISTTool to retrieve a paginated list of tags. Use after authenticating to fetch and browse through all available tags.

Input Parameters

integer
Page number to fetch, must be at least 1. Default is 1.
integer
Number of tags per page, between 1 and 100. Default is 50.

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: INSIGHTO_AI_READ_TOOL_FUNCTION_INVOKE_LOG_LISTTool 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

integer
Page number to fetch, must be at least 1. Default is 1.
integer
Number of logs per page, between 1 and 100. Default is 50.
string
Filter logs by conversation ID (UUID). If provided, only returns logs for the specified conversation.

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: INSIGHTO_AI_READ_TOOL_TOOLFUNCTION_LISTTool 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

integer
Page number to fetch, must be at least 1. Default is 1.
integer
Number of tool functions per page, between 1 and 100. Default is 50.
string
required
Unique identifier of the tool to fetch functions for

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: INSIGHTO_AI_READ_TWILIO_AUTH_LISTTool to retrieve a paginated list of Twilio authentications. Use after authenticating to fetch and browse through all configured Twilio auth integrations.

Input Parameters

integer
Page number to fetch, must be at least 1. Default is 1.
integer
Number of Twilio authentications per page, between 1 and 100. Default is 50.

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: INSIGHTO_AI_RETRIEVE_LINKED_TOOL_AND_USERTool 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

integer
Page number to retrieve, must be at least 1. Default is 1.
integer
Number of items per page, between 1 and 100. Default is 50.
string
required
Unique identifier of the tool (UUID format)

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: INSIGHTO_AI_RETRIEVE_LIST_OF_USER_CUSTOM_VOICETool to retrieve a paginated list of user custom voices. Use after authenticating to fetch available custom voices.

Input Parameters

integer
Page number to retrieve, must be at least 1. Default is 1.
integer
Number of voices per page, between 1 and 1000. Default is 50.

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: INSIGHTO_AI_RETRIEVE_USER_MONTHLY_USAGES_AGGREGATIONTool to retrieve user monthly usages aggregation data. Use when you need to fetch analytics about user usage patterns aggregated by month.

Input Parameters

integer
Page number for pagination, must be at least 1. Default is 1.
integer
Number of records per page, between 1 and 100. Default is 50.

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: INSIGHTO_AI_RETRIEVE_WEBHOOK_LOGTool to retrieve webhook logs for a specific webhook. Use to monitor webhook delivery status and debug webhook issues.

Input Parameters

integer
Page number to fetch, must be at least 1. Default is 1.
integer
Number of webhook logs per page, between 1 and 100. Default is 50.
string
required
Unique identifier of the webhook to retrieve logs for.

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: INSIGHTO_AI_SEND_MESSAGES_TO_CONTACTSTool 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

string
Text message to send (only for chat-based assistants; ignored for calling).
string
required
Widget ID connected to WhatsApp or SMS.
array
required
List of UUIDs identifying contacts to receive messages.
boolean
Start a new conversation thread instead of replying to the existing one.

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: INSIGHTO_AI_UPDATE_TOOL_BY_IDTool 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

object
SDK configuration for the tool as a dictionary
string
Name of the tool
string
Organization ID associated with the tool
boolean
Whether the tool is enabled
string
required
Unique identifier of the tool to update
string
Base URL for the tool’s API endpoint
string
Category of the tool (IToolCategoryEnum)
string
URL to the tool’s logo
string
Type of the tool (IToolTypeEnum)
object
Custom attributes for the tool as a dictionary
string
Description of the tool
string
Tool provider identifier (IChannelProviderEnum)
object
Authentication configuration for the tool as a dictionary

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: INSIGHTO_AI_UPDATE_TOOLFUNCTION_BY_IDTool 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

string
Name of the toolfunction.
object
Additional custom details or configuration for the toolfunction.
string
Tool ID to associate with this toolfunction.
boolean
Whether the toolfunction is enabled or disabled.
string
Description of the toolfunction and its purpose.
string
required
Unique identifier of the toolfunction to update.
string ("sdk" | "curl" | "query_index")
Enum for tool function types based on API documentation.

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: INSIGHTO_AI_UPDATE_TWILIO_AUTH_BY_IDTool to update a Twilio authentication configuration by its ID. Use when you need to modify Twilio auth credentials or settings.

Input Parameters

string
Display name for the Twilio authentication
string
required
Unique identifier of the Twilio authentication to update
string
Twilio authentication token
string
Twilio account SID for authentication

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: INSIGHTO_AI_UPDATE_USER_PROFILETool to update a user profile in Insighto.ai. Use when modifying user account details, contact information, or billing settings.

Input Parameters

string
User’s city
string
User’s email address
string
User’s phone number in E.164 format
string
User’s state or province
string
User’s physical address
string
User’s country
string
Role identifier for the user
string
required
Unique identifier of the user to update
boolean
Whether the user is on a trial subscription
string
User’s birthdate in ISO 8601 format
boolean
Whether the user account is active
boolean
Whether the user has a paid subscription
string
User’s last name
string
User’s first name
boolean
Whether the user has previously used a trial
boolean
Whether the user has superuser privileges
boolean
Whether the user is an enterprise customer
string
Timestamp when billing information was last updated
string
Stripe customer identifier
string
Timestamp of the last credits refresh
string
Identifier of the billing plan scheduled for next billing cycle
string
Timestamp of the next scheduled credits refresh
string
Identifier of the user’s current active billing plan
string
Stripe subscription identifier
string
Date of the last payment processed via Stripe
boolean
Whether the user has a payment method on file in Stripe
string
Current status of the Stripe subscription

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: INSIGHTO_AI_UPDATE_USERWHATSAPP_BY_IDTool to update a UserWhatsApp configuration by its ID. Use when you need to modify WhatsApp Business API settings for a user.

Input Parameters

string
Phone number ID associated with WhatsApp Business API
string
required
Unique identifier of the UserWhatsApp to update
string
Phone business ID associated with WhatsApp Business API
string
Facebook app secret for WhatsApp Business API integration
string
WhatsApp access token for authentication
string
WhatsApp phone number to update

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: INSIGHTO_AI_UPDATE_WEBHOOK_BY_IDTool 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

string
New name for the webhook
boolean
Whether the webhook should be enabled or disabled
string
New URL endpoint where webhook events will be sent. Must be a valid HTTP/HTTPS URL.
string
required
Unique identifier of the webhook to update

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: INSIGHTO_AI_UPSERT_CONTACT_BY_EMAIL_OR_PHONE_NUMBERCreate or update an Insighto.ai contact using its email address and phone number. Both identifiers and the contact’s first and last names are required.

Input Parameters

string
required
Email address of the contact. Used as a unique identifier for upserting.
string
required
Last name of the contact.
string
required
First name of the contact.
string
required
Phone number of the contact including the country code. For example: 16501111234 (no spaces or special characters).

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