Skip to content

Retry and Delivery Policies

alsi-lawr edited this page Jul 15, 2026 · 1 revision

Retry and delivery policies

Policy sections live under TwitchBot:Policies. They are required when the Twitch runtime is active.

Session policies

Policy Attempts Initial delay Maximum delay Backoff Attempt timeout
IrcSession 5 00:00:03 00:00:30 Exponential 00:02:00
EventSubSession 5 00:00:05 00:01:00 Exponential 00:02:00
EventSubChannelRecovery 5 00:00:05 00:01:00 Exponential 00:01:00

Public chat

Policy Shipped value
PublicChatRetry:AttemptLimit 3
PublicChatRetry:Delay 00:00:01
PublicChatRetry:MaximumDelay 00:00:30
PublicChatRetry:DelayBackoffType Exponential
PublicChatDeliveryLifetime:MaximumAge 00:00:30
PublicChatTerminalRetention:Duration 7.00:00:00

Validation rules

  • Attempt limits must be at least one.
  • Delays, timeouts, delivery lifetime, and retention must be positive.
  • Maximum delay cannot be shorter than the initial delay.
  • Public-chat maximum age cannot exceed one minute.
  • Backoff must be a defined Polly DelayBackoffType; the shipped value is Exponential.

Retries improve resilience but do not create an exactly-once guarantee. Expired, terminal, and ambiguous delivery outcomes remain visible to operations; see Runtime health and delivery.

Clone this wiki locally