Sari la conținut

Contacte

Persoanele și companiile cu care lucrezi.

Deschide Contacte
Verificat față de tabloul de bord la 20 noiembrie 2026

Contacte nu are un microserviciu propriu. Metodele lui publice aparțin microserviciului account, care conține și Profiluri, și microserviciului team pentru cererile de prietenie. Fiecare acționează pentru contul a cărui cheie API o folosești.

Grupurile, etichetele, câmpurile personalizate, Păstrează legătura, verificarea dublurilor, importul și alegerea unui plan nu au nicio metodă publică astăzi. Acestea se fac în dashboard.

Trimite o cerere către o metodă cu cheia ta:

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',
    },
)

O cerere refuzată răspunde cu un code negativ și spune de ce în data. Majoritatea metodelor de mai jos primesc și un workspace_id opțional, pentru a acționa într-un spațiu de lucru pe care îl deții, altul decât cel principal.

Citește contacte

get_contacts listează contactele.

  • _id sau contact_id returnează un singur contact.
  • search filtrează lista după un șir de căutare, iar name după un nume.
  • filter_type restrânge lista, de exemplu la archived, shared, pinned, favorites sau online. Dacă este omis, listează contactele active împreună cu cererile de conectare care așteaptă.
  • with_requests setat pe true adaugă și la o listă filtrată cererile în așteptare, trimise și primite.
  • tag listează contactele care poartă o etichetă, folder_id listează un folder (trimite __none__ pentru contactele fără folder), iar group_id listează membrii unui grup de contacte.
  • profile_id citește contactele altui profil al tău. limit, skip și bookmark paginează lista.

Adaugă un contact

create_contact adaugă o persoană manual. Primește name și email, care sunt obligatorii, și opțional phone, company, job_title și account_type setat pe personal sau business, ceea ce scutește un model de efortul de a ghici.

  • E-mailul este cheia agendei. Trimiterea unuia pe care îl ai deja returnează contactul existent în loc de o a doua copie.
  • source înregistrează de unde vine contactul, manual când nu trimiți niciuna, iar context este o linie care apare în activitatea contactului.
  • profile_id clasează contactul sub un alt profil al tău.
  • Nimeni nu este întrebat nimic și nu se trimite niciun e-mail. Este același lucru cu Adaugă fără invitație din dashboard.

Ca să aduci o listă din cod, apelează-o o dată pentru fiecare persoană.

Cereri de prietenie

  • add_contact_member trimite o cerere unui alt utilizator Xuda, găsit după access_email sau după to_uid.
  • get_contact_members listează cererile și conexiunile tale, fiecare cu cardul celeilalte persoane. stat primește o stare a cererii sau mai multe, de listat.
  • unfriend_contact primește un contact_id și încheie conexiunea. Contactul rămâne în agenda ta.

Organizează un contact

Fiecare dintre acestea primește un contact_id.

Arhivează și șterge

Ștergerea nu poate fi anulată

Un contact șters cu delete_contact a dispărut. Arhivarea este pasul de folosit când vrei doar să scoți un contact din cale.

Cum ți se pare acest ghid?

Ultima actualizare: 19 noiembrie 2026