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

# Quickstart

> Comece a usar a API em menos de 5 minutos

## Pré-requisitos

<Steps>
  <Step title="Conta Leavo">
    Crie uma conta em [app.leavo.ai](https://app.leavo.ai)
  </Step>

  <Step title="Chave de API">
    Gere uma chave de API em **Configurações** > **Chaves de API**
  </Step>
</Steps>

## Sua Primeira Requisição

Vamos fazer uma requisição simples para listar seus leads:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.leavo.ai/backend/leads" \
    -H "Authorization: Bearer sua_chave_aqui"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.leavo.ai/backend/leads', {
    headers: {
      'Authorization': 'Bearer sua_chave_aqui'
    }
  });

  const leads = await response.json();
  console.log(leads);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.leavo.ai/backend/leads',
      headers={'Authorization': 'Bearer sua_chave_aqui'}
  )

  print(response.json())
  ```
</CodeGroup>

## Criar seu Primeiro Lead

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.leavo.ai/backend/leads" \
    -H "Authorization: Bearer sua_chave_aqui" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "João Silva",
      "email": "joao@exemplo.com",
      "phone": "+5511999999999",
      "company": "Empresa XYZ"
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.leavo.ai/backend/leads', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sua_chave_aqui',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: 'João Silva',
      email: 'joao@exemplo.com',
      phone: '+5511999999999',
      company: 'Empresa XYZ'
    })
  });

  const lead = await response.json();
  console.log('Lead criado:', lead);
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://api.leavo.ai/backend/leads',
      headers={
          'Authorization': 'Bearer sua_chave_aqui',
          'Content-Type': 'application/json'
      },
      json={
          'name': 'João Silva',
          'email': 'joao@exemplo.com',
          'phone': '+5511999999999',
          'company': 'Empresa XYZ'
      }
  )

  print('Lead criado:', response.json())
  ```
</CodeGroup>

## Processar Mensagem com IA

Envie uma mensagem para processamento com nossa IA:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.leavo.ai/ai/process" \
    -H "Authorization: Bearer sua_chave_aqui" \
    -H "Content-Type: application/json" \
    -d '{
      "tenant_id": "seu_tenant_id",
      "lead_id": "id_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"
    }'
  ```

  ```javascript JavaScript theme={null}
  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: 'seu_tenant_id',
      lead_id: 'id_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'
    })
  });
  ```
</CodeGroup>

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Gerenciar Leads" icon="users" href="/pt-BR/api-reference/leads/list">
    CRUD completo de leads
  </Card>

  <Card title="Configurar Webhooks" icon="webhook" href="/pt-BR/api-reference/webhooks/overview">
    Integre com sistemas externos
  </Card>

  <Card title="Criar Cadências" icon="calendar" href="/pt-BR/api-reference/cadences/overview">
    Automatize sequências de mensagens
  </Card>

  <Card title="Campos Personalizados" icon="sliders" href="/pt-BR/api-reference/custom-fields/overview">
    Adicione campos customizados aos leads
  </Card>
</CardGroup>