event_inbox

com.sonarconnections/sonar-connections · Verify this server

The person's own conversations with people they have connected with at an event, and the last few lines of one of them. Use it for "any messages", "did Jo reply", "what did Dana say", "read my inbox". Called with no arguments it lists up to twenty threads, person-to-person ones first: each row carries the other person's FIRST NAME, the last line, when it landed, whether that line was the person's own, and how many they have not read. Called with `firstName` or `chatId` it returns the last few lines of that one conversation, oldest first, each line saying only whether it was theirs, what it said and when. It carries no phone number, no email address, no surname, no account id and no photo: those are not on this surface. IT READS ONLY THE CALLER'S OWN CONVERSATIONS and the server re-checks that on every call, so a conversation they are not in comes back refused with NOT_PARTICIPANT rather than empty. A `firstName` is matched against THEIR OWN THREADS ONLY: if two of them answer to it the reply is AMBIGUOUS_NAME and names neither, and you ask which one they mean rather than choosing. If none does it is NAME_NOT_IN_THREADS, and you say you cannot see a conversation with that person. SHOW FIRST NAMES AND READ THE LINES OUT AS GIVEN. Say only what the reply carries: never guess who somebody is, what they meant, whether they are still at the event, or what is in a thread this reply did not return. Reading a conversation MARKS IT READ for that person, exactly as opening it in the app or on the web does. It requires a personal connector token: a shared one cannot reach anybody's conversations at all.