Webhook — troubleshooting
Errori comuni e come Botely fa il retry.
Schedule retry
Su 5xx, 408, 425, 429 o errori di rete Botely riprova dopo 30 s, 2 min, 10 min, 1 h e 6 h.
Dopo i tuoi `retryMax` tentativi falliti la delivery passa a dead_letter e appare in dashboard. Default 5, alzabile fino a 20 in /app/settings/webhooks.
Su 4xx (escluso 408/425/429) Botely NON riprova — il receiver ha detto esplicitamente no.
Firma non valida
Se la verifica fallisce: assicurati di firmare i BYTE RAW del body, NON l'oggetto JSON parsato. Una ri-serializzazione cambia whitespace e ordine chiavi.
Se ruoti il secret in /app/settings/webhooks, il vecchio secret smette di funzionare immediatamente. Le delivery in volo falliranno.
Test payload
Ogni card webhook ha un pulsante 'Send test'. Invia un payload sintetico `action=TEST` firmato con il tuo secret live e mostra inline status code + body della risposta. Test rate-limit 5/min/utente.
Timeout
Botely aspetta fino a 10 s la risposta. Endpoint più lenti sono trattati come errori di rete e quindi retryable. Se il tuo receiver è intenzionalmente async (mette in coda), rispondi 200 subito e processa in background.