Profielen
De gezichten die jij en je bedrijf laten zien.
Profielen heeft zes publieke methoden voor de profielen zelf: tonen, maken, wijzigen, archiveren, terugzetten en verwijderen. Een extra methode stelt in bij welke profielen een item hoort, en drie horen bij Telefoon en gaan over de antwoordregels en de zakelijke identiteit van een profiel. Elke methode werkt voor het account waarvan je de API-sleutel gebruikt.
Een abonnement voor Profielen kiezen, een lid uitnodigen, de assistent van een profiel kiezen en een nummer koppelen hebben op dit moment geen publieke methode. Die doe je in het dashboard.
Stuur een verzoek naar een methode met je sleutel:
Een geweigerd verzoek antwoordt met een negatieve code en zegt in data waarom. Elke methode neemt ook een optionele workspace_id, om te werken in een werkruimte die je bezit, anders dan je hoofdwerkruimte.
Profielen lezen
get_account_profiles toont de profielen van de werkruimte, het laatst gewijzigde eerst.
_idofprofile_idgeeft een profiel.filter_typebeperkt de lijst:archivedvoor gearchiveerde profielen,sharedvoor profielen die met jou zijn gedeeld,favoritesvoor de profielen die met het hartje zijn gemarkeerd. Weggelaten toont hij elk actief profiel.account_typebeperkt op soort:personal,businessofvirtual.folder_idtoont een dashboardmap, of__none__voor de profielen in geen enkele map.search,limit,skipenbookmarkpagineren en doorzoeken de lijst.
Een profiel maken
create_account_profile neemt een profile_name en een account_type, en optioneel een profile_signature (de beschrijving), een afbeelding en een avatar, en een email_account_id om een gekoppelde mailbox te koppelen.
- Een virtueel profiel neemt ook
virtual_character, de beschrijving waaruit zijn portret wordt getekend, envirtual_traits, een keuze voor elk van leeftijd, geslacht, etniciteit en uiterlijk. Het wordt geweigerd tenzij het abonnement Profielen van de werkruimte virtuele profielen bevat (Starter en hoger) of het account een betaald lidmaatschap heeft, en het account is geverifieerd. - Een persoonlijk profiel van een persoonlijk account, of een zakelijk profiel van een zakelijk account, begint met de eigen afbeelding en avatar van het account als je er geen stuurt.
- Een werkruimte die al evenveel profielen heeft als het abonnement toestaat, weigert een nieuw met
code-62 enreasonplan_cap. Ze houdt de profielen die ze heeft. Het hoofdprofiel waarmee een account of werkruimte begint, wordt nooit geweigerd.
Een profiel wijzigen
update_account_profile neemt de _id van het profiel en elk van de velden die je wilt wijzigen: de naam, de beschrijving, de afbeelding en avatar, email_account_id, account_type, het virtuele personage en de eigenschappen, en registered_apps en registered_mini_apps, die bepalen welke modules een tabblad krijgen bij elk contact in het profiel (registered_apps is de hele geordende lijst).
- Een profiel omzetten naar virtueel vraagt dezelfde eisen als er een maken.
- Een profiel dat met jou is gedeeld, is een kopie: zijn eigenaar richt zijn canvas in, dus een wijziging van
canvaserop wordt geweigerd.
Archiveren, terugzetten en verwijderen
archive_account_profileneemtprofile_iden verplaatst het profiel naar Gearchiveerd. Het hoofdprofiel wordt geweigerd. Als het profiel het profiel in gebruik in die werkruimte was, gaat de werkruimte terug naar zijn hoofdprofiel.unarchive_account_profilehaalt een gearchiveerd profiel terug. Het telt weer mee voor de limiet van het abonnement, dus een volle werkruimte weigert het. Een profiel dat met een teamdeling kwam, kan op deze manier niet worden teruggezet.delete_account_profileverwijdert een gearchiveerd profiel definitief, en de chats die eraan hangen met hem. Hij neemt alleen een gearchiveerd profiel: eerst archiveren, dan verwijderen.
Een profiel dat met delete_account_profile is verwijderd, is weg, en de chats die eraan vastzitten ook. Archiveren is de stap om te gebruiken als je een profiel alleen uit de weg wilt hebben.
Instellen bij welke profielen een item hoort
update_entity_account_profiles neemt de _id van het item en een niet-lege lijst account_profiles, en stelt in bij welke profielen dat item hoort. Het werkt op een contact, een chat, een AI-assistent, een AI-agent en een mini-app, en weigert elke andere soort item.
De telefoonlijn van een profiel
Drie methoden van Telefoon nemen een profiel. Ze staan bij de andere methoden van Telefoon, en een profiel is hoe ze zijn nummer vinden.
get_profile_answering_rulesleest de antwoordregels van een lijn (kantooruren, beltijdslimiet, wie wordt gebeld, doorschakelen, voicemail en opname) en wat het huidige abonnement toestaat.update_profile_answering_rulesslaat ze op. Een instelling die het abonnement niet bevat, wordt geweigerd in plaats van weggelaten.update_profile_business_identityslaat de zakelijke identiteit op bij het profiel dat het nummer gaat bezitten.