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

# SDKs

> Clientes tipados em Python e TypeScript para a API REST da iZap.

Chame a API REST pelo seu app com um cliente gerado. Os dois SDKs usam um
[personal access token](/pt/api-reference/authentication). Crie um no Dashboard
em **Configurações do usuário → API Keys**.

| Pacote | Instalação | Código-fonte |
| - | - | - |
| SDK Python | `pip install izap` | [versariai/izap-sdk-python](https://github.com/versariai/izap-sdk-python) |
| SDK TypeScript | `npm install @izapai/sdk` | [versariai/izap-sdk-typescript](https://github.com/versariai/izap-sdk-typescript) |

Os clientes encapsulam o mesmo schema público da [API REST](/pt/api-reference/introduction).
Eles enviam `business-id` como header, retentam requisições idempotentes e disparam
um único tipo de erro em 4xx/5xx. Use `webhooks.verify` em qualquer SDK para
conferir a assinatura de uma entrega contra o corpo **cru** da requisição — veja
[Webhooks](/pt/api-reference/webhooks) para os headers e o esquema de assinatura.

Precisa de um scaffold em um app existente? O [assistente de configuração](/pt/api-reference/wizard)
grava código REST, MCP, webhook ou SSE. No terminal,
`npm install -g @izapai/cli` — a [CLI](/pt/api-reference/cli). `izap init`
executa o assistente.

## Python (`izap`)

Requer Python 3.11 ou mais novo.

```bash theme={null}
pip install izap
```

```python theme={null}
import os

import izap
from izap.api.whatsapp_templates import list_whats_app_templates

client = izap.Client(
    os.environ["IZAP_TOKEN"],
    business_id=os.environ["IZAP_BUSINESS_ID"],
)

with client:
    templates = list_whats_app_templates.sync(client=client, status="approved")
    for template in templates.templates:
        print(template.name, template.language)
```

`izap.AsyncClient` é a contraparte asyncio. Aponte `base_url` para
`https://api-staging.izap.ai` no staging. Todo 4xx/5xx dispara `izap.IzapApiError`.

[PyPI: izap](https://pypi.org/project/izap/)

## TypeScript (`@izapai/sdk`)

Requer Node.js 20 ou mais novo. ESM com declarações de tipo, para uso no servidor.

```bash theme={null}
npm install @izapai/sdk
```

```ts theme={null}
import { createClient } from "@izapai/sdk";

const izap = createClient({
  token: process.env.IZAP_TOKEN!,
  businessId: process.env.IZAP_BUSINESS_ID,
});

const { data } = await izap.listWhatsAppTemplates({
  query: { status: "approved" },
});
for (const template of data.templates) {
  console.log(template.name, template.language);
}
```

Passe `baseUrl: "https://api-staging.izap.ai"` no staging. Respostas fora de 2xx
disparam `IzapApiError`.

[npm: @izapai/sdk](https://www.npmjs.com/package/@izapai/sdk)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.