Contacts
Les personnes et les entreprises avec lesquelles vous travaillez.
Contacts n'a pas de microservice propre. Ses méthodes publiques appartiennent au microservice account, qui contient aussi Profils, et au microservice team pour les demandes d'ami. Chacune agit pour le compte dont vous utilisez la clé API.
Les groupes, les étiquettes, les champs personnalisés, Garder le contact, la détection des doublons, l'import et le choix d'un forfait n'ont aujourd'hui aucune méthode publique. Cela se fait dans le tableau de bord.
Envoyez une requête à une méthode avec votre clé :
Une requête refusée renvoie un code négatif et en donne la raison dans data. La plupart des méthodes ci-dessous acceptent aussi un workspace_id facultatif, pour agir dans un espace de travail dont vous êtes propriétaire autre que votre espace principal.
Lire les contacts
get_contacts liste les contacts.
_idoucontact_idrenvoie un seul contact.searchfiltre la liste par une chaîne de recherche, etnamepar un nom.filter_typerestreint la liste, par exemple àarchived,shared,pinned,favoritesouonline. Sans ce paramètre, elle liste les contacts actifs avec les demandes de connexion en attente.with_requestsdéfini àtrueajoute aussi à une liste filtrée les demandes en attente, envoyées et reçues.tagliste les contacts qui portent une étiquette,folder_idliste un dossier (envoyez__none__pour les contacts sans dossier) etgroup_idliste les membres d'un groupe de contacts.profile_idlit les contacts d'un autre de vos profils.limit,skipetbookmarkpaginent la liste.
Ajouter un contact
create_contact ajoute une personne à la main. Il prend name et email, obligatoires, et facultativement phone, company, job_title et account_type défini à personal ou business, ce qui évite à un modèle d'avoir à deviner.
- L'e-mail est la clé du carnet. En envoyer un que vous avez déjà renvoie le contact existant au lieu d'une seconde copie.
sourceindique d'où vient le contact,manualsi vous n'en envoyez pas, etcontextest une ligne qui s'affiche dans l'activité du contact.profile_idclasse le contact sous un autre de vos profils.- Personne n'est sollicité et aucun e-mail n'est envoyé. C'est équivalent à Ajouter sans invitation dans le tableau de bord.
Pour importer une liste depuis du code, appelez-le une fois par personne.
Demandes d'ami
add_contact_memberenvoie une demande à un autre utilisateur Xuda, trouvé paraccess_emailou parto_uid.get_contact_membersliste vos demandes et vos connexions, chacune avec la fiche de l'autre personne.stataccepte un ou plusieurs statuts de demande à lister.unfriend_contactprend uncontact_idet met fin à la connexion. Le contact reste dans votre carnet.
Organiser un contact
Chacune de ces méthodes prend un contact_id.
favorite_contactetunfavorite_contactactivent et retirent le cœur, ce que liste le choix Favoris du Filtre.pin_contactetunpin_contactépinglent un contact et retirent l'épingle.set_not_contactdéplace un expéditeur hors de la liste vers Non-contacts, pour les alertes d'une banque, les reçus d'une boutique ou une adresse no-reply. Ses e-mails sont toujours lus comme avant.unset_not_contactle remet en place et l'y maintient.not_spam_contactmarque un contact comme non spam et fait confiance à son adresse.set_deep_research_contactactive la recherche approfondie pour un contact, etunset_deep_research_contactla désactive et efface ce qu'elle avait conservé.generate_contact_avatarefface les images d'un contact et dessine un nouvel avatar. Il n'est pas disponible sur les comptes gratuits.
Archiver et supprimer
archive_contactdéplace un contact dans Archivé.unarchive_contactle ramène.delete_contactsupprime un contact. Dans le tableau de bord, seul un contact archivé peut être supprimé : archivez d'abord.
Un contact supprimé avec delete_contact est perdu. Archiver est l'étape à utiliser quand vous voulez seulement écarter un contact.