Get a user
Resolve a human participant your agent is in conversation with. Every message.received event carries data.sender_handle.id (a usr_… id); pass it here to read that sender’s name and messaging phone number, enough to greet them or match them to an existing account.
Scope: the user must currently share an active conversation with your agent. Any other id (unknown, or a user you have no active conversation with) returns 404 so the endpoint can neither enumerate accounts nor confirm who owns a phone number.
Authorizations
Agent Token (rly_live_…), shown once when the agent is created in Relay Console.
Path Parameters
The sender_handle.id from a message.received event.
Response
The resolved user profile.
A human participant your agent shares a conversation with. name is canonical; first_name/last_name are a convenience split of name on the first space (a two-word given name puts its tail in last_name), so greet with them but store name if you need the exact value.

