Servidor MCP: Acciones e Información Disponibles

Prev Next

Esta guía sirve como una referencia completa de las capacidades de entrada del servidor Manatal MCP. A continuación, encontrará especificaciones detalladas de los campos de entrada disponibles y la estructura de los datos de respuesta que puede esperar recibir. Para obtener más información sobre el servidor Manatal MCP, consulte este artículo.

Para obtener la mejor experiencia, utilice ChatGPT o Claude. Admite todas las acciones enumeradas a continuación.

1. Buscar Candidatos

Encuentre y filtre candidatos por experiencia, educación o ubicación

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
Nombre Completo String No Filtrar por nombre completo del candidato Jane Doe
Correo Electrónico String No Filtrar por dirección de correo electrónico del candidato jane.doe@example.com
Número de Teléfono String No Filtrar por número de teléfono del candidato +1-555-010-9988
Género String No Filtrar por género (separado por comas: unknown, male, female, other) female
Fecha de Nacimiento (Inicio) Date No Filtrar por fecha de nacimiento mayor o igual a 1990-01-01
Fecha de Nacimiento (Fin) Date No Filtrar por fecha de nacimiento menor o igual a 1995-12-31
Empresa Actual String No Filtrar por empresa actual Tech Solutions Inc.
Posición Actual String No Filtrar por posición actual Senior Developer
Última Universidad String No Filtrar por última universidad Stanford University
Ubicación String No Filtrar por ubicación New York
Tipo de Origen String No Filtrar por tipo de origen applied
ID(s) del Creador String No Filtrar por ID del usuario que creó los candidatos 42123
ID(s) del Propietario String No Filtrar por ID del propietario del candidato 81245
ID(s) de Industria (OR) String No Filtrar por ID de industria del candidato obtenido con la herramienta list_industries 3,7
ID(s) de Industria (AND) String No Filtrar por ID de industria del candidato obtenido con la herramienta list_industries 3,7
Etiquetas String No Filtrar por IDs de etiquetas separados por comas, obtenidos con list_candidate_tags 5,9
Fecha de Creación (Inicio) Date No Filtrar por fecha de creación mayor o igual a 2025-01-01
Fecha de Creación (Fin) Date No Filtrar por fecha de creación menor o igual a 2025-06-30
Fecha de Actualización (Inicio) Date No Filtrar por fecha de actualización mayor o igual a 2025-11-01
Fecha de Actualización (Fin) Date No Filtrar por fecha de actualización menor o igual a 2025-11-30
Página Integer No Número de página 1
Tamaño de Página Integer No Resultados por página 20

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID del Candidato 10234
Nombre Completo Jane Doe
ID del Creador 42241
ID del Propietario 81252
Tipo de Origen applied
Correo Electrónico jane.doe@example.com
Número de Teléfono +1-555-010-9988
Género female
Fecha de Nacimiento 1990-01-01
Consentimiento true
Fecha de Consentimiento 2025-06-30
Dirección 123 Main St, Springfield
Código Postal 12345
Último Título Bachelor of Science
Última Universidad Stanford University
Empresa Actual Tech Solutions Inc.
Departamento Actual Engineering
Posición Actual Senior Developer
Descripción Desarrollador de software con experiencia y sólidos conocimientos en desarrollo web full-stack y liderazgo de equipos.
Ubicación New York
Fecha de Creación 2025-06-30
Fecha de Actualización 2025-11-01
Etiquetas del Candidato Java, Backend Development, Team Lead
Campos Personalizados {“linkedin”: “linkedin.com/in/janedoe”, “notice_period”: “30 days”}
Industrias Information Technology

2. Crear Candidato

Añada una nueva persona a su base de datos de candidatos

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
Nombre Completo String Sí Nombre completo del candidato Jane Doe
Correo Electrónico String No Dirección de correo electrónico jane.doe@example.com
Número de Teléfono String No Número de teléfono +1-555-010-9988
Género String No male, female, other, unknown female
Fecha de Nacimiento Date No Fecha de nacimiento 1990-01-01
Dirección String No Dirección postal 123 Main St, Springfield
Código Postal String No Código postal 62704
Empresa Actual String No Nombre del empleador actual Tech Solutions Inc.
Departamento Actual String No Departamento actual Engineering
Posición Actual String No Puesto actual Senior Developer
Último Título String No Nombre del título más reciente Bachelor of Science
Última Universidad String No Nombre de la universidad más reciente Stanford University
Descripción String No Notas/resumen en texto libre Con experiencia en Python…
Tipo de Origen String No Origen del candidato. Opciones: sourced, applied, referred, agency, other applied
Otro Origen String No Campo para añadir información manual al origen si el Tipo de Origen es other Encontrado a través de un encuentro del sector
Consentimiento Boolean No Indica si el candidato dio su permiso para usar sus datos true
Campos Personalizados Array No Valores del candidato para los campos personalizados definidos en Manatal [{“field_id”:4,“value”:“120k”}]

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID del Candidato 10234
Nombre Completo Jane Doe
ID del Creador 42241
ID del Propietario 81252
Tipo de Origen applied
Correo Electrónico jane.doe@example.com
Número de Teléfono +1-555-010-9988
Género female
Fecha de Nacimiento 1990-01-01
Consentimiento true
Fecha de Consentimiento 2025-06-30
Dirección 123 Main St, Springfield
Último Título Bachelor of Science
Última Universidad Stanford University
Empresa Actual Tech Solutions Inc.
Departamento Actual Engineering
Posición Actual Senior Developer
Descripción Desarrollador de software con experiencia y sólidos conocimientos en desarrollo web full-stack y liderazgo de equipos.
Ubicación New York
Fecha de Creación 2025-06-30
Fecha de Actualización 2025-11-01
Etiquetas del Candidato [“Java”, “Backend Development”, “Team Lead”]
Campos Personalizados {“linkedin”: “linkedin.com/in/janedoe”, “notice_period”: “30 days”}
Industrias Information Technology

3. Obtener Candidato

Consulte todos los detalles de un candidato específico

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Candidato Integer Sí ID del candidato que se desea obtener 10234

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID del Candidato 10234
Nombre Completo Jane Doe
ID del Creador 42241
ID del Propietario 81252
Tipo de Origen applied
Correo Electrónico jane.doe@example.com
Número de Teléfono +1-555-010-9988
Género female
Fecha de Nacimiento 1990-01-01
Consentimiento true
Fecha de Consentimiento 2025-06-30
Dirección 123 Main St, Springfield
Código Postal 12345
Último Título Bachelor of Science
Última Universidad Stanford University
Empresa Actual Tech Solutions Inc.
Departamento Actual Engineering
Posición Actual Senior Developer
Descripción Desarrollador de software con experiencia y sólidos conocimientos en desarrollo web full-stack y liderazgo de equipos.
Ubicación New York
Fecha de Creación 2025-06-30
Fecha de Actualización 2025-11-01
Etiquetas del Candidato Java, Backend Development, Team Lead
Campos Personalizados {“linkedin”: “linkedin.com/in/janedoe”, “notice_period”: “30 days”}
Industrias Information Technology

4. Actualizar Candidato

