Processamento com IA

Visão Geral

O endpoint de processamento com IA permite enviar mensagens de texto, imagens, áudios e PDFs para análise inteligente. O sistema pode responder de forma síncrona ou assíncrona (via postback).

Endpoint Principal

POST /ai/process

Parâmetros do Payload

string

obrigatório

ID do tenant (obtido no dashboard)

string

obrigatório

ID do lead que está enviando a mensagem

string

obrigatório

Papel do remetente: user, assistant, human, system

string

obrigatório

Conteúdo da mensagem

string

obrigatório

Tipo da mensagem: text, image, audio, pdf

string

URL da mídia (obrigatório para tipos diferentes de text)

boolean

padrão:"false"

Quando true, acumula mensagens e envia resposta via postback

string

URL para receber a resposta (obrigatório quando debounce: true)

Exemplo de Requisição

curl -X POST "https://api.leavo.ai/ai/process" \
  -H "Authorization: Bearer sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "tenant_id": "uuid-do-tenant",
    "lead_id": "uuid-do-lead",
    "role": "user",
    "content": "Olá, gostaria de saber mais sobre o produto",
    "message_type": "text",
    "debounce": true,
    "postback_url": "https://seu-webhook.com/callback"
  }'

const response = await fetch('https://api.leavo.ai/ai/process', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sua_chave_aqui',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    tenant_id: 'uuid-do-tenant',
    lead_id: 'uuid-do-lead',
    role: 'user',
    content: 'Olá, gostaria de saber mais sobre o produto',
    message_type: 'text',
    debounce: true,
    postback_url: 'https://seu-webhook.com/callback'
  })
});

Tipos de Mensagem

Texto

Mensagem de texto simples.

{
  "message_type": "text",
  "content": "Sua mensagem aqui"
}

Imagem

Envie uma imagem para análise visual.

{
  "message_type": "image",
  "content": "Descrição opcional",
  "url": "https://exemplo.com/imagem.jpg"
}

Áudio

Envie um áudio para transcrição e análise.

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

PDF

Envie um PDF para extração de conteúdo.

{
  "message_type": "pdf",
  "url": "https://exemplo.com/documento.pdf"
}

Modo Debounce

O modo debounce é útil quando você quer acumular várias mensagens antes de processar.

Como Funciona

Quando debounce: true, o sistema acumula mensagens por um tempo configurado
Após o tempo de debounce, todas as mensagens são processadas juntas
A resposta é enviada para a postback_url

Fluxo de Requisição

Resposta Síncrona (sem debounce)

Quando debounce: false, a resposta é retornada imediatamente:

{
  "success": true,
  "response": "Olá! Claro, posso ajudar com informações sobre nosso produto..."
}

Resposta via Postback

Quando debounce: true, o postback recebe:

{
  "lead_id": "uuid-do-lead",
  "response": "Olá! Claro, posso ajudar com informações sobre nosso produto...",
  "timestamp": "2024-01-15T10:30:00Z"
}

Início

Conceitos

Boas Práticas

Processamento com IA

Visão Geral

Endpoint Principal

Parâmetros do Payload

Exemplo de Requisição

Tipos de Mensagem

Modo Debounce

Como Funciona

Fluxo de Requisição

Resposta Síncrona (sem debounce)

Resposta via Postback

​Visão Geral

​Endpoint Principal

​Parâmetros do Payload

​Exemplo de Requisição

​Tipos de Mensagem

​Modo Debounce

​Como Funciona

​Fluxo de Requisição

​Resposta Síncrona (sem debounce)

​Resposta via Postback

Visão Geral

Endpoint Principal

Parâmetros do Payload

Exemplo de Requisição

Tipos de Mensagem

Modo Debounce

Como Funciona

Fluxo de Requisição

Resposta Síncrona (sem debounce)

Resposta via Postback