Redeem handoff link
Consumes a handoff link and returns the contact it was issued for, so the caller can attach the new conversation to that existing contact instead of creating a duplicate.
Single-use is enforced atomically: the second call on the same token fails, even if it arrives concurrently with the first. Expired links fail the same way — the check is on the stored expiry, not on MongoDB’s TTL sweep, which lags by up to a minute.
Like ReadSupportTokenController, this accepts any identity the route’s
requireAnyIdentity policy admits rather than requiring tenant membership: the
usual caller is Talqui Core reacting to an inbound message, authenticating
as a plugin with no operator session of its own.