Profiles
Las caras que muestran tú y tu negocio.
Perfiles tiene seis métodos públicos para los propios perfiles: listar, crear, cambiar, archivar, restaurar y eliminar. Otro más define a qué perfiles pertenece un elemento, y tres pertenecen a Phone y cubren las reglas de respuesta y la identidad empresarial de un perfil. Cada uno actúa en nombre de la cuenta cuya clave de API usas.
Elegir un plan de Perfiles, invitar a un miembro, elegir el asistente de un perfil y asociar un número no tienen hoy ningún método público. Eso se hace en el panel.
Envía una solicitud a un método con tu clave:
Una solicitud rechazada responde con un code negativo y explica el motivo en data. Todos los métodos aceptan además un workspace_id opcional, para actuar en un espacio de trabajo de tu propiedad distinto del principal.
Leer perfiles
get_account_profiles lista los perfiles del espacio de trabajo, del cambiado más recientemente al más antiguo.
_idoprofile_iddevuelve un solo perfil.filter_typeacota la lista:archivedpara los perfiles archivados,sharedpara los perfiles compartidos contigo,favoritespara los marcados con el corazón. Si se omite, lista todos los perfiles activos.account_typeacota por tipo:personal,businessovirtual.folder_idlista una carpeta del panel, o__none__para los perfiles que no están en ninguna carpeta.search,limit,skipybookmarkpaginan y buscan en la lista.
Crear un perfil
create_account_profile recibe un profile_name y un account_type, y opcionalmente un profile_signature (la descripción), una imagen y un avatar, y un email_account_id para asociar un buzón conectado.
- Un perfil virtual recibe además
virtual_character, la descripción a partir de la cual se dibuja su retrato, yvirtual_traits, una opción para cada uno de edad, género, etnia y aspecto. Se rechaza salvo que el plan de Perfiles del espacio de trabajo incluya perfiles virtuales (Starter y superiores) o la cuenta tenga una membresía de pago, y que la cuenta esté verificada. - Un perfil personal de una cuenta personal, o un perfil de empresa de una cuenta de empresa, empieza con la imagen y el avatar de la propia cuenta cuando no envías ninguno.
- Un espacio de trabajo que ya tiene tantos perfiles como permite su plan rechaza uno nuevo con
code-62 yreasonplan_cap. Conserva los perfiles que tiene. El perfil principal con el que empieza una cuenta o un espacio de trabajo nunca se rechaza.
Cambiar un perfil
update_account_profile recibe el _id del perfil y cualquiera de los campos que quieras cambiar: el nombre, la descripción, la imagen y el avatar, email_account_id, account_type, el personaje y los rasgos virtuales, y registered_apps y registered_mini_apps, que deciden los módulos que obtienen una pestaña en cada contacto del perfil (registered_apps es la lista ordenada completa).
- Cambiar un perfil a virtual exige lo mismo que crear uno.
- Un perfil que se compartió contigo es una copia: su propietario organiza su lienzo, así que un cambio en
canvassobre él se rechaza.
Archivar, restaurar y eliminar
archive_account_profilerecibeprofile_idy mueve el perfil a Archivados. El perfil principal se rechaza. Si el perfil era el que se estaba usando en ese espacio de trabajo, el espacio de trabajo vuelve a su perfil principal.unarchive_account_profilerecupera un perfil archivado. Vuelve a contar para el límite del plan, así que un espacio de trabajo lleno lo rechaza. Un perfil que llegó con un uso compartido de equipo no se puede restaurar de este modo.delete_account_profileelimina definitivamente un perfil archivado, y con él los chats que cuelgan de él. Solo acepta un perfil archivado: primero archiva y después elimina.
Un perfil eliminado con delete_account_profile desaparece, y también los chats asociados a él. Archivar es el paso adecuado cuando solo quieres apartar un perfil.
Definir a qué perfiles pertenece un elemento
update_entity_account_profiles recibe el _id del elemento y una lista account_profiles no vacía, y define a qué perfiles pertenece ese elemento. Funciona con un contacto, un chat, un asistente de IA, un agente de IA y una mini app, y rechaza cualquier otro tipo de elemento.
La línea telefónica de un perfil
Tres métodos de Phone reciben un perfil. Se listan con el resto de métodos de Phone, y el perfil es la forma en que encuentran su número.
get_profile_answering_ruleslee las reglas de respuesta de una línea (horario comercial, tiempo de timbre, a quién se llama, reenvío, buzón de voz y grabación) y lo que permite el plan actual.update_profile_answering_ruleslas guarda. Un ajuste que el plan no incluye se rechaza en lugar de descartarse.update_profile_business_identityguarda la identidad empresarial en el perfil que será propietario del número.