SDKs

Chame a API REST pelo seu app com um cliente gerado. Os dois SDKs usam um personal access token. 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
SDK TypeScript	`npm install @izapai/sdk`	versariai/izap-sdk-typescript

Os clientes encapsulam o mesmo schema público da API REST. 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 para os headers e o esquema de assinatura. Precisa de um scaffold em um app existente? O assistente de configuração grava código REST, MCP, webhook ou SSE. No terminal, npm install -g @izapai/cli — a CLI. izap init executa o assistente.

Python (`izap`)

Requer Python 3.11 ou mais novo.

pip install izap

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

TypeScript (`@izapai/sdk`)

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

npm install @izapai/sdk

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

Visão geral

Endpoints

Python (`izap`)

TypeScript (`@izapai/sdk`)

​Python (izap)

​TypeScript (@izapai/sdk)

Python (`izap`)

TypeScript (`@izapai/sdk`)