Profiles
I volti che tu e la tua azienda mostrate.
Profiles ha sei metodi pubblici per i profili stessi: elenca, crea, modifica, archivia, ripristina ed elimina. Un altro imposta a quali profili appartiene un elemento, e tre appartengono a Phone e riguardano le regole di risposta e l'identità aziendale di un profilo. Ogni metodo agisce per l'account di cui usi la chiave API.
Scegliere un piano Profiles, invitare un membro, scegliere l'assistente di un profilo e collegare un numero non hanno oggi alcun metodo pubblico. Si fanno nella dashboard.
Invia una richiesta a un metodo con la tua chiave:
Una richiesta rifiutata risponde con un code negativo e ne spiega il motivo in data. Ogni metodo accetta anche un workspace_id facoltativo, per agire in un workspace di tua proprietà diverso da quello principale.
Leggere i profili
get_account_profiles elenca i profili del workspace, dal più recentemente modificato.
_idoprofile_idrestituisce un solo profilo.filter_typerestringe l'elenco:archivedper i profili archiviati,sharedper i profili condivisi con te,favoritesper quelli segnati con il cuore. Se omesso, elenca ogni profilo attivo.account_typerestringe per tipo:personal,businessovirtual.folder_idelenca una cartella della dashboard, oppure__none__per i profili senza cartella.search,limit,skipebookmarkpaginano e filtrano l'elenco.
Creare un profilo
create_account_profile richiede un profile_name e un account_type, e facoltativamente un profile_signature (la descrizione), un'immagine e un avatar, e un email_account_id per collegare una casella di posta connessa.
- Un profilo virtual richiede anche
virtual_character, la descrizione da cui viene disegnato il suo ritratto, evirtual_traits, una scelta ciascuno per età, genere, etnia e aspetto. Viene rifiutato a meno che il piano Profiles del workspace includa i profili virtuali (Starter e superiori) o l'account abbia un abbonamento a pagamento, e l'account sia stato verificato. - Un profilo personal di un account personale, o un profilo business di un account business, parte con l'immagine e l'avatar dell'account stesso se non ne invii nessuno.
- Un workspace che contiene già tanti profili quanti ne consente il suo piano rifiuta un nuovo profilo con
code-62 ereasonplan_cap. Conserva i profili che ha. Il profilo principale con cui parte un account o un workspace non viene mai rifiutato.
Modificare un profilo
update_account_profile richiede l'_id del profilo e uno qualsiasi dei campi che vuoi cambiare: il nome, la descrizione, l'immagine e l'avatar, email_account_id, account_type, il personaggio e i tratti virtuali, e registered_apps e registered_mini_apps, che decidono i moduli che ottengono una scheda su ogni contatto del profilo (registered_apps è l'intero elenco ordinato).
- Passare un profilo a virtual richiede gli stessi requisiti della sua creazione.
- Un profilo condiviso con te è una copia: il suo canvas è organizzato dal proprietario, quindi una modifica a
canvassu di esso viene rifiutata.
Archiviare, ripristinare ed eliminare
archive_account_profilerichiedeprofile_ide sposta il profilo in Archiviati. Il profilo principale viene rifiutato. Se il profilo era quello in uso in quel workspace, il workspace torna al suo profilo principale.unarchive_account_profileriporta indietro un profilo archiviato. Conta di nuovo nel limite del piano, quindi un workspace pieno lo rifiuta. Un profilo arrivato con una condivisione di team non può essere ripristinato in questo modo.delete_account_profileelimina definitivamente un profilo archiviato, insieme alle chat che ne dipendono. Accetta solo un profilo archiviato: prima archivia, poi elimina.
Un profilo eliminato con delete_account_profile non esiste più, e nemmeno le chat collegate. L'archiviazione è il passaggio da usare quando vuoi solo toglierlo di mezzo.
Impostare a quali profili appartiene un elemento
update_entity_account_profiles richiede l'_id dell'elemento e un elenco account_profiles non vuoto, e imposta a quali profili appartiene quell'elemento. Funziona su un contatto, una chat, un assistente AI, un agente AI e una mini app, e rifiuta qualsiasi altro tipo di elemento.
La linea telefonica di un profilo
Tre metodi di Phone richiedono un profilo. Sono elencati insieme agli altri metodi di Phone, e il profilo è il modo in cui trovano il suo numero.
get_profile_answering_ruleslegge le regole di risposta di una linea (orari di lavoro, timeout di squillo, chi viene chiamato, inoltro, segreteria e registrazione) e ciò che il piano attuale consente.update_profile_answering_rulesle salva. Un'impostazione non inclusa nel piano viene rifiutata invece di essere scartata.update_profile_business_identitymemorizza l'identità aziendale sul profilo che sarà titolare del numero.