Actualice detalles seleccionados de un perfil de candidato existente.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Candidato Integer Sí ID del Candidato 10234
Nombre Completo String No Nombre completo del candidato Jane Doe
Tipo de Origen String No Cómo se obtuvo al candidato. Opciones: sourced, applied, referred, agency, other. applied
Otro Origen String No Información adicional del origen cuando el Tipo de Origen es "other". Encuentro del sector
Consentimiento Boolean No Indica si el candidato ha dado su consentimiento para el uso de sus datos true
Correo Electrónico String No Dirección de correo electrónico jane.doe@example.com
Número de Teléfono String No Número de teléfono +1-555-010-9988
Género String No Opciones de género: male, female, other, unknown. female
Fecha de Nacimiento Date No Fecha de nacimiento (YYYY-MM-DD) 1990-01-01
Dirección String No Dirección postal 123 Main St, Springfield
Código Postal String No Código postal 62704
Último Título String No Nombre del título más reciente Bachelor of Science
Última Universidad String No Nombre de la universidad más reciente Stanford University
Empresa Actual String No Nombre del empleador actual Tech Solutions Inc.
Departamento Actual String No Departamento actual Engineering
Posición Actual String No Puesto actual Senior Developer
Descripción String No Notas o resumen en texto libre sobre el candidato Desarrollador de software con experiencia
Entrada de Campos Personalizados Array No Valores del candidato para los campos personalizados definidos en Manatal [{"field":"seniority","value":"Senior"}]

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID del Candidato 10234
Nombre Completo Jane Doe
ID del Creador 42241
ID del Propietario 81252
Tipo de Origen applied
Correo Electrónico jane.doe@example.com
Número de Teléfono +1-555-010-9988
Género female
Fecha de Nacimiento 1990-01-01
Consentimiento true
Fecha de Consentimiento 2025-06-30
Dirección 123 Main St, Springfield
Último Título Bachelor of Science
Última Universidad Stanford University
Empresa Actual Tech Solutions Inc.
Departamento Actual Engineering
Posición Actual Senior Developer
Descripción Desarrollador de software con experiencia y sólidos conocimientos en desarrollo web full-stack y liderazgo de equipos.
Ubicación New York
Fecha de Creación 2025-06-30
Fecha de Actualización 2025-11-01
Etiquetas del Candidato [“Java”, “Backend Development”, “Team Lead”]
Campos Personalizados {“linkedin”: “linkedin.com/in/janedoe”, “notice_period”: “30 days”}
Industrias Information Technology

5. Obtener Currículo del Candidato

Obtenga los currículos de un candidato y el contenido analizado de su CV.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Candidato Integer Sí ID del Candidato 10234

Salida Esperada

Devuelve una lista de currículos; Resume Parsed Edited contiene el contenido analizado del CV, mientras que Is Default identifica el currículo principal y State indica el estado del procesamiento.

Nombre del Campo Valores de Ejemplo
ID del Currículo 1
Estado completed
Nombre del Archivo del Currículo Jane_Doe_CV.pdf
Currículo Analizado Editado {}
Es Predeterminado true

6. Listar Redes Sociales del Candidato

Liste los perfiles de redes sociales confirmados de un candidato.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Candidato Integer Sí ID del Candidato 10234

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID del Perfil Social 1
Slug de la Red Social linkedin
Nombre de la Red Social LinkedIn
URL de la Red Social https://www.linkedin.com/in/janedoe
Imagen null

7. Obtener Campos del Candidato

Obtenga las definiciones de campos de candidato nativos y personalizados del cliente.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
(ninguno — sin parámetros) — — — —

Salida Esperada

Los campos están anidados dentro de columnas de perfil y grupos; groups[].fields[] identifica la definición de un campo individual, no el valor guardado de un candidato.

Nombre del Campo Valores de Ejemplo
groups[] → Nombre Personal Details
groups[] → Está Oculto false
groups[].fields[] → Slug seniority
groups[].fields[] → Nombre Seniority
groups[].fields[] → Descripción Nivel de seniority del candidato
groups[].fields[] → Tipo de Campo dropdown
groups[].fields[] → Opciones de Respuesta ["Junior","Senior"]
groups[].fields[] → Tipo de Opción de Respuesta text
groups[].fields[] → Es Obligatorio false
groups[].fields[] → Es Nativo false
groups[].fields[] → Está Oculto false

8. Listar Etiquetas de Candidatos

Liste las etiquetas de candidatos disponibles

Entradas Posibles

Sin entrada

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de Etiqueta 5
Nombre urgent

9. Listar Formación del Candidato

Consulte la formación académica y las cualificaciones de un candidato

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Candidato Integer Sí ID del Candidato 10234

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID 3312
Escuela Stanford University
Título Bachelor of Science
Fecha de Inicio 2010-09-01
Fecha de Fin 2014-06-01
Ubicación Seattle, WA
Descripción Enfocado en ingeniería de software y sistemas distribuidos. Miembro del Club de Robótica.

10. Añadir Formación del Candidato

Registre títulos, certificaciones y estudios de un candidato

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Candidato Integer Sí ID del candidato 10234
ID de la Escuela Integer Sí ID obtenido de search_schools 1123
ID del Título Integer No ID obtenido de search_degrees 45
Descripción String No Detalles adicionales Se graduó con honores
Fecha de Inicio Date No Fecha en que se inició la formación 2010-09-01
Fecha de Fin Date No Fecha en que finalizó la formación 2014-06-01

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Formación 3312
ID del Candidato 10234
Escuela Stanford University
Título Bachelor of Science
Ubicación mostrada Bangkok Thailand
Descripción Enfocado en ingeniería de software y sistemas distribuidos. Miembro del Club de Robótica.
Fecha de Inicio 2010-09-01
Fecha de Fin 2014-06-01

11. Listar Experiencias del Candidato

Consulte los trabajos anteriores y la experiencia de un candidato

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Candidato Integer Sí ID del Candidato 10234

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Experiencia 9981
Empleador Tech Solutions Inc.
ID del Empleador 123
Posición Senior Developer
ID de la Posición 123
Fecha de Inicio 2018-01-01
Fecha de Fin 2020-01-02
Es Empleador Actual true
Descripción Liderando el equipo de la plataforma principal, responsable de la estrategia de la hoja de ruta y de la alineación entre áreas.
Ubicación New York, NY

12. Añadir Experiencia del Candidato

Registre el historial laboral y las posiciones de un candidato

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Candidato Integer Sí ID del Candidato 10234
ID del Empleador Integer Sí ID obtenido de search_employers 771
ID de la Posición Integer Sí ID obtenido de search_positions 220
Descripción String No Responsabilidades/logros Lideró un equipo de backend de 5 personas
Fecha de Inicio Date No Fecha en que el candidato comenzó el trabajo 2018-01-01
Fecha de Fin Date No Fecha en que el candidato dejó el trabajo 2022-05-01
Es Empleador Actual Boolean No Indica si es el trabajo actual del candidato o no true

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Experiencia 9981
ID del Candidato 10234
Empleador Tech Solutions Inc.
Posición Senior Developer
ID de la Posición 220
Fecha de Inicio 2018-01-01
Fecha de Fin 2020-01-01
Es Empleador Actual true
Descripción Gestionó campañas en redes sociales y la estrategia SEO.
Ubicación Mostrada Austin, TX

13. Listar Notas del Candidato

Lea todas las notas y comentarios sobre un candidato

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Candidato Integer Sí ID del candidato 10234

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Nota 5521
Información Excelentes habilidades de comunicación
ID del Creador 42241
Nombre del Creador Emma
Fecha de Creación 2025-11-01

