last_interaction

The last_interaction message is sent from the parent container (myzPAX) to the embedded app (iframe). It provides the timestamp of the last user interaction that was reported by the iframe using the interaction message.

Message Type

type messageType = 'last_interaction';

Payload

type Payload = number; // Timestamp in milliseconds

The payload is a single number representing the time (in milliseconds since epoch) when the embedded app last sent an interaction message to myzPAX.

When It Is Sent

myzPAX sends this message:

  • In response to sendZpaxMessage('last_interaction') from the embedded app.
  • Automatically when the iframe regains focus (e.g., user switches tabs or windows).

Example

const unsubscribe = addZpaxMessageListener('last_interaction', (message) => {
  const lastInteractionTime = new Date(message.data);
  console.log('User last interacted at:', lastInteractionTime.toLocaleString());
});

Use Cases

  • To decide whether to lock the app or re-authenticate based on inactivity duration.
  • To resync timers after the tab becomes active again.

Related