> ## Documentation Index
> Fetch the complete documentation index at: https://docs.movoice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom functions

# Custom function calls

For businesses with unique requirements, Movoice AI allows you to create **Custom Tools** that connect your AI agents directly to your proprietary APIs.

## When to use Custom Tools

* Checking an internal database for order status.
* Verifying a customer's loyalty points.
* Calculating a custom quote in real-time.
* Unlocking a digital gate or triggering a hardware event.

## Setup Architecture

### 1. Define the Interface

In the **Tools Tab**, create a "Custom Tool." Define:

* **Tool Name**: (e.g., `get_order_status`)
* **Parameters**: (e.g., `order_id`)
* **Description**: Tell the LLM when to use this (e.g., "Use this whenever a user asks where their package is.")

### 2. The Webhook URL

Provide the URL of your API endpoint. When the tool is triggered, Movoice will send a POST request with the extracted parameters.

### 3. Response Integration

Your server should respond with a JSON object. Movoice will pass this data back to the LLM, which will then translate the technical results into natural language for the caller.

## Security

We recommend using **API Keys** or **Secret Tokens** in your headers to ensure that only Movoice AI can trigger your internal functions.
