Kontakte
Die Menschen und Unternehmen, mit denen du arbeitest.
Contacts hat keinen eigenen Microservice. Seine öffentlichen Methoden gehören zum Account-Microservice, der auch Profile enthält, und für Freundschaftsanfragen zum Team-Microservice. Jede Methode handelt für das Konto, dessen API-Schlüssel du verwendest.
Gruppen, Tags, benutzerdefinierte Felder, In Kontakt bleiben, die Duplikatprüfung, der Import und die Wahl eines Tarifs haben heute keine öffentliche Methode. Das erledigst du im Dashboard.
Sende mit deinem Schlüssel eine Anfrage an eine Methode:
Eine abgelehnte Anfrage antwortet mit einem negativen code und nennt den Grund in data. Die meisten der folgenden Methoden akzeptieren außerdem ein optionales workspace_id, um in einem Workspace zu handeln, den du besitzt und der nicht dein Heim-Workspace ist.
Kontakte lesen
get_contacts listet die Kontakte auf.
_idodercontact_idliefert einen einzelnen Kontakt.searchfiltert die Liste nach einem Suchbegriff undnamenach einem Namen.filter_typegrenzt die Liste ein, zum Beispiel aufarchived,shared,pinned,favoritesoderonline. Ohne Angabe werden die aktiven Kontakte zusammen mit den wartenden Verbindungsanfragen aufgelistet.with_requestsauftruegesetzt fügt auch einer gefilterten Liste die offenen Anfragen hinzu, gesendete und empfangene.taglistet die Kontakte auf, die einen bestimmten Tag tragen,folder_idlistet einen Ordner auf (sende__none__für die Kontakte ohne Ordner), undgroup_idlistet die Mitglieder einer Kontaktgruppe auf.profile_idliest die Kontakte eines anderen deiner Profile.limit,skipundbookmarkblättern durch die Liste.
Einen Kontakt hinzufügen
create_contact fügt eine Person von Hand hinzu. Es erwartet name und email, die Pflicht sind, und optional phone, company, job_title sowie account_type auf personal oder business gesetzt, was einem Modell das Raten erspart.
- Die E-Mail ist der Schlüssel des Adressbuchs. Sendest du eine, die du schon hast, kommt der bestehende Kontakt zurück statt einer zweiten Kopie.
sourcehält fest, woher der Kontakt kam,manual, wenn du nichts sendest, undcontextist eine Zeile, die in der Aktivität des Kontakts erscheint.profile_idlegt den Kontakt unter einem anderen deiner Profile ab.- Niemand wird etwas gefragt, und es wird keine E-Mail gesendet. Es entspricht Ohne Einladung hinzufügen im Dashboard.
Um eine Liste aus dem Code einzulesen, rufe es einmal pro Person auf.
Freundschaftsanfragen
add_contact_membersendet eine Anfrage an einen anderen Xuda-Nutzer, gefunden überaccess_emailoder überto_uid.get_contact_memberslistet deine Anfragen und Verbindungen auf, jeweils mit der Karte der anderen Person.statakzeptiert einen oder mehrere Anfragestatus zum Auflisten.unfriend_contacterwartet einecontact_idund beendet die Verbindung. Der Kontakt bleibt in deinem Adressbuch.
Einen Kontakt organisieren
Jede davon erwartet eine contact_id.
favorite_contactundunfavorite_contactsetzen und löschen das Herz, das die Auswahl Favoriten des Filters auflistet.pin_contactundunpin_contactheften einen Kontakt an und nehmen die Anheftung weg.set_not_contactverschiebt einen Absender aus der Liste zu Keine Kontakte, für die Meldungen einer Bank, die Belege eines Shops oder eine No-Reply-Adresse. Seine Mails werden weiterhin wie zuvor gelesen.unset_not_contactlegt ihn zurück und behält ihn dort.not_spam_contactmarkiert einen Kontakt als kein Spam und vertraut seiner Adresse.set_deep_research_contactschaltet Deep Research für einen Kontakt ein, undunset_deep_research_contactschaltet es aus und löscht, was es gespeichert hat.generate_contact_avatarlöscht die Bilder eines Kontakts und zeichnet einen neuen Avatar. Es ist in kostenlosen Konten nicht verfügbar.
Archivieren und löschen
archive_contactverschiebt einen Kontakt nach Archiviert.unarchive_contactholt ihn zurück.delete_contactlöscht einen Kontakt. Im Dashboard lässt sich nur ein archivierter Kontakt löschen, archiviere also zuerst.
Ein mit delete_contact gelöschter Kontakt ist weg. Archivieren ist der richtige Schritt, wenn du einen Kontakt nur aus dem Weg haben willst.