14. Añadir Nota del Candidato

Escriba observaciones, comentarios de entrevistas o recordatorios sobre un candidato

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Candidato Integer Sí ID del Candidato 10234
Información String Sí El contenido o cuerpo de la información. El candidato prefiere el trabajo remoto y tiene una visa válida

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Nota 5521
Nombre del creador Emma
Información El candidato prefiere el trabajo remoto y tiene una visa válida
ID del Creador 42241
Fecha de Creación 2026-07-02

15. Listar Reuniones del Candidato

Liste las reuniones y evaluaciones de AI Interviewer y AI Notetaker de un candidato.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Candidato Integer Sí ID del Candidato 10234
Origen de la Reunión String No Filtre por origen de la reunión. ai_interviewer devuelve solo las reuniones de AI Interviewer; ai_notetaker devuelve todos los demás orígenes. Omita para devolver todo. Opciones: ai_interviewer, ai_notetaker. ai_interviewer
Página Integer No Número de página 1
Tamaño de Página Integer No Resultados por página (máx. 10) 10

Salida Esperada

La evaluación contiene contenido JSON cuando está disponible; obtenga las transcripciones mediante Get Meeting.

Nombre del Campo Valores de Ejemplo
ID de la Reunión 901
ID del Cliente 123
ID de la Actividad 7789
Título Entrevista con el candidato
Hora de la Reunión 2026-09-22T09:00:00Z
URL de la Reunión null
Compartido con Invitados false
Está Archivado false
Fecha de Creación 2026-09-22T09:00:00Z
Fecha de Actualización 2026-09-22T09:00:00Z
ID de la Vacante 5567
ID del Candidato 10234
Estado completed
Tipo de Origen ai_interviewer
Duración 1800
Evaluación null

16. Buscar Organizaciones

Encuentre empresas clientes en su base de datos

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
Nombre String No Filtrar por nombre de la organización (contiene) Acme Corp
Ubicación String No Filtrar por ubicación (contiene) New York
Sitio Web String No Filtrar por sitio web (contiene) https://acme.com
Visibilidad Array No public, private, confidential public
ID(s) del Creador String No Filtrar por ID del usuario que creó la organización 42123
ID(s) del Propietario String No Filtrar por ID del propietario de la organización 81245
Fecha de Creación (Inicio) Date No Filtrar por fecha de creación mayor o igual a 2025-01-01
Fecha de Creación (Fin) Date No Filtrar por fecha de creación menor o igual a 2025-06-30
Fecha de Actualización (Inicio) Date No Filtrar por fecha de actualización mayor o igual a 2025-11-01
Fecha de Actualización (Fin) Date No Filtrar por fecha de actualización menor o igual a 2025-11-30
Página Integer No Número de página 1
Tamaño de Página Integer No Resultados por página 20
ID(s) de Etapa (stage__in) String No IDs de etapas de organización separados por comas devueltos por get_organization_stage. 1,2

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Organización 892
Nombre Acme Corp
Dirección 456 Market St
Sitio Web https://acme.com
Es Público true
Es Visible false
Descripción Proveedor global de widgets y soluciones tecnológicas
ID del Propietario 81245
Nombre del Propietario John Doe
Logotipo https://example/logo.png
ID del Creador 881242
Nombre del Creador Mark Paul
Fecha de Creación 2025-06-30
Fecha de Actualización 2025-06-15
Sitio Web https://example.com
Campos Personalizados {“industry”: “Tech”, “tier”: “Gold”}
Ubicación Bangkok
Etapa (stage) 1
ID de Etapa (stage_id) 1
Nombre de la Etapa (stage_name) Qualified

17. Crear Organización

Cree una nueva organización

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
Nombre String Sí Nombre de la organización Acme Corp
Dirección String No Dirección postal 456 Market St
Descripción String No Descripción Empresa líder en tecnología financiera
Sitio Web String No URL del sitio web https://acme.com
ID del Propietario Integer No ID del usuario propietario 81245
Campos Personalizados Array No Entradas de campos personalizados [{“field_id”:1,“value”:“A”}]

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Organización 892
Nombre Acme Corp
Dirección 456 Market St
Descripción Proveedor líder de soluciones logísticas.
Sitio Web https://acme.com
ID del Propietario 81245
Nombre del Propietario John Doe
Es Público true
Es Visible false
Campos Personalizados {“industry”: “Tech”, “tier”: “Enterprise”}
Fecha de Creación 2025-10-01
Fecha de Actualización 2025-10-05

18. Actualizar Organización

Actualice los detalles de una organización.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
id integer Sí ID de la Organización 1
external_id string or null No ID de la organización en los sistemas del consumidor de la API. Longitud máxima: 255 null
name string No Nombre de la organización. Longitud mínima: 1. Longitud máxima: 255 "Acme Corp"
description string No Descripción de la organización "Account details"
owner integer or null No ID de usuario de list_client_users para asignar como propietario de la organización 123
address string No Dirección de la organización "123 Main Street"
website string No Sitio web de la organización. Longitud máxima: 255 "https://example.com"
custom_field_input array of objects No Valores de los campos personalizados de organización del cliente, como entradas {"field": <slug>, "value": <value>}. Llame primero a get_organization_field y tome cada field de un slug que devuelva: las entradas cuyo slug sea desconocido, o cuyo valor el campo rechace, se descartan silenciosamente y el resto de la actualización se realiza correctamente. Solo cambian los campos indicados aquí; los campos omitidos conservan su valor actual. []
custom_field_input[].field string Sí Slug exacto, sensible a mayúsculas y minúsculas, devuelto por la herramienta get-field correspondiente. "seniority"
custom_field_input[].value string / number / boolean / array of values or null Sí Valor que coincide con la definición del campo y sus opciones permitidas; null borra el campo. null

Proporcione el id obligatorio y al menos un campo de actualización. Los campos omitidos conservan sus valores actuales.

Salida Esperada

Devuelve el registro actualizado.

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
id integer No ID del Registro 1
name string or null No nombre "Acme Corp"
description string or null No descripción "Account details"
logo string or null No logotipo null
creator integer or null No creador 123
creator_name string or null No nombre del creador null
owner integer or null No propietario 123
owner_id integer or null No id del propietario 123
owner_name string or null No nombre del propietario null
location string or null No ubicación null
address string or null No dirección "123 Main Street"
website string or null No sitio web "https://example.com"
is_public boolean or null No es público true
is_visible boolean or null No es visible true
stage integer or null No etapa 1
stage_id integer or null No id de la etapa 1
stage_name string or null No nombre de la etapa "Qualified"
custom_fields object or null No campos personalizados {"seniority":"Senior"}
created_at string or null (date-time) No Marca de tiempo de creación "2026-10-19T09:00:00Z"
updated_at string or null (date-time) No Marca de tiempo de la última actualización "2026-10-19T09:00:00Z"

19. Obtener Campos de la Organización

Liste los campos de organización disponibles y los valores permitidos.

Entradas Posibles

Sin parámetros. Entrada: {}.

Salida Esperada

