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

# Construa na iZap

> A plataforma de desenvolvedor para automação de negócios voltada para WhatsApp — uma API REST, OAuth 2.0 e um servidor MCP de Analytics para seus agentes.

A iZap faz automação de negócios voltada para WhatsApp: assistentes de IA cuidam de
conversas com clientes, pedidos e agendamentos. **É aqui que você constrói sobre
ela** — chame a API REST ou controle tudo por um agente de IA via servidor MCP. A
mesma lógica de negócio e a mesma autenticação OAuth 2.0 em todo lugar.

<Columns cols={2}>
  <Card title="Obtenha um token de acesso e faça sua primeira chamada" icon="rocket" href="/pt/quickstart" horizontal cta="Começar o início rápido" arrow>
    Do zero a uma requisição autenticada em poucos minutos.
  </Card>

  <Card title="Abra o dashboard" icon="gauge" href="https://dash.izap.ai" horizontal cta="Ir para dash.izap.ai" arrow>
    Gerencie assistentes, empresas e o acesso à API.
  </Card>
</Columns>

## Sua primeira chamada

Troque suas credenciais por um JWT e envie-o como token Bearer em cada requisição.

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.izap.ai/api/v1/auth/jwt/login" \
       -H "Content-Type: application/x-www-form-urlencoded" \
       -d "username=$IZAP_EMAIL&password=$IZAP_PASSWORD"
  # -> {"access_token":"<JWT>","token_type":"bearer"}

  curl "https://api.izap.ai/api/v1/businesses" \
       -H "Authorization: Bearer $IZAP_TOKEN"
  ```

  ```python Python theme={null}
  import os, httpx

  base = "https://api.izap.ai"
  tok = httpx.post(
      f"{base}/api/v1/auth/jwt/login",
      data={"username": os.environ["IZAP_EMAIL"], "password": os.environ["IZAP_PASSWORD"]},
  ).json()["access_token"]

  r = httpx.get(f"{base}/api/v1/businesses", headers={"Authorization": f"Bearer {tok}"})
  print(r.json())
  ```

  ```typescript TypeScript theme={null}
  const base = "https://api.izap.ai";

  const login = await fetch(`${base}/api/v1/auth/jwt/login`, {
    method: "POST",
    headers: { "Content-Type": "application/x-www-form-urlencoded" },
    body: new URLSearchParams({
      username: process.env.IZAP_EMAIL!,
      password: process.env.IZAP_PASSWORD!,
    }),
  });
  const { access_token } = await login.json();

  const res = await fetch(`${base}/api/v1/businesses`, {
    headers: { Authorization: `Bearer ${access_token}` },
  });
  console.log(await res.json());
  ```
</CodeGroup>

<Note>
  Para aplicativos de terceiros, use o fluxo OAuth 2.0 authorization-code + PKCE em
  vez de armazenar credenciais — veja [Autenticação](/pt/api-reference/authentication).
</Note>

<Tip>
  Pule o trabalho repetitivo: `npx @izap/wizard` monta um cliente funcional REST,
  MCP, webhook ou SSE na sua stack. Veja o
  [assistente de configuração](/pt/api-reference/wizard).
</Tip>

## O que você pode construir

<Columns cols={3}>
  <Card title="API REST" icon="code" href="/pt/api-reference/introduction">
    Chats, empresas, agendamentos, templates e transmissões sob `/api/v1`. JSON na
    entrada, JSON na saída, versionado e previsível.
  </Card>

  <Card title="Analytics MCP" icon="robot" href="/pt/api-reference/mcp">
    Aponte o Claude, o ChatGPT ou seu próprio agente para `{origin}/mcp` e chame as
    ferramentas de analytics e gerenciamento de assistentes diretamente.
  </Card>

  <Card title="Autenticação" icon="key" href="/pt/api-reference/authentication">
    Um único servidor OAuth 2.0 para a API e para o MCP. JWTs Bearer para
    servidor-a-servidor, authorization-code + PKCE para apps interativos.
  </Card>
</Columns>

## Controle a iZap por um agente

Registre o Analytics MCP como um servidor HTTP remoto e seu agente poderá chamar as
ferramentas da iZap com o mesmo token da API REST.

```json theme={null}
{
  "mcpServers": {
    "izap": {
      "type": "http",
      "url": "https://api.izap.ai/mcp",
      "headers": { "Authorization": "Bearer ${IZAP_TOKEN}" }
    }
  }
}
```

<Card title="Veja o catálogo completo de ferramentas do MCP" icon="list-check" href="/pt/api-reference/mcp" horizontal arrow>
  Gerenciamento de assistentes, estatísticas de mensagens, analytics de conversas e busca por palavra-chave.
</Card>

## Ambientes

| Ambiente | Origem da API                 | URL do MCP                        |
| -------- | ----------------------------- | --------------------------------- |
| Produção | `https://api.izap.ai`         | `https://api.izap.ai/mcp`         |
| Staging  | `https://api-staging.izap.ai` | `https://api-staging.izap.ai/mcp` |

<Note>
  A API REST é versionada sob `/api/v1`; mudanças que quebram compatibilidade migram
  para um novo caminho de versão. A referência interativa de **Endpoints**, na aba de
  referência da API, é gerada a partir da spec OpenAPI curada e é a fonte autoritativa
  dos formatos de requisição e resposta.
</Note>

## Continue

<Columns cols={3}>
  <Card title="Início rápido" icon="rocket" href="/pt/quickstart">
    O passo a passo completo, do token à primeira chamada.
  </Card>

  <Card title="Status da API" icon="signal" href="https://api.izap.ai/status">
    Saúde da API de produção em tempo real.
  </Card>

  <Card title="AI Trainer" icon="graduation-cap" href="https://trainer.izap.ai/trainer">
    Treine e refine seus assistentes de WhatsApp.
  </Card>
</Columns>