Interface: InboundMessageNormalised

An inbound user message after normalisation.

Properties


readonly body: string | null;

Plaintext body for text/captions; emoji for reactions; reply title for interactive.


readonly contactProfileName: string | null;

Display name from Meta’s contacts[].profile.name, if present.


readonly contactWaId: string;

Sender wa_id (E.164 without leading +).


readonly eventId: string;

Globally-unique idempotency key derived from envelope path + wamid.


readonly kind: "inbound_message";


readonly messageType: string;

text, image, document, audio, video, sticker, reaction, interactive, unknown.


readonly payload: Record<string, unknown>;

Normalised body for persistence into messages.payload.


readonly phoneNumberId: string;

Meta wa_phone_number_id from envelope metadata — not our internal uuid.


readonly replyToWamid: string | null;

Reply context: the wamid of the message being replied to, if any.


readonly ts: Date | null;

Meta event time. Unix seconds from the inbound payload, decoded to Date.


readonly waMessageId: string;

Meta wamid.