Saltar al contenido

Contactos

Las personas y empresas con las que trabajas.

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

Contactos no tiene un microservicio propio. Sus métodos públicos pertenecen al microservicio de cuenta, que también contiene Perfiles, y al microservicio de equipo para las solicitudes de amistad. Cada uno actúa en nombre de la cuenta cuya clave de API usas.

Los grupos, las etiquetas, los campos personalizados, Mantén el contacto, la comprobación de duplicados, la importación y la elección de un plan 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_contact \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","name":"Dana Levi","email":"[email protected]","company":"Levi Studio"}'
const res = await fetch('https://xuda.ai/cpi/create_contact', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    name: 'Dana Levi',
    email: '[email protected]',
    company: 'Levi Studio',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/create_contact',
    json={
        'api_key': 'YOUR_API_KEY',
        'name': 'Dana Levi',
        'email': '[email protected]',
        'company': 'Levi Studio',
    },
)

Una solicitud rechazada responde con un code negativo y explica el motivo en data. La mayoría de los métodos siguientes aceptan además un workspace_id opcional, para actuar en un espacio de trabajo de tu propiedad distinto del principal.

Leer contactos

get_contacts lista los contactos.

  • _id o contact_id devuelve un solo contacto.
  • search filtra la lista por una cadena de búsqueda, y name por un nombre.
  • filter_type acota la lista, por ejemplo a archived, shared, pinned, favorites u online. Si se omite, lista los contactos activos junto con las solicitudes de conexión pendientes.
  • with_requests con valor true añade también a una lista filtrada las solicitudes pendientes, enviadas y recibidas.
  • tag lista los contactos que llevan una etiqueta, folder_id lista una carpeta (envía __none__ para los contactos que no están en ninguna carpeta) y group_id lista los miembros de un grupo de contactos.
  • profile_id lee los contactos de otro perfil tuyo. limit, skip y bookmark paginan la lista.

Añadir un contacto

create_contact añade una persona a mano. Recibe name y email, que son obligatorios, y opcionalmente phone, company, job_title y account_type con valor personal o business, lo que le ahorra a un modelo tener que adivinar.

  • El correo es la clave de la libreta. Enviar uno que ya tienes devuelve el contacto existente en lugar de una segunda copia.
  • source registra de dónde vino el contacto, manual cuando no envías ninguno, y context es una línea que se muestra en la actividad del contacto.
  • profile_id archiva el contacto bajo otro perfil tuyo.
  • No se le pregunta nada a nadie y no se envía ningún correo. Es lo mismo que Añadir sin invitación en el panel.

Para traer una lista desde código, llámalo una vez por persona.

Solicitudes de amistad

  • add_contact_member envía una solicitud a otro usuario de Xuda, encontrado por access_email o por to_uid.
  • get_contact_members lista tus solicitudes y conexiones, cada una con la tarjeta de la otra persona. stat recibe un estado de solicitud, o varios, para listar.
  • unfriend_contact recibe un contact_id y termina la conexión. El contacto sigue en tu libreta.

Organizar un contacto

Cada uno de estos recibe un contact_id.

Archivar y eliminar

Eliminar no se puede deshacer

Un contacto eliminado con delete_contact desaparece. Archivar es el paso adecuado cuando solo quieres apartar un contacto.

¿Qué te parece esta guía?

Última actualización: 16 de noviembre de 2026