Guest API proactive message 403 forbidden

NICE CXone API & Integrations
1

Trying to send a proactive web message to a returning guest using the Guest API. I have the guestId from the previous session but keep hitting a 403.

  • Endpoint: POST /api/v2/guests/{guestId}/messages
  • Header: Authorization: Bearer {token}
  • Payload: {“content”: “Hi there”}

Is there a specific scope missing or a session validity check I’m overlooking?

2

The docs state: “Proactive messaging requires an active guest session.” Your guestId is likely expired. You can’t just reuse an old ID. Generate a fresh one via POST /api/v2/guests/sessions first. Then use that new guestId in the message payload. The 403 is the session being stale.