> ## 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.

# Início rápido

> Autentique-se e faça sua primeira chamada à API da iZap.

Este guia leva você do zero até sua primeira chamada de API autenticada. Você vai
precisar de uma conta iZap no ambiente que estiver usando (produção ou staging).

## Passo 1: obtenha um token de acesso

A API autentica cada requisição com um Bearer JWT. Para começar rápido, troque suas
credenciais de conta por um token no endpoint de login:

```bash 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"}
```

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

## Passo 2: chame a API

Envie o token como um header Bearer em cada requisição:

```bash theme={null}
export IZAP_TOKEN="<JWT>"
curl "https://api.izap.ai/api/v1/businesses" \
     -H "Authorization: Bearer $IZAP_TOKEN"
```

Os tokens expiram — renove-os (fazendo login novamente ou via OAuth refresh grant)
quando uma requisição retornar `401`.

## Passo 3: conecte o Analytics MCP (opcional)

Prefere controlar a iZap a partir de um cliente ou agente de IA? Aponte-o para o
servidor iZap Analytics MCP e chame as ferramentas diretamente:

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

Veja [Analytics MCP](/pt/api-reference/mcp) para o catálogo completo de ferramentas.

<Tip>
  Quer que a configuração seja feita para você? `npx @izap/wizard` grava um
  cliente REST, MCP, webhook ou SSE funcional no seu projeto. Veja o
  [assistente de configuração](/pt/api-reference/wizard).
</Tip>

## Próximos passos

<Columns cols={2}>
  <Card title="Autenticação" icon="key" href="/pt/api-reference/authentication">
    Fluxo OAuth 2.0, descoberta e uso de JWT.
  </Card>

  <Card title="API REST" icon="code" href="/pt/api-reference/introduction">
    Os recursos que a iZap expõe e como chamá-los.
  </Card>
</Columns>