Retrieving users

Feature available for : Linkedin, WhatsApp, Instagram, Telegram

Get an Attendee

Once you have chat and messages, you might want to match them with Users. Use the GET /chat_attendees/{id} or GET /chat_attendees API Methods or the appropriate SDK Methods.

Get a User with a public identifier

You can retrieve a user profile, including its Provider Internal ID providing the Provider Public ID by using the GET /users/{provider_public_id} API Method or the appropriate SDK Method.

This can be useful to start new chats with unknown users.

If the user is unknown, this method does not sync the user into Unipile. It's a just a proxy to the provider. This means he will not appear in attendees lists unless you start a new chat with him.

Get a public identifier from an Attendee

For now, public identifiers are not present in Attendees, so you can use the GET /users/{provider_id} Method or the appropriate SDK Method to find it by passing the Provider Internal ID found in Attendees and Messages

Be careful how you implement action GET /users/{provider_id/provider_public_id}, please have a look on Provider limits and restrictions

Example of retrieving a full LinkedIn profile

Using route Retrieve a profile

curl --request GET \
     --url https://{YOUR_DSN}/api/v1/users/julien-crepieux?linkedin_sections=%2A&account_id=3H-KVe-mQ2GT9M0hKSkgHgs \
     --header 'X-API-KEY: {YOUR_ACCESS_TOKEN}' \
     --header 'accept: application/json' \
await client.users.getProfile({
  account_id: '3H-KVe-mQ2GT9M0hKSkgHgs',
  identifier: 'julien-crepieux',
});

Result

