Get a user
Resolve a human participant your agent is in conversation with. Every message.received event carries data.message.sender.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 (direct or group) 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 at agent creation.
Path Parameters
The sender.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.