Contactos
Las personas y empresas con las que trabajas.
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:
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.
_idocontact_iddevuelve un solo contacto.searchfiltra la lista por una cadena de búsqueda, ynamepor un nombre.filter_typeacota la lista, por ejemplo aarchived,shared,pinned,favoritesuonline. Si se omite, lista los contactos activos junto con las solicitudes de conexión pendientes.with_requestscon valortrueañade también a una lista filtrada las solicitudes pendientes, enviadas y recibidas.taglista los contactos que llevan una etiqueta,folder_idlista una carpeta (envía__none__para los contactos que no están en ninguna carpeta) ygroup_idlista los miembros de un grupo de contactos.profile_idlee los contactos de otro perfil tuyo.limit,skipybookmarkpaginan 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.
sourceregistra de dónde vino el contacto,manualcuando no envías ninguno, ycontextes una línea que se muestra en la actividad del contacto.profile_idarchiva 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_memberenvía una solicitud a otro usuario de Xuda, encontrado poraccess_emailo porto_uid.get_contact_memberslista tus solicitudes y conexiones, cada una con la tarjeta de la otra persona.statrecibe un estado de solicitud, o varios, para listar.unfriend_contactrecibe uncontact_idy termina la conexión. El contacto sigue en tu libreta.
Organizar un contacto
Cada uno de estos recibe un contact_id.
favorite_contactyunfavorite_contactponen y quitan el corazón, que es lo que lista la opción Favoritos del Filtro.pin_contactyunpin_contactfijan un contacto y le quitan la fijación.set_not_contactsaca a un remitente de la lista y lo pasa a No son contactos, para las alertas de un banco, los recibos de una tienda o una dirección no-reply. Su correo se sigue leyendo como antes.unset_not_contactlo devuelve y lo mantiene ahí.not_spam_contactmarca un contacto como no spam y confía en su dirección.set_deep_research_contactactiva la investigación profunda para un contacto, yunset_deep_research_contactla desactiva y borra lo que guardó.generate_contact_avatarborra las imágenes de un contacto y dibuja un avatar nuevo. No está disponible en cuentas gratuitas.
Archivar y eliminar
archive_contactmueve un contacto a Archivados.unarchive_contactlo recupera.delete_contactelimina un contacto. En el panel solo se puede eliminar un contacto archivado, así que primero archiva.
Un contacto eliminado con delete_contact desaparece. Archivar es el paso adecuado cuando solo quieres apartar un contacto.