Create handoff link
Issues a single-use link that lets the contact continue the conversation on a different channel while staying the same contact.
The source session supplies the contact and the channel being left; the
destination plugin connection decides which strategy builds the URL — a
wa.me deep link whose pre-filled text carries the token, a Telegram
?start= deep link, or a Web Chat URL with the token as a query param.
A Web Chat destination also seeds the contact’s
contactExternal['urn:talqui:chat-widget:0'] when it has none, and embeds
it in the link as S_ID, so the contact is recognized in whichever browser
they open it in. That is the only write this endpoint performs, it never
replaces an existing id, and it is skipped for every other channel — see
CreateHandoffLinkUseCase.resolveShadowID.
The link is only generated here. Delivering it to the contact — pasting it into a reply, or sending it automatically — is the caller’s job.
Path Parameters
The tenant the handoff link is issued for.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Body
Plugin connection of the channel the contact should move to.
1Session the contact is currently talking on.
1How long the link stays redeemable. Defaults to 24h.
300 <= x <= 604800Response
Response for status 201.