Profiler
De ansigter, du og din virksomhed viser.
Profiler har seks offentlige metoder til selve profilerne: list, opret, ændr, arkivér, gendan og slet. Én til sætter, hvilke profiler et element hører til, og tre hører til Telefon og dækker en profils svarregler og virksomhedsidentitet. Hver virker for den konto, hvis API-nøgle du bruger.
At vælge en Profiler-plan, invitere et medlem, vælge en profils assistent og knytte et nummer til har ingen offentlig metode i dag. Det gøres i dashboardet.
Send en forespørgsel til en metode med din nøgle:
En afvist forespørgsel svarer med en negativ code og siger hvorfor i data. Hver metode tager også et valgfrit workspace_id, for at virke i et arbejdsområde, du ejer, andet end dit hjemlige.
Læs profiler
get_account_profiles lister arbejdsområdets profiler, senest ændrede først.
_idellerprofile_idreturnerer én profil.filter_typeindsnævrer listen:archivedfor arkiverede profiler,sharedfor profiler delt med dig,favoritesfor dem, der er markeret med hjertet. Udeladt lister den alle aktive profiler.account_typeindsnævrer efter art:personal,businessellervirtual.folder_idlister én dashboard-mappe, eller__none__for profilerne uden mappe.search,limit,skipogbookmarksider og søger i listen.
Opret en profil
create_account_profile tager et profile_name og en account_type og eventuelt en profile_signature (beskrivelsen), et billede og en avatar samt en email_account_id til at knytte en forbundet postkasse.
- En virtuel profil tager også
virtual_character, den beskrivelse, dens portræt tegnes ud fra, ogvirtual_traits, ét valg hver for alder, køn, etnicitet og udseende. Den afvises, medmindre arbejdsområdets Profiler-plan indeholder virtuelle profiler (Starter og op) eller kontoen har et betalt medlemskab, og kontoen er verificeret. - En personlig profil på en personlig konto eller en virksomhedsprofil på en virksomhedskonto starter med kontoens eget billede og avatar, når du ikke sender nogen.
- Et arbejdsområde, der allerede rummer lige så mange profiler, som dets plan tillader, afviser en ny med
code-62 ogreasonplan_cap. Det beholder de profiler, det har. Den hovedprofil, en konto eller et arbejdsområde starter med, afvises aldrig.
Ændr en profil
update_account_profile tager profilens _id og de felter, du vil ændre: navnet, beskrivelsen, billedet og avataren, email_account_id, account_type, den virtuelle figur og egenskaber samt registered_apps og registered_mini_apps, som afgør de moduler, der får en fane på hver kontakt i profilen (registered_apps er hele den ordnede liste).
- At skifte en profil til virtuel kræver det samme som at oprette en.
- En profil, der blev delt med dig, er en kopi: dens ejer arrangerer dens lærred, så en ændring af
canvaspå den afvises.
Arkivér, gendan og slet
archive_account_profiletagerprofile_idog flytter profilen til Arkiveret. Hovedprofilen afvises. Hvis profilen var den, der var i brug i det arbejdsområde, vender arbejdsområdet tilbage til sin hovedprofil.unarchive_account_profilebringer en arkiveret profil tilbage. Den tæller igen med i planens grænse, så et fuldt arbejdsområde afviser den. En profil, der kom med en teamdeling, kan ikke gendannes på denne måde.delete_account_profilesletter en arkiveret profil for altid og de chats, der hænger på den, med den. Den tager kun en arkiveret profil: arkivér først, slet derefter.
En profil, der er slettet med delete_account_profile, er væk, og det er de chats, der er knyttet til den, også. Arkivér er det trin, du skal bruge, når du bare vil have en profil af vejen.
Indstil, hvilke profiler et element hører til
update_entity_account_profiles tager elementets _id og en ikke-tom account_profiles-liste og sætter, hvilke profiler det element hører til. Den virker på en kontakt, en chat, en AI-assistent, en AI-agent og en miniapp, og afviser enhver anden slags element.
En profils telefonlinje
Tre metoder i Telefon tager en profil. De er listet sammen med resten af Telefons metoder, og en profil er den måde, de finder dens nummer på.
get_profile_answering_ruleslæser en linjes svarregler (åbningstider, ringetid, hvem der ringes til, videresendelse, telefonsvarer og optagelse) og hvad den nuværende plan tillader.update_profile_answering_rulesgemmer dem. En indstilling, planen ikke indeholder, afvises frem for at blive droppet.update_profile_business_identitygemmer virksomhedsidentiteten på den profil, der skal eje nummeret.