read_handle

Return the conversation id inside a handle. The signature is verified first and the expiry second, both before the id is trusted for anything.

Parameters

Returns

str — the conversation id.

Raises

GatewayRejection, carrying the status the browser should see:

An expired handle is normal rather than exceptional. Every long-lived conversation reaches it eventually, so treat it as “start a new conversation” instead of something to show the visitor.

Example

1
from signalwire.ai_chat import ChatGateway, GatewayRejection
2
3
gateway = ChatGateway(config_url="https://bayview-taxi.example.com/swml")
4
5
6
def conversation_for(handle: str) -> str | None:
7
    try:
8
        return gateway.read_handle(handle)
9
    except GatewayRejection as rejection:
10
        if rejection.status == 403:
11
            return None  # expired or forged; start fresh
12
        raise