> ## Documentation Index
> Fetch the complete documentation index at: https://docs-zap.loce.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SDKs

> Bibliotecas oficiais para integração com a API

<Tip>
  **Acelere sua integração com nossos SDKs**: Nossas bibliotecas oficiais facilitam a integração com a API da LoceZap.
</Tip>

## <Icon icon="code" type="solid" />  O que são os SDKs da LoceZap?

Os SDKs (Software Development Kits) da LoceZap são bibliotecas que simplificam a comunicação com nossa API. Eles oferecem uma interface amigável e específica para cada linguagem, permitindo que você integre rapidamente no seu aplicativo.

## <Icon icon="boxes-stacked" type="solid" />  SDKs Disponíveis

Oferecemos SDKs oficiais para diversas linguagens de programação. Escolha o que melhor se adapta à sua stack tecnológica:

<Tabs>
  <Tab title="Backend">
    <CardGroup cols={2}>
      <Card title="Node.js" icon="node-js" color="#68A063" href="https://www.npmjs.com/package/loce-zap">
        SDK oficial para Node.js
      </Card>

      <Card title="Python" icon="python" color="#366B98" href="https://pypi.org/project/loce-zap/">
        SDK oficial para Python
      </Card>
    </CardGroup>
  </Tab>
</Tabs>

## <Icon icon="terminal" type="solid" />  Exemplos de Uso

Veja como é simples usar nossos SDKs em algumas das linguagens mais populares:

<CodeGroup>
  ```javascript Node.js theme={null}
  // Instalação: npm install loce-zap
  import { LoceZap } from 'loce-zap-sdk';

  // Inicialize o cliente com sua chave de API
  const zap = new LoceZap({ apiKey: process.env.LOCE_ZAP_API_KEY! });

  // Crie um uma sessao whatsapp 
  const { qrCode } = await zap.connect('my-session-id', {
    sessionName: 'Whatsapp do Zé',
    webhookUrl: 'https://example.com/webhook',
    webhookMessages: true, //Evento de mensagens (não disponível no plano free)
  });
  ```

  ```python Python theme={null}
  # Instalação: pip install loce-zap
  import LoceZap

  # Inicialize o cliente com sua chave de API
  zap = LoceZap("your_api_key")

  // Crie um uma sessao whatsapp 
  qr = zap.connect("Support Session", "https://example.com/webhook", webhook_messages=True)
  print(qr.status, qr.qrCode)

  // Envie uma mensagem de texto
  zap.send_message_text("support-session", "5511999999999", "Hello from Python 👋")
  ```
</CodeGroup>

## <Icon icon="question-circle" type="solid" />  Perguntas Frequentes

<Accordion title="Como instalar o SDK da minha linguagem?">
  Você pode usar o gerenciador de pacotes da sua linguagem, como npm, pip.
</Accordion>

<Accordion title="Falta um SDK para a linguagem que eu uso. O que fazer?">
  Entre em contato conosco via discord [https://discord.gg/kK7BedTdzR](https://discord.gg/kK7BedTdzR) informando qual linguagem você precisa. Também aceitamos contribuições da comunidade!
</Accordion>

## <Icon icon="book" type="solid" />  Recursos Adicionais

<Card title="Webhooks" icon="webhook" href="./webhook">
  Aprenda a configurar webhooks para receber notificações de eventos.
</Card>