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

# Comece Aqui

> API potente para gestão de instâncias e automações no WhatsApp. Conecte-se, envie mensagens e gerencie eventos facilmente.

{document.querySelectorAll("#footer a").forEach((a) => a.remove())}

<Note>
  **Base URL:** `https://api.wppfy.com`
</Note>

## ⚠️ Recomendação Importante

<Warning>
  **Use WhatsApp Business**

  Recomenda-se fortemente utilizar contas de **WhatsApp Business** para evitar desconexões, limitações de envio e instabilidade na conexão.
</Warning>

## Autenticação

Para interagir com a API, você precisará configurar os *Headers* de suas solicitações. Escolha o tipo de acesso necessário:

<CodeGroup>
  ```bash Token da Instância theme={null}
  # Header para rotas de envio e controle de sessão
  token: SEU_TOKEN_AQUI
  ```
</CodeGroup>

## Estados da Sessão

Entenda o que significa cada estado de conexão para monitorar suas instâncias em tempo real.

<CardGroup cols={3}>
  <Card title="Desconectado" icon="circle-xmark" color="#ef4444">
    A instância está totalmente desconectada do servidor do WhatsApp.
  </Card>

  <Card title="Conectando" icon="rotate" color="#eab308">
    O sistema está tentando estabelecer o handshake com o WhatsApp.
  </Card>

  <Card title="Conectado" icon="circle-check" color="#22c55e">
    Conexão estável. A instância está pronta para enviar e receber dados.
  </Card>
</CardGroup>

## Limites e Restrições

<CardGroup cols={2}>
  <Card title="Limite de Instâncias" icon="gauge-high">
    O servidor tem um limite estrito de instâncias simultâneas ("slots").
  </Card>

  <Card title="Taxa de Limite (429)" icon="ban">
    Se o limite for atingido, novas conexões retornarão **HTTP 429**.
  </Card>
</CardGroup>

<Info>
  **Servidores Grátis/Demo:** tem restrições adicionais de tempo de vida (TTL) da instância, desconectando-se automaticamente após um período.
</Info>

## Recursos Adicionais

<CardGroup cols={2}>
  <Card title="Baixar Spec OpenAPI" icon="file-arrow-down" href="#">
    Baixe o arquivo JSON/YAML para importar no Postman ou Insomnia.
  </Card>

  <Card title="Suporte Técnico" icon="headset" href="https://wppfy.com/dashboard?support=true">
    Acesse nosso canal de suporte para dúvidas sobre integração.
  </Card>
</CardGroup>