Desde la sección Gestión de Webhooks y APIs puedes crear y administrar webhooks que envían eventos de Pandapé a tus sistemas, consultar el consumo mensual de la API y acceder a las credenciales técnicas. Es el lugar para integrar Pandapé con tus aplicaciones (ERP, HRIS, BI, etc.) y mantener un control claro.
Antes de empezar, te recomendamos consultar el artículo Glosario de términos clave (Webhooks & API), donde explicamos conceptos técnicos como endpoint, URL HTTPS, token, Client ID/Secret, etc. que revisaremos a lo largo de esta guía.
Este artículo aborda los siguientes temas:
Cómo acceder
- Desde tu cuenta de Pandapé ATS, entra en Configuración.
- En el apartado Otras configuraciones, selecciona Webhooks y APIs.
Qué puedes consultar y gestionar
- Consumo del último mes: muestra el número total de solicitudes de Webhook y API requests realizadas. Estos contadores se actualizan cada hora, por lo que no reflejan los datos en tiempo real.
- Credenciales de acceso a la API: incluye la documentación técnica, tu Client ID y Client Secret, necesarios para integraciones seguras.
- Webhooks configurados: listado de todos los webhooks activos creados en tu cuenta.
- Últimas 10 solicitudes de Webhook: ofrece una vista rápida del estado más reciente de tus envíos. Para más información, consulta el artículo Datos de logs Webhook: consulta de estado y reenvíos.
- Nuevo webhook: permite crear un nuevo webhook directamente desde esta sección. Consulta el apartado Cómo crear un nuevo webhook para ver los pasos detallados.
Cómo crear un nuevo webhook
Al crear un webhook defines qué evento notificará Pandapé, a qué dirección se enviará la información y cómo se autentica ese envío. Sigue estos pasos:
- Haz clic en Nuevo webhook.
- En la ventana Crear webhook, escribe un Nombre (p. ej. Alta de candidato – ATS – ERP).
- Selecciona el Evento que quieres activar (p. ej. Candidato registrado para una oferta). Para ver todos, consulta: Tipos de eventos disponibles en los webhooks.
- Indica la URL de destino: el endpoint HTTPS de tu sistema al que llegará la notificación.
- Elige el método de autenticación del envío. Selecciona una de las tres pestañas —Sin autorización, Token fijo o Token dinámico— y completa los datos correspondientes (te explicamos cada una más abajo).
- En Configurar para, define el alcance del webhook:
- Todas las vacantes: el webhook se activará ante el evento en cualquier proceso.
- Una vacante específica: se limitará a un proceso concreto.
- Te recomendamos hacer clic en Probar webhook para verificar la conexión con tu endpoint. Verás un resultado de éxito o de fallo.
- Haz clic en Guardar para finalizar la configuración.
A continuación te explicamos los tres métodos de autenticación que puedes elegir:
|
Método de autenticación |
¿Cuándo usarlo y qué completar? |
| Sin autorización | El envío no incluye token. Úsalo si tu endpoint no requiere validar el origen de la solicitud. |
| Token fijo | Defines manualmente un token estático en el campo Token (hasta 4.000 caracteres). Pandapé lo incluye en cada envío de este webhook. |
| Token dinámico | Pandapé obtiene el token automáticamente desde tu sistema antes de cada envío. Debes indicar: URL del token, Client ID y Client Secret. Tu proveedor debe ser compatible con OAuth 2.0 (RFC 6749). |
¿Cómo funciona el Token dinámico? (OAuth 2.0)
El Token dinámico utiliza el estándar OAuth 2.0 (RFC 6749) en su flujo Client Credentials, diseñado para la comunicación entre sistemas (de máquina a máquina), sin intervención de un usuario. Antes de cada envío, Pandapé obtiene automáticamente un token de acceso desde tu proveedor de autenticación y lo incluye en el webhook, para que tu sistema pueda validar el origen de la solicitud.
El proceso ocurre en tres momentos:
1. Pandapé solicita el token
Pandapé envía una petición a tu URL del token con estas características:
- Método:
POST. - Cabecera:
Content-Type: application/x-www-form-urlencoded. - En el cuerpo de la petición incluye estos parámetros:
|
Parámetro |
Presencia |
Descripción |
grant_type
|
Obligatorio |
Valor fijo: client_credentials.
|
client_id
|
Obligatorio | Tu Client ID. |
client_secret
|
Obligatorio | Tu Client Secret. |
scope
|
Opcional |
Alcance del token, si tu proveedor lo requiere (p. ej.
webhooks:receive).
|
2. Tu proveedor responde con el token
Si las credenciales son válidas, tu proveedor responde con 200 OK y un objeto JSON con el token:
|
Campo |
Descripción |
access_token
|
Token de acceso que Pandapé usará en la llamada del webhook. |
token_type
|
Tipo de token. Según la RFC 6749, debe ser Bearer.
|
expires_in
|
Vigencia del token, expresada en segundos. |
scope
|
Alcance concedido al token (si aplica). |
3. Pandapé envía el webhook
Pandapé incluye el access_token (de tipo Bearer) en la llamada a tu URL de destino. Tu sistema valida ese token y procesa la información solo si es válido.
- Estándar admitido: la autenticación con Token dinámico admite exclusivamente el estándar OAuth 2.0 (RFC 6749). Asegúrate de que tu proveedor de autenticación sea compatible con este estándar.
- Cliente confidencial: este flujo está pensado para clientes confidenciales, capaces de resguardar tu Client Secret en un entorno de backend seguro.
-
Sin tokens de actualización: este flujo no utiliza tokens
de actualización (
refresh tokens). Cuando Pandapé necesita un token nuevo, vuelve a solicitarlo con tus credenciales. - Compatibilidad: los webhooks con Token fijo que ya tienes configurados siguen funcionando sin cambios.
Consejo:
- Usa Probar webhook antes de guardar para confirmar que la conexión con tu endpoint funciona. Si el resultado es de fallo, revisa la URL de destino y, en la autenticación, los datos del token.
Tipos de eventos disponibles en los webhooks
A continuación, encontrarás los tipos de eventos que puedes seleccionar al crear un webhook en Pandapé.
Cada evento define cuándo se dispara la notificación automática hacia tu sistema (endpoint), según la acción o cambio registrado dentro del ATS.
|
Tipo de evento |
Descripción |
| Candidato registrado para una oferta | Se envía cuando un candidato completa el registro en una oferta. |
| Candidato cambió de etapa en una oferta | Se envía al mover al candidato entre etapas del proceso de selección. |
| Evaluación del candidato guardado | Se envía al guardar una evaluación en el perfil del candidato. |
| Se completó el cuestionario | Se envía cuando finaliza un cuestionario asociado al proceso. |
| La Video entrevista ha sido actualizada | Se envía al crear o actualizar una videoentrevista. |
| Se ha actualizado la valoración general del candidato | Se envía al cambiar la valoración global del perfil. |
| Solicitar cambio de estado | Se envía al solicitar un cambio de estado de la oferta/proceso. |
| Solicitante enviado para una solicitud | Se envía al remitir un solicitante en el módulo de Solicitudes. |
| El solicitante cambió la pasantía en una solicitud | Se envía cuando el solicitante cambia su pasantía/etapa en una solicitud. |