Contatti
Le persone e le aziende con cui lavori.
Contacts non ha un microservizio proprio. I suoi metodi pubblici appartengono al microservizio account, che contiene anche Profiles, e al microservizio team per le richieste di amicizia. Ogni metodo agisce per l'account di cui usi la chiave API.
Gruppi, tag, campi personalizzati, Resta in contatto, il controllo duplicati, l'importazione e la scelta di un piano non hanno oggi alcun metodo pubblico. Si fanno nella dashboard.
Invia una richiesta a un metodo con la tua chiave:
Una richiesta rifiutata risponde con un code negativo e ne spiega il motivo in data. La maggior parte dei metodi qui sotto accetta anche un workspace_id facoltativo, per agire in un workspace di tua proprietà diverso da quello principale.
Leggere i contatti
get_contacts elenca i contatti.
_idocontact_idrestituisce un solo contatto.searchfiltra l'elenco con una stringa di ricerca, enamecon un nome.filter_typerestringe l'elenco, per esempio aarchived,shared,pinned,favoritesoonline. Se omesso, elenca i contatti attivi insieme alle richieste di connessione in attesa.with_requestsimpostato sutrueaggiunge anche a un elenco filtrato le richieste in sospeso, inviate e ricevute.tagelenca i contatti che hanno un tag,folder_idelenca una cartella (invia__none__per i contatti senza cartella), egroup_idelenca i membri di un gruppo di contatti.profile_idlegge i contatti di un altro tuo profilo.limit,skipebookmarkpaginano l'elenco.
Aggiungere un contatto
create_contact aggiunge una persona a mano. Richiede name ed email, obbligatori, e facoltativamente phone, company, job_title e account_type impostato su personal o business, che evita a un modello il compito di indovinare.
- L'email è la chiave della rubrica. Inviarne una che hai già restituisce il contatto esistente invece di una seconda copia.
sourceregistra da dove arriva il contatto,manualse non ne invii nessuno, econtextè una riga che compare nell'attività del contatto.profile_idarchivia il contatto sotto un altro tuo profilo.- Non viene chiesto nulla a nessuno e non viene inviata alcuna email. È come Aggiungi senza invito nella dashboard.
Per importare un elenco da codice, chiamalo una volta per persona.
Richieste di amicizia
add_contact_memberinvia una richiesta a un altro utente Xuda, trovato tramiteaccess_emailoto_uid.get_contact_memberselenca le tue richieste e connessioni, ciascuna con la scheda dell'altra persona.stataccetta uno o più stati di richiesta da elencare.unfriend_contactrichiede uncontact_ide termina la connessione. Il contatto resta nella tua rubrica.
Organizzare un contatto
Ognuno di questi richiede un contact_id.
favorite_contacteunfavorite_contactimpostano e tolgono il cuore, che è ciò che elenca la voce Preferiti del Filtro.pin_contacteunpin_contactfissano un contatto e tolgono il fissaggio.set_not_contactsposta un mittente fuori dall'elenco in Non contatti, per gli avvisi di una banca, le ricevute di un negozio o un indirizzo no-reply. La sua posta viene letta come prima.unset_not_contactlo rimette a posto e ce lo mantiene.not_spam_contactsegna un contatto come non spam e si fida del suo indirizzo.set_deep_research_contactattiva la ricerca approfondita per un contatto, eunset_deep_research_contactla disattiva e cancella ciò che aveva conservato.generate_contact_avatarcancella le immagini di un contatto e disegna un nuovo avatar. Non è disponibile sugli account gratuiti.
Archiviare ed eliminare
archive_contactsposta un contatto in Archiviati.unarchive_contactlo riporta indietro.delete_contactelimina un contatto. Nella dashboard si può eliminare solo un contatto archiviato, quindi prima archivia.
Un contatto eliminato con delete_contact non esiste più. L'archiviazione è il passaggio da usare quando vuoi solo toglierlo di mezzo.