Profily
Tváre, ktoré vy a vaša firma ukazujete.
Profily majú šesť verejných metód pre samotné profily: výpis, vytvorenie, zmena, archivácia, obnovenie a odstránenie. Ešte jedna nastavuje, ku ktorým profilom položka patrí, a tri patria Telefónu a pokrývajú pravidlá odpovedania profilu a jeho firemnú identitu. Každá koná za účet, ktorého API kľúč použijete.
Výber plánu Profilov, pozvanie člena, výber asistenta profilu a pripojenie čísla dnes nemajú verejnú metódu. Robia sa v dashboarde.
Pošlite požiadavku metóde so svojím kľúčom:
Odmietnutá požiadavka odpovie záporným code a dôvod uvedie v data. Každá metóda berie aj voliteľné workspace_id, aby konala v pracovnom priestore, ktorý vlastníte, inom než vo vašom domovskom.
Čítanie profilov
get_account_profiles vypíše profily pracovného priestoru, naposledy zmenené ako prvé.
_idaleboprofile_idvráti jeden profil.filter_typezužuje zoznam:archivedpre archivované profily,sharedpre profily zdieľané s vami,favoritespre tie označené srdcom. Ak sa vynechá, vypíše každý aktívny profil.account_typezužuje podľa druhu:personal,businessalebovirtual.folder_idvypíše jeden priečinok dashboardu, alebo__none__pre profily bez priečinka.search,limit,skipabookmarkstránkujú a prehľadávajú zoznam.
Vytvorenie profilu
create_account_profile berie profile_name a account_type a voliteľne profile_signature (popis), obrázok a avatara a email_account_id na pripojenie pripojenej schránky.
- Virtuálny profil berie aj
virtual_character, popis, z ktorého sa kreslí jeho portrét, avirtual_traits, po jednej voľbe pre vek, pohlavie, etnikum a vzhľad. Odmietne sa, ak plán Profilov pracovného priestoru nezahŕňa virtuálne profily (Starter a vyššie) alebo účet nemá platené členstvo, a účet musí byť overený. - Osobný profil osobného účtu alebo firemný profil firemného účtu začína s vlastným obrázkom a avatarom účtu, ak žiadne nepošlete.
- Pracovný priestor, ktorý už obsahuje toľko profilov, koľko jeho plán povoľuje, odmietne nový s
code-62 areasonplan_cap. Ponechá si profily, ktoré má. Hlavný profil, s ktorým účet alebo pracovný priestor začína, sa nikdy neodmietne.
Zmena profilu
update_account_profile berie _id profilu a ľubovoľné polia, ktoré chcete zmeniť: meno, popis, obrázok a avatara, email_account_id, account_type, virtuálnu postavu a vlastnosti a registered_apps a registered_mini_apps, ktoré rozhodujú o moduloch, ktoré dostanú kartu pri každom kontakte v profile (registered_apps je celý usporiadaný zoznam).
- Prepnutie profilu na virtuálny musí splniť rovnakú podmienku ako jeho vytvorenie.
- Profil, ktorý bol s vami zdieľaný, je kópia: jeho plochu usporadúva jeho vlastník, takže zmena
canvasna ňom sa odmietne.
Archivácia, obnovenie a odstránenie
archive_account_profileberieprofile_ida presunie profil do Archivované. Hlavný profil sa odmietne. Ak bol profil tým, ktorý sa v tom pracovnom priestore používal, pracovný priestor sa vráti na svoj hlavný profil.unarchive_account_profilevráti archivovaný profil. Znova sa počíta do limitu plánu, takže plný pracovný priestor ho odmietne. Profil, ktorý prišiel s tímovým zdieľaním, sa takto obnoviť nedá.delete_account_profileodstráni archivovaný profil natrvalo a spolu s ním chaty, ktoré na ňom visia. Berie iba archivovaný profil: najprv archivujte, potom odstráňte.
Profil odstránený cez delete_account_profile je preč a rovnako chaty k nemu pripojené. Archivácia je krok, ktorý použite, keď chcete profil len dať z cesty.
Nastavenie, ku ktorým profilom položka patrí
update_entity_account_profiles berie _id položky a neprázdny zoznam account_profiles a nastaví, ku ktorým profilom táto položka patrí. Funguje na kontakte, chate, AI asistentovi, AI agentovi a mini aplikácii a každý iný druh položky odmietne.
Telefónna linka profilu
Tri metódy Telefónu berú profil. Sú uvedené spolu s ostatnými metódami Telefónu a profil je spôsob, ako nájdu jeho číslo.
get_profile_answering_rulesčíta pravidlá odpovedania linky (pracovné hodiny, časový limit zvonenia, komu sa zvoní, presmerovanie, hlasová schránka a nahrávanie) a čo aktuálny plán povoľuje.update_profile_answering_rulesich ukladá. Nastavenie, ktoré plán nezahŕňa, sa odmietne a nezahodí.update_profile_business_identityukladá firemnú identitu na profil, ktorý bude číslo vlastniť.