Simplepush

Appearance

Names & Devices ​

In an organization, people are addressed and attributed by name, not by topic values or ids.

Member names ​

The name given at invite time (sp org members invite "Alice") is the member's identity in the organization. You pass it to --member / -m when sending. It comes back as recipient.name and actor.name when collecting. Member names on sends are matched case-insensitively.

bash
sp task -m "Alice" --title "Quick question" --text-input "Where are the keys?"

Device names ​

Members can name each of their devices in the app under Settings → Device Name. Device names are not used for addressing. A send always goes to all of a member's devices. Device names appear in event attribution, so you can tell which device answered:

json
"actor": {
  "publicId": "usr_…",
  "name": "Alice",
  "devicePublicId": "dev_…",
  "deviceName": "Alice's iPhone"
}

This is useful for shared or role-based devices. A member named "Warehouse" with devices named forklift-tablet and office-desk tells you where an answer came from, without extra bookkeeping.

Conventions ​

For larger organizations a naming convention helps senders find people and read event streams:

  • People: first name, or name-role (alice-eng, bob-dispatch)
  • Function accounts: the function (oncall, warehouse, front-desk)
  • Devices: location-device (berlin-printer-room, truck-3-tablet)