Devuelve una lista de registros.

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
groups array of objects No grupos []
groups[].name string or null No Nombre para mostrar del grupo (p. ej., "Personal Details"). Solo diseño: no forma parte de ninguna carga útil. null
groups[].is_hidden boolean No Indica si todo el grupo está oculto en la vista de perfil del cliente. false
groups[].fields array of objects No campos []
groups[].fields[].slug string No Identificador del campo. Páselo tal cual como custom_field_input[].field; distingue entre mayúsculas y minúsculas y debe coincidir exactamente, por lo que nunca lo adivine, traduzca ni reformatee a partir del nombre para mostrar. "seniority"
groups[].fields[].name string or null No Nombre para mostrar que ven los reclutadores: haga coincidir la redacción del usuario con este y luego envíe slug. null
groups[].fields[].description string or null No Texto de ayuda que explica para qué sirve el campo. null
groups[].fields[].field_type string No Tipo de valor del campo: text, long_text, date (cadena YYYY-MM-DD), number, percentage, boolean, dropdown (un solo valor), multiple_select_dropdown y checkbox (lista de valores), o custom_id (generado por el sistema, nunca editable). "dropdown"
groups[].fields[].answer_choices array of strings No Valores permitidos para los campos dropdown, multiple_select_dropdown y checkbox cuando answer_choice_type es text. El valor escrito debe ser una de estas cadenas (o una lista de ellas para campos de varios valores); cualquier otra cosa se rechaza. []
groups[].fields[].answer_choice_type string No text significa que las opciones de answer_choices son los valores aceptados. Cualquier otro valor (candidate, job, organization, contact, user) significa que el campo almacena el ID de otro registro, y answer_choices no enumera las opciones. "text"
groups[].fields[].is_required boolean No Indica si el cliente requiere que se complete este campo. false
groups[].fields[].is_native boolean No true para atributos integrados (full_name, email, ...), que deben actualizarse mediante el parámetro de nivel superior correspondiente. Solo los campos con is_native: false se pueden escribir mediante custom_field_input. false
groups[].fields[].is_hidden boolean No Indica si el campo está oculto en la vista de perfil del cliente. false

20. Obtener Etapas de la Organización

Liste las etapas de la organización.

Entradas Posibles

Sin parámetros. Entrada: {}.

Salida Esperada

Devuelve una lista de registros.

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
id integer No ID de la etapa de la organización 1
name string or null No Nombre para mostrar de la etapa "Qualified"

21. Listar Notas de la Organización

Lea notas sobre una empresa cliente

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID de la Organización Integer Sí ID de la organización 892

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Nota 4471
Información Cliente clave, renovar contrato en el T3
Nombre del Creador Emma
ID del Creador 42241
Fecha de Creación 2025-11-01

22. Añadir Nota de la Organización

Registre información sobre las relaciones e interacciones con clientes

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID de la Organización Integer Sí ID de la organización 892
Información String Sí El contenido o cuerpo de la información (compatible con HTML) Cliente clave, renovar contrato en el T3

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Nota 4471
Información El cliente solicitó una reunión de seguimiento el próximo martes.
ID del Creador 42241
Nombre del Creador Emma
Fecha de Creación 2026-07-02

23. Buscar Contactos

Encuentre personas en empresas clientes

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
Nombre Completo String No Filtrar por nombre completo (contiene) John Smith
Nombre para Mostrar String No Filtrar por nombre para mostrar (contiene) J. Smith
Correo Electrónico String No Filtrar por correo electrónico (contiene) john@acme.com
Número de Teléfono String No Filtrar por número de teléfono (contiene) +1-555-020-1234
ID(s) de la Organización String No IDs de organización separados por comas 892
Fecha de Creación (Inicio) Date No Filtrar por fecha de creación mayor o igual a 2025-01-01
Fecha de Creación (Fin) Date No Filtrar por fecha de creación menor o igual a 2025-06-30

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID del Contacto 6621
Nombre Completo John Smith
Nombre para Mostrar J. Smith
Correo Electrónico john@acme.com
Número de Teléfono +1-555-020-1234
Nombre de la Organización Acme Corp
ID de la Organización 892
Descripción Contacto clave de la cuenta empresarial
Campos Personalizados {“priority”: “high”, “source”: “referral”}
ID del Creador 1234
Fecha de Creación 2025-06-30
ID de Usuario (user) 123 or null
Tipo de Contacto (type) contact or guest

24. Actualizar Contacto

Actualice los detalles de un contacto.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
id integer Sí ID del Contacto 1
full_name string No Nombre completo del contacto. Longitud mínima: 1. Longitud máxima: 255 "John Smith"
display_name string No Nombre para mostrar, que puede ser diferente del nombre completo. Longitud máxima: 255 "J. Smith"
email string or null (email) No Correo electrónico del contacto. No envíe este campo cuando el type del contacto sea guest; un contacto invitado no puede editar su correo electrónico. Longitud máxima: 254 "john@example.com"
phone_number string No Número de teléfono del contacto. Longitud máxima: 16 "+66812345678"
description string No Descripción del contacto "Account details"
custom_field_input array of objects No Valores de los campos personalizados de contacto del cliente, como entradas {"field": <slug>, "value": <value>}. Llame primero a get_contact_field y tome cada field de un slug que devuelva: las entradas cuyo slug sea desconocido, o cuyo valor el campo rechace, se descartan silenciosamente y el resto de la actualización se realiza correctamente. Solo cambian los campos indicados aquí; los campos omitidos conservan su valor actual. []
custom_field_input[].field string Sí Slug exacto, sensible a mayúsculas y minúsculas, devuelto por la herramienta get-field correspondiente. "seniority"
custom_field_input[].value string / number / boolean / array of values or null Sí Valor que coincide con la definición del campo y sus opciones permitidas; null borra el campo. null

Proporcione el id obligatorio y al menos un campo de actualización. Los campos omitidos conservan sus valores actuales.

Salida Esperada

Devuelve el registro actualizado.

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
id integer No ID del Registro 1
full_name string or null No nombre completo "John Smith"
display_name string or null No nombre para mostrar "J. Smith"
email string or null No correo electrónico "john@example.com"
phone_number string or null No número de teléfono "+66812345678"
description string or null No descripción "Account details"
organization_name string or null No nombre de la organización "Acme Corp"
user integer or null No usuario 123
creator integer or null No creador 123
type string or null No Tipo de contacto. contact para un contacto independiente, o guest. "contact"
custom_fields object or null No campos personalizados {"seniority":"Senior"}
created_at string or null (date-time) No Marca de tiempo de creación "2026-10-19T09:00:00Z"

25. Obtener Campos del Contacto

Liste los campos de contacto disponibles y los valores permitidos.

Entradas Posibles

Sin parámetros. Entrada: {}.

Salida Esperada

