Insighto.ai
insighto_aiInsighto.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.
Acciones disponibles (10)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Create IntentINSIGHTO_AI_CREATE_INTENTAcciónTool to create a new intent in insighto.ai. use when adding custom intents before training or deployment. call after confirming intent attributes.
INSIGHTO_AI_CREATE_INTENTAcciónTool to create a new intent in insighto.ai. use when adding custom intents before training or deployment. call after confirming intent attributes.
Parámetros de entrada
namestringObligatorioName of the intent to create.
is_activebooleanWhether the intent is active; defaults to true.
attributesobjectCustom key/value attributes for this intent.
descriptionstringOptional human-readable description for the intent.
intent_typestringType of the intent; defaults to 'user'.
Parámetros de salida
dataobjectObligatorioCreated intent details.
metaobjectResponse metadata.
errorstringError if any occurred during the execution of the action
messagestringAPI message, typically 'Data created successfully'.
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create ProviderINSIGHTO_AI_CREATE_PROVIDERAcciónTool to create a new provider. use after obtaining org id to register the provider.
INSIGHTO_AI_CREATE_PROVIDERAcciónTool to create a new provider. use after obtaining org id to register the provider.
Parámetros de entrada
namestringObligatorioProvider display name
org_idstringOrganization ID under which the provider will be created
statusbooleanWhether the provider is active or not
attributesobjectAdditional provider-specific attributes
provider_keystringObligatorioUnique key for the provider
provider_namestringenumIdentifier of the provider type
openaielevenlabsazure_speechcartesiaplayht
Parámetros de salida
dataobjectDetails of the created provider
metaobjectMetadata returned by the API
errorstringError if any occurred during the execution of the action
messagestringResponse message from the API
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create WidgetINSIGHTO_AI_CREATE_WIDGETAcciónTool to create a new widget with specified attributes. use after confirming assistant id and widget type.
INSIGHTO_AI_CREATE_WIDGETAcciónTool to create a new widget with specified attributes. use after confirming assistant id and widget type.
Parámetros de entrada
namestringInternal name for the widget.
org_idstringOrganization ID; defaults to API key's organization.
attributesobjectCustom key/value pairs for metadata.
bubble_textstringDefault text in bubble.
descriptionstringDetailed description of the widget.
widget_typestringObligatorioenumType of widget to create.
chathtmlwhatsappphonehtml_callleadconnectorleadconnector_callsmsfb_messengerinstagramweb_callplivo_call+3assistant_idstringAssistant ID to attach this widget to.
bubble_colorstringHex code for bubble background.
display_namestringName shown to end users.
header_colorstringHex code for header background.
style_paramsobjectAdditional style overrides for provider.
intro_messagestringOne-time welcome message.
action_buttonsarrayObligatorioQuick action buttons for the widget.
bot_icon_colorstringHex code for bot avatar/icon.
ice_break_colorstringHex code for ice-break messages.
remove_brandingbooleanIf true, hides Insighto.ai branding.
bot_message_colorstringHex code for bot message text.
header_text_colorstringHex code for header text.
user_message_colorstringHex code for user message text.
action_buttons_colorstringHex code for action button backgrounds.
textbox_default_textstringPlaceholder text in input box.
user_opening_messagesstring[]ObligatorioMessages shown when the widget is first opened.
bot_text_message_colorstringHex code for bot text messages.
user_text_message_colorstringHex code for user text messages.
Parámetros de salida
dataobjectDetails of the created widget returned by the API.
metaobjectAdditional metadata.
errorstringError if any occurred during the execution of the action
messagestringAPI response message.
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Contact By IDINSIGHTO_AI_GET_CONTACT_BY_IDAcciónTool to retrieve details of a specific contact by contact id. use when you have a valid contact id and need the full contact profile.
INSIGHTO_AI_GET_CONTACT_BY_IDAcciónTool to retrieve details of a specific contact by contact id. use when you have a valid contact id and need the full contact profile.
Parámetros de entrada
contact_idstringObligatorioUnique identifier of the contact to retrieve
Parámetros de salida
dataobjectThe contact record; null if not found
metaobjectObligatorioAdditional metadata returned by the API
errorstringError if any occurred during the execution of the action
messagestringStatus message returned by the API
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get List Of ContactsINSIGHTO_AI_GET_LIST_OF_CONTACTSAcciónTool to fetch a paginated list of contacts. use after confirming a valid api key to iterate through pages of contacts.
INSIGHTO_AI_GET_LIST_OF_CONTACTSAcciónTool to fetch a paginated list of contacts. use after confirming a valid api key to iterate through pages of contacts.
Parámetros de entrada
pageintegerPage number, must be at least 1. Default is 1.
sizeintegerNumber of contacts per page, between 1 and 100. Default is 50.
Parámetros de salida
dataobjectObligatorioPagination data and list of contacts
metaobjectObligatorioAdditional metadata returned by the API
errorstringError if any occurred during the execution of the action
messagestringOptional response message from the API
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get List Of ConversationsINSIGHTO_AI_GET_LIST_OF_CONVERSATIONSAcciónTool to fetch a list of conversations. use after specifying date range and filters to retrieve conversation metadata.
INSIGHTO_AI_GET_LIST_OF_CONVERSATIONSAcciónTool to fetch a list of conversations. use after specifying date range and filters to retrieve conversation metadata.
Parámetros de entrada
pageintegerPage number for pagination (>=1)
sizeintegerNumber of items per page (1-100)
date_tostringObligatorioEnd date-time (inclusive) in ISO 8601 format
date_fromstringObligatorioStart date-time (inclusive) in ISO 8601 format
intent_idstringFilter by intent ID
assistant_idstringFilter by assistant ID
includes_voicebooleanIf true, only return voice-enabled conversations
Parámetros de salida
dataobjectObligatorioPaginated conversation listing data
metaobjectAdditional metadata returned by the API
errorstringError if any occurred during the execution of the action
messagestringAPI response message, if any
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get List Of DatasourcesINSIGHTO_AI_GET_LIST_OF_DATASOURCESAcciónTool to list all existing data sources. use when you need to fetch the complete set of data sources.
INSIGHTO_AI_GET_LIST_OF_DATASOURCESAcciónTool to list all existing data sources. use when you need to fetch the complete set of data sources.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Read Contact Custom Field ListINSIGHTO_AI_READ_CONTACT_CUSTOM_FIELD_LISTAcciónTool to retrieve a list of custom fields associated with contacts. use when you need to inspect or sync contact metadata definitions.
INSIGHTO_AI_READ_CONTACT_CUSTOM_FIELD_LISTAcciónTool to retrieve a list of custom fields associated with contacts. use when you need to inspect or sync contact metadata definitions.
Parámetros de entrada
pageintegerPage number to fetch, must be at least 1. Default is 1.
sizeintegerNumber of custom fields per page, between 1 and 100. Default is 50.
Parámetros de salida
dataobjectObligatorioPaginated data of contact custom fields
metaobjectObligatorioAdditional metadata returned by the API
errorstringError if any occurred during the execution of the action
messagestringResponse message from the API
successfulbooleanObligatorioWhether or not the action execution was successful or not
Read Intents ListINSIGHTO_AI_READ_INTENTS_LISTAcciónTool to retrieve a list of all intents. use after authenticating; supports pagination.
INSIGHTO_AI_READ_INTENTS_LISTAcciónTool to retrieve a list of all intents. use after authenticating; supports pagination.
Parámetros de entrada
pageintegerPage number to retrieve (>= 1)
sizeintegerNumber of intents per page (1-100)
Parámetros de salida
dataobjectObligatorioPaged intents payload
metaobjectNon-payload metadata
errorstringError if any occurred during the execution of the action
messagestringInformational message from the server
successfulbooleanObligatorioWhether or not the action execution was successful or not
Send Messages To ContactsINSIGHTO_AI_SEND_MESSAGES_TO_CONTACTSAcciónTool 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.
INSIGHTO_AI_SEND_MESSAGES_TO_CONTACTSAcciónTool 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.
Parámetros de entrada
messagestringText message to send (only for chat-based assistants; ignored for calling).
widget_idstringObligatorioWidget ID connected to WhatsApp or SMS.
contact_idsstring[]ObligatorioList of UUIDs identifying contacts to receive messages.
start_new_conversationbooleanStart a new conversation thread instead of replying to the existing one.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not