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

# API in ingresso del canale

I Plugin di canale dovrebbero modellare i percorsi di ricezione con i sostantivi inbound e message:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
platform event -> inbound facts/context -> agent reply -> message delivery
```

Usa `openclaw/plugin-sdk/channel-inbound` per la normalizzazione degli eventi inbound,
la formattazione, le root e l'orchestrazione. Usa
`openclaw/plugin-sdk/channel-outbound` per il comportamento nativo di
invio, ricevuta, consegna durevole e anteprima live.

## Helper Di Base

```ts theme={"theme":{"light":"min-light","dark":"min-dark"}}
import {
  buildChannelInboundEventContext,
  runChannelInboundEvent,
  dispatchChannelInboundReply,
} from "openclaw/plugin-sdk/channel-inbound";
```

* `buildChannelInboundEventContext(...)`: proietta i fatti di canale normalizzati nel
  contesto di prompt/sessione. Usa `channelContext` per passare i metadati
  sender/chat di proprietà del canale a `ctx.channelContext` dell'hook del Plugin; estendi
  `PluginHookChannelSenderContext` o `PluginHookChannelChatContext` da questo
  subpath per i campi specifici del canale.
* `runChannelInboundEvent(...)`: esegue ingest, classificazione, preflight, risoluzione,
  registrazione, dispatch e finalizzazione per un evento di piattaforma inbound.
* `dispatchChannelInboundReply(...)`: registra e invia una risposta inbound già assemblata
  con un adattatore di consegna.

Il runtime del Plugin iniettato espone gli stessi helper di alto livello sotto
`runtime.channel.inbound.*` per i canali in bundle/nativi che ricevono già
l'oggetto runtime.

```ts theme={"theme":{"light":"min-light","dark":"min-dark"}}
await runtime.channel.inbound.run({
  channel: "demo",
  accountId,
  raw: platformEvent,
  adapter: {
    ingest: normalizePlatformEvent,
    resolveTurn: resolveInboundReply,
  },
});
```

I dispatcher di compatibilità dovrebbero assemblare gli input di `dispatchChannelInboundReply(...)`
e mantenere la consegna della piattaforma nell'adattatore di consegna. I nuovi percorsi di invio dovrebbero
preferire gli adattatori message e gli helper message durevoli.

## Migrazione

I vecchi alias runtime `runtime.channel.turn.*` sono stati rimossi. Usa:

* `runtime.channel.inbound.run(...)` per eventi inbound raw.
* `runtime.channel.inbound.dispatchReply(...)` per contesti di risposta assemblati.
* `runtime.channel.inbound.buildContext(...)` per payload di contesto inbound.
* `runtime.channel.inbound.runPreparedReply(...)` solo per percorsi di dispatch preparati
  di proprietà del canale che assemblano già la propria closure di dispatch.

Il nuovo codice Plugin non dovrebbe introdurre API di canale denominate `turn`. Mantieni il vocabolario
turn del modello o dell'agente nel codice agent/provider; i Plugin di canale usano i termini inbound,
message, delivery e reply.