Webhooks y avisos en Slack, Microsoft Teams o Discord
Con Pro y Team, abre Panel > Integraciones para enviar eventos de Pandafile a un canal de Slack, Microsoft Teams o Discord, o a tu propio servidor como webhook firmado. Elige los eventos, envía una prueba y revisa el registro de entregas.
Con Pro y Team, Pandafile puede avisar a tus otras herramientas en el momento en que pasa algo: un mensaje en un canal de Slack, Microsoft Teams o Discord, o un webhook, es decir, una petición HTTPS firmada a tu propio servidor.
Eventos que puedes elegir
- Transferencia lista: la subida ha terminado y el enlace funciona.
- Transferencia descargada: una vez por destinatario, la primera vez. Puedes elegir cada descarga en su lugar.
- Transferencia caducada.
- Aprobación o solicitud de cambios de un destinatario.
- Subida a una de tus solicitudes de archivos.
- Documento firmado por todos, para Pandafile Sign.
Añadir una integración
- En Slack, Microsoft Teams o Discord, crea un webhook entrante para el canal y copia su URL. Para tu propio sistema, usa una dirección HTTPS de tu servidor.
- Inicia sesión en Pandafile y abre Panel > Integraciones.
- En Añadir una integración, elige el tipo, pega la URL, añade un nombre si quieres y marca los eventos que te interesan.
- Pulsa Añadir integración y después Enviar evento de prueba para comprobar que llega.
Puedes tener hasta 5 integraciones. Los mensajes de chat se escriben en el idioma de tu cuenta.
Webhooks para desarrolladores
- Cada entrega es un POST JSON con el tipo de evento, un id y los detalles: ids, títulos, enlaces, contadores y direcciones de correo de los destinatarios. Nunca incluye el contenido de los archivos, contraseñas ni enlaces de descarga personales.
- Cada petición lleva una cabecera Pandafile-Signature con una marca de tiempo (t) y una firma HMAC-SHA256 (v1) de la marca de tiempo y el cuerpo, hecha con tu secreto de firma. El secreto empieza por whsec_ y solo se muestra una vez.
- Nuevo secreto crea un secreto de firma nuevo. El anterior sigue funcionando 24 horas, para que puedas cambiar sin perder eventos.
- Responde con un estado 2xx en menos de 10 segundos. Si no, volvemos a intentarlo al cabo de 1 minuto, 5 minutos, 30 minutos, 2 horas y 12 horas.
- El registro de entregas muestra las últimas 50 entregas de cada integración y su resultado.
Equipos, modo de prueba y Zapier
En un equipo, cada persona gestiona sus propias integraciones y solo recibe eventos de sus propias transferencias. Los eventos de transferencias de prueba hechas con una clave API de prueba llegan a los webhooks con livemode en false, nunca a Slack, Teams o Discord. Zapier y Make se conectan mediante la API de Pandafile y aparecen en Suscripciones de API.