Devuelve una lista de registros.

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
groups array of objects No grupos []
groups[].name string or null No Nombre para mostrar del grupo (p. ej., "Personal Details"). Solo diseño: no forma parte de ninguna carga útil. null
groups[].is_hidden boolean No Indica si todo el grupo está oculto en la vista de perfil del cliente. false
groups[].fields array of objects No campos []
groups[].fields[].slug string No Identificador del campo. Páselo tal cual como custom_field_input[].field; distingue entre mayúsculas y minúsculas y debe coincidir exactamente, por lo que nunca lo adivine, traduzca ni reformatee a partir del nombre para mostrar. "seniority"
groups[].fields[].name string or null No Nombre para mostrar que ven los reclutadores: haga coincidir la redacción del usuario con este y luego envíe slug. null
groups[].fields[].description string or null No Texto de ayuda que explica para qué sirve el campo. null
groups[].fields[].field_type string No Tipo de valor del campo: text, long_text, date (cadena YYYY-MM-DD), number, percentage, boolean, dropdown (un solo valor), multiple_select_dropdown y checkbox (lista de valores), o custom_id (generado por el sistema, nunca editable). "dropdown"
groups[].fields[].answer_choices array of strings No Valores permitidos para los campos dropdown, multiple_select_dropdown y checkbox cuando answer_choice_type es text. El valor escrito debe ser una de estas cadenas (o una lista de ellas para campos de varios valores); cualquier otra cosa se rechaza. []
groups[].fields[].answer_choice_type string No text significa que las opciones de answer_choices son los valores aceptados. Cualquier otro valor (candidate, job, organization, contact, user) significa que el campo almacena el ID de otro registro, y answer_choices no enumera las opciones. "text"
groups[].fields[].is_required boolean No Indica si el cliente requiere que se complete este campo. false
groups[].fields[].is_native boolean No true para atributos integrados (full_name, email, ...), que deben actualizarse mediante el parámetro de nivel superior correspondiente. Solo los campos con is_native: false se pueden escribir mediante custom_field_input. false
groups[].fields[].is_hidden boolean No Indica si el campo está oculto en la vista de perfil del cliente. false

26. Listar Notas del Contacto

Lea notas sobre los contactos de sus clientes

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Contacto Integer Sí ID del contacto 6621

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Nota 8834
Información Prefiere el correo electrónico al contacto telefónico
ID del Creador 42241
Nombre del Creador Emma
Fecha de Creación 2025-11-01

27. Añadir Nota del Contacto

Registre conversaciones o recordatorios sobre los contactos de clientes

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Contacto Integer Sí ID del Contacto 123
Información String Sí Nota para adjuntar al contacto Notas de la reunión de la llamada de solicitud de empleo.

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Nota 452
Información Llamada de seguimiento programada para el próximo martes.
ID del Creador 12
Nombre del Creador Emma
Fecha de Creación 2025-11-15

28. Listar Reuniones del Contacto

Liste las reuniones y evaluaciones de AI Notetaker de un contacto.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Contacto Integer Sí ID del Contacto 6621
Página Integer No Número de página 1
Tamaño de Página Integer No Resultados por página (máx. 10) 10

Salida Esperada

La evaluación contiene contenido JSON cuando está disponible; obtenga las transcripciones mediante Get Meeting.

Nombre del Campo Valores de Ejemplo
ID de la Reunión 901
ID del Cliente 123
ID de la Actividad 7789
Título Entrevista con el candidato
Hora de la Reunión 2026-09-22T09:00:00Z
URL de la Reunión null
Compartido con Invitados false
Está Archivado false
Fecha de Creación 2026-09-22T09:00:00Z
Fecha de Actualización 2026-09-22T09:00:00Z
ID de la Vacante 5567
ID del Candidato 10234
Estado completed
Tipo de Origen ai_notetaker
Duración 1800
Evaluación null

29. Buscar Vacantes

Encuentre posiciones abiertas por puesto, estado o empresa

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
Nombre de la Posición String No Filtrar por título del puesto (contiene) Senior Developer
Nombre de la Organización String No Filtrar por nombre de la organización (contiene) Acme Corp
Ciudad String No Filtrar por ciudad (contiene) New York
Estado String No Separados por comas: planning, active, on_hold, won, lost active
Está Publicado Boolean No Filtrar por estado de publicación en la Página de carrera true
Es Remoto Boolean No Filtrar por opción de trabajo remoto true
ID(s) del Creador String No IDs de creadores separados por comas 42123
ID(s) del Propietario String No IDs de propietarios separados por comas 81245
Fecha de Apertura (Inicio) Date No Filtrar por fecha de apertura mayor o igual a 2025-01-01
Fecha de Apertura (Fin) Date No Filtrar por fecha de apertura menor o igual a 2025-06-30
Fecha de Cierre (Inicio) Date No Filtrar por fecha de cierre mayor o igual a 2025-07-01
Fecha de Cierre (Fin) Date No Filtrar por fecha de cierre menor o igual a 2025-12-31
Fecha de Creación (Inicio) Date No Filtrar por fecha de creación mayor o igual a 2025-01-01
Fecha de Creación (Fin) Date No Filtrar por fecha de creación menor o igual a 2025-06-30
Fecha de Actualización (Inicio) Date No Filtrar por fecha de actualización mayor o igual a 2025-11-01
Fecha de Actualización (Fin) Date No Filtrar por fecha de actualización menor o igual a 2025-11-30
Página Integer No Número de página 1
Tamaño de Página Integer No Resultados por página 20

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Vacante 419258
ID de la Organización 1495136
Nombre de la Organización Acme Corp
Nombre de la Posición Senior Developer
Descripción Analizar grandes conjuntos de datos para impulsar estrategias de negocio.
Número de Vacantes 1
Es Remoto True
ID del Creador 123
Nombre del Creador Emma
ID del Propietario 456
Nombre del Propietario John
Estado Indiana
Ciudad Georgia
Dirección Indiana
Código Postal 10119
Salario Mínimo 80000
Salario Máximo 100000
Moneda 1
Código de Moneda USD
Frecuencia monthly
Detalles del Contrato full_time
Está Publicado true
Estado active
Fecha de Creación 2026-04-09T09:54:37.629221Z
Fecha de Actualización 2026-04-09T09:54:58.982897Z
Fecha de Apertura 2026-04-09T09:54:37.614247Z
Fecha de Cierre null
Campos Personalizados {“department”: “Analytics”, “priority”: “high”}
Industria Organizaciones Benéficas / Servicios Sociales / Organizaciones sin Fines de Lucro
Está Fijado en la Página de carrera false

30. Crear Vacante

Añada una nueva posición que desee cubrir

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID de la Organización Integer Sí Organización a la que pertenece la vacante 892
Nombre de la Posición String Sí Título del puesto Senior Developer
Dirección String No Dirección postal de la ubicación de la vacante 456 Market St
Código Postal String No Código postal 10001
Detalles del Contrato String No Opciones: full_time, part_time, temporary, freelance, internship, apprenticeship, contractor, consultancy. full_time
ID de la Moneda Integer No ID de la moneda para el salario 1
Salario Mínimo Number No Salario mínimo 90000
Salario Máximo Number No Salario máximo 130000
Número de Vacantes Integer No Número de posiciones a cubrir 2
Descripción String No Descripción de la vacante (compatible con HTML) Buscamos…
Industria Array No Lista de IDs de industria [3,7]
Es Remoto Boolean No Indica si la vacante es remota true
Está Publicado Boolean No Publicado en la Página de carrera true
Está Fijado en la Página de carrera Boolean No Indica si la vacante se ha añadido a la Página de carrera o no false
ID del Propietario Integer No ID del usuario propietario 81245
Estado String No planning, active, on_hold, won, lost active
Campos Personalizados Array No Valores de la vacante para los campos personalizados definidos en Manatal {“department”: “Analytics”, “priority”: “high”}

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Vacante 419258
ID de la Organización 1495136
Nombre de la Organización Acme Corp
Nombre de la Posición Senior Developer
Descripción Analizar grandes conjuntos de datos para impulsar estrategias de negocio.
Número de Vacantes 1
Es Remoto null
ID del Creador 123
Nombre del Creador Emma
ID del Propietario 456
Nombre del Propietario John
Estado Indiana
Ciudad Georgia
Dirección Indiana
Código Postal 10119
Salario Mínimo 80000
Salario Máximo 100000
ID de la Moneda 1
Código de Moneda USD
Frecuencia day
Detalles del Contrato full_time
Está Publicado true
Estado active
Fecha de Creación 2026-04-09T09:54:37.629221Z
Fecha de Actualización 2026-04-09T09:54:58.982897Z
Fecha de Apertura 2026-04-09T09:54:37.614247Z
Fecha de Cierre 2026-04-09T09:54:37.614247Z
Campos Personalizados {“department”: “Analytics”, “priority”: “high”}
Industria Organizaciones Benéficas / Servicios Sociales / Organizaciones sin Fines de Lucro
Está Fijado en la Página de carrera false

