Ugrás a tartalomhoz

Kapcsolatok

Az emberek és cégek, akikkel együtt dolgozik.

Kapcsolatok megnyitása
Az irányítópulttal összevetve ekkor: 2026. november 20.

A Kapcsolatoknak nincs saját mikroszolgáltatása. A nyilvános metódusai az account mikroszolgáltatáshoz tartoznak, amely a Profilokat is tartalmazza, az ismerőskérésekhez pedig a team mikroszolgáltatáshoz. Mindegyik annak a fióknak a nevében jár el, amelynek az API-kulcsát használja.

A csoportoknak, a címkéknek, az egyéni mezőknek, a Kapcsolatban tartásnak, a duplikátumellenőrzésnek, az importálásnak és a csomagválasztásnak ma nincs nyilvános metódusa. Ezek a dashboardon történnek.

Küldjön kérést egy metódusnak a kulcsával:

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

Az elutasított kérés negatív code értéket ad, és a data megmondja az okát. Az alábbi metódusok többsége fogad egy opcionális workspace_id értéket is, hogy egy Ön által birtokolt, az alapmunkaterületétől eltérő munkaterületen járjon el.

Kapcsolatok olvasása

A get_contacts listázza a kapcsolatokat.

  • Az _id vagy a contact_id egy kapcsolatot ad vissza.
  • A search keresőkifejezéssel szűri a listát, a name pedig névvel.
  • A filter_type szűkíti a listát, például archived, shared, pinned, favorites vagy online értékre. Ha elhagyja, az aktív kapcsolatokat listázza a várakozó kapcsolódási kérésekkel együtt.
  • A true értékre állított with_requests a függőben lévő kéréseket, küldötteket és kapottakat is hozzáadja a szűrt listához.
  • A tag az egy címkét hordozó kapcsolatokat listázza, a folder_id egy mappát (a mappa nélküli kapcsolatokhoz küldjön __none__ értéket), a group_id pedig egy kapcsolatcsoport tagjait.
  • A profile_id az Ön egy másik profiljának kapcsolatait olvassa. A limit, skip és bookmark lapozza a listát.

Kapcsolat hozzáadása

A create_contact kézzel ad hozzá egy személyt. A name és az email értéket várja, ezek kötelezők, és opcionálisan a phone, company, job_title értéket, valamint az account_type értéket personal vagy business beállítással, ami megspórolja a modellnek a találgatást.

  • Az e-mail a címjegyzék kulcsa. Ha olyat küld, amelyik már megvan, a meglévő kapcsolatot adja vissza egy második másolat helyett.
  • A source rögzíti, honnan jött a kapcsolat, manual, ha nem küld egyet sem, a context pedig egy sor, amely megjelenik a kapcsolat tevékenységében.
  • A profile_id az Ön egy másik profilja alá sorolja a kapcsolatot.
  • Senkit nem kérdeznek semmiről, és nem megy e-mail. Ugyanaz, mint a Hozzáadás meghívás nélkül a dashboardon.

Ha egy listát kódból szeretne behozni, hívja meg személyenként egyszer.

Ismerőskérések

  • Az add_contact_member kérést küld egy másik Xuda-felhasználónak, akit az access_email vagy a to_uid alapján talál meg.
  • A get_contact_members listázza a kéréseit és a kapcsolatait, mindegyiket a másik személy kártyájával. A stat egy kérésállapotot vagy többet fogad a listázáshoz.
  • Az unfriend_contact egy contact_id értéket vár, és megszünteti a kapcsolatot. A kapcsolat a címjegyzékében marad.

Kapcsolat rendezése

Mindegyik contact_id értéket vár.

Archiválás és törlés

A törlés nem vonható vissza

A delete_contact metódussal törölt kapcsolat elvész. Az Archiválás az a lépés, amelyet akkor használjon, ha csak félre szeretné tenni a kapcsolatot.

Milyen ez az útmutató?

Utoljára frissítve: 2026. november 20.