Profiler
Ansiktena du och ditt företag visar upp.
Profiler har sex offentliga metoder för själva profilerna: lista, skapa, ändra, arkivera, återställa och ta bort. En till anger vilka profiler ett objekt hör till, och tre hör till Telefon och gäller en profils svarsregler och företagsidentitet. Varje metod verkar för kontot vars API-nyckel du använder.
Att välja en Profiler-plan, bjuda in en medlem, välja en profils assistent och koppla ett nummer har ingen offentlig metod i dag. Det görs i dashboarden.
Skicka en förfrågan till en metod med din nyckel:
En nekad förfrågan svarar med en negativ code och säger varför i data. Varje metod tar också ett valfritt workspace_id, för att verka i en arbetsyta du äger utöver din hemarbetsyta.
Läs profiler
get_account_profiles listar arbetsytans profiler, senast ändrade först.
_idellerprofile_idreturnerar en profil.filter_typesmalnar av listan:archivedför arkiverade profiler,sharedför profiler som delats med dig,favoritesför de som markerats med hjärtat. Utelämnat listar det varje aktiv profil.account_typesmalnar av efter sort:personal,businessellervirtual.folder_idlistar en dashboardmapp, eller__none__för profilerna som inte ligger i någon mapp.search,limit,skipochbookmarkbläddrar i och söker i listan.
Skapa en profil
create_account_profile tar ett profile_name och ett account_type, och valfritt en profile_signature (beskrivningen), en bild och en avatar, och ett email_account_id för att koppla en ansluten brevlåda.
- En virtuell profil tar också
virtual_character, beskrivningen som dess porträtt ritas utifrån, ochvirtual_traits, ett val vardera för ålder, kön, etnicitet och utseende. Den nekas om inte arbetsytans Profiler-plan inkluderar virtuella profiler (Starter och uppåt) eller kontot har ett betalt medlemskap, och kontot har verifierats. - En personlig profil för ett personligt konto, eller en företagsprofil för ett företagskonto, börjar med kontots egen bild och avatar när du inte skickar någon.
- En arbetsyta som redan har lika många profiler som dess plan tillåter nekar en ny med
code-62 ochreasonplan_cap. Den behåller profilerna den har. Huvudprofilen som ett konto eller en arbetsyta börjar med nekas aldrig.
Ändra en profil
update_account_profile tar profilens _id och vilka fält du vill ändra: namnet, beskrivningen, bilden och avataren, email_account_id, account_type, den virtuella karaktären och dragen, samt registered_apps och registered_mini_apps, som avgör vilka moduler som får en flik på varje kontakt i profilen (registered_apps är hela den ordnade listan).
- Att byta en profil till virtuell måste klara samma krav som att skapa en.
- En profil som delats med dig är en kopia: dess ägare ordnar dess canvas, så en ändring av
canvaspå den nekas.
Arkivera, återställa och ta bort
archive_account_profiletarprofile_idoch flyttar profilen till Arkiverad. Huvudprofilen nekas. Om profilen var den som användes i den arbetsytan går arbetsytan tillbaka till sin huvudprofil.unarchive_account_profiletar tillbaka en arkiverad profil. Den räknas mot planens gräns igen, så en full arbetsyta nekar det. En profil som kom med en teamdelning kan inte återställas på det här sättet.delete_account_profiletar bort en arkiverad profil för gott, och chattarna som hänger på den med den. Den tar bara en arkiverad profil: arkivera först, ta sedan bort.
En profil som tagits bort med delete_account_profile är borta, och chattarna som hör till den likaså. Arkivera är steget att använda när du bara vill ha en profil ur vägen.
Ange vilka profiler ett objekt hör till
update_entity_account_profiles tar objektets _id och en icke-tom account_profiles-lista, och anger vilka profiler objektet hör till. Den fungerar på en kontakt, en chatt, en AI-assistent, en AI-agent och en miniapp, och nekar alla andra sorters objekt.
En profils telefonlinje
Tre av Telefons metoder tar en profil. De listas tillsammans med Telefons övriga metoder, och en profil är hur de hittar dess nummer.
get_profile_answering_rulesläser en linjes svarsregler (öppettider, ringtid, vem som rings, vidarekoppling, röstbrevlåda och inspelning) och vad den nuvarande planen tillåter.update_profile_answering_rulessparar dem. En inställning som planen inte inkluderar nekas i stället för att tas bort.update_profile_business_identitylagrar företagsidentiteten på profilen som kommer att äga numret.