AI Processing

Overview

The AI processing endpoint allows you to send text messages, images, audio, and PDFs for intelligent analysis. The system can respond synchronously or asynchronously (via postback).

Main Endpoint

POST /ai/process

Payload Parameters

string

required

Tenant ID (obtained from dashboard)

string

required

ID of the lead sending the message

string

required

Sender role: user, assistant, human, system

string

required

Message content

string

required

Message type: text, image, audio, pdf

string

Media URL (required for types other than text)

boolean

default:"false"

When true, accumulates messages and sends response via postback

string

URL to receive the response (required when debounce: true)

Request Example

curl -X POST "https://api.leavo.ai/ai/process" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "tenant_id": "tenant-uuid",
    "lead_id": "lead-uuid",
    "role": "user",
    "content": "Hello, I would like to know more about the product",
    "message_type": "text",
    "debounce": true,
    "postback_url": "https://your-webhook.com/callback"
  }'

const response = await fetch('https://api.leavo.ai/ai/process', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your_api_key_here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    tenant_id: 'tenant-uuid',
    lead_id: 'lead-uuid',
    role: 'user',
    content: 'Hello, I would like to know more about the product',
    message_type: 'text',
    debounce: true,
    postback_url: 'https://your-webhook.com/callback'
  })
});

Message Types

Text

Simple text message.

{
  "message_type": "text",
  "content": "Your message here"
}

Image

Send an image for visual analysis.

{
  "message_type": "image",
  "content": "Optional description",
  "url": "https://example.com/image.jpg"
}

Audio

Send audio for transcription and analysis.

{
  "message_type": "audio",
  "url": "https://example.com/audio.mp3"
}

PDF

Send a PDF for content extraction.

{
  "message_type": "pdf",
  "url": "https://example.com/document.pdf"
}

Debounce Mode

Debounce mode is useful when you want to accumulate multiple messages before processing.

How It Works

When debounce: true, the system accumulates messages for a configured time
After the debounce time, all messages are processed together
The response is sent to the postback_url

Request Flow

Synchronous Response (without debounce)

When debounce: false, the response is returned immediately:

{
  "success": true,
  "response": "Hello! Sure, I can help with information about our product..."
}

Postback Response

When debounce: true, the postback receives:

{
  "lead_id": "lead-uuid",
  "response": "Hello! Sure, I can help with information about our product...",
  "timestamp": "2024-01-15T10:30:00Z"
}

Getting Started

Core Concepts

Best Practices

Overview

Main Endpoint

Payload Parameters

Request Example

Message Types

Debounce Mode

How It Works

Request Flow

Synchronous Response (without debounce)

Postback Response

​Overview

​Main Endpoint

​Payload Parameters

​Request Example

​Message Types

​Debounce Mode

​How It Works

​Request Flow

​Synchronous Response (without debounce)

​Postback Response

Overview

Main Endpoint

Payload Parameters

Request Example

Message Types

Debounce Mode

How It Works

Request Flow

Synchronous Response (without debounce)

Postback Response