zapapi 1.0.0

SDK oficial Python para a API ZapApi — WhatsApp para desenvolvedores

ZapApi Python SDK

SDK oficial Python para a ZapApi — WhatsApp API para desenvolvedores.

Instalacao

pip install zapapi

Quick Start

from zapapi import ZapApi

client = ZapApi(api_key="zap_live_sua_chave_aqui")

# Criar uma sessao
session = client.sessions.create(name="Meu Bot")

# Enviar mensagem de texto
client.messages.send_text(
    session_id=session["id"],
    to="[e-mail]",
    text="Ola pelo ZapApi!",
)

# Listar sessoes
for s in client.sessions.list():
    print(s["name"], s["status"])

Async

import asyncio
from zapapi import AsyncZapApi

async def main():
    async with AsyncZapApi(api_key="zap_live_sua_chave_aqui") as client:
        sessions = await client.sessions.list()

        await client.messages.send_text(
            session_id=sessions[0]["id"],
            to="[e-mail]",
            text="Mensagem async!",
        )

asyncio.run(main())

Recursos Disponiveis

Recurso	Descricao
client.sessions	Criar, conectar, desconectar e gerenciar sessoes WhatsApp
client.messages	Enviar texto, midia, botoes, listas, localizacao, contato, enquete, reacao, sticker
client.groups	Criar e gerenciar grupos, participantes, links de convite
client.contacts	Verificar numeros, foto de perfil
client.webhooks	Registrar, atualizar, testar e gerenciar webhooks
client.account	Dados da conta, uso, chaves de API

Enviar Diferentes Tipos de Mensagem

# Midia (imagem, video, audio, documento)
client.messages.send_media(
    session_id="sess_abc",
    to="[e-mail]",
    media_url="https://example.com/foto.jpg",
    type="image",
    caption="Veja esta foto!",
)

# Localizacao
client.messages.send_location(
    session_id="sess_abc",
    to="[e-mail]",
    latitude=-23.5505,
    longitude=-46.6333,
    name="Sao Paulo",
)

# Enquete
client.messages.send_poll(
    session_id="sess_abc",
    to="[e-mail]",
    question="Qual sua linguagem favorita?",
    options=["Python", "TypeScript", "Go"],
)

# Reacao
client.messages.send_reaction(
    session_id="sess_abc",
    to="[e-mail]",
    message_id="msg_xyz",
    emoji="👍",
)

Gerenciar Grupos

# Criar grupo
group = client.groups.create(
    session_id="sess_abc",
    name="Equipe Vendas",
    participants=["[e-mail]"],
)

# Adicionar participantes
client.groups.add_participants(
    session_id="sess_abc",
    group_id=group["id"],
    participants=["[e-mail]"],
)

# Link de convite
link = client.groups.invite_link(session_id="sess_abc", group_id=group["id"])

Webhooks

# Registrar webhook
client.webhooks.create(
    url="https://meuapp.com/webhook",
    events=["message.received", "session.status"],
    secret="meu_segredo",
)

# Verificar assinatura no seu servidor
from zapapi import verify_signature

is_valid = verify_signature(
    body=request.body,          # bytes do body
    signature=request.headers["X-ZapApi-Signature"],
    secret="meu_segredo",
)

Tratamento de Erros

from zapapi import ZapApi, ZapApiError, RateLimitError, AuthenticationError

client = ZapApi(api_key="zap_live_...")

try:
    client.sessions.get("sess_inexistente")
except AuthenticationError:
    print("Chave de API invalida")
except RateLimitError as e:
    print(f"Rate limit — tente novamente em {e.retry_after}s")
except ZapApiError as e:
    print(f"Erro {e.status_code}: {e.message}")

Context Manager

# Sync
with ZapApi(api_key="zap_live_...") as client:
    client.sessions.list()

# Async
async with AsyncZapApi(api_key="zap_live_...") as client:
    await client.sessions.list()

Links

• Documentacao
• API Reference
• Dashboard
• GitHub

Licenca

MIT - INOVIX