Vai al contenuto

Contatti

Le persone e le aziende con cui lavori.

Apri Contatti
Verificato rispetto alla dashboard il 20 novembre 2026

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:

curl -s https://xuda.ai/cpi/create_contact \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","name":"Dana Levi","email":"[email protected]","company":"Levi Studio"}'
const res = await fetch('https://xuda.ai/cpi/create_contact', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    name: 'Dana Levi',
    email: '[email protected]',
    company: 'Levi Studio',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/create_contact',
    json={
        'api_key': 'YOUR_API_KEY',
        'name': 'Dana Levi',
        'email': '[email protected]',
        'company': 'Levi Studio',
    },
)

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.

  • _id o contact_id restituisce un solo contatto.
  • search filtra l'elenco con una stringa di ricerca, e name con un nome.
  • filter_type restringe l'elenco, per esempio a archived, shared, pinned, favorites o online. Se omesso, elenca i contatti attivi insieme alle richieste di connessione in attesa.
  • with_requests impostato su true aggiunge anche a un elenco filtrato le richieste in sospeso, inviate e ricevute.
  • tag elenca i contatti che hanno un tag, folder_id elenca una cartella (invia __none__ per i contatti senza cartella), e group_id elenca i membri di un gruppo di contatti.
  • profile_id legge i contatti di un altro tuo profilo. limit, skip e bookmark paginano 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.
  • source registra da dove arriva il contatto, manual se non ne invii nessuno, e context è una riga che compare nell'attività del contatto.
  • profile_id archivia 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_member invia una richiesta a un altro utente Xuda, trovato tramite access_email o to_uid.
  • get_contact_members elenca le tue richieste e connessioni, ciascuna con la scheda dell'altra persona. stat accetta uno o più stati di richiesta da elencare.
  • unfriend_contact richiede un contact_id e termina la connessione. Il contatto resta nella tua rubrica.

Organizzare un contatto

Ognuno di questi richiede un contact_id.

Archiviare ed eliminare

L'eliminazione non può essere annullata

Un contatto eliminato con delete_contact non esiste più. L'archiviazione è il passaggio da usare quando vuoi solo toglierlo di mezzo.

Come ti sembra questa guida?

Ultimo aggiornamento il 16 novembre 2026