Users overview

A user is a provider's user. They are the Attendees in chats.

Identifiers

Users have two identifiers:

Provider internal ID

The id used internally by the provider to identify the user, and used in postpress to reference attendees of resources, for example in the Message object.

• LinkedIn (regular user). Last part of the internal profile URL: linkedin.com/in/ACoAAAEkwwAB9KEc2TrQgOLEQ-vzRyZeCDyc6DQ.

  Each user has multiple fixed provider ids for Classic, Recruiter, and Sales Navigator. They start differently and you need to convert with the get-profile route using the right api parameter to send messages in each product:

  • Sales Navigator: ACw...
  • Recruiter: AE...
  • Classic: ACo... (and since recently, ADo...)
• WhatsApp: 0000000000@lid.
• Instagram: a sequence of numbers like 013456789. You can get the Instagram provider's internal id from a username by using the GET /users/{identifier} route.
• Telegram: a sequence of numbers like 013456789. You can get the Telegram provider's internal id from a username by using the GET /users/{identifier} route.
• X (Twitter): a sequence of numbers like 013456789. You can get the X provider's internal id from a username by using the GET /users/{identifier} route.

Provider public ID

The public id used by users to share their profile. It can be found as:

• LinkedIn (regular user): last part of the public profile URL: linkedin.com/in/satyanadella.
• LinkedIn (company): last part of the public profile URL: linkedin.com/company/microsoft.
• WhatsApp: 33600000000@s.whatsapp.net. The WhatsApp provider's public id is deterministic: the phone number plus the suffix @s.whatsapp.net. You can test if a number has WhatsApp by using the GET /users/{identifier} route.
• Instagram: a username, e.g. postpress.
• Telegram: phone number, e.g. 33600000000.
• X (Twitter): a username, e.g. @postpressApp (with or without the @).

Attendees

Since it is impossible to sync the millions of users of a provider, postpress only syncs "known users" that we call Attendees.

They have an additional identifier, a postpress ID, which is a unique id used in postpress to reference attendees of resources, for example in Group Participants.

postpress considers users as known (and therefore as Attendees) if you have a relation with them, through contacts or chats, so you can easily retrieve them from those relational elements. They are one of the following:

• Contacts of the connected account (known as Relations in LinkedIn, known as Friends in Facebook).
• Public non-contacts with whom the connected account has an existing chat.
• Public non-contacts who participate in the same groups as the connected account.

Unknown Users

Unknown users are all the rest:

• Public non-contacts without an existing chat.
• Private users.

They become known (and therefore a synced Attendee) as soon as you start a chat with them.