message.delivery_failed

Fired when a bot message cannot be delivered

When to use this

Observe failed outbound sends and trigger retries or alerting.

Auth

Requires authenticated bot Socket.IO connection.

Event Payload

Field	Type	Description
`event_id`	`string`	Unique event identifier
`request_id`	`string`	Original request trace ID
`conversation_id`	`string`	Target conversation
`error_code`	`string`	Failure code
`error_message`	`string`	Human-readable reason
`failed_at`	`string`	ISO timestamp

Errors

Delivery failure is itself the error signal; no extra envelope.

cURL

Not applicable for inbound events.

TypeScript

socket.on("message.delivery_failed", (event) => {
  console.error(event.error_code, event.error_message);
});

Retry behavior

Retry only for transient failure codes and always reuse idempotency keys.

interaction.button_clicked

Fired when a user clicks a button component from a bot message

BotMessage

Canonical bot message model

On this page

When to use this Auth Event Payload Errors cURL TypeScript Retry behavior