31. Obtener Vacante

Obtenga todos los detalles de una vacante por ID

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID de la Vacante Integer Sí ID de la vacante que se desea obtener 5567

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Vacante 419258
ID de la Organización 1495136
Nombre de la Organización Acme Corp
Nombre de la Posición Senior Developer
Descripción Analizar grandes conjuntos de datos para impulsar estrategias de negocio.
Número de Vacantes 1
Es Remoto null
ID del Creador 123
Nombre del Creador Emma
ID del Propietario 456
Nombre del Propietario John
Estado Indiana
Ciudad Georgia
Dirección Indiana
Código Postal 10119
Salario Mínimo 80000
Salario Máximo 100000
ID de la Moneda 1
Código de Moneda USD
Frecuencia monthly
Detalles del Contrato full_time
Está Publicado true
Estado active
Fecha de Creación 2026-04-09T09:54:37.629221Z
Fecha de Actualización 2026-04-09T09:54:58.982897Z
Fecha de Apertura 2026-04-09T09:54:37.614247Z
Fecha de Cierre null
Campos Personalizados {“department”: “Analytics”, “priority”: “high”}
Industria Organizaciones Benéficas / Servicios Sociales / Organizaciones sin Fines de Lucro
Está Fijado en la Página de carrera false

32. Actualizar Vacante

Actualice los detalles de una vacante.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
id integer Sí ID de la Vacante 1
external_id string or null No ID de la vacante en los sistemas del consumidor de la API. Longitud máxima: 255 null
position_name string No Título del puesto. Longitud mínima: 1. Longitud máxima: 255 "Software Engineer"
description string No Descripción de la vacante "Account details"
headcount integer or null No Número de personas que se contratarán para la vacante. Mínimo: 0. Máximo: 2147483647 3
is_salary_visible boolean No Indica si la información salarial se muestra a los candidatos en la Página de carrera y en las ofertas de empleo. false
salary_min string or null (decimal) No salario mínimo 50000
salary_max string or null (decimal) No salario máximo 70000
frequency string or null No frecuencia "monthly"
currency integer or null No ID de moneda de list_currencies 1
industries integer or null No ID de industria de list_industries null
owner integer or null No ID de usuario de list_client_users para asignar como propietario de la vacante 123
address string No Dirección de la oficina donde se desarrollará la vacante. Longitud máxima: 255 "123 Main Street"
city string No Ciudad de la oficina donde se desarrollará la vacante. Longitud máxima: 255 "Bangkok"
state string No Estado de la oficina donde se desarrollará la vacante. Longitud máxima: 255 "Bangkok"
country string No País de la oficina donde se desarrollará la vacante. Longitud máxima: 255 "Example"
zipcode string No Código de la ciudad para la dirección de la oficina. Longitud máxima: 255 "10110"
contract_details string No detalles del contrato. Valores permitidos: full_time, part_time, temporary, freelance, internship, apprenticeship, contractor, consultancy "full_time"
is_published boolean No está publicado true
is_remote boolean or null No es remoto true
status string No Estado de la vacante. Valores permitidos: active, on_hold, won, lost "active"
expected_close_at string (date-time) No Fecha prevista en la que se cerrará o cubrirá la posición de la vacante "2026-10-19T09:00:00Z"
custom_field_input array of objects No Valores de los campos personalizados de vacante del cliente, como entradas {"field": <slug>, "value": <value>}. Llame primero a get_job_field y tome cada field de un slug que devuelva: las entradas cuyo slug sea desconocido, o cuyo valor el campo rechace, se descartan silenciosamente y el resto de la actualización se realiza correctamente. Solo cambian los campos indicados aquí; los campos omitidos conservan su valor actual. []
custom_field_input[].field string Sí Slug exacto, sensible a mayúsculas y minúsculas, devuelto por la herramienta get-field correspondiente. "seniority"
custom_field_input[].value string / number / boolean / array of values or null Sí Valor que coincide con la definición del campo y sus opciones permitidas; null borra el campo. null
is_pinned_in_career_page boolean No Indica si la vacante se ha añadido a la Página de carrera o no false

Proporcione el id obligatorio y al menos un campo de actualización. Los campos omitidos conservan sus valores actuales.

Salida Esperada

Devuelve el registro actualizado.

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
id integer No ID del Registro 1
organization integer or null No organización null
organization_name string or null No nombre de la organización "Acme Corp"
position_name string or null No nombre de la posición "Software Engineer"
description string or null No descripción "Account details"
headcount integer or null No número de vacantes 3
is_remote boolean or null No es remoto true
creator integer or null No creador 123
creator_name string or null No nombre del creador null
owner integer or null No propietario 123
owner_name string or null No nombre del propietario null
state string or null No estado "Bangkok"
city string or null No ciudad "Bangkok"
address string or null No dirección "123 Main Street"
zipcode string or null No código postal "10110"
salary_min number or null No salario mínimo 50000
salary_max number or null No salario máximo 70000
currency integer or null No moneda 1
currency_code string or null No código de moneda "USD"
frequency string or null No frecuencia "monthly"
contract_details string or null No detalles del contrato "full_time"
is_published boolean or null No está publicado true
status string or null No estado "active"
created_at string or null (date-time) No Marca de tiempo de creación "2026-10-19T09:00:00Z"
updated_at string or null (date-time) No Marca de tiempo de la última actualización "2026-10-19T09:00:00Z"
open_at string or null (date-time) No fecha de apertura "2026-10-19T09:00:00Z"
close_at string or null (date-time) No fecha de cierre "2026-11-19T09:00:00Z"
custom_fields object or null No campos personalizados {"seniority":"Senior"}
industries_name string or null No nombre de industrias null
is_pinned_in_career_page boolean or null No está fijado en la Página de carrera null

33. Obtener Campos de la Vacante

Liste los campos de vacante disponibles y los valores permitidos.

Entradas Posibles

Sin parámetros. Entrada: {}.

Salida Esperada

