Saltar al contenido

Profiles

Las caras que muestran tú y tu negocio.

Abrir Profiles
Comprobado con el panel el 20 de noviembre de 2026

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:

curl -s https://xuda.ai/cpi/create_account_profile \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","profile_name":"Support","account_type":"business"}'
const res = await fetch('https://xuda.ai/cpi/create_account_profile', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    profile_name: 'Support',
    account_type: 'business',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/create_account_profile',
    json={
        'api_key': 'YOUR_API_KEY',
        'profile_name': 'Support',
        'account_type': 'business',
    },
)

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.

  • _id o profile_id devuelve un solo perfil.
  • filter_type acota la lista: archived para los perfiles archivados, shared para los perfiles compartidos contigo, favorites para los marcados con el corazón. Si se omite, lista todos los perfiles activos.
  • account_type acota por tipo: personal, business o virtual.
  • folder_id lista una carpeta del panel, o __none__ para los perfiles que no están en ninguna carpeta. search, limit, skip y bookmark paginan 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, y virtual_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 y reason plan_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 canvas sobre él se rechaza.

Archivar, restaurar y eliminar

  • archive_account_profile recibe profile_id y 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_profile recupera 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_profile elimina definitivamente un perfil archivado, y con él los chats que cuelgan de él. Solo acepta un perfil archivado: primero archiva y después elimina.
Eliminar no se puede deshacer

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.

¿Qué te parece esta guía?

Última actualización: 16 de noviembre de 2026