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

# Visão geral

> WebSocket ou webhook: como escolher o método de recebimento

O Hust oferece dois métodos para receber mensagens em tempo real. Escolha um conforme a arquitetura da sua integração.

<CardGroup cols={2}>
  <Card title="WebSocket" icon="bolt" href="/chat/websocket">
    Sua aplicação abre e mantém uma conexão persistente com o Hust.
  </Card>

  <Card title="Webhook" icon="webhook" href="/chat/webhook">
    O Hust envia uma requisição HTTP para uma URL sua a cada evento.
  </Card>
</CardGroup>

## Qual escolher

|                                      | WebSocket     | Webhook             |
| ------------------------------------ | ------------- | ------------------- |
| Quem inicia a conexão                | Sua aplicação | O Hust              |
| Precisa de URL pública               | Não           | Sim                 |
| Precisa de processo sempre ativo     | Sim           | Não                 |
| Funciona em serverless               | Não           | Sim                 |
| Mensagens perdidas se o cliente cair | Sim           | Não, há retentativa |

O **WebSocket** é a opção natural para aplicações que já rodam como serviço contínuo e que não têm um endereço público acessível pela internet — um bot rodando dentro da sua rede, por exemplo.

O **Webhook** é a opção natural para quem já tem uma API exposta e quer tratar mensagens como qualquer outra requisição HTTP, sem gerenciar reconexão nem manter processo de pé.