Devuelve una lista de registros.

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
groups array of objects No grupos []
groups[].name string or null No Nombre para mostrar del grupo (p. ej., "Personal Details"). Solo diseño: no forma parte de ninguna carga útil. null
groups[].is_hidden boolean No Indica si todo el grupo está oculto en la vista de perfil del cliente. false
groups[].fields array of objects No campos []
groups[].fields[].slug string No Identificador del campo. Páselo tal cual como custom_field_input[].field; distingue entre mayúsculas y minúsculas y debe coincidir exactamente, por lo que nunca lo adivine, traduzca ni reformatee a partir del nombre para mostrar. "seniority"
groups[].fields[].name string or null No Nombre para mostrar que ven los reclutadores: haga coincidir la redacción del usuario con este y luego envíe slug. null
groups[].fields[].description string or null No Texto de ayuda que explica para qué sirve el campo. null
groups[].fields[].field_type string No Tipo de valor del campo: text, long_text, date (cadena YYYY-MM-DD), number, percentage, boolean, dropdown (un solo valor), multiple_select_dropdown y checkbox (lista de valores), o custom_id (generado por el sistema, nunca editable). "dropdown"
groups[].fields[].answer_choices array of strings No Valores permitidos para los campos dropdown, multiple_select_dropdown y checkbox cuando answer_choice_type es text. El valor escrito debe ser una de estas cadenas (o una lista de ellas para campos de varios valores); cualquier otra cosa se rechaza. []
groups[].fields[].answer_choice_type string No text significa que las opciones de answer_choices son los valores aceptados. Cualquier otro valor (candidate, job, organization, contact, user) significa que el campo almacena el ID de otro registro, y answer_choices no enumera las opciones. "text"
groups[].fields[].is_required boolean No Indica si el cliente requiere que se complete este campo. false
groups[].fields[].is_native boolean No true para atributos integrados (full_name, email, ...), que deben actualizarse mediante el parámetro de nivel superior correspondiente. Solo los campos con is_native: false se pueden escribir mediante custom_field_input. false
groups[].fields[].is_hidden boolean No Indica si el campo está oculto en la vista de perfil del cliente. false

34. Listar Notas de la Vacante

Lea notas y actualizaciones sobre una vacante abierta

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID de la Vacante Integer Sí ID de la vacante 5567

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Nota 7789
Información El cliente quiere avanzar rápido con este puesto
ID del Creador 42241
Nombre del Creador Emma
Fecha de Creación 2025-11-01

35. Añadir Nota de la Vacante

Registre actualizaciones, requisitos o avances de contratación

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID de la Vacante Integer Sí ID de la vacante 5567
Información String Sí El contenido o cuerpo de la información de la nota El cliente quiere avanzar rápido con este puesto

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Nota 7789
Información El cliente quiere avanzar rápido con este puesto
ID del Creador 42241
Nombre del Creador Emma
Fecha de Creación 2026-07-02

36. Listar Reuniones de la Vacante

Liste las reuniones y evaluaciones de AI Interviewer de una vacante.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID de la Vacante Integer Sí ID de la Vacante 5567
Página Integer No Número de página 1
Tamaño de Página Integer No Resultados por página (máx. 10). 10

Salida Esperada

La evaluación contiene contenido JSON cuando está disponible; obtenga las transcripciones mediante Get Meeting.

Nombre del Campo Valores de Ejemplo
ID de la Reunión 901
ID del Cliente 123
ID de la Actividad 7789
Título Entrevista con el candidato
Hora de la Reunión 2026-09-22T09:00:00Z
URL de la Reunión null
Compartido con Invitados false
Está Archivado false
Fecha de Creación 2026-09-22T09:00:00Z
Fecha de Actualización 2026-09-22T09:00:00Z
ID de la Vacante 5567
ID del Candidato 10234
Estado completed
Tipo de Origen ai_interviewer
Duración 1800
Evaluación null

37. Buscar Matches

Consulte qué candidatos se han asociado a qué vacantes y su progreso

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID(s) de la Vacante String No IDs de vacantes separados por comas 5567
ID(s) de Etapa del Match String No IDs de etapas de match separados por comas (de list_match_stages) 3
Fecha de Creación (Inicio) Date No Filtrar por fecha de creación mayor o igual a 2025-01-01
Fecha de Creación (Fin) Date No Filtrar por fecha de creación menor o igual a 2025-06-30
Fecha de Actualización (Inicio) Date No Filtrar por fecha de actualización mayor o igual a/posterior a 2025-11-01
Fecha de Actualización (Fin) Date No Filtrar por fecha de actualización menor o igual a 2025-11-30
Enviado el (Inicio) Date No Filtrar por fecha de envío mayor o igual a 2026-01-01
Enviado el (Fin) Date No Filtrar por fecha de envío menor o igual a 2026-01-31
Entrevista el (Inicio) Date No Filtrar por fecha de entrevista mayor o igual a 2026-01-10
Entrevista el (Fin) Date No Filtrar por fecha de entrevista menor o igual a 2026-01-20
Oferta el (Inicio) Date No Filtrar por fecha de oferta menor o igual a 2026-02-01
Oferta el (Fin) Date No Filtrar por fecha de oferta menor o igual a 2026-02-10
Contratado el (Inicio) Date No Filtrar por fecha de contratación mayor o igual a 2026-02-15
Contratado el (Fin) Date No Filtrar por fecha de contratación menor o igual a 2026-02-28
Rechazado el (Inicio) Date No Filtrar por fecha de rechazo mayor o igual a 2026-02-28
Rechazado el (Fin) Date No Filtrar por fecha de rechazo menor o igual a 2026-02-28
Página Integer No Número de página 1
Tamaño de Página Integer No Resultados por página 20

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID del Match 77120
ID del Candidato 10234
ID de la Vacante 5567
ID del Propietario 123
ID del Creador 456
Etapa del Match Interview
Está Activo true
Contratado el 2026-01-30
Enviado el 2026-01-10
Entrevista el 2026-01-15
Oferta el 2026-01-20
Rechazado el 2026-01-15
Fecha de Creación 2026-01-10
Fecha de Actualización 2026-01-15

38. Obtener Match

Obtenga los detalles de un match por ID

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Match Integer Sí ID del match 77120

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID del Match 77120
ID del Candidato 10234
ID de la Vacante 5567
ID del Propietario 123
ID del Creador 456
Etapa del Match Interview
Está Activo true
Contratado el 2026-01-30
Enviado el 2026-01-10
Entrevista el 2026-01-15
Oferta el 2026-01-20
Rechazado el 2026-01-15
Fecha de Creación 2026-01-10
Fecha de Actualización 2026-01-15

39. Añadir Candidato a Vacante

Conecte a un candidato con una vacante abierta

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID del Candidato Integer Sí Candidato que se añadirá 10234
ID de la Vacante Integer Sí Vacante con la que se asocia al candidato 5567
Está Activo Boolean No Indica si el match sigue activo o no true
Enviado el DateTime No Fecha en que el candidato se añadió a la vacante 2026-01-10T00:00:00Z
Entrevista el DateTime No Fecha en que el candidato fue entrevistado por última vez 2026-01-15T00:00:00Z
Oferta el DateTime No Fecha en que se hizo una oferta al candidato 2026-02-01T00:00:00Z
Contratado el DateTime No Fecha en que se contrató al candidato 2026-02-15T00:00:00Z
Rechazado el DateTime No Fecha en que el candidato dejó de ser considerado para la vacante. (null)

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID del Match 77120
ID del Candidato 10234
ID de la Vacante 5567
ID del Propietario 123
ID del Creador 456
Etapa del Match Interview
Está Activo true
Contratado el 2026-01-30
Enviado el 2026-01-10
Entrevista el 2026-01-15
Oferta el 2026-01-20
Rechazado el 2026-01-15
Fecha de Creación 2026-01-10
Fecha de Actualización 2026-01-15

