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

# timeout e retries

> configurações de confiabilidade e proteção

configurações que garantem que o webhook chega, mesmo com falhas.

## timeout padrão

em cada tentativa você tem **10 segundos** pra responder com sucesso. se demorar mais, considera timeout e tenta novamente.

## retry automático

quando falha (erro `5XX` ou timeout), a gente tenta novamente.

### configuração padrão

* **máximo de tentativas**: 5
* **primeira espera**: 10 segundos
* **backoff exponencial**: cada tentativa espera o dobro da anterior

### exemplo de tentativas

```
1ª tentativa: imediata
2ª tentativa: 10 segundos depois
3ª tentativa: 20 segundos depois
4ª tentativa: 40 segundos depois
5ª tentativa: 80 segundos depois
```

depois de 5 falhas nós marcamos como falha e paramos de enviar. você pode reenviar manualmente pela plataforma se quiser.

## erros retentáveis vs não-retentáveis

### retenta (`5XX`, timeout ou `429`)

* `500+` — erro no seu servidor, pode ser temporário
* timeout — levou demais, talvez fique melhor da próxima vez
* rede indisponível

não retenta `4XX` exceto `429`

se responde `400`, a gente marca como falha imediatamente sem tentar novamente.