Profily
Tváře, které ukazujete vy a vaše firma.
Profily mají šest veřejných metod pro samotné profily: výpis, vytvoření, změnu, archivaci, obnovení a smazání. Jedna další nastavuje, kterým profilům položka patří, a tři patří Telefonu a týkají se pravidel odpovídání profilu a firemní identity. Každá jedná za účet, jehož klíč API použijete.
Volba tarifu Profilů, pozvání člena, volba asistenta profilu a připojení čísla dnes nemají veřejnou metodu. Ty se dělají v dashboardu.
Pošlete požadavek metodě se svým klíčem:
Odmítnutý požadavek odpoví záporným code a v data říká proč. Každá metoda bere také volitelné workspace_id, aby jednala v jiném pracovním prostoru, který vlastníte, než ve svém domovském.
Čtení profilů
get_account_profiles vypisuje profily pracovního prostoru, naposledy změněné první.
_idneboprofile_idvrátí jeden profil.filter_typezužuje seznam:archivedpro archivované profily,sharedpro profily sdílené s vámi,favoritespro ty označené srdcem. Když chybí, vypíše každý aktivní profil.account_typezužuje podle druhu:personal,businessnebovirtual.folder_idvypíše jednu složku dashboardu, nebo__none__pro profily bez složky.search,limit,skipabookmarkstránkují a prohledávají seznam.
Vytvoření profilu
create_account_profile bere profile_name a account_type a volitelně profile_signature (popis), obrázek a avatar a email_account_id pro připojení připojené schránky.
- Virtuální profil bere také
virtual_character, popis, podle kterého se kreslí jeho portrét, avirtual_traits, po jedné volbě pro věk, pohlaví, etnický původ a vzhled. Odmítne se, pokud tarif Profilů pracovního prostoru nezahrnuje virtuální profily (Starter a výše) nebo účet nemá placené členství, a účet musí být ověřen. - Osobní profil osobního účtu nebo firemní profil firemního účtu začíná vlastním obrázkem a avatarem účtu, když žádné nepošlete.
- Pracovní prostor, který už drží tolik profilů, kolik jeho tarif povoluje, nový odmítne s
code-62 areasonplan_cap. Ponechá si profily, které má. Hlavní profil, kterým účet nebo pracovní prostor začíná, se nikdy neodmítne.
Změna profilu
update_account_profile bere _id profilu a libovolná pole, která chcete změnit: jméno, popis, obrázek a avatar, email_account_id, account_type, virtuální postavu a vlastnosti a registered_apps a registered_mini_apps, které rozhodují o modulech, které dostanou kartu na každém kontaktu v profilu (registered_apps je celý uspořádaný seznam).
- Přepnutí profilu na virtuální musí splnit stejnou laťku jako jeho vytvoření.
- Profil, který byl sdílen s vámi, je kopie: jeho plochu uspořádává jeho vlastník, takže změna
canvasna něm se odmítne.
Archivace, obnovení a smazání
archive_account_profilebereprofile_ida přesune profil do Archivováno. Hlavní profil se odmítne. Pokud byl profil tím, který se v onom pracovním prostoru používal, pracovní prostor se vrátí k hlavnímu profilu.unarchive_account_profilevrátí archivovaný profil. Znovu se počítá do limitu tarifu, takže plný pracovní prostor jej odmítne. Profil, který přišel s týmovým sdílením, nelze tímto způsobem obnovit.delete_account_profilesmaže archivovaný profil navždy a spolu s ním chaty, které na něm visí. Bere jen archivovaný profil: nejdřív archivujte, pak smažte.
Profil smazaný pomocí delete_account_profile je pryč a také chaty k němu připojené. Archivace je krok, který použijte, když chcete profil jen odklidit.
Nastavení, kterým profilům položka patří
update_entity_account_profiles bere _id položky a neprázdný seznam account_profiles a nastavuje, kterým profilům tato položka patří. Funguje na kontaktu, chatu, AI asistentovi, AI agentovi a mini aplikaci a jakýkoli jiný druh položky odmítne.
Telefonní linka profilu
Tři metody Telefonu berou profil. Jsou vypsány spolu s ostatními metodami Telefonu a profil je způsob, jak najdou jeho číslo.
get_profile_answering_rulesčte pravidla odpovídání linky (pracovní doba, časový limit vyzvánění, komu se vyzvání, přesměrování, hlasová schránka a nahrávání) a co povoluje současný tarif.update_profile_answering_rulesje ukládá. Nastavení, které tarif nezahrnuje, se odmítne, ne zahodí.update_profile_business_identityuloží firemní identitu na profil, který bude číslo vlastnit.