40. Listar Etapas de Match

Liste las etapas disponibles del proceso de trabajo candidato-vacante.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
(ninguno — sin parámetros) — — — —

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de Etapa 3
Nombre Interview
Rango 0
Fecha de Creación 2025-10-05
Fecha de Actualización 2025-10-10

41. Obtener Etapas de Match de la Vacante

Obtenga las etapas del proceso de trabajo de una vacante y su configuración.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID de la Vacante Integer Sí ID de la Vacante 5567

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de Etapa del Proceso de Trabajo 3
Nombre Submitted
Categoría submitted_stage
Tiene Acción de Automatización false
Etapas Clave ["submitted_stage"]

42. Listar Motivos de Rechazo

Liste los motivos del cliente para rechazar candidatos de los procesos de trabajo.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
Ordenación String No Qué campo usar al ordenar los resultados. id

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID del Motivo de Rechazo 1
Motivo Skills mismatch

43. Listar Candidatos Rechazados

Liste los candidatos rechazados de una etapa específica del proceso de trabajo.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID de la Vacante Integer Sí ID de la Vacante 5567
ID de Etapa Integer Sí ID de la etapa del proceso de trabajo (de get_job_match_stage). Restringe los resultados a los matches rechazados en esa etapa. 3
Buscar String No Buscar por nombre completo o correo electrónico del candidato Jane
Página Integer No Un número de página dentro del conjunto de resultados paginado. 1
Tamaño de Página Integer No Número de resultados que se devolverán por página. 10
Ordenación String No Ordene los resultados. Anteponga '-' para orden descendente. id

Salida Esperada

Cada elemento representa un match rechazado; su Match ID es distinto del Candidate ID.

Nombre del Campo Valores de Ejemplo
ID del Match 77120
Candidato → ID del Candidato 10234
Candidato → Nombre Completo Jane Doe
Candidato → Correo Electrónico jane.doe@example.com
Candidato → Imagen null
Vacante → ID de la Vacante 5567
Motivos de Rechazo ["Skills mismatch"]

44. Mover Matches en Lote

Mueva uno o más matches activos a otra etapa del proceso de trabajo.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID de la Vacante Integer Sí ID de la Vacante 5567
Lista de IDs de Match Array Sí IDs de match que se moverán [77120,77121]
ID de Etapa del Proceso de Trabajo Integer Sí ID de la etapa de destino del proceso de trabajo de get_job_match_stage 3

Salida Esperada

Nombre del Campo Valores de Ejemplo
Estado Matches updated
Automatizaciones {}

45. Rechazar Matches en Lote

Rechace uno o más matches activos de un proceso de trabajo.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID de la Vacante Integer Sí ID de la Vacante 5567
Lista de IDs de Match Array Sí IDs de match que se rechazarán [77120,77121]
Lista de IDs de Motivos de Rechazo Array Sí IDs de motivos de rechazo de list_drop_reasons [2]
Información String No Texto de nota HTML opcional adjunto a cada match rechazado El candidato no cumple los requisitos del puesto.

Salida Esperada

Nombre del Campo Valores de Ejemplo
Estado Matches updated
Automatizaciones {}

46. Obtener Reunión

Obtenga los detalles, la evaluación y la transcripción de una reunión.

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
ID de la Reunión Integer Sí ID de la Reunión 901

Salida Esperada

La evaluación y la transcripción contienen contenido JSON cuando está disponible; null significa que no se devuelve contenido para ese campo.

Nombre del Campo Valores de Ejemplo
ID de la Reunión 901
ID del Cliente 123
ID de la Actividad 7789
Título Entrevista con el candidato
Hora de la Reunión 2026-09-22T09:00:00Z
URL de la Reunión null
Compartido con Invitados false
Está Archivado false
Fecha de Creación 2026-09-22T09:00:00Z
Fecha de Actualización 2026-09-22T09:00:00Z
ID de la Vacante 5567
ID del Candidato 10234
Estado completed
Tipo de Origen ai_interviewer
Duración 1800
Evaluación null
Transcripción null

47. Buscar Empleadores

Busque empleadores por nombre para obtener sus IDs

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
Término de Búsqueda String Sí Búsqueda por nombre de empleador (mín. 3 caracteres) Tech Solutions
Límite de Consulta Integer No Resultados por página (1-100, predeterminado 20) 20

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID del Empleador 771
Nombre Tech Solutions Inc.

48. Crear Empleador

Cree un nuevo empleador por nombre

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
Nombre String Sí Nombre del empleador Acme Corp

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID del Empleador 892
Nombre Acme Corp

49. Buscar Posiciones

Busque títulos de puesto por nombre para obtener los IDs de posición

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
Término de Búsqueda String Sí Búsqueda por nombre de posición (mín. 3 caracteres) Developer
Límite de Consulta Integer No Resultados por página (1-100, predeterminado 20) 20

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Posición 220
Nombre Senior Developer

50. Crear Posición

Cree una nueva posición de trabajo por nombre

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
Nombre String Sí Nombre de la posición/título del puesto Product Manager

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Posición 331
Nombre de la Posición Product Manager

51. Buscar Escuelas

Busque escuelas/universidades por nombre para obtener los IDs de escuela

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
Término de Búsqueda String Sí Búsqueda por nombre de escuela (mín. 3 caracteres) Stanford

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Escuela 1123
Nombre Stanford University

52. Crear Escuela

Cree una nueva escuela/universidad por nombre

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
Nombre String Sí Nombre de la escuela/universidad Springfield Community College

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Escuela 4471
Nombre Springfield Community College

53. Buscar Títulos

Busque títulos por nombre para obtener los IDs de título

Entradas Posibles

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
Término de Búsqueda String No Búsqueda por nombre de título Bachelor
Ordenación String No rank or name rank

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID del Título 45
Nombre Bachelor of Science

54. Listar Industrias

Liste las industrias disponibles

Entradas Posibles

Sin entrada

Salida Esperada

Nombre del Campo Valores de Ejemplo
ID de la Industria 3
Nombre Fintech

55. Listar Monedas

Liste las monedas disponibles.

Entradas Posibles

Sin parámetros. Entrada: {}.

Salida Esperada

Devuelve una lista de registros.

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
id integer No ID de la moneda. Páselo como currency en update_job. 1
name string or null No Nombre de la moneda "US Dollar"
symbol string or null No Símbolo de la moneda "$"
code string or null No Código de la moneda "USD"

56. Listar Usuarios del Cliente

Liste los usuarios disponibles para asignaciones de propiedad.

Entradas Posibles

Sin parámetros. Entrada: {}.

Salida Esperada

Devuelve una lista de registros.

Nombre del Campo Tipo Obligatorio Descripción Ejemplo
id integer No ID del usuario. Páselo como owner en update_job o update_organization. 1
full_name string or null No Nombre completo del usuario "John Smith"
display_name string or null No Nombre para mostrar del usuario "J. Smith"
Note

Esta función utiliza IA para respaldar su flujo de trabajo de reclutamiento. Los resultados de la IA están pensados para orientar, no para reemplazar su criterio. Es posible que los resultados no siempre sean totalmente precisos o completos, por lo que le recomendamos revisarlos como parte de su proceso. Todas las decisiones finales de reclutamiento son de su exclusiva responsabilidad.