Help center

Search results

33 results forAPI

API & SDK

Introduction to the API and SDKs

Choose between the REST API and official SDKs to integrate an Inceptiva agent.

Create and protect an API key

Publish an agent's API channel and manage its credentials securely.

Send your first API message

Invoke a published agent with HTTP and process its response.

Maintain and manage conversations

Preserve context, retrieve history, and delete a conversation through the API.

Receive streamed responses

Display an agent's response while it is generated through SSE or an official SDK.

Handle errors and usage limits

Respond correctly to authentication, validation, network, and rate-limit errors.

Integrate the TypeScript SDK

Install and use the official Inceptiva SDK on Node.js 18 or later.

Integrate the Python SDK

Install and use the official Inceptiva client for Python 3.10 or later.

Integrate the .NET SDK

Use the official Inceptiva client in .NET 8 or later applications.

Use metadata and citations

Add request traceability and present public sources from a response.

Prepare an integration for production

Apply security, cancellation, observability, and context controls before release.

Channels

Introduction to channels

Understand where you can publish an agent and what each channel requires.

Publish an agent to a channel

Enable the point of contact where your users will interact with the agent.

Prepare an agent before publishing

Review identity, responses, permissions, and risks before opening a channel.

Configure WhatsApp Business

Connect a Meta Cloud API number and prepare its webhook.

Publish an agent through the API

Generate credentials to integrate the agent securely from a server.

Enable, disable, or change a channel

Control availability without deleting the agent or losing configuration.

Test conversations in published channels

Validate the real journey from the first message to its record in Studio.

Troubleshoot channels

Locate activation, delivery, response, and credential failures.

Troubleshooting

Diagnose an issue step by step

Isolate a failure before changing configuration or contacting support.

Gather information for support

Prepare a reproducible, secure case so the team can help quickly.

Getting started

Get started with Inceptiva

Understand how agents, knowledge, tools, and channels work together before creating your first experience.

Create your first agent

Use the visual builder to define the agent's identity, knowledge, tools, and channel.

Publish and share your agent

Review the agent's status and choose its first channel for other people to use.

Tools

Introduction to tools

Understand how tools let an agent perform controlled actions.

Create an HTTP tool

Connect an agent to an API to query or modify data.

Configure request parameters, data, and body

Define fixed values and the values the agent must obtain during a conversation.

Protect credentials and secret headers

Configure external authentication without exposing tokens or passwords.

Web widget

Introduction to the Web Widget

Understand how to publish an agent's chat on any website.

Knowledge

Upload and index documents

Add PDF, Word, or Excel files and prepare them for agents to consult.

Agent teams

Configure the coordinator and specialists

Define clear responsibilities so each agent participates at the right time.

Agents

Write effective instructions

Define the objective, rules, and boundaries that guide agent responses.

Workflows

Run tools from a workflow

Add authorized actions and control their inputs, results, and external side effects.