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 | |
| Nombre de la Red Social | |
| 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" |
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.