{
	"object": "UserProfile",
	"provider": "LINKEDIN",
	"provider_id": "ACoAAAcDMMQBODyLwZrRcgYhrkCafURGqva0U4E",
	"public_identifier": "julien-crepieux",
	"first_name": "Julien",
	"last_name": "Crepieux",
	"headline": "Co-founder & CEO at Unipile | One API to Enhance your App with Multi-Channel Messaging",
	"primary_locale": {
		"country": "FR",
		"language": "fr"
	},
	"is_open_profile": false,
	"is_premium": true,
	"is_influencer": false,
	"is_creator": true,
	"is_relationship": true,
	"network_distance": "FIRST_DEGREE",
	"is_self": false,
	"websites": [
		"https://www.unipile.com"
	],
	"follower_count": 12801,
	"connections_count": 12541,
	"location": "Riorges, Auvergne-Rhône-Alpes, France",
	"profile_picture_url": "https://media.licdn.com/dms/image/v2/D4D03AQHzFyxxK8jpRg/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1692795345827?e=1736380800&v=beta&t=4dob_N5yuQjNW3z9axCR2SB0uy7uSiGhW9DwI3cnapE",
	"profile_picture_url_large": "https://media.licdn.com/dms/image/v2/D4D03AQHzFyxxK8jpRg/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1692795345827?e=1736380800&v=beta&t=dFsLL5e26SJ-tex8j1lgmaVcoL0sheCZzyDIT8WtDVs",
	"background_picture_url": "https://media.licdn.com/dms/image/v2/D4E16AQGuyKQrYe6MiQ/profile-displaybackgroundimage-shrink_200_800/profile-displaybackgroundimage-shrink_200_800/0/1700839352634?e=1736380800&v=beta&t=H-QkJv5B8gJYgWupfuxIWTIo08mU79qKq7EAphb0WJM",
	"education": [
		{
			"degree": "Master of Business Administration (MBA) Entrepreneuriat et Management des PMO, Stratégie d'entreprise, Management, Gestion de Projet,",
			"school": "iaelyon School of Management",
			"start": "1/1/2004",
			"end": "1/1/2005"
		},
		{
			"degree": "Maîtrise en Management, Management, Marketing",
			"school": "IUP Management Saint-Étienne et Roanne",
			"start": "1/1/2003",
			"end": "1/1/2004"
		},
		{
			"degree": "Licence en Management, Management, Marketing",
			"school": "IUP Management Saint-Étienne et Roanne",
			"start": "1/1/2002",
			"end": "1/1/2003"
		},
		{
			"degree": "Licence AES, Droit, administration et économie",
			"school": "Université Lumière Lyon 2",
			"start": "1/1/2001",
			"end": "1/1/2002"
		},
		{
			"degree": "DUT Techniques de Commercialisation, Vente, Négociation, Marketing",
			"school": "IUT de Saint Etienne (Compte certifié)",
			"start": "1/1/1999",
			"end": "1/1/2001"
		}
	],
	"work_experience": [
		{
			"company_id": "38111148",
			"company": "Unipile",
			"position": "CEO & co-founder",
			"location": "Riorges, Auvergne-Rhône-Alpes, France",
			"start": "7/1/2020",
			"end": null
		},
		{
			"company_id": "3571243",
			"company": "SPOT-HIT",
			"position": "Directeur général",
			"location": "Riorges, Auvergne-Rhône-Alpes, France",
			"description": "Spot Hit est spécialisé dans l’édition d’un logiciel pour la gestion des campagnes de marketing direct (sms, emails, etc.)\n\n✅ Définition des objectifs et encadrement de l’ensemble des équipes (15 personnes) : développeurs et Sys Admin, Support clients, commerciaux, marketing et administration\n\n✅ Définition des roadmap produits pour le développement de nouvelles solutions et évolution de la plateforme actuelle (marketing automation) en fonction des DAS identifiés. \n\n✅ Lancement d’un nouveau DAS pour cibler des clients avec des besoins orientés gestion réseaux de points de vente (100 et plus)\n\n✅ Gestion en direct des comptes clés et développement du portefeuille sur les business stratégiques\n\n❗ Spot Hit a été rachetée en septembre 2019 par un groupe norvégien (Link MOBILITY) lui-même détenu par un fond de pension américain (Abry Partners)\n▶️ Projets internationaux et transversaux : déploiement de la plateforme dans l’Europe de l’Ouest : Italie, Espagne et UK\n▶️ Analyse et reporting financiers exigeants\n▶️ Développement de business sur des portefeuilles de clients croisés",
			"start": "4/1/2018",
			"end": "7/1/2020"
		},
		{
			"company_id": "1877494",
			"company": "RECOVEO",
			"position": "Directeur général",
			"description": "Recoveo est un laboratoire spécialisé dans la récupération de données sur supports informatiques endommagés (Disques durs, Serveurs, SSD, Smartphones...)\n\n✅ Lancement de la division Software dédiée à l'édition de logiciels métier, recrutement des équipes, mise en place de l'organisation fonctionnelle et définition de l'offre et de son positionnement. \n\n✅ Edition et commercialisation de 2 logiciels spécialisés dans la récupération de données et 1 spécialisé dans l'effacement sécurisé.\n\n✅Lancement du premier module de formation à la récupération de données en France.",
			"start": "9/1/2017",
			"end": "3/1/2018"
		},
		{
			"company_id": "1877494",
			"company": "RECOVEO",
			"position": "Directeur commercial",
			"description": "Recoveo est un laboratoire spécialisé dans la récupération de données sur supports informatiques endommagés (Disques durs, Serveurs, SSD, Smartphones...)\n\n✅ Membre du comité de direction avec lequel je définissais nos axes de développement stratégiques (Commerciaux, Financiers, Marketing et Techniques)\n\n✅ Encadrement et animation d'une équipe de Chargés d'affaires dédiés à la vente et au suivi des offres de services (prestations et logiciels)\n\n✅ Egalement en charge du portefeuille de clients grand-comptes.",
			"start": "11/1/2010",
			"end": "8/1/2017"
		},
		{
			"company_id": "4518587",
			"company": "Color Café",
			"position": "Directeur d'agence",
			"location": "Roanne",
			"description": "Color Café était une entreprise spécialisée dans la mise à disposition de distributeurs automatiques alimentaires auprès d'espaces publics, d'entreprises et de collectivités. (rachetée par Capda)\n\n✅ Responsable de la gestion opérationnelle du centre de profit. J'animais l'équipe de vente et l'équipe d'approvisionneurs et de techniciens.\n\n✅ Je gérais également la majeure partie des comptes clés du groupe.",
			"start": "5/1/2007",
			"end": "10/1/2010"
		},
		{
			"company_id": "2831",
			"company": "Tele2",
			"position": "Commercial",
			"location": "Roanne",
			"description": "Commercialisation des offres Mobiles, Fixes et Internet",
			"start": "12/1/2006",
			"end": "4/1/2007"
		},
		{
			"company_id": "9486914",
			"company": "Terre du Ciel",
			"position": "Assitant Marketing & Commercial espaces publicaitaires",
			"location": "Louhans",
			"description": "2 missions principales :\n- Concevoir et animer le site web\n- Promouvoir la vente d'espaces publicitaires auprès d'annonceurs",
			"start": "12/1/2005",
			"end": "11/1/2006"
		},
		{
			"company_id": "25700475",
			"company": "POTHIER Productions",
			"position": "Chef de projet junior",
			"location": "Régny",
			"description": "Etude de marché pour la commercialisation d'une cabine acoustique",
			"start": "5/1/2005",
			"end": "11/1/2005"
		}
	],
	"skills": [
		{
			"name": "Management d'équipe",
			"endorsement_count": 3
		},
		{
			"name": "Négociation commerciale",
			"endorsement_count": 3
		},
		{
			"name": "Gestion de centre de profit",
			"endorsement_count": 1
		},
		{
			"name": "Channel Partners",
			"endorsement_count": 0
		},
		{
			"name": "Solution Selling",
			"endorsement_count": 0
		},
		{
			"name": "Team Management",
			"endorsement_count": 8
		},
		{
			"name": "SaaS",
			"endorsement_count": 0
		},
		{
			"name": "Business Development",
			"endorsement_count": 1
		},
		{
			"name": "Account Management",
			"endorsement_count": 0
		},
		{
			"name": "New Business Development",
			"endorsement_count": 0
		},
		{
			"name": "Partner Management",
			"endorsement_count": 0
		},
		{
			"name": "Cloud Computing",
			"endorsement_count": 8
		},
		{
			"name": "Sales Management",
			"endorsement_count": 0
		},
		{
			"name": "B2B",
			"endorsement_count": 0
		},
		{
			"name": "Management",
			"endorsement_count": 17
		},
		{
			"name": "Product Marketing",
			"endorsement_count": 0
		},
		{
			"name": "Business Strategy",
			"endorsement_count": 0
		},
		{
			"name": "Managed Services",
			"endorsement_count": 0
		},
		{
			"name": "Telecommunications",
			"endorsement_count": 0
		},
		{
			"name": "Business Alliances",
			"endorsement_count": 0
		},
		{
			"name": "Pre-sales",
			"endorsement_count": 0
		},
		{
			"name": "Product Management",
			"endorsement_count": 0
		},
		{
			"name": "Selling",
			"endorsement_count": 0
		},
		{
			"name": "Stratégie commerciale",
			"endorsement_count": 7
		},
		{
			"name": "Développement commercial",
			"endorsement_count": 9
		},
		{
			"name": "Vente de solutions",
			"endorsement_count": 0
		},
		{
			"name": "Gestion d'équipe",
			"endorsement_count": 3
		},
		{
			"name": "Sales",
			"endorsement_count": 0
		}
	],
	"languages": [
		{
			"name": "Anglais",
			"proficiency": "Professional working proficiency"
		},
		{
			"name": "Français",
			"proficiency": "Native or bilingual proficiency"
		}
	],
	"certifications": [],
	"summary": "Hello 👋\n\nIn July 2020, my associate Arnaud and I launched Unipile, focusing on developing a solution to group messaging platforms into one single app.\n\n2 years later, we've decided to developped APIs to help software publishers to integrate messaging platforms like LinkedIn and WhatsApp into their own app. Our goal is to equip clients in the software industry with tools that enable their end-users to seamlessly manage communications across various channels such as Emails, Calendar and Messaging apps (WhatsApp, LinkedIn...). \n\n🚀 In march 2023, we successfully secured €1.5 million in funding to further our growth.\n\n💻 For more information about our solution, please visit: 👉 https://www.unipile.com",
	"volunteering_experience": [],
	"projects": [],
	"